Creating a SAMPLE_RS

Create a SAMPLE_RS and SAMPLE_RS_ERSSD when the directories or files do not exist.

If the SAMPLE_RS directories already exist, go to Refreshing a SAMPLE_RS section.
  1. Go to the SAP Replication Server installation directory. This is one directory level above where REP-15_5 resides. This is the value for $SYBASE.
  2. Set the environment variables by sourcing the SYBASE.csh file.
  3. Edit the interfaces files and add these entries:
    SAMPLE_RS
       master tcp ether localhost 11752
       query tcp ether localhost 11752
    #
    SAMPLE_RS_ERSSD
       master tcp ether localhost 11751
       query tcp ether localhost 11751
    Change localhost to the name of the host machine.
    Warning!  There can only be one SAMPLE_RS_ERSSD on a host machine.
  4. Go to $SYBASE/REP* directory.
  5. Create a directory called samp_repserver.
    mkdir samp_repserver
  6. Go to the samp_repserver directory.
    cd samp_repserver
  7. Create a directory called samp_partition.
    mkdir samp_partition
  8. Create a file called SAMPLE_RS.res like the following with these modifications:
    In the values of the parameters, the $SYBASE must reflect the actual name of the path as rs_init cannot utilize environment variables.
    Parameter Description
    sybinit.release_directory The actual path or value of $SYBASE
    rs.rs_idserver_pass Valid password
    rs.rs_rssd_prim_pass Valid password
    rs.rs_rssd_maint_pass Valid password
    rs.rs_ltm_rs_pass Valid password
    rs.rs_rs_sa_pass Valid password
    rs.rs_rs_run_file Valid file and path that will used to start up SAMPLE_RS. $SYBASE/REP-15_5/samp_repserver/RUN_SAMPLE_RS is the suggested location and file name.
    rs.rs_rs_errorlog Valid file and path that will used SAMPLE_RS log file. $SYBASE/REP-15_5/samp_repserver/SAMPLE_RS.log is the suggested location and file name.
    rs.rs_rs_cfg_file Valid file and path that will used SAMPLE_RS configuration file. $SYBASE/REP-15_5/samp_repserver/SAMPLE_RS.cfg is the suggested location and file name.
    rs.rs_erssd_database_dir Valid path where the ERSSD database will be located. $SYBASE/REP-15_5/samp_repserver/dbfile is the suggested location.
    rs.rs_erssd_translog_dir Valid path where the ERSSD database transaction log will be located. $SYBASE/REP-15_5/samp_repserver/log is the suggested location.
    rs.rs_erssd_backup_dir Valid path where the ERSSD backups, including the mirror log, will be located. $SYBASE/REP-15_5/samp_repserver/backup is the suggested location.
    rs.rs_erssd_errorlog_dir Valid path where the ERSSD log will be located. $SYBASE/REP-15_5/samp_repserver/errorlog is the suggested location.
    rs.rs_diskp_name Valid file and path that will be used for the stable device. The file does not have to exist, however, the directory path must exist. $SYBASE/REP-15_5/samp_repserver/samp_partition/partition1 is the suggested location.
    rs.rs_rs_pass Valid password
    See the table for description of the parameters that do not have values in the following resource file and provide their values based on the description.
    # --- rs_init resource file ----
    #
    sybinit.release_directory:  
    sybinit.product: rs
    rs.rs_operation: rs_install
    #
    # --- ID SERVER INFORMATION ----
    #
    rs.rs_idserver_name: SAMPLE_RS
    rs.rs_id_server_is_rs_server: yes
    rs.rs_idserver_user: USE_DEFAULT
    rs.rs_idserver_pass: 
    rs.rs_rssd_prim_pass: 
    rs.rs_rssd_maint_pass: 
    rs.rs_ltm_rs_pass: 
    #
    # --- REPLICATION SERVER INFORMATION ----
    #
    rs.rs_name: SAMPLE_RS
    rs.rs_rs_sa_user: USE_DEFAULT
    rs.rs_rs_sa_pass:  
    rs.rs_erssd_requires_ltm: no
    rs.rs_needs_repagent: yes
    rs.rs_rs_run_file: 
    rs.rs_rs_errorlog: 
    rs.rs_rs_cfg_file: 
    rs.rs_charset: USE_DEFAULT
    rs.rs_language: USE_DEFAULT
    rs.rs_sortorder: USE_DEFAULT
    #
    # --- ERSSD ----
    #
    rs.rs_rssd_embedded: yes
    rs.rs_erssd_name: SAMPLE_RS_ERSSD
    rs.rs_erssd_database_dir: 
    rs.rs_erssd_translog_dir: 
    rs.rs_erssd_backup_dir: 
    rs.rs_erssd_errorlog_dir: 
    #
    # --- DISK PARTITION INFORMATION ----
    #
    rs.rs_diskp_name: 
    rs.rs_diskp_lname: partition1
    rs.rs_diskp_size: 20
    rs.rs_diskp_vstart: 0
    #
    # --- REMOTE SITE CONNECTION INFORMATION ----
    #
    rs.rs_rs_user: USE_DEFAULT
    rs.rs_rs_pass:  
    
    #
    # --- ID SERVER INTERFACES INFORMATION ----
    #
    rs.do_add_id_server: no
    rs.do_add_replication_server: no
    
  9. Use rs_init to execute this resource file:
    $SYBASE/REP-15_5/install/rs_init -r SAMPLE_RS.res -T T_SEND_CLEARTEXT_PASSWORD

    If the creation of the SAMPLE_RS fails:

    1. Correct the error.
    2. Stop the SAP Replication Server if it is running.
    3. Remove the files in these directories:
      • $SYBASE/REP*/samp_repserver/backup/SAMPLE_RS_ERSSD.db
      • $SYBASE/REP*/samp_repserver/backup/SAMPLE_RS_ERSSD.log
      • $SYBASE/REP*/samp_repserver/backup/SAMPLE_RS_ERSSD.mlg
      • $SYBASE/REP*/samp_repserver/dbfile/SAMPLE_RS_ERSSD.db
      • $SYBASE/REP*/samp_repserver/errorlog/SAMPLE_RS_ERSSD.out
      • $SYBASE/REP*/samp_repserver/log/SAMPLE_RS_ERSSD.log
      • $SYBASE/REP*/samp_repserver/RUN_SAMPLE_RS
      • $SYBASE/REP*/samp_repserver/SAMPLE_RS.cfg
      • $SYBASE/REP*/samp_repserver/SAMPLE_RS.log
    4. Rerun rs_init.
  10. Verify that the SAMPLE_RS is available. Log in to the SAMPLE_RS.
    isql -Usa –Ppassword -SSAMPLE_RS

    The password to the sa user ID is the value that was filled in the resource file for rs.rs_rs_sa_pass.

  11. Enter:
    admin who
    go
    
  12. End the session by exiting from the isql client.
    exit
    go