When you invoke the ra_admin utility with the -vr option, the utility validates the specified resource file and returns information about the validation process.
The ra_admin utility validates resource files by:
Verifying uniqueness of the Replication Agent administration port number and instance name
Verifying access to the primary data server, Replication Server®, and RSSD
Verifying the host name, port number, database name, user login, and password on each server
Verifying the Replication Server database connection for the primary database
Verifying that the pds_username user has all the required permissions at the primary database
If any validation fails, the ra_admin utility 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.
Sybase recommends that you validate a new resource file before you create
a Replication Agent instance using the new resource file.
Invoke the ra_admin utility, specifying the -vr option and the name of the resource file:
ra_admin -vr res_file
Here, res_file is the name of the resource file you want to validate.
For example, if the resource file is named pubs2.rs, enter the following 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, you can skip step 2, and use the resource file to create a Replication Agent instance. For more information, see “Creating an instance with a resource file”.
If the validation encounters errors, continue to step 2.
Use the following procedure to correct validation errors:
Review the error messages to determine the cause of the failure.
Edit the resource file to correct the appropriate values.
Invoke ra_admin -vr again, specifying the name of the resource file.
Repeat this step until the resource file is successfully validated.
To validate a resource file