How do I upgrade my copy of Zeus?

The Zeus Web Server upgrade procedure is automated and designedto allow you both to preserve your current configuration and roll back to iteasily should there be any problems. The procedure to upgrade to the currentversion of the Zeus Web Server is below:

• Download the latest Zeus Web Server from your customer pages at http://customer.zeus.com/ (if you do not have an account number or password, please contact sales@zeus.com).
• Unpack the archive in /tmp or some other appropriate location and run the zinstall script (as root).
• When prompted for an installation directory, enter the directory in which your current installation exists (/usr/local/zeus by default). The zinstall script will ask you whether you wish to upgrade this installation - answer 'Y'.
• The script will then shutdown Zeus, upgrade the installation automatically, then restart Zeus with your configuration preserved when it has finished.

The upgrade script performs the following actions:

• shuts down your existing Zeus Web Server installation
• creates the following new directories (version numbers may be different) inside ZEUSHOME (the Zeus installation directory)
• • webadmin-4.1
  • web-4.1
  • admin-4.1
  • snmp-4.1
• populates these with the new files from the downloaded package
• migrates existing configuration files (global.cfg and virtual server configuration files in ZEUSHOME/webadmin/conf/)
• migrates symbolic links to point to the new version
• restarts the web server installation.

The Zeus Web Server installation will now be running the new version withyour existing configuration intact. Should you need to roll back to yourprevious installation, you can do so by running stop-zeus and changingthe symbolic links to point back to the previous installation, then run thestart-zeus script.

Additional notes:

• When upgrading, the zinstall script only migrates filesit knows about. If you have stored any additional files inside theweb/, admin/, or webadmin/ directories(for example log files aside from the standard one inweb/log/, cgi-bins, etc), you will need to migratethese yourself after zinstall has completed.
• It is recommended that you do not create files inside web/, webadmin/ or admin/ directories, but instead putZeus-specific files inside a directory directly under ZEUSHOME.

Content Manager [Administrator] 19 September 2005