Starting an instance with the ra utility

When you start the Replication Agent with the ra utility, you can specify the instance start-up state. If you do not specify a start-up state when you invoke the ra utility, the Replication Agent instance starts in its default Admin state.

NoteSet the SYBASE environment before you invoke the Replication Agent ra utility. See “Preparing to use the utilities” for more information.

StepsStarting Replication Agent using the ra utility

  1. Open an operating system command window on the Replication Agent host machine.

  2. At the operating system prompt, navigate to the Replication Agent bin directory.

    • On Windows platforms, enter:

      cd %SYBASE%\RAX-15_2\bin
      

      Here, %SYBASE% is the path to the Replication Agent installation directory.

    • On UNIX platforms, enter:

      cd $SYBASE/RAX-15_2/bin
      

      Here, $SYBASE is the path to the Replication Agent installation directory.

  3. In the Replication Agent bin directory, invoke the ra utility to start the Replication Agent instance:

    ra -iinst_name
    

    or

    ra -iinst_name -state
    

    where:

    • inst_name is the server name of the Replication Agent instance.

    • state is the optional keyword for the start-up state:

      • admin – starts the Replication Agent instance in Admin state.

      • replicate – starts the Replication Agent instance in Replicating state.

      NoteIf you do not specify the state option, Replication Agent starts in Admin state.

    For example, to start the Replication Agent instance named “my_ra” in Replicating state:

    ra -i my_ra -replicate
    

After you start the Replication Agent instance, you must open another operating system command window to log in to its administration port.

See “Using the ra utility” for more information.