====================================================================== 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 * Differences between ZXTM and other Zeus products * 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. 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. It can be found in the 'getting_started.pdf' file in this distribution. 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. ZXTM can also be configured from the command line. ---------------------------------------------------------------------- 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 > Backup/Restore page. * 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 2.0r1 to 3.0), you should not attempt to make configuration changes while the cluster contains version 2.0r1 and 3.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 * Stop Zeus and change the symlinks 'zxtm' and 'zxtmadmin' back to their earlier values, using the following commands: # stop-zeus # rm zxtm # ln -s zxtm-2.0r1 zxtm # rm zxtmadmin # ln -s zxtmadmin-2.0r1 zxtmadmin # start-zeus Note that ZXTM is stopped while you make these changes. Note also that ZXTM will revert to using your earlier configuration. ---------------------------------------------------------------------- Differences between ZXTM and other Zeus products ---------------------------------------------------------------------- Users familiar with Zeus Web Server or Zeus Load Balancer should be aware of the following differences to ZXTM: * Installation of ZXTM is a two-stage process; initial unpacking of the software, and subsequent initial configuration. * It is not possible to install ZXTM in the same location (ZEUSHOME) as other Zeus products such as ZWS or ZLB. Similarly, ZXTM does not share an Admin Server with other Zeus products. * Each ZXTM machine has a local Admin Server. In a cluster of ZXTM traffic managers, you can use any of the Admin Servers to manage all the machines in the cluster. ---------------------------------------------------------------------- Customer/Evaluator Support ---------------------------------------------------------------------- If you require any technical guidance in using ZXTM, evaluators and customers with a valid support contract can contact Zeus's Technical Support team at support@zeus.com. Please review the 'Diagnose' information and the generate a 'Technical Support report' using the ZXTM Admin Server before contacting Zeus Technical Support, and remembering to quote your evaluator or customer number in the subject header of any emails.