ra_downgrade_prepare

(Oracle and Microsoft SQL Server only) The ra_downgrade_prepare command prepares Replication Agent to downgrade to an earlier version.

When executed in Replication Agent for Microsoft SQL Server or Replication Agent for Oracle, the ra_downgrade_prepare command copies the RASD contents to an export file. This file is then applied by the instance to which Replication Agent is being downgraded (the earlier version) to complete the downgrade.

Note: The ra_downgrade_prepare and ra_downgrade_accept commands have been deprecated. Use the ra_downgrade and ra_migrate commands where possible. See the Replication Agent Primary Database Guide.

Syntax

ra_downgrade_prepare { list | target_inst_path }

Parameters

Usage

  • To prepare for downgrading to an earlier version of Replication Agent, the ra_downgrade_prepare command first changes Replication Agent system objects in the primary database to match those of the instance to which Replication Agent is being downgraded.

  • (Microsoft SQL Server and Oracle only) The ra_downgrade_prepare command also extracts the contents of the Replication Agent System Database (RASD) to a file named timestamp.export, where timestamp is a timestamp taken at the moment ra_downgrade_prepare was invoked. By default, this file is located in the import subdirectory under the directory specified by the rasd_backup_dir configuration parameter of the Replication Agent instance to which you are downgrading (the earlier version). The path to this file is returned if ra_downgrade_prepare executes successfully.

  • The ra_downgrade_prepare command is valid when the Replication Agent instance is in the Admin or Replication Down state.

Related reference
ra_downgrade
ra_downgrade_accept
ra_migrate