Follow the procedures in this section to install Replication Server components.
This procedure installs Replication Manager, the plug-in
to Sybase Central, Java Edition. However, it does not install the
Replication Server plug-in to Sybase Central, Windows Edition. To install
the Replication Server plug-in to Sybase Central, Windows
Edition, see “Installing Sybase Central on Windows”.
Installing Replication Server components
Choose one of the following installation modes:
Graphical user interface (GUI) – which lets you install the components using the InstallShield interface.
Console – which lets you install components in a command line environment.
Response file – which lets you record or create a response file. You can install Replication Server in two different ways using a response file:
Silent – which 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 – which 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.text, where $SYBASE is
the Replication Server installation directory.
Mount the Replication Server CD:
Mac: The operating system mounts the CD automatically.
If you do not see the CD in the /Volumes directory:
Enter the following command in a terminal window to identify the location of the CD drive:
/usr/sbin/disktool -l
You see the following output, where the CD drive is “cd9660,” the CD is called “RS126 MAC,” and the drive’s location is “disk1s0”:
***Disk Appeared ('disk0',Mountpoint = '', fsType = '', volName = '') ***Disk Appeared ('disk0s1',Mountpoint = '', fsType = '', volName = '') ***Disk Appeared ('disk0s2',Mountpoint = '', fsType = '', volName = '') ***Disk Appeared ('disk0s3',Mountpoint = '', fsType = '', volName = '') ***Disk Appeared ('disk0s4',Mountpoint = '', fsType = '', volName = '') ***Disk Appeared ('disk0s5',Mountpoint = '/', fsType = 'hfs', volName = 'macxase2') ***Disk Appeared ('disk1',Mountpoint = '', fsType = '', volName = '') ***Disk Appeared ('disk1',Mountpoint = '', fsType = '', volName = '') ***Disk Appeared ('disk1s0',Mountpoint = '', fsType = 'cd9660', volName = 'RS126 MAC')
Enter the following command, using the CD drive’s location:
/usr/sbin/disktool -m disk1s0
You see the following output:
disk1s0 device will attempt to be mounted ... ***Disk Appeared ('disk0',Mountpoint = '', fsType = '', volName = '') ***Disk Appeared ('disk0s1',Mountpoint = '', fsType = '', volName = '') ***Disk Appeared ('disk0s2',Mountpoint = '', fsType = '', volName = '') ***Disk Appeared ('disk0s3',Mountpoint = '', fsType = '', volName = '') ***Disk Appeared ('disk0s4',Mountpoint = '', fsType = '', volName = '') ***Disk Appeared ('disk0s5',Mountpoint = '/', fsType = 'hfs', volName = 'macxase2') ***Disk Appeared ('disk1',Mountpoint = '', fsType = '', volName = '') ***Disk Appeared ('disk1s0',Mountpoint = '', fsType = 'cd9660', volName = 'RS126 MAC') Disk Mounting Completed
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 RS126SOLARIS, this
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.
Tru64 UNIX: Enter the following command, where RS126HPTru64 is the CD drive device name, and /cdrom is the name of the directory where the CD is to be mounted:
/sbin/mount -r -t cdfs -o noversion -o rrip RS126HPTru64/cdrom
Log out.
Log on as “root.”
Enter the following, where RS126HP is the CD drive device name, and /cdrom is the name of the directory where the CD is to be mounted:
/etc/mount -F cdfs -o ro RS126HP/cdrom
Log out as “root.”
Log in as “sybase.”
Log out.
Log on as “root.”
Enter the following, where /cdrom is the name of the directory where the CD is to be mounted:
mount -F cdfs -o ro /dev/dsk/c1t3d0 /cdrom
Log out as “root.”
Log in as “sybase.”
IBM AIX: Mount the CD using the following command, where RS126 IBM is the CD drive device name, and /cdrom is the name of the directory where the CD is to be mounted:
/usr/sbin/mount -v 'cdrfs' -r" device_name RS126IBM/cdrom
The location of the mount command is site-specific and may differ from what is shown in these instructions.
SGI: 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 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
Insert the Replication Server CD in the CD drive.
Double-click the CD icon, then double-click the Setup icon.
If you have a “headless” Mac that lacks a monitor, install Replication Server in command line mode. See “Installing in console 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:
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 to proceed.
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 exists, InstallShield prompts:
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?
If you click Yes, and:
The products were 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.
The products were installed with InstallShield, InstallShield determines the correct course of action without prompting you.
WARNING! Do not install into an existing Adaptive Server Enterprise 12.x (64-bit) directory. If you do, localization (.loc files) will be overwritten, and Adaptive Server Enterprise will not start.
Select the type of installation:
If you choose Typical, InstallShield displays the following default components:
Sybase Servers
Replication Server Administration Tools – Sybase Central, Java Edition, and Replication Manager plug-in to Sybase Central, Java Edition
Connectivity
Language Modules for Replication Server
Language Modules-Connectivity
jConnect
Shared
Sybase Software Asset Management – SySAM
Not available for HP Tru64 UNIX, Mac OS X
and SGI – to start a sample Replication Server
automatically after installation, select Typical installation and
then select the defaults.
If you choose Full, InstallShield installs every component on the CD.
If you choose Custom, select the components to install. Certain components are automatically installed if they are required to run your selected components.
To install the Replication Server plug-in to
Sybase Central, Windows Edition, use the PC-Client CD and
follow the instructions in “Installing Sybase Central on Windows”.
Click Next. InstallShield installs the components on the hard drive and displays a progress indicator.
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.
Not available for HP Tru64 UNIX, Mac OS X and SGI – on the sample Replication Server option window, click:
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 click No, you can configure and start a sample Replication Server after installation. See “Starting the sample Replication Server” for more information.
Not available for HP Tru64 UNIX, Mac OS X, and SGI – 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 configured using the file $SYBASE/REP-12_6/samp_repserver/SAMPLE_RS.res. All files and logs associated with the sample Replication Server will be located in the directory $SYBASE/REP-12_6/samp_repserver. 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.
Not available for HP Tru64 UNIX, Mac OS X, and SGI – click Next. If you chose to start a sample Replication Server, the Configure New Replication Server window displays the progress of the server configuration.
Click Next. The Installation Completed window displays, verifying that the Replication Server software is now installed.
If you chose to start a sample Replication Server, Replication Server 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 how to configure your new Replication Server.
Click Finish. The InstallShield wizard closes.
Run the license tool to enter your Sybase Software Asset Management Certificates. See “Using the SySAM license manager” for more information.
Check the Sybase downloads Web site for updates.
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 Itanium, HP-UX and Solaris:
./setup -console
./setup -console -is:javahome JVM
Mac: In a terminal window, enter:
java -Djava.awt.headless=true -cp /Volumes/"RS126 MAC"/suite.jar \ run -console
InstallShield starts and displays the welcome window as follows:
-------------------------------------------------- Welcome to the InstallShield Wizard for Sybase Replication Server Software, Version 12.6. The InstallShield Wizard will install Replication Server Software, Version 12.6 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.