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 Mirror Replication Agent host machine, or
A remote machine configured to provide a GUI environment for the Mirror Replication Agent host machine.
See “Installing in console mode” for information about installing the Mirror Replication Agent software in an interactive text (or console) mode.
To install Mirror Replication Agent with the GUI wizard
Log in to the Mirror Replication Agent host machine using an operating system user account with authority to start, stop, and administer the Mirror Replication Agent instance (for example, the “sybase” user).
Close all non-essential applications, and minimize any open windows.
Insert the Mirror 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
Choose Next to continue.
You can exit the GUI wizard and stop the installation
at any point before it is complete by choosing Cancel.
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.
Choose 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
Choose Next to accept the default installation directory, or do one of the following:
Click the “browse” button (...) to select an installation directory in the file browser, then choose Next.
Enter a directory name in the Destination Directory box, then choose Next.
If you enter a directory name that does not exist, InstallShield prompts:
The directory does not exist. Do you want to create it?
Choose 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 choose 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 without prompting you.
On Microsoft Windows platforms, if you are prompted
to overwrite a DLL, choose 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:
Mirror Replication Agent 12.6
jConnect-5_5 EBF 11473
jTDS
Free Utilities for jConnect
jisql
SySAM
Shared
Full If you choose Full, InstallShield displays the complete list of products and features on the Mirror Replication Agent 12.6 distribution CD:
Mirror Replication Agent 12.6
jConnect-5_5 EBF 11473
Debug Classes
jTDS
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 Mirror Replication Agent installation, choose Custom, and select only the Mirror Replication Agent 12.6 product. The following products and features are installed automatically when you select only the Mirror Replication Agent product:
Mirror Replication Agent 12.6
jTDS
SySAM
Shared
After you select the products and features for a Custom installation and choose Next, InstallShield displays the products and features you selected.
Choose 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.
Choose Next, and then choose Finish to complete the installation and shut down InstallShield.
To verify that the software components were installed correctly, see “Verifying the installation”.
After you complete the Mirror Replication Agent software installation, you must complete the following post-installation tasks:
Set up the SYBASE environment on the Mirror Replication Agent host machine. See “Setting up the SYBASE environment” for more information.
Register the Mirror Activator license certificate with the Sybase Software Asset Management (SySAM) license manager. See “Registering license certificates” for more information.
