Next Topic

Previous Topic

Book Contents

Upgrading Traverse from 5.5 or later to R93 on UNIX

  1. In a distributed configuration, stop Traverse components on the DGE hosts, and then on the server where the BVE/Provisioning Database is operating (Step 2). In this environment, always make sure you upgrade the system running the BVE/Provisioning Database first.
  2. Log in to the Traverse (BVE) server as root or use the su or sudo commands to obtain root permissions.
  3. Shut down all Traverse components:
cd /usr/local/traverse/
etc/traverse.init stop
  1. Back up the existing Traverse installation directory:
cd /usr/local/traverse/
utils/databaseUtil.pl --action=export --file=/usr/local/traverse/database/provdb.xml
cd ../..
cp -r traverse OLD-traverse-5.x
This directory preserves the 5.x installation in case you abort the upgrade process.
  1. Download and save the installation package (tar-gzipped package) to a temporary location on the server.
  2. Extract the installation package and start installation by executing the following commands:

    Note: (Solaris only) Use the GNU version of tar instead of the native tar utility in the following command.

cd /tmp
gunzip -c traverse-x.y.z-OS.tar.gz | tar xf -
cd traverse-5.6
sh install.sh

If you use Traverse on a single server (BVE and DGE on the same host, single DGE), specify the previous Traverse installation directory during the installation process. The installer automatically converts configuration and historical data to version (format) R93.

  1. When the installation/upgrade completes, review the configuration files from the previous version of Traverse in the <TRAVERSE_HOME>/OLD-traverse-5.5 directory. If you made any modifications to the configuration files, such as adding a new JDBC driver or configuring plug-in authentication, you must manually re-apply the changes.
  2. If you have Traverse installed on a single server only, skip to Step 11.
    If you have Traverse installed on more than one server (multiple DGEs, and/or BVE and DGE on separate servers), continue to Step 9.
  3. After the installer finishes the upgrade, start the Provisioning Database on the server running the BVE/Provisioning Database component:
cd /usr/local/traverse
etc/provdb.init start
  1. Install Traverse on all other servers (DGEs). You can upgrade multiple DGEs at the same time. During the upgrade process, the installer analyzes the aggregation scheme which is why you must start the Provisioning Database (Step 9).

    The analysis/migration process can take a large amount of time. The duration of the conversion process depends on the hardware specifications of the DGE system. For example, converting data for 15000 tests with historical data for six months:

1 x 3.4GHz Pentium 4; 1GBRAM; SATA drives = 3 hours
  1. After you upgrade the DGEs, start Traverse. Start the server on which you installed the BVE/Provisioning Database, and then start the DGE servers.
cd /usr/local/traverse
etc/traverse.init start