|1Update|

|0Before Updating|

|bullet|

|item| Review the original installation instructions to refresh the various
considerations involved.

|item| Some |/insurance| on the directory tree is recommended in case
the update should fail or otherwise be unusable or problematic (of course, this
is good advice whenever about to make major changes to anything!)  This may be
in the format of a regular site backup, special pre-update backup, or special
pre-update ZIP archive of the directory tree.  The latter two could be
accomplished using commands similar to the following:

|code|
$ BACKUP WASD_ROOT:[000000...] location:WASDROOT.BCK/SAVE/VERIFY

$ ZIP "-V" location:WASDROOT.ZIP device:[WASD_ROOT...]*.*
$ ZIP "-T" location:WASDROOT.ZIP
|!code|

|^ If using ZIP then ensure that a previous version of the target ZIP file
does not already exist.  If it does then that version is updated, a new
version is not created.

|item| For existing files a new version is created (the first time this is about
to occur the UNZIPper requests permission |-| either "A" for all, or
"y" or "n" or a per-file basis).

|item| It is possible to |/selectively| extract portions of a tree if
something has become damaged.  This would be accomplished by specifying what
needs to be extracted from the archive (instead of the default
|/all||), as illustrated by the following example where only the Alpha
object modules are extracted.

|code|
$ SET DEFAULT device:[000000]
$ UNZIP device:[dir]archive-AXP.ZIP ht_root/src/httpd/obj_axp/*.*
|!code|

|!bullet|

|2Package UNZIP|

|^ Updating a package follows a similar process to installation.

|^ The ZIP archive will contain brief installation instructions.  Use the
following command to read this and any other information provided.

|code|
$ UNZIP -z device:[dir]archive.ZIP
|!code|

|^ It is recommended to check the integrity of, then list the contents of, the
archive before UNZIPing.

|code|
$ UNZIP -t device:[dir]archive.ZIP
$ UNZIP -l device:[dir]archive.ZIP
|!code|

|^ The archive contains the complete directory tree.  Hence it is necessary
to SET DEFAULT into the parent directory of the WASD_ROOT logical name, as with
the following example.

|code|
$ SHOW LOGICAL WASD_ROOT
   "WASD_ROOT" = "DKA100:[WASD_ROOT.]" (LNM$SYSTEM_TABLE)
$ SET DEFAULT DKA100:[000000]
$ UNZIP device:[dir]archive.ZIP
|!code|

|note|
|0Updating From v9.3 or Earlier|
|*Before UNZIPing| the v11 package and when updating an existing v9.3 or
earlier installation the |*root directory must be renamed from HT_ROOT.DIR to
WASD_ROOT.DIR||.  The v10 and later packages use [WASD_ROOT] as the top-level
directory in line with other naming schema changes employing "WASD".  Remember
to modify local startup procedures in-line with this new top-level directory
name.  Also note that the v11 package is not suitable for updating from
existing v8.0 or earlier installation.
|!note|

|0Source Archive, Object Module Archives|

|^ If a complete build is planned then only the main archive is required.  If
a link-only build then an additional archive for each architecture must be
UNZIPed.

|0WASD OpenSSL Archive|

|^ WASD SSL is discussed in detail in
|link%|../features/##Transport Layer Security++of++WASD Features and Facilities||.

|note|
The WASD OpenSSL kit is designed as an update to an existing WASD installation
and so expects to be UNZIPed under the root directory.  Note the use of the
"-d" switch in the following example.
|!note|

|code|
$ UNZIP -d [.WASD_ROOT] device:[dir]OPENSSLWASD|/nnn-arch||.ZIP
|!code|

|99DCL Procedure UPDATE.COM|
|2UPDATE.COM Procedure|

|^ The UPDATE.COM procedure assists with subsequent updates of WASD. 
It assumes a |/vanilla| setup, using the standard directories and
account  environment described in this document.  All sections prompt before
performing any action and generally default to "no".  Read the questions
carefully!

|^ Of course it is best (read mandatory) for the server to be shut down during
an update!

|code|
$ HTTPD/DO=EXIT/ALL
|!code|

|^ After UNZIPing the updated package do the following:

|code|
$ SET DEFAULT WASD_ROOT:[000000]
$ @UPDATE
|!code|

|^ It provides the following functions:

|number|

|item| |*Build Executables |-| |
Either compile sources and link, or just link package object code to produce
images for the local version of VMS.  If the system has a suitable SSL toolkit
the installer is requested whether an SSL enabled version be built.

|item| |*Server Quick-Check |-| |
Executes a procedure that runs up the HTTPd in demonstration mode.  Allows
evaluation/checking of the basic package (|link|Quick-Check||).

|item| |*Server Support/Configuration Files |-| |
Copies changed example HTTP server configuration and support files from the
[EXAMPLE] directory to the [HTTP$SERVER], [LOCAL] and [STARTUP] directories. 

|item| |*Update Scripts |-| |
Selectively copy groups of scripts from package build directories into the
scripting directories.

|item| |*Reapply Package Security |-| |
This section traverses the updated tree and sets all package directories and
files to required levels of access.  For directory settings see
|link%|../config/##Recommended Package Security++in++WASD Configuration||.

|item| |*Post-Update Cleanup |-| |
Prompts for permission to execute the post-update procedure described below.

|item| |*Purge Files |-| |
Prompts for permission to purge the entire WASD_ROOT:[000000...] tree.

|!number|

|^ If declined during the update procedure the post-update steps 6 and 7 can
be performed at any subsequent time using

|code|
$ SET DEFAULT WASD_ROOT:[000000]
$ @UPDATE CLEANUP
$ PURGE [...]
|!code|

|2Re-Linking|

|^ After a major update to the operating system the package may refuse to
start, reporting the message

|code|
%DCL-W-ACTIMAGE, error activating image WHATEVER
-CLI-E-IMGNAME, image file DKA0:[SYS0.SYSCOMMON.][SYSLIB]WHATEVER_SHR.EXE
-SYSTEM-F-SHRIDMISMAT, ident mismatch with shareable image
|!code|

|^ This implies the executables require re-linking for your particular version
of VMS.  This can be accomplished quite simply, perform the linking section
only of the UPDATE.COM Procedure.