Validating a Resource File

Use ra_admin to validate your resource file.

When you invoke ra_admin with the -vr option, the utility validates the specified resource file and returns information about the validation process.
ra_admin verifies:
  • Uniqueness of the Replication Agent administration port number and instance name

  • Access to the primary data server, Replication Server, and RSSD

  • The host name, port number, database name, user login, and password on each server

  • The Replication Server database connection for the primary database

  • That the pds_username user has all the required permissions at the primary database

If any validation fails, ra_admin returns an error message and information about the failure.

You can repeat the validation process as many times as necessary. No entities are changed or created as a result of this process.

Note: Sybase recommends that you validate a new resource file before you create a Replication Agent instance using the new resource file.
  1. Invoke ra_admin, specifying the -vr option and the name of the resource file:
    ra_admin -vr res_file

    where res_file is the name of the resource file you want to validate.

    For example, if the resource file is named pubs2.rs, enter this at the command prompt:
    ra_admin -vr pubs2.rs
    Validation results are returned as either:
    • Response-file processing completed.

      or

    • Response-file processing completed with errors.

    If the validation is successful, skip step 2, and use the resource file to create a Replication Agent instance.

    If the validation encounters errors, continue to step 2.

  2. Use this procedure to correct validation errors:
    1. Review the error messages to determine the cause of the failure.
    2. Edit the resource file to correct the appropriate values.
    3. Invoke ra_admin -vr again, specifying the name of the resource file.

    Repeat this step until the resource file is successfully validated.

Related tasks
Creating an Instance with a Resource File