This section describes how to upgrade to Replication Server 15.1 by upgrading your Replication Servers.
WARNING! Before upgrading to Replication Server 15.1 if your Replication Server is using an Adaptive Server RSSD with a version earlier than 12.5, you must upgrade this Adaptive Server to at least version 12.5. Otherwise, the upgrade process will fail.
Upgrading to Replication Server 15.1 from an earlier
version
Back up your current installation.
If you plan to install the Replication Server software in a directory other than an existing Sybase version directory, make sure that the interfaces file is accessible. See the Replication Server Installation Guide for instructions.
Install the new Replication Server software. See Replication Server Installation Guide for instructions.
Upgrade the RSSD for each Replication Server. See “Upgrading an RSSD”.
Upgrade each user database that is managed by an upgraded Replication Server. See “Upgrading a user database in a replication system”.
WARNING! Do not stop the RepAgent, truncate the transaction log, increase the generation number, and so on, while upgrading an earlier version of Replication Server to version 15.1 to avoid malfunctioning of your replication system.
Complete these steps in the order shown in this section to upgrade an RSSD based on the information from the “Replication Server installation worksheet” for the Replication Server you are upgrading. Upgrading an RSSD may add new Replication Server system tables, add new rows or columns to existing tables, or install new stored procedures.
Set the SYBASE environment variable to the directory where Replication Server 15.1 is installed.
Log in as the “sybase” user and change to the $SYBASE directory.
Verify that RSSD servers, Replication Servers, and RepAgents that you are upgrading are running.
If the Replication Server uses Adaptive Server Enterprise for the RSSD, grant sa_role to the primary user at RSSD as follows:
sp_role 'grant', sa_role, primary_user
The RSSD_primary_user in
the .cfg file must have a replication role or sa role, not the sa user
ID or the user that has been entered in the rs_init panel.
Start rs_init:
$SYBASE/$SYBASE_REP/install/rs_init
You see the RS_INIT menu.
Select Configure a Server Product. Choose Continue.
Select Replication Server.
Select Upgrade an Existing Replication Server.
Complete the Upgrade Existing Replication Server screen with the information from the “Replication Server installation worksheet” for the Replication Server you are upgrading.
Enter the name of the Replication Server with the RSSD you are upgrading.
Enter the login name for the RS SA user. The default value is “sa.”
Enter the password for the “sa” user on the Replication Server.
Enter the path name of the Replication Server Configuration file.
Press Ctrl+A to save your changes. rs_init displays the following message:
Execute the Replication Server tasks now?
Enter “y” to continue the RSSD upgrade.
rs_init displays informational messages as it loads the upgrade script into the RSSD. When the upgrade is complete, rs_init displays these messages:
RSSD successfully upgraded from old_rel_no to new_rel_no. Replication Server 'rs_name' can now be restarted. Task to upgrade the RSSD succeeded. Configuration completed successfully.
where:
old_rel_no – is the Replication Server version from which you are upgrading.
new_rel_no – is Replication Server version 15.0.
rs_name – is the name of the Replication Server.
If you installed the new Replication Server software in a different directory from the earlier version, modify the runserver files for the Replication Servers so that they use the programs in the new version directory.
Restart the Replication Server using the appropriate executables for the new version.
WARNING! Some Replication Server configuration options with newer versions may have a wider valid range. If you increase any of these configuration options after upgrading, you must put back their old values before downgrading. Otherwise, the Replication Server may not start or may behave incorrectly. Replication Server 15.1 upgrade process prints all the current configuration option values in rs_config to rs_init log, so that you can restore their former settings before downgrading.
For instructions on downgrading an RSSD to an earlier version, see “Downgrading Replication Server to an earlier version”.
