Use aserep to start and initialize ASE Replicator. When you run this script the first time, with a unique set of parameters, it:
Creates the ASE Replicator instance subdirectories in the directory where ASE Replicator is installed
Creates ASE Replicator system tables and procedures in the Distribution Database
Creates a RUN script that you can use as a shortcut to start ASE Replicator
Creates the sp_helpddb.sql script
Starts the ASE Replicator process on the primary Adaptive Server host
The aserep script is provided as a shell script (.sh) for UNIX operating systems and a batch file (.bat) for Windows NT and Windows 2000 operating systems.
On UNIX platforms, aserep.sh checks for the $SYBASE environment variable. If the $SYBASE environment variable is not set, aserep.sh assumes it is executing in the $SYBASE/RPL-12_5/bin directory and it sets the $SYBASE variable to ’pwd’/../.. so that it can set the other paths it needs to define.
Command line parameters that you provide the first time you run aserep define the configuration of the ASE Replicator process.
To run the aserep script the first time
Log in to the operating system on the primary Adaptive Server host.
Make sure that the $SYBASE environment variable is defined.
If it is not, set the current directory to the Sybase installation directory, and source SYBASE.csh or SYBASE.sh (UNIX), or execute SYBASE.bat (Windows NT or Windows 2000).
Set the current directory to the $SYBASE/RPL-12_5/bin directory:
Run the aserep script and specify all of the following command line parameters:
-m ASE_host where ASE_host is the name of the host machine where Adaptive Server is installed.
-a ASE_port where ASE_port is the port number used to connect to the Adaptive Server.
-s my_ASERep where my_ASERep is the server name of the ASE Replicator process. This name must be unique on the ASE Replicator host machine.
-r my_ASERep_port where my_ASERep_port is the port number ASE Replicator uses to listen for incoming connections. This port number must be unique on the ASE Replicator host machine.
-d DDB_name where DDB_name is the name of the Distribution Database you created.
-u rep_user where rep_user is the ASE Replicator system user login you created.
-p passwd where passwd is the password for the ASE Replicator system user login.
After you run the aserep script, the ASE Replicator process starts and displays the Sybase copyright and disclosure statements in the operating system window.
If the process starts successfully, the operating system prompt does not return in that window until you shut down the ASE Replicator process.
If an error message appears shortly after the copyright and disclosure statements, and the operating system prompt returns, then the ASE Replicator process failed to start successfully.
If the ASE Replicator process does not start successfully after you run the aserep script, verify that:
You entered all of the command line parameters correctly, and
You completed all of the other setup procedures in this chapter.