This installation procedure uses the installation program wizard in GUI mode (the GUI wizard), which requires one of the following:
A GUI environment (with a display, keyboard, and pointing device) on the Replication Agent host machine, or
A remote machine configured to provide a GUI environment for the Replication Agent host machine.
See “Installing in console mode” for information about installing the Replication Agent software in an interactive text (or console) mode.
Installing Replication Agent with the GUI wizard
Log in to the Replication Agent host machine using an operating system user account with authority to start, stop, and administer the Replication Agent instance (for example, the “sybase” user).
Close all non-essential applications, and minimize any open windows.
Insert the Replication Agent 15.2 distribution CD in the CD drive.
Start the installation program GUI wizard:
On Microsoft Windows platforms, the installation program GUI wizard should start automatically.
If the GUI wizard does not start automatically, select Start | Run, and enter:
x:\setup.exe
where x: is your CD drive.
You can also start the GUI wizard from Microsoft Windows Explorer by double-clicking the setup.exe file icon.
On UNIX platforms, enter the following at the command prompt:
cd /cdrom ./setup
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:
Existing %SYBASE% or c:\sybase on Microsoft Windows platforms
Existing $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, and then click Next, or
Enter a directory name in the Destination Directory box, and then click Next.
If you enter a directory name that does not exist, the installation program 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, the installation program 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 the installation program, then the installation program 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 the installation program is
attempting to overwrite.
Select the type of installation from the two options:
Typical
Custom
Typical If you choose Typical, the installation program displays the following products and features:
Replication Agent 15.2
SySAM License Server
SySAM License Utilities
Custom If you choose Custom, the installation program displays the same products and features as the Typical installation list, with check boxes that allow you to select the specific products and features to install.
Replication Agent 15.2
SySAM License Server
SySAM License Utilities
After you select the products and features for a Custom installation and click Next, the installation program displays the products and features you selected.
Click Next to continue.
The installation program installs the components in the installation directory you specified, and displays an installation progress indicator.
If errors occur during the installation, the installation program displays error messages. In the event of an installation error, exit the installation program wizard to correct the cause of the error, then restart the installation program. For more information, see “Installation troubleshooting”.
If the software is installed successfully, the installation program displays a window confirming the successful installation.
Click Next.
The SySAM License Server window opens and displays this prompt:
Will the licenses be obtained from the License Server?
Select yes, if you have a preexisting SySAM network license server installed. 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.
Click Next.
The SySAM notification window prompts you to configure your server for e-mail notification. When configuration is enabled, you receive information about license management events that require attention. Select Yes and either accept the default values that are supplied, or enter values for the following (from your worksheet):
SMTP server host name
SMTP server port number
E-mail return address
Recipients of the notification
Message severity level of an event that triggers e-mail notification. Your choices are:
Informational
Warning
Error
If you choose not to have e-mail alerts or severity messages logged, select No.
Click Next.
Click Finish to complete the installation and close the installation program.
To verify that the software components were installed correctly, see “Verifying the installation”.
After you complete the Replication Agent software installation, you must set up the SYBASE environment on the Replication Agent host machine. See “Setting up the SYBASE environment”.
