Copying an Existing Replication Agent Instance Configuration to a New Instance

Create a new Replication Agent instance based on the configuration of an existing instance.

On the Replication Agent host machine, open an operating system command window.
Navigate to the Replication Agent bin directory:
- On Windows platforms:
  cd %SYBASE%\RAX-15_5\bin
  where %SYBASE% is the path to the Replication Agent installation directory.
- On UNIX platforms:
  cd $SYBASE/RAX-15_5/bin
  where $SYBASE is the path to the Replication Agent installation directory.
In the Replication Agent bin directory, invoke rao_admin to create a new Replication Agent instance whose configuration is based on the configuration of an existing instance:
```
rao_admin -c new_inst -p port_num -f old_inst [-uid ra_username -pwd ra_password]
```
where:
- new_inst is the name of the new Replication Agent instance.
- port_num is the client socket port number for the administration port of the new instance.
- old_inst is an existing Replication Agent instance whose configuration you want to copy for the new instance.
- ra_username is the administrator login name you want to use for this Replication Agent instance. If you do not provide this option on the command line, you will be prompted for a value.
- ra_password is the password for the administrator login. If you do not provide this option on the command line, you will be prompted for a value.
After you invoke rao_admin, the operating system prompt returns when the new Replication Agent instance is created.
Verify that the Replication Agent instance was created properly using one of these methods:
- Invoke rao_admin with the -v option, and specify the name of the Replication Agent instance:
  rao_admin -v new_inst
  where new_inst is the name of the Replication Agent instance.
  When you verify a Replication Agent instance with the -v option, the utility verifies the instance by checking for an instance directory with the specified instance name under the Replication Agent base directory, and checking all of the subdirectories under the Replication Agent instance directory.
- Invoke rao_admin with the -l option:
  rao_admin -l
  The -l option lists all verifiable Replication Agent instances, which should include the new one you just created.
- As an alternative to using rao_admin, you can use operating system commands to verify that the Replication Agent instance directories were created correctly.

Note: When you create a new Replication Agent instance and copy the configuration of an existing instance, some configuration parameters are set to default values, and they are not copied from the existing configuration.

The values of these configuration parameters are not copied from an existing configuration:

admin_port
log_directory
pds_database_name
pds_host_name
pds_password
pds_port_number
pds_retry_count
pds_retry_timeout
pds_username
rs_source_db
rs_source_ds
rasd_backup_dir
rasd_database
rasd_trace_log_dir
rasd_tran_log
asa_port

See the Replication Agent Reference Manual for more information about Replication Agent configuration parameters.

After you create a Replication Agent instance, you can use rao to start the instance so that you administer and configure it.

Note:

A new user login name and password are required when creating a Replication Agent instance. You have the option to change the password.