Preparing to Upgrade

Prepare the Replication Server for upgrade.

1. Back up the RSSD or ERSSD. The upgrade process makes changes to the RSSD or ERSSD that you cannot roll back if the upgrade fails. Restore the RSSD or ERSSD from the backup if the upgrade fails.
2. Determine where you want to install Replication Server.
   If you plan to install the Replication Server software in a directory that:

   • Does not contain your existing Replication Server installation – verify that the sql.ini file is accessible and see Upgrading Replication Server
   • Contains your existing Replication Server installation – see Upgrades and Downgrades Using Existing Directories
3. Read the release bulletin for your platform for any special installation instructions about mixed-version environments, installing, or upgrading.
4. Use rs_helpsub and rs_helpdbsub to check that all subscriptions are valid. The upgrade fails if there are subscriptions that are not in a valid state before upgrading.
5. Install Replication Server, following the instructions in the Replication Server Installation Guide for your platform.
6. Verify the system-wide and route versions and upgrade to version 12.6 if necessary:
   1. Execute sysadmin system_version on the current Replication Server. If the system version is 1260 or later, you can upgrade your Replication Server now. If the system version is earlier than 12.6, proceed to step 6b.

      sysadmin system_version 
      go

      An example of the output is:

      The current system version is 1102.

   2. Set the system version on the ID Server to 1260:

      sysadmin system_version,1260 
      go

      If setting the system version is unsuccessful, this message appears and you must proceed to step 6c:

      The system version could not be set. The specified version ‘1260’ is higher than the lowest Replication Server version in the system ‘1250’

      If setting the system version is successful, this message appears and you can proceed to step 6d:

      The system version has been reset from 1102 to 1260

   3. Upgrade Replication Server to 12.6 and set the site version to 12.6 for any Replication Server in the domain that has a version earlier than 12.6. Repeat step 6b.
   4. Execute sysadmin system_version again on the current Replication Server. If the system version is 12.6 or later, proceed to step 6e.
   5. Execute admin show_route_versions to verify all route versions are 1260 or later. If the route version is lower than 12.6, see Replication Server Administration Guide Volume 1 > Manage Routes > Upgrade Routes for information in upgrading the route version. After you upgrade the routes, you can upgrade the current Replication Server.