Installing in GUI mode

This section describes the steps for installing DI Suite components for the first time using the GUI mode.

Run the installer.

If you are installing from the SPDC, run the setup program from the directory where you have extracted all the files. For more information on how to install from the SPDC, see “Installing from the SPDC”.

If you are installing using the DI Suite installation media:

Insert the DI Suite installation media.
At the command line enter:
```
/cdrom/setup
```
The Welcome window displays. Click Next to proceed.

Specify the geographic location.

Select the geographic location where you are installing to display the agreement appropriate to your region. Read the End-user License and Copyright Agreement. Select “I agree to the terms of the Sybase license for the install location specified” and click Next.

Provide the license information.

On the Sybase Software Asset Management License Server window, provide the licenses for the components you want to install. For information on various component licenses, see “Licenses for DI Suite components”.

Use one of these options to enter the licenses:
- Specify License Keys – click Browse to select the license file. To select multiple license files, use Shift+Click or Ctrl+Click. The license pane displays the license information.
  
  Alternatively, copy and paste the license information directly in the license pane. Click Next to proceed.
  
  The installer determines if the license you have entered is a served or an unserved license.
  
  For a served license:
  - If the served license requires a license server for the machine on which you are installing the DI components, the installer prompts you to provide the directory in which you want to install the license server. Click Next. The installer displays an installation summary window and proceeds to install the license server.
  - If the served license is activated for a machine other than where you are installing the DI Suite components, you must set up a license server on that machine, deploy the license, and then select Use Previously Deployed License server option on the installer.
    
    For information on how to set up a standalone license server, see Appendix A, “Setting up a SySAM Standalone License Server.”
    
    If you are intalling the license server on a platform that is not supported by DI Suite 1.1, go to the SySAM Web site to download the license server setup program.
- Use Previously Deployed License server – if you have a previously deployed license server, enter the host name of the machine where the license server is running, and the port number if the port number you are using is not default. Click Next.
For more information on SySAM licensing, see the Sybase Software Asset Management User’s Guide.
Depending on the license information you provide, the components that are available for installation are displayed. You may see any or all of the following components:
- Sybase Replication
- Sybase Search
- Sybase Data Federation
- Sybase Real-Time Events
- Sybase ETL
- Sybase Data Integration Suite – Standard Edition
Review and verify the list. If you do not see a component you want to install, return to the previous window and provide the license for the component. Click Next.

You can install the Standard Edition only on a single machine with a maximum of 2 CPUs. If the installer detects more than 2 CPUs on the installation machine, it displays an error.

Select to install either the Individual Data Integration Suite Components or the Standard Edition.

If you have provided the license for individual Suite components, along with the licenses for the Standard Edition, the installer prompts you to select one of the following options:

Individual Data Integration Suite Components
Standard Edition

Click Next.

Specify the installation directory.

Click Browse to select a directory, click Next to accept the default directory, or enter a different directory name where you want to install the DI Suite components. The default directory is /opt/sybase. Sybase recommends that you install the DI Suite components into the Sybase directory, if one already exists on your machine.

