The Mirror Replication Agent ma_admin utility:
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 resource file
Upgrades Mirror Replication Agent instances
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.
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”.
-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.
-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.
-u upgrade_option
Upgrades a Mirror Replication Agent instance based on the specified upgrade option (upgrade_option):
source_installation_dir – upgrade all instances of Mirror Replication Agent in the specified source installation directory from the current product installation directory.
source_instance_dir – upgrade one instance of Mirror 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 Mirror 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.
