The Mirror Replication Agent ma_admin utility provides the following functions:
Creates, copies, deletes, and verifies Mirror Replication Agent instances
Lists all valid Mirror Replication Agent instances on the Mirror Replication Agent host machine
Returns the path of the Mirror Replication Agent installation directory
Creates Mirror Replication instances from parameters in a response file
To run the ma_admin utility, invoke it as a command at the operating system prompt
ma_admin [option [create options]] [inst_name]
You can also invoke ma_admin with
no option specified to return command usage information.
-b
The option that returns the complete path of the Mirror Replication Agent installation directory.
-c inst_name
The option that creates a new Mirror 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, the following options are required:
-p, or
-p and -f
When you use the -f option, the primary database type specified for the existing Mirror Replication Agent instance is copied to the configuration of the new Mirror Replication Agent instance.
-p port_num
The option that specifies a client socket port number for the administration port of the Mirror Replication Agent instance. The port_num must be a valid port number, and unique on the Mirror Replication Agent host machine.
When the -c option is used, you also have the option of specifying that the configuration of the new Mirror Replication Agent instance should be based on the configuration file for an existing Mirror Replication Agent instance. To do this, use the -f option.
-f old_inst
The option that copies the configuration of an existing Mirror Replication Agent instance for a new Mirror Replication Agent instance. The old_inst string is the name of the existing Mirror Replication Agent instance whose configuration you want to copy for the new Mirror Replication Agent instance.
When you use the -f option, some
configuration parameters are set to default values. For more information,
see “Copying a Mirror Replication Agent configuration”.
-d inst_name
The option that deletes a specified Mirror Replication Agent instance. The inst_name string must be the name of an existing Mirror Replication Agent instance.
When you invoke ma_admin with the -d option, the utility deletes all of the subdirectories associated with the specified instance from the Mirror Replication Agent installation directory.
On Microsoft Windows platforms, if any application is
accessing a file or directory associated with a Mirror 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 Mirror 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
-h
The option that returns command usage information.
-l (lowercase L)
The option that lists all verifiable Mirror Replication Agent instances.
-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:
ase – Adaptive Server Enterprise server
oracle – Oracle database server
The database value is not case
sensitive.
-v inst_name
The option that verifies the complete directory structure for a specified Mirror Replication Agent instance.
The inst_name string must be the name of an existing Mirror Replication Agent instance.
