Setting the Replication Server site version

After you upgrade Replication Server version 12.6 and its user databases, and set the system version to 1102 or higher, you must set the Replication Server site version to the new software version level before you can use the new Replication Server features.

Refer to What’s New in Replication Server? and the Replication Server release bulletin for more information about new features.

Downgrade restriction

Once you set the replication system version to a new level, you cannot downgrade any Replication Servers in the replication system below that version level or install a Replication Server below that version level.To return to an earlier software version, you must reinstall all Replication Servers and re-create your replication applications.

If you do not want to use new features that depend on the site version, do not set the Replication Server site version after the upgrade. Then you can downgrade to an earlier version if needed.

Notecreate, alter, and drop replication definitions are not allowed until you set the Replication Server site version to 1200 or higher.

StepsSetting the Replication Server site version to the 12.6 Replication Server version

  1. Log in to the current Replication Server.

  2. Execute this command:

    sysadmin site_version, 1260
    

The Replication Server release bulletin may instruct you to set the site version to a more recent version level.

NoteOnce you have set the Replication Server site version, you cannot downgrade the Replication Server. To return to an earlier software version, you must reinstall the Replication Server and re-create any aspects of your replication applications that pertain to that Replication Server.

Backing up the RSSD

After you upgrade a Replication Server, set its site version to 1260, and perform route upgrades to the relevant routes, use the Adaptive Server commands dump database or dump transaction to back up the RSSD.

If you have a current backup, you can restore the RSSD with the Adaptive Server commands load database or load transaction to avoid potential problems from loading an RSSD that corresponds to an earlier version level. After you load the backup, all queued messages from other Replication Servers can be recognized by this Replication Server and RSSD.

If you restore the RSSD from a backup performed before you set the site version, messages that the RSSD cannot accept might arrive at the Replication Server.

Upgrading for character set conversion

To use the character set conversion features introduced in Replication Server version 11.0.2, set your system version to version 11.0.2 and verify that the primary Replication Server is aware of the system version.

To do this, follow these steps after you upgrade the system version at the ID Server:

When this command is executed, subsequent updates at the primary database can undergo character set conversion.

Using new features in version 12.6

You can use new Relication Server features that interact with other Replication Servers only if all these things are true:

See “Setting the replication system version” and “Upgrading routes” for more information.

For example, Replication Servers with a site version set to version 12.6 can create replication definitions for tables containing unicode datatype. Such replication definitions are distributed to other Replication Servers with site versions that are at the same version level or higher. Replication Servers of earlier versions do not receive information about these replication definitions.