Create a Replication Agent instance from the Windows or UNIX command line.
Prerequisites
Set the SYBASE environment before you invoke
ra_admin.
Task- On the
Replication Agent host machine, open an operating system command window.
- Navigate to the Replication
Agent bin directory:
-
On
Windows platforms: cd %SYBASE%\RAX-15_5\bin
where %SYBASE% is
the path to the Replication Agent installation directory.
-
On UNIX platforms: cd $SYBASE/RAX-15_5/bin
where $SYBASE is the path
to the Replication Agent installation directory.
- In the Replication Agent bin directory, invoke ra_admin to create a new Replication Agent
instance:
ra_admin -c new_inst -p port_num -t database [-uid ra_username] [-pwd ra_password]
where:
-
new_inst is
the name of the new Replication Agent instance.
-
port_num is the client
socket port number for the administration port of the new instance.
Make sure that a second port, port_num+1, is available for the RASD.
- database identifies the type of data server that the
primary database resides in:
- oracle –
Oracle database server
- mssql –
Microsoft SQL Server (valid only on Microsoft Windows
platforms)
- ibmudb –
IBM DB2 for Linux, UNIX, and Windows
- ra_username
is the administrator login name you want to use
for this Replication Agent instance. If you do not provide this
option on the command line, you will be prompted for a
value.
- ra_password is the password for the administrator
login. If you do not provide this option on the command line, you
will be prompted for a value.
After you invoke
ra_admin, the operating
system prompt returns when the new Replication Agent instance is
created.
- Verify that the Replication Agent instance was created properly
using one of these methods:
-
Invoke ra_admin with the -v option, and specify the name of the Replication
Agent instance:ra_admin -v new_inst
where new_inst is the
name of the Replication Agent instance.
When you verify a 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 Replication Agent base directory,
and checking all of the subdirectories under the Replication Agent
instance directory.
-
Invoke ra_admin with the -l option:ra_admin -l
The -l option lists all
verifiable Replication Agent instances, which should include the
new one you just created.
-
As an alternative to using ra_admin, you can use operating system commands to
verify that the Replication Agent instance directories were
created correctly.
After you create a Replication Agent instance, you can use ra to start the instance so that you can
administer and configure it.