Chapter 3: Installing Sybase Replication Agent

Installing with the GUI wizard

This installation procedure uses the InstallShield wizard in GUI mode (the GUI wizard), which requires either:

A GUI environment (with a display, keyboard, and pointing device) on the Sybase Replication Agent host machine, or
A remote machine configured to provide a GUI environment for the Sybase Replication Agent host machine.

See “Installing in console mode” for information about installing the Sybase Replication Agent software in an interactive text (or console) mode.

To install Sybase Replication Agent with the GUI wizard

Log in to the Sybase Replication Agent host machine using an operating system user account with authority to start, stop, and administer the Sybase Replication Agent instance (for example, the “sybase” user).
Close all non-essential applications, and minimize any open windows.
Insert the Sybase Replication Agent 12.6 distribution CD in the CD-ROM drive.
Start the InstallShield GUI wizard:
- On Microsoft Windows platforms, the InstallShield GUI wizard should start automatically.
  
  If the GUI wizard does not start automatically, select Start | Run, and enter the following in the Open box:
```
x:\setupwin32.exe
```
  where x: is your CD-ROM drive.
  
  You can also start the GUI wizard from Windows Explorer by double-clicking the setupwin32.exe file icon.
- On UNIX platforms, enter the following at the command prompt:
```
cd /cdrom
./setup_type
```
  where setup_type is one of the following strings that corresponds to the UNIX platform type:
  - setupaix
  - setuphp11x
  - setupsolaris
  - setuplinux
Click Next to continue.

You can click Cancel to exit the GUI wizard and stop the installation at any point before it is complete.
Select your geographic location in the license agreement and copyright notice window.
Read the Sybase license agreement and select “I agree.”

You must agree to the terms of the software license before you can continue the installation.

Click Next to continue.
Specify an installation directory in the Destination window.

The default installation directory is:
- %SYBASE% or c:\sybase on Microsoft Windows platforms
- $SYBASE or /opt/sybase on UNIX platforms
Click Next to accept the default installation directory, or do one of the following:
- Click Browse to select an installation directory in the file browser, then click Next, or
- Enter a directory name in the Destination Directory box, then click Next.
If you enter a directory name that does not exist, InstallShield prompts:
```
The directory does not exist.
Do you want to create it?
```
Click Yes to create the installation directory you specified.

If the directory you specified (either by default or by entering a directory name) 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 Sybase products were installed with Studio Installer (for example, Replication Server version 12.5), InstallShield overwrites the common components.
- The products were installed with InstallShield, InstallShield determines the correct course of action.
On Microsoft Windows platforms, if you are prompted to overwrite a DLL, click Yes only if the version of the new DLL is newer than the one InstallShield is attempting to overwrite.
Select the type of installation from three options:
- Typical
- Full
- Custom
Typical If you choose Typical, InstallShield displays the following products and features:
- Sybase Replication Agent 12.6
- jConnect
  - Free Utilities for jConnect
    - jisql
- SySAM
- Shared
Full If you choose Full, InstallShield displays the complete list of products and features on the Sybase Replication Agent 12.6 distribution CD:
- Sybase Replication Agent 12.6
- jConnect
  - Debug Classes
  - Javadocs
  - Documentation for jConnect:
    - English documentation
    - French documentation
    - German documentation
    - Japanese documentation
  - Free Utilities for jConnect:
    - jisql
    - Ribo
  - Samples
- SySAM
- Shared
Custom If you choose Custom, InstallShield displays the same products and features as the Full installation list, with check boxes that allow you to select the specific products and features you want to install.

For a minimal Sybase Replication Agent installation, choose Custom, and select only the Sybase Replication Agent 12.6 product. The following products and features are installed automatically when you select only the Sybase Replication Agent product:
- Sybase Replication Agent 12.6
- jConnect
- SySAM
- Shared
After you select the products and features for a Custom installation and click Next, InstallShield displays the products and features you selected.
Click Next to continue.

InstallShield installs the components in the installation directory you specified, and displays an installation progress indicator.

If errors occur during the installation, InstallShield displays error messages. In the event of an installation error, exit the InstallShield wizard to correct the cause of the error, then restart InstallShield. For more information, see “Installation troubleshooting”.

If the software is installed successfully, InstallShield displays a final window confirming the successful installation, and reminding you to check for updates on the Sybase downloads Web page.
Click Next, and then click Finish to complete the installation and shut down InstallShield.

To verify that the software components were installed correctly, see “Verifying the installation”.

Post-installation tasks

After you complete the Sybase Replication Agent software installation, you must complete the following post-installation tasks:

Set up the SYBASE environment on the Sybase Replication Agent host machine. See “Setting up the SYBASE environment” for more information.
Register the Sybase Replication Agent license certificate with the Sybase Software Asset Management (SySAM) license manager. See “Registering license certificates” for more information.

View this book as PDF