Upgrade the Synchronizer (on-premises)

If you are upgrading Synchronizer on-premises, perform the following steps. Note that the process is different, depending on your pre-upgrade Synchronizer version.

Upgrade from CP 10 or later

Back up and uninstall the old Synchronizer

  1. Back up your old Synchronizer configuration folder: /opt/sync/conf/.

  2. Uninstall the old Synchronizer service from /opt:

    • Run /opt/sync/install/uninstall.sh

    • Run rm –rf /opt/sync

  3. Delete the old Synchronizer files in /opt/sync/.

Configure and install the new Synchronizer

  1. Download the new Synchronizer as described in Install the Synchronizer.

  2. Copy the contents of your old Synchronizer conf folder from its backup location to /opt/sync/conf/, overwriting the files located there.

  3. In sync.yml, locate the database > action parameter. Change its value to UPGRADE.

  4. Within /opt/sync/install, execute the install.sh script as described in Install the Synchronizer.

Upgrade from CP 9 or earlier

Back up and uninstall the old Synchronizer

  1. Back up your old Synchronizer configuration folder: /opt/sync/conf/.

  2. Back up your old Integration Bridge configuration .yml file: /opt/ibs/conf/ibs.yml.

  3. Uninstall the old Synchronizer service from /opt:

    • Run /opt/sync/install/uninstall.sh

    • Run rm –rf /opt/sync

  4. Delete the old Synchronizer files in /opt/sync/.

Configure and install the new Synchronizer

  1. Download the new Synchronizer as described in Install the Synchronizer.

  2. In the new Synchronizer, the format of the /opt/sync/conf/hazelcast.xml file has changed.

    • If you did not customize the hazelcast.xml file in your old Synchronizer, open the backup you created of your old conf folder, and delete the hazelcast.xml file from the backup.

    • If you customized the hazelcast.xml file in your old Synchronizer, contact Support before proceeding.

  3. Copy the contents of your old Synchronizer conf folder from its backup location to /opt/sync/conf/, overwriting the files located there. (Do not overwrite the new hazelcast.xml file.)

  4. Within the sync.yml file, add a section after the database section, headed opbDatabase.

  5. Open your backed-up ibs.yml file, and copy the contents of the database section to the new opbDatabase section in sync.yml.

  6. In sync.yml, locate the database > action parameter. Change its value to UPGRADE.

  7. Within /opt/sync/install, execute the install.sh script as described in Install the Synchronizer.

  8. In ALM Octane Settings > Site Parameters, create a new parameter called SYNCX_BASE_URL. In the parameter value, enter the public base URL of the Synchronizer (for example: http://sync-server.company.net:8080).

After the above steps are complete, you need to upgrade your links and uninstall the old bridge. Proceed now to Upgrade Synchronizer links and uninstall the Integration Bridge.