Sets the site version number for the Replication Server. This lets you use the software features in the corresponding release, and prevents you from downgrading to an earlier release. If the Replication Server uses ERSSD, this command also shuts down the ERSSD, upgrades its database file and restarts ERSSD.
If your Replication Server uses ERSSD, this command
may cause some threads to shutdown since ERSSD is being restarted.
Replication should continue after you restart all threads that are
shutdown.
sysadmin site_version [, version]
The site version number for Replication Server.
Version number |
Site version |
|---|---|
Pre-11.5 |
N/A |
11.5 |
1150 |
12.0 |
1200 |
12.5 |
1250 |
12.6 |
1260 |
15.0, 15.0.1 |
1500 |
No site version numbers exist for releases earlier than 11.5. Maintenance releases may support higher site version numbers.
Displays the current site version number for the Replication Server:
sysadmin site_version
Changes the site version number to correspond to release 15.0:
sysadmin site_version, 1500
To set the site version number for the current Replication Server, execute sysadmin site_version with a version parameter.
The site version number you enter must be no higher than the software version number or the release level of Replication Server.
To display the site version number for Replication Server, execute sysadmin site_version without a version parameter.
Starting with Replication Server version 11.5, you can use new software features up to the version set in Replication Server’s site version.
A minimum system version number of 1102 is required. See sysadmin system_version for more information.
The initial site version number for a Replication Server depends on whether you have installed a new Replication Server or upgraded from an earlier release:
For a newly installed Replication Server of release 15.0, the site version number is 1500.
If you have upgraded to release 11.5 or higher from release 10.1.x or 11.0.x, the site version number matches the system version number. You can use sysadmin site_version to set the site version number to 1150 or higher only if the system version number is set to 1102.
For more information about features that were introduced in a particular Replication Server software release, see What’s New in Replication Server for that release.
WARNING! When you set the site version number, you cannot downgrade to an earlier release.
For more information about installing or upgrading Replication Servers, refer to the Replication Server installation and configuration guides for your platform.
In a mixed-version replication system, an 1102 system version number and site version numbers for individual Replication Servers allow release 11.0.2 or 11.0.3 Replication Servers to work with release 11.5 or higher Replication Servers.
In such a system, new features may not be available to earlier versions of Replication Server. For example, a Replication Server of release 11.5 can create multiple replication definitions for a table. An 11.0.2 or 11.0.3 Replication Server can subscribe to only one such replication definition. See the Replication Server Administration Guide Volume 1 for more information.
After you have upgraded one or both Replication Servers on either end of a route to release 11.5 or later, and you have set the site versions to a higher level, you need to upgrade the route. Upgrading a route rematerializes the data in system tables and makes information associated with new features available to a newly upgraded Replication Server.
There are two possible scenarios for route upgrade:
If you have Replication Manger, use the Replication Manger to upgrade routes. For instruction on upgrading routes, please see the Replication Manger online help
If new features have not been used at the source Replication Server, use sysadmin fast_route_upgrade to upgrade routes.
For example, if you upgrade a Replication Server of release 12.6 to release 15.0 and set its site version accordingly, you will need to upgrade a route from another Replication Server of release 15.0. When you upgrade the route, the newly upgraded Replication Server receives information from the 15.0 Replication Server such as additional replication definitions for the table.
See the Replication Server Configuration Guide for more information about upgrading routes.
Version information is stored in the rs_version system table. The rs_routes system table also contains version information. Route version information is stored in the rs_routeversions system table.
sysadmin site_version requires “sa” permission.
admin version, sysadmin fast_route_upgrade, sysadmin system_version
