Creating a Replication Agent Instance Using Resource Files

Create a Replication Agent instance with a resource file.

Invoke ra_admin with the command line parameters that support creating and validating 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.

The ra_admin parameters in the resource file allow you to specify these options, in addition to creating a Replication Agent instance:

  • Create the instance 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.

Note: When you validate a resource file with ra_admin -vr, no other action is taken, and no Replication Agent instance is created.
When you create a Replication Agent instance with a resource file:
  • The asa_password configuration parameter value must not contain single quotes, double quotes, or a semicolon.
  • The pds_username and pds_password configuration parameter values must not contain single or double quotes if the create_pds_username parameter is set to yes.
Parent topic: ra_admin