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 ra_admin to create a new Replication Agent instance whose configuration is based on the configuration of an existing instance:
```
ra_admin -c new_inst -p port_num -f old_inst
```
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.
After you invoke ra_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 ra_admin with the -v option, and specify the name of the Replication Agent instance:
  ra_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 ra_admin with the -l option:
  ra_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 ra_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_datasource_name
pds_host_name
pds_password
pds_port_number
pds_retry_count
pds_retry_timeout
pds_server_name
pds_username
rs_source_db
rs_source_ds
function_password
rs_password
rssd_password
ssl_identity_password
ra_admin_owner_password
ddl_password
rasd_backup_dir
rasd_database
rasd_trace_log_dir
rasd_tran_log
asa_port
asm_password
rman_password

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

After you create a Replication Agent instance, you can use ra 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.