Creating a Replication Agent Instance Using a Resource File

Create a Replication Agent instance using the oraclexs resource file template for Oracle XStream.

Invoke ra_admin using the command line parameters that create and validate a Replication Agent instance using a resource file:
ra_admin {-vr res_file | -r res_file}
where:

  • -vr res_file

    validates the specified resource file (res_file), without creating a Replication Agent instance or making any change in the environment.

  • -r res_file

    creates a Replication Agent instance, based on the contents of the specified resource file (res_file).

A resource file is an ASCII text file that contains configuration information for the Replication Agent instance to be created by ra_admin.

In addition to creating a Replication Agent instance, the ra_admin parameters in the resource file allows you to:

  • Create the user login in the primary data server, and grant all required permissions.

  • Start the new instance after it is created.

  • Initialize the new instance after it starts.

To create a Replication Agent instance with XStream APIs, set the instance_type configuration parameter in the resource file as instance_type=oraclexs.

Note: When you create a Replication Agent instance with a resource file, the pds_username and pds_password configuration parameter values cannot contain single or double quotes if the create_pds_username parameter is set to yes.
Parent topic: Configuring the Replication Agent for Oracle to Use XStream APIs