Make sure that the installation directory name does not have non-ASCII characters or spaces.
If the installation directory you specified already exists, and contains an earlier installation, you see:
```
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 to replace any previous installation in this directory.

If the installation directory you specify does not exist, you see:
```
The directory does not exist. Do you want to create it?
```
Click Yes. By default, the installer installs the components in the $SYBASE directory, if it exists. If you proceed to install in a new directory, the existing Sybase products may not work properly. Click No to go back and change the directory. Click Yes to proceed.

If the installer detects an incompatible version of a Sybase product in this directory, it displays a warning. For compatibility information of DI Suite components against other Sybase products, see “DI Suite component coexistence matrix”.

Select the components to install

Select the individual components you want to install. If you want to select all the displayed components for installation, click Select All Components.

Select the installation type:

Select Full to install all the subcomponents for the selected component on a single machine. For example, if you have selected the Sybase Replication component, the Full option installs all subcomponents available under this component. Click Next.
Select Custom to choose specific subcomponents you want to install for the selected component. You can install these subcomponents on a single machine or multiple machines. For example, if you have selected the Sybase Replication component, the Custom option allows you to install any or all of the subcomponents available under this component on a single machine or multiple machines. Click Next.

In the case of Standard Edition, you must install all DI Suite components on a single machine, except the Replication Agent and ASE Active Messaging subcomponents. You can install Replication Agent and ASE Active Messaging subcomponents on separate machines. For more information, see “Deployment and licensing options for Standard Edition”.

Before you begin a custom installation, you must have a thorough understanding of a typical installation architecture for each DI Suite component. See Chapter 8, “Typical Deployment Scenarios,” for information you may need before performing a custom installation.

For more information on the Full and Custom installation type, see “Installation type”.

Review the subcomponents to install.

The installer displays all the subcomponents that are available for each selected component. Review the list to verify the subcomponents you want to install. Unselect the subcomponents you do not want to install. Click Next.

For certain components, you must provide additional information before you can proceed with the installation:

For Sybase Search

Depending on the installation type you chose, you are prompted to provide configuration parameters as listed in the following tables. Modify or accept the default values, and click Next.

**Table 3-2: Search configuration parameters for Full install**
Parameter name	Description
Hub Container Port	Identifies the port number on which the single container will run. Enter an appropriate value between 1024 and 65535.
Container RMI Port	Identifies the port number on which the hub container RMI service will run. Enter an appropriate value between 1024 and 65535.
Hyena Port	The port number on which the Hyena Web server will run. Enter an appropriate value between 1024 and 65535.
Web Administrator Password	Enter the Web administrator password. The password can be alphanumeric and must have a minimum of 6 characters.
Confirm Web Administrator Password	Re-enter the Web administrator password.

**Table 3-3: Search configuration parameters for Custom install**
Selection	Parameter name and description
Hub Container	Hub Container Port – identifies the port number on which the single container will run. Enter an appropriate value between 1024 and 65535. Container RMI Port – identifies the port number on which the hub container RMI service will run. Enter an appropriate value between 1024 and 65535.
Satellite Container	Container ID – identifies the unique container ID. Enter an appropriate value between 2 and 99. Container RMI Port – identifies the port number on which the hub container RMI service will run. Enter an appropriate value between 1024 and 65535. Container Port – identifies the port number on which the satellite container will run. Enter an appropriate value between 1024 and 65535. Hub Container Host Name – identifies the host name on which the hub container will run. Enter a host name.
Web Administration	Container RMI Port – identifies the port number on which the hub container RMI service will run. Enter an appropriate value between 1024 and 65535. Hub Container Host Name – identifies the host name on which the hub container will run. Enter a host name. Hyena Port – the port number on which the Hyena Web server will run. Enter an appropriate value between 1024 and 65535. Web Administrator Password – enter the Web administrator password. The password can be alphanumeric and must have a minimum of 6 characters. Confirm Web Administrator Password – re-enter the Web administrator password.

For Sybase ASE Active Messaging

Enter or select an existing Adaptive Server Enterprise (ASE) installation directory and click Next to proceed.

Sybase ASE Active Messaging on Sun Solaris supports 32-bit and 64-bit versions of ASE 12.5.4 ESD#3 or later, or ASE 15.0.1 ESD#1 or later. On IBM AIX, it supports 64-bit version of ASE 12.5.4 ESD#3 or later, or ASE 15.0.1 ESD#1 or later.

If the installer detects a supported version of ASE, it proceeds with the installation.

If the installer detects multiple supported versions of ASE installations, it displays all of them and prompts you to select the versions to install the Sybase Real-Time Events ASE Active Messaging component. Click Next.

If the installer does not detect an ASE installation in the specified directory, or detects an unsupported ASE version, it asks if you want to continue installing without the Sybase ASE Active Messaging subcomponent. Click Yes to continue. Click Next.
For RepConnector
1. Before installing, make sure you have completed the prerequisites for installing RepConnector. For more information, see “Installation prerequisites”.
2. Select the application server where you want to install RepConnector:
  - RepConnector for Sybase EAServer
  - RepConnector for BEA WebLogic
  Click Next.
  
  RepConnector supports Sybase EAServer version 5.3 on Sun Solaris and 5.2.1 on IBM AIX.
3. If you have selected BEA WebLogic as the application server, specify the directory in which BEA WebLogic is installed. Make sure you have write permission to the BEA WebLogic installation directory.
  
  Click Next.
4. Provide the BEA WebLogic server information:
  - Domain Name – the name of the WebLogic domain you will be deploying RepConnector to.
  - Server Name – the name of the WebLogic server you will be deploying RepConnector to.
  - WebLogic Server Host Name – the name of the machine you are installing on.
  - WebLogic Server Port Number – the WebLogic listening port. The default port is 7001.
  - Server administrator account information (Username and Password) – your WebLogic user name and password.

Configure e-mail notifications for SySAM events.

The SySAM notification window prompts you to configure the DI Suite 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 new values for the following:

SMTP server host name – the Simple Mail Transfer Protocol (SMTP) host to use for routing e-mail notifications.
SMTP server port number – the port number to use for contacting the SMTP host.
Sender e-mail – the return e-mail address to which notification replies are sent.
Recipient e-mail – the e-mail addresses to which notifications are sent.
Message severity for e-mail alerts – the minimum severity level that must exist before an e-mail notification is sent.

If you choose not to have e-mail alerts or severity messages logged, select No. Click Next.

Review the installation summary.

The installer displays the selections you have made. Review the information, and click Next.

Complete the installation.

If the software is installed successfully, a final window appears, indicating a successful installation. It also advises you to read the configuration guides for configuration information, and the release bulletin for last-minute information about the Sybase DI Suite, and check for software updates on the Sybase download Web page.

Click Finish to exit the installer.

If you encounter errors during installation, check the di_log.txt file in the installation directory, to see a record of the installation process and to troubleshoot the errors.

After successful installation: