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 |
15.1 |
1510 |
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.1:
sysadmin site_version, 1510
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.
You can use new software features up to the version set in Replication Server’s site version.
For a newly installed Replication Server of release 15.1, the site version number is 1510.
For more information about features that were introduced in a particular Replication Server software release, see Replication Server New Features Guide 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, different Replication Servers have different site versions. In such a system, some features are only available to Replication Servers with higher site versions. For example, the site version of a primary Replication Server and one of its replicate Replication Server is 1510, while the site version its other replicate Replication Server is 1260. When a table replication definition has a timestamp column, the replicate Replication Server with the lower site version can only subscribe to the timestamp as varbinary (8), while the replicate Replication Server with 1510 site version can subscribe to the timestamp column directly.
After you have upgraded one or both Replication Servers on either end of a route to a higher release level, 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
