ra_migrate

Performs any necessary migration for upgrade and downgrade tasks between releases of Replication Agent.

This command is used to complete the upgrade process or to complete the downgrade process started by the ra_downgrade command, which is executed by the instance from which Replication Agent is being downgraded (the later version).

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_migrate

Parameters

None – There are no parameters.

Usage

After upgrading to a new release of Replication Agent, you must first run ra_migrate to update to the latest version of Replication Agent.
The ra_migrate command is valid when the Replication Agent instance is in the Admin or Replication Down state.
(Oracle only) The ra_migrate command will verify that the following privileges have been granted to pds_username:
- EXECUTE_CATALOG_ROLE
- select on V_$LOGMNR_CONTENTS
- select on V_$LOGMNR_LOGS
These privileges are necessary for the ra_dumptran and ra_helpop commands to function properly. These privileges are not required for replication, only for using the ra_dumptran and ra_helpop commands, which are used in debugging and troubleshooting. If these privileges have not been granted at the time ra_migrate is invoked, a warning message is returned and logged in the Replication Agent log file.
After a downgrade, the ra_migrate command restores the RASD from file.
To use ra_migrate, Replication Agent must be able to connect to the primary database.