Use the following procedure to create a Mirror Replication Agent instance using the command line.
You must set the SYBASE environment before you invoke
the Mirror Replication Agent ma_admin utility. See “Preparing to use the utilities”.
Creating a Mirror Replication Agent instance using the command
line
Open an operating system command window on the Mirror Replication Agent host machine.
At the operating system prompt, navigate to the Mirror Replication Agent bin directory:
On Microsoft Windows platforms:
cd %SYBASE%\MA-15_2\bin
where %SYBASE% is the path to the Mirror Replication Agent installation directory.
On UNIX platforms:
cd $SYBASE/MA-15_2/bin
where $SYBASE is the path to the Mirror Replication Agent installation directory.
In the Mirror Replication Agent bin directory, invoke the ma_admin utility to create a new Mirror Replication Agent instance:
ma_admin -c new_inst -p port_num -t database
where:
new_inst is the name of the Mirror Replication Agent instance.
port_num is the client socket port number for the administration port of the new instance.
database identifies the type of data server that the primary database resides in:
ase – Adaptive Server Enterprise
oracle – Oracle database server
After you invoke ma_admin, the operating system prompt returns when the new Mirror Replication Agent instance is created.
Verify that the Mirror Replication Agent instance was created properly using one of the following methods:
Invoke ma_admin with the -v option, and specify the name of the new Mirror Replication Agent instance:
ma_admin -v new_inst
where new_inst is the name of the new Mirror Replication Agent instance.
When you verify a Mirror 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 Mirror Replication Agent base directory, and checking all of the subdirectories under the Mirror Replication Agent instance directory.
Invoke ma_admin with the -l option:
ma_admin -l
The -l option lists all verifiable Mirror Replication Agent instances, which should include the new one you just created.
As an alternative to using the ma_admin utility, you can use operating system commands to verify that the Mirror Replication Agent instance directories were created correctly.
After you create a Mirror Replication Agent instance, you can use the ma utility to start the instance so that you can administer and configure it. See “Starting Mirror Replication Agent”.
Sybase recommends that you create a user login name
and password to replace the default “sa” login
and secure access to the administration port, immediately after
you create a Mirror Replication Agent instance. See “Creating the Mirror Replication Agent administrator login”.
