Validating a resource file

When you invoke the mra_admin utility with the -vr option, the utility validates the specified resource file and returns information about the validation process.

The mra_admin utility validates resource files by:

Verifying uniqueness of the Mirror Replication Agent administration port number and instance name
Verifying access to the primary data server, Replication Server^®, and RSSD, including:
- Verifying the host name, port number, database name, user login, and password on each server
- Verifying jConnect™ for JDBC™ stored procedures in the primary data server
- Verifying the Replication Server database connection for the primary database
Verifying access to mirror log devices, if specified in the resource file

If any validation fails, the mra_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 use it to create a Mirror Replication Agent instance.

To validate a resource file

Invoke the mra_admin utility, specifying the -vr option and the name of the resource file:
```
mra_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 the following at the command prompt:
```
mra_admin -vr pubs2.rs
```
Results are returned as either:
- Admin processing completed
  
  or
- Admin processing completed with errors
If the validation is successful, you can skip step 2 and use the resource file to create a Mirror Replication Agent instance. See “Creating an instance with a resource file” for more information.

If the validation encounters errors, continue to step 2.
Use the following 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 mra_admin -vr again, specifying the name of the resource file.
Repeat this step until the resource file is successfully validated.