Overview of the upgrade process

Use this document if your cluster runs Symphony version 3.1 or 3.2. There is no direct upgrade of Symphony version 3.x hosts to Symphony version 4.x. Direct upgrade is supported from Symphony version 4.0 and greater. If your cluster runs Symphony version 4.0, ignore this document.

CAUTION:

Do not try to upgrade your cluster with the RPM option -U. This option is destructive because it removes other clusters on the host.

To move from Symphony 3.1 or 3.2 to Symphony 4.1, we strongly recommend that the 4.1 cluster have different management hosts from the original cluster. For compute hosts, we support a parallel installation. There are manual steps to migrate configuration files.

For Linux, when you configure automatic system startup (egosetrc.sh) for Symphony 4.1, it disables the feature for the original version.

If the original cluster was Symphony 3.1, the older EGO command prompt is disabled when you install Symphony 4.1.

Benefits:

To prevent conflicts, the new Symphony 4.1 cluster has the following differences from the original cluster:

  • It can almost eliminate production downtime required for upgrade

  • It is easy to roll back to the previous version

  • Different installation directory

  • Different ports

  • Different syntax to grant root privileges to egoadmin (on Linux)

  • Different cluster ID (on Windows)

Note:

(for parallel clusters) To maintain consistent performance while running two versions of the software at the same time, management hosts will need enough extra memory to run an additional management console and an additional loader controller.

Note:

(for parallel clusters) For Linux, to maintain automatic startup functionality for the original version of Symphony, link the original rc to a different alias before you install Symphony 4.1.

Note:

(for parallel clusters) For Windows, to use the Platform Management Console with the original cluster, input the URL in a browser manually.

Note:

(for parallel clusters) For Windows, to use the Symphony 4.1 CLI, launch it from the Symphony program group shortcut. To use Symphony 3.1 and 3.2, follow the procedure in this document.