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.
Mount the Replication Server CD. Enter:
```
# mount -t iso9660 /dev/cdrom /mnt/cdrom
```
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.

When you complete the installation process, unmount and remove the CD from the drive at the # prompt by entering:

# umount /dev/cdrom

# eject

Installing in GUI mode

At the # prompt, enter the following, where /mnt/cdrom is the directory you specified when mounting the CD drive, and ./setup unloads the components in GUI mode:
```
cd /mnt/cdrom
./setup -is:javahome JVM
```
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.1. 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 install 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 a license model,” in Chapter 2 “Understanding Licensing Concepts and Models” of the Sybase Software Asset Management User’s Guide 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:

./setup -is:javahome JVM -console

InstallShield starts and displays the welcome window as follows:

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

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

The InstallShield Wizard will install Replication
Server Software, Version 15.0.1 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.