Installing Replication Server

Follow the procedures in this section to install Replication Server components.

Installing Replication Server components

Choose one of the following installation modes:

Graphical user interface (GUI) – lets you install the components using the InstallShield interface.
Console – lets you install components in a command line environment.
Response file – lets you record or create a response file. You can install Replication Server in two different ways using a response file:
- Silent – lets you save the installation settings in a response file and install the product without any interaction required on your part. This is convenient if you are performing identical installations on multiple machines.
- Console installation using response file – lets you install in console mode but with all the responses already filled in, so that you can accept all the defaults and install Replication Server according to the responses in the response file. This can be convenient if several sites are installing Replication Server in a nongraphical user interface environment and must conform to a standard installation with minor changes.

If you encounter problems during installation, check the installation log file to see a record of the installation process. The file is located in $SYBASE/log.txt, where $SYBASE is the Replication Server installation directory.

Mount the Replication Server CD:

Solaris:

The operating system mounts the CD automatically. If you get CD-reading errors, check your operating system kernel to make sure the ISO 9660 option is turned on.
If your CD shows up as anything other than sybasecd, it means you previously installed a Sybase CD on your system. Perform either of these two options to install your current CD:
- Restart your system.
- Delete the sybasecd file in /vol/dsk.
HP-UX:
1. Log out.
2. Log in as “root.”
3. Enter the following where device_name is the name of the CD device drive, and /RS150HP/cdrom is the name of the directory where the CD is to be mounted:
```
/etc/mount -F cdfs -o ro device_name /RS150HP/cdrom
```
4. Log out as “root.”
5. Log in as “sybase.”
IBM AIX:

Mount the CD using the following command, where device_name is the name of the CD device drive, and /RS150IBM/cdrom is the name of the directory where the CD is to be mounted:
```
/usr/sbin/mount -v 'cdrfs' -r device_name /RS150IBM/cdrom
```
The location of the mount command is site-specific and may differ from what is shown in these instructions.

If you cannot mount the CD drive, consult your operating system documentation or contact your operating system administrator.

Verify that you are logged in as the “sybase” user with “root” privileges.

Installing in GUI mode

At the UNIX prompt, enter the following, where cdrom is the directory you specified when mounting the CD drive, and ./setup unloads the components in GUI mode:

IBM AIX:

cd /device_name 
./setup -is:javahome JVM

HP-UX:
```
cd /cdrom
./setup
```
Solaris:
```
cd /cdrom/rs150solaris 
./setup
```

You might see the following 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.

If so, set the temporary directory to another directory that has more disk space by entering the following at the command line, where directory_name is the name of the temporary directory to which InstallShield will write its temporary files:

setup -is:tempdir directory_name

This directory should have at least 100MB of disk space.

Select Next.

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

Read the Sybase license agreement and select “I agree.” Click Next. You must agree to the license and copyright before you can continue.

In the install directory window, click Next to accept the default directory for the installation ($SYBASE or /opt/sybase), or enter a different directory name.

If the installation directory you chose does not exist, InstallShield prompts:

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 the following 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. If the products were previously installed with:

Studio Installer (for example, if you installed a version of Replication Server earlier than 12.6 or a version of Adaptive Server earlier than 12.5.1), InstallShield overwrites common components.
InstallShield, the correct course of action is determined by InstallShield without prompting you.

Select the type of installation:

If you choose Full or Typical, InstallShield displays the following default components:
- Sybase Servers – Replication Server
- Connectivity
- Language Modules for Replication Server
- Language Modules – Connectivity
- Shared
- Replication Monitoring Services
- Replication Server Administration Tools – Sybase Central and Replication Manager Plugin
- Sybase Software Asset Management
If you choose Custom, select the components to install. Certain components are automatically installed if they are required to run your selected components.

Click Next. InstallShield displays a progress indicator as it installs the components.

If you do not have enough disk space for the installation, InstallShield displays an error message. In this case, exit InstallShield, remove any programs or files that you do not need, and clean out temporary directories. Then, restart InstallShield.

On successful installation, InstallShield displays the following message: Click Next.

The InstallShield Wizard has successfully installed Replication Server Software, Version 15.0. Choose next to continue the wizard.

The SySAM License Server window opens and displays this prompt:

Will licenses be obtained from the License Server?

Select Yes if you have a preexisting SySAM network license server installed or installed a new license server using “Installing a new license server”.

Enter the host name and the port number of the license server.
Select No if you do not have a SySAM license server installed and are going to use a local license file. A message displays telling you to download the license file.

If you select Yes and the license server is not found, or you select No and the local license file is not installed on your local machine, this message displays:

Installer can’t check out a license. Do you want to continue with a license?

Click Yes to complete the installation. If you select No, this message displays:

Please remember to download and install the license file after this installation.

Click OK to return to the beginning of step 12.

See “Choosing the appropriate license server configuration” for information on which choice is appropriate for your installation.

The SySAM Notification window asks you to configure your server for e-mail notification. When configuration is enabled, you will receive information about license management events requiring attention.

SMTP server host name
SMTP server port number
E-mail Return Address
Recipient e-mail addresses
Message severity that triggers e-mail messages

On the sample Replication Server option window, select:

Yes – to configure and start a sample Replication Server. InstallShield displays the configuration information for the sample Replication Server. Write this information down.
No – to complete the installation and configure a fully-featured Replication Server manually.

If you select No, you can configure and start a sample Replication Server after installation. See “Start the sample Replication Server” for more information.

Click Next. If you chose to configure and start a sample Replication Server, InstallShield displays the configuration information related to the sample Replication Server:

This page contains detailed information regarding the sample Replication Server. Please record this information.

The sample Replication Server will be called SAMPLE_RS and will run on port 11752. It will be configured with a user of sa and no password.


The sample Replication Server will use an embedded RSSD called SAMPLE_RS_ERSSD that runs on port 11751. It will be configured with a user of SAMPLE_RS_RSSD_prim and a password of SAMPLE_RS_RSSD_prim_ps.

The installer has updated the appropriate interfaces file or sql.ini file.

All files and logs associated with the sample Replication Server will be located in the directory $SYBASE/REP-15_0/samp_repserver.

The sample Replication Server will be configured using the file $SYBASE/REP-15_0/samp_repserver/SAMPLE_RS.res.

Click Next. The Configure New Replication Server window displays the progress of the server configuration.

Click Next. The Installation Completed window appears, verifying that the Replication Server software is now installed.

If you chose to start a sample Replication Server, it is started automatically. If you did not choose to start a sample Replication Server, you must configure and then start your Replication Server manually.

See the Replication Server Configuration Guide for UNIX for information about configuring your new Replication Server.

Click Finish. The InstallShield wizard closes.

Installing in console mode

The steps for installing components in an interactive text mode are the same as those described in “Installing in GUI mode”, except that you execute InstallShield from the command line using the setup -console command, and you enter text to select installation options.

At the command line, enter:

HP-UX and Solaris:
```
./setup -console
```
IBM AIX:
```
./setup -console -is:javahome JVM
```

InstallShield starts and displays the welcome window as follows:

--------------------------------------------------

Welcome to the InstallShield Wizard for Sybase Replication Server Software, Version 15.0.

The InstallShield Wizard will install Replication Server Software, Version 15.0 on your computer.

To continue, choose Next.

Press 1 for Next, 3 to Cancel or 4 to Redisplay [1]

-------------------------------------------------

Follow the remaining prompts to install Replication Server software.