======================================================================

README for Zeus Extensible Traffic Manager (ZXTM)

======================================================================

This file contains important information about Zeus Extensible Traffic
Manager that you should read before attempting installation:

 * Installing Zeus Extensible Traffic Manager

 * Using the Zeus Administration Graphical User Interface

 * Upgrading Zeus Extensible Traffic Manager

 * Customer/Evaluator Support


----------------------------------------------------------------------
Installing Zeus Extensible Traffic Manager
----------------------------------------------------------------------

Installation of Zeus Extensible Traffic Manager takes two steps.

Step 1: Run the 'zinstall' script as the superuser (root) from a shell
command prompt.  This extracts the software from the distribution archive
and places it in the installation directory.  It then displays the
location of the 'configure' script required for step 2 and offers the
option to continue straight to step 2.

Step 2: Perform initial configuration by running the configure script in
the installation directory.  This script can be re-run as required to
reconfigure the initial settings, or reset ZXTM to its unconfigured
factory default settings.

Further documentation
---------------------

The document 'Getting Started with ZXTM' describes installation and
configuration strategies for evaluation and production deployments.

You should review this document before proceeding with the first
installation of ZXTM.


----------------------------------------------------------------------
Using the Zeus Administration Graphical User Interface
----------------------------------------------------------------------

The ZXTM Admin Server is a web-based administration interface to your ZXTM
cluster.  The URL used to access this interface will be provided at the
end of step 2 of the installation procedure.

----------------------------------------------------------------------
Upgrading Zeus Extensible Traffic Manager
----------------------------------------------------------------------

Upgrading ZXTM is designed to be a simple process. You do not need to stop
ZXTM before upgrading.

It is advisable to back up your configuration before upgrading; this can
be done via the Admin Server's System > Backups page.

The upgrade can be performed through the Admin Server or from the command
line.

Admin Server

  * Navigate to the System > Traffic Managers page

  * Click on the button marked "Upgrade..."

  * Select the ZXTM tarball as the file to upload then click "Upload"

  * Review the information displayed then confirm by clicking
    "Install this upgrade"

  * The upgrade will now take place and you will be redirected to the
    Admin Server when it has completed.

Command Line

  * After unpacking the ZXTM tarball, run the 'zinstall' script.

  * Use the same installation directory as the existing ZXTM (ZEUSHOME).

  * Choose to Upgrade when prompted.

  * The upgrade process is automatic from here and your existing
    configuration is retained. Note that the traffic manager will be
    stopped for a few seconds while the upgrade takes place.

Upgrading a Cluster
-------------------

To upgrade a clustered install, follow the instructions above for each
traffic manager in turn. If you are using traffic IP groups, the traffic
IP address of the machine being upgraded will be taken on by another
machine for a few seconds. When the upgrade is complete, the IP will
switch back to the upgraded machine.

Note that different major versions of ZXTM do not automatically share
configuration.  Therefore, if you are upgrading to a new major version
(for example, from 4.2r2 to 5.0), you should not attempt to make
configuration changes while the cluster contains version 4.2r2 and 5.0
software.  If you do so, your changes may be lost when the upgrade
completes.

Downgrading ZXTM
----------------

If you wish to revert to an earlier version of ZXTM, follow these
instructions:

  * Change directory into ZEUSHOME

  * Run:

     zxtm/bin/rollback

  * Follow the onscreen instructions

Note that ZXTM is stopped while you make these changes.  Note also that
ZXTM will revert to using your earlier configuration.

----------------------------------------------------------------------
Customer/Evaluator Support
----------------------------------------------------------------------

If you require any technical guidance in using ZXTM, evaluators and
customers with a valid support contract should contact their support
provider.

Please review the 'Diagnose' information and the generate a 'Technical
Support report' using the ZXTM Admin Server before contacting the
Technical Support, and remembering to quote your evaluator or customer
number in the subject header of any emails.