The Mirror Replication Agent mra_admin utility provides the following functions:
Create, copy, delete, and verify Mirror Replication Agent instances
List all valid Mirror Replication Agent instances on the Mirror Replication Agent host machine
Return the path of the Mirror Replication Agent installation directory
To run the mra_admin utility, invoke it as a command at the operating system prompt.
mra_admin [option [create options]] [inst_name]
You can also invoke mra_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 to create
a new Mirror Replication Agent instance, you must also use the -p option
to specify a port number for the 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 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. See “Copying a Mirror Replication Agent configuration” for more
information.
-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 mra_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
-l (lowercase L)
The option that lists all verifiable Mirror Replication Agent instances.
-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.
