The Replication Agent ra_admin utility:
Creates, copies, deletes, and verifies Replication Agent instances.
Lists all valid Replication Agent instances on the Replication Agent host machine.
Returns the path of the Replication Agent installation directory.
Creates an output file in the $SYBASE/RAX-15_2/admin_logs directory The format of the file name is adminmmddyyyy_hhmmss.log. Here, mmddyyy and hhmmss are the current date and time.
Upgrades Replication Agent instances.
To run the ra_admin utility, invoke it as a command at the operating system prompt.
ra_admin [option [create options]] [inst_name]
You can also invoke ra_admin with
no option specified to return command usage information.
-b
The option that returns the complete path of the Replication Agent installation directory.
-c inst_name
The option that creates a new Replication Agent instance using the specified name (inst_name).
The inst_name string must be a valid server name, and unique on the host machine.
When you use the -c option, one of the following options are required:
-p and -t, or
-p and -f.
When you use the -f option to copy an existing Replication Agent configuration, you need not specify the -t option. The primary database type specified for the existing Replication Agent instance is copied to the configuration of the new Replication Agent instance when you specify the -f option.
-h
The option that returns command usage information.
-p port_num
The option that specifies a client socket port number for the administration port of the Replication Agent instance.
The port_num must be a valid port number and unique on the Replication Agent host machine. For Oracle and Microsoft SQL Server, Replication Agent also requires that a second port, port_num+1, must be available for the RASD.
-t database
The option that identifies the type of data server that the primary database resides in.
The database string must be one of the following:
ibmudb – IBM DB2 Universal Database
mssql – Microsoft SQL Server
oracle – Oracle database server
The database value is not case-sensitive.
When the -c option is used, you also have the option to specify the configuration of the new Replication Agent instance to be based on the configuration file for an existing Replication Agent instance. To do this, use the -f option.
-f old_inst
The option that copies the configuration of an existing Replication Agent instance for a new Replication Agent instance.
The old_inst string is the name of the existing Replication Agent instance whose configuration you want to copy for the new Replication Agent instance.
When you use the -f option to copy an existing Replication Agent configuration, you need not specify the -t option; the primary database type specified for the existing Replication Agent instance is copied to the configuration of the new Replication Agent instance when you specify the -f option.
When you use the -f option, some
configuration parameters are set to default values. See “Copying a Replication Agent configuration” for more
information.
-d inst_name
The option that deletes a specified Replication Agent instance.
The inst_name string must be the name of an existing Replication Agent instance.
When you invoke ra_admin with the -d option, the utility deletes all of the subdirectories associated with the specified instance from the Replication Agent installation directory.
On Windows platforms, if any application is accessing
a file or directory associated with a Replication Agent instance
when you delete the instance, the open file or directory is not deleted.
An error message informs you of the file or directory not deleted.
To finish deleting a Replication Agent instance after a file or directory access conflict on a Microsoft Windows platform, you must:
Verify that the file or directory is not open in any application
Manually delete the file or directory
-l (lowercase L)
The option that lists all verifiable Replication Agent instances.
-v inst_name
The option that verifies the complete directory structure for a specified Replication Agent instance.The inst_name string must be the name of an existing Replication Agent instance.
-vr res_file
Validates the specified resource file (res_file), without creating a Replication Agent instance or making any change in the environment.
-r res_file
Creates a Replication Agent instance, based on the contents of the specified resource file (res_file).
-u upgrade_option
Upgrades a Replication Agent instance based on the specified upgrade option (upgrade_option):
source_installation_dir – upgrade all instances of Replication Agent in the specified source installation directory from the current product installation directory.
source_instance_dir – upgrade one instance of Replication Agent in the specified source instance directory from the current product installation directory. The instance is first copied to and then updated within the current product installation directory.
all – upgrade all instances of Replication Agent within the current product installation directory. The configuration files are backed up before the upgrade for use in error recovery, if required. If an error occurs, the upgrade is rolled back.
The all option requires relatively less space because upgrades are performed directly on instances within the current product installation directory, not to copies. However, reversing an upgrade is more difficult for the same reason.
instance_name|instance=instance_name – upgrade only the specified instance in the current product installation directory. The upgrade is performed directly on the specified instance, not to a copy. The configuration file is backed up before the upgrade for use in error recovery, if required. If an error occurs, the upgrade is rolled back.
