Installing Replication Server

This section describes how to install Replication Server components.

For more information, refer to your operating system documentation or consult your operating system administrator.

  1. Insert the Replication Server product CD in the CD drive.

  2. All platforms:

    • Verify that the drive on which you are installing has sufficient space for Replication Server.

    • Verify that you are logged in as the “sybase” user with read, write, and execute privileges.

    Windows:

    • Set the TEMP environment variable to a temporary directory, such as c:\temp. InstallShield frees this space after the installation is complete.

    For more information, refer to your operating system documentation or consult your operating system administrator.

  3. Mount the CD. Follow directions for your platform.

    Windows:

    The operating system mounts the CD automatically. Go to step 4.

    HP Itanium:

    1. Log out.

    2. Log in as “root.”

    3. Enter the following command, where device_name is the name of the CD drive device and /mnt/cdrom is the name of the directory where the CD is to be mounted:

      mount -F cdfs -o ro device_name /mnt/cdrom
      
    4. Log out as “root”.

    5. Log in as “sybase.”

    IBM AIX:

    Enter the following or similar command, where device_name is the name of the CD drive device and /mnt/cdrom is the name of the directory where the CD is to be mounted. The mount command is site-specific, so your mount syntax may differ from this example.

    mount -v ‘cdrfs’ -r device_name /mnt/cdrom
    

    Linux:

    Enter this command at the # prompt:

    mount -t iso9660 /dev/cdrom /mnt/cdrom
    

    Solaris:

    The operating system mounts the CD automatically. Go to step 4.

    If you get CD-reading errors, check your operating system kernel to make sure that the ISO 9660 option is turned on.

    If your CD shows up as anything other than sybasecd on your machine (for example, sybasecd#1), this means you have previously installed a Sybase CD on your system.

    To install this CD, restart your system or delete the sybasecd file in /vol/dsk.

  4. Invoke InstallShield to install Replication Server in GUI mode.

    For more information, go to Chapter 2, “Installing Replication Server,” in the Replication Server Installation Guide for your platform.

    On Windows:

    Windows automatically finds and opens the setup file. Go to step 5.

    If InstallShield does not open, double-click setup.exe or select Start | Run and enter the following command, where x is the CD drive.

    x: \setup.exe
    

    On HP Itanium:

    Enter the following command, where cdrom is the directory you specified when mounting the CD:

    cd /cdrom 
    ./setup
    

    On IBM AIX:

    Enter the following command, where device_name is the name of the CD drive device:

    cd /device_name 
    ./setup -is:javahome JVM
    

    On Linux:

    Enter the following command at the # prompt:

    cd /mnt/cdrom 
    ./setup -is:javahome JVM
    

    On Solaris:

    Enter the following command, where cdrom is the directory you specified when mounting the CD and volume label is the volume name in the /cdrom directory:

    cd /cdrom/volume label
    ./setup
    
  5. Go to step 6 unless you see this error message:

    Error writing file = There may not be enough
    temporary disk space. Try using -is:tempdir to use a
    temporary directory on a partition with more disk
    space.
    

    Set the temporary directory to a directory with at least 100MB of disk space. Enter this command to set the temporary directory:

    setup.exe -is:tempdir directory_name
    

    For more information, go to Chapter 2, “Installing Replication Server,” in the Replication Server Installation Guide for your platform.

  6. InstallShield appears. Click Next.

  7. Choose your geographic location in the license and copyright agreement window.

  8. Read the Sybase license agreement and select “I agree.” Click Next.

  9. In the Install Directory window:

    • Click Next to accept the default installation directory, or

    • Enter a different installation directory name, and then click Next.

    WARNING! See “Selecting an installation directory for Replication Server” before you select an installation directory. In some cases, installing Replication Server in an existing directory can irreversibly affect other Sybase software.

  10. If the installation directory you selected does not exist, InstallShield displays this message:

    The directory does not exist. Do you want to create it?
    

    Click Yes.

    If the installation directory you selected exists, and contains a prior installation, InstallShield prompts you with this message:

    You have chosen to install into an existing
    directory. Any older versions of the products you
    choose to install that are detected in this directory
    will be replaced. Do you want to continue with
    installation into this directory?
    

    Click Yes if you wish to install on top of the previous installation.

  11. Select the Typical installation.

    NoteSelecting Typical installation installs the Replication Server components considered to be useful for most customers.

  12. Click Next.

    InstallShield lists the installation directory, a summary of the features to be installed, and the total disk space required for the installation.

  13. Click Next. InstallShield installs the components on your hard drive and displays a progress monitor.

  14. Click Next after installation completes.

  15. The SySAM License Server window opens and displays this prompt:

    Will licenses be obtained from the License Server?
    
  16. The sample Replication Server option window appears. Click Yes to configure and start the sample Replication Server.

  17. Click Next.

    InstallShield displays the configuration information for the sample Replication Server. This information is displayed in Table 2-1.

  18. If the Adaptive Servers and Replication Server are not on the same machine, you must change the host name for Replication Server from “localhost” to the actual machine name.

    Use the Replication Server dsedit utility to make the change.

    For more information, go to “Using dsedit to change the Replication Server host name”.

  19. Click Next if the configuration information for the sample Replication Server is correct.

    The Configure New Replication Server window appears. InstallShield describes the configuration process and starts the Replication Server.

  20. Click Finish. InstallShield closes.

    You are now ready to create the replication environment.

    For more information, go to Chapter 3, “Setting Up and Configuring the Replication Environment.”

Table 2-1 displays default configuration information for sample Replication Server.

Table 2-1: Sample Replication Server default configuration information

Type of information

Location or description

Directory for all sample Replication Server files and log files

  • On Windows: %SYBASE%\%SYBASE_REP%\samp_repserver

  • On UNIX: $SYBASE/$SYBASE_REP/samp_repserver

Configuration file used to configure sample Replication Server

  • On Windows: %SYBASE%\%SYBASE_REP%\samp_repserver\SAMPLE_RS.res

  • On UNIX: $SYBASE/$SYBASE_REP/samp_repserver/SAMPLE_RS.res

Sample Replication Server information

ERSSD information

  • ERSSD name – SAMPLE_RS_ERSSD

  • Port number – 11751

  • User – SAMPLE_RS_RSSD_prim

  • Password – SAMPLE_RS_RSSD_prim_ps

Run file to start sample Replication Server

On Windows:

  • %SYBASE%\%SYBASE_REP%\samp_repserver\RUN_SAMPLE_RS.bat

On UNIX:

  • $SYBASE/$SYBASE_REP/samp_repserver/RUN_SAMPLE_RS

Sample Replication Server log file

On Windows:

  • %SYBASE%\%SYBASE_REP%\samp_repserver\SAMPLE_RS.log

On UNIX:

  • $SYBASE/$SYBASE_REP/samp_repserver/SAMPLE_RS.log

Interfaces file information

  • On Windows: InstallShield updates the sql.ini file.

  • On UNIX: InstallShield updates the interfaces file.