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. See “Installing DI Suite components from the SPDC”.

If you are installing using the DI Suite installation media:

Insert the DI Suite installation media.

The setup program should start automatically. If it does not start automatically, start the program manually by selecting Run from the Windows Start menu. Browse to setup.exe.
The Welcome window displays. Click Next to proceed.

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.

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 either deploy the license to an existing license server, if one exists, or install a new license server if you have not installed one yet. Click Back and select “Use previously deployed license server” on the installer if you have deployed the license to an existing license server. Click Next to install a new license server.
    
    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” 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 installing the license server on a platform that is not supported by DI Suite 1.2, 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.
- Proceed Installation Without Providing License Key – if you do not have licenses for any of the DI Suite components, you can select this option, and click Next to proceed. The installer allows you to install and use the DI Suite components without a license for a grace period of 30 days. To continue using these components after the end of the grace period, obtain valid licenses from the SPDC, and install these licenses using the DI Suite License Installer. See “Installing licenses for components under grace period”.
For more information on SySAM licensing, see the Sybase Software Asset Management User’s Guide.
The installer displays a list of licensed and unlicensed components. You can select to install the components without licenses, however these components will stop working at the end of 30 days unless, you obtain and install the appropriate licenses for each.

Review and verify the list. Click Next.

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

Since you can install 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 does not display this screen. The “Individual Data Integration Suite Components” option is selected by default and you are automatically taken to the next screen.

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.

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.

For some of the components, the new version does not overwrite the previously installed version. It gets installed in a separate 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.

To select all the displayed components for installation, click Select All Components. Click Next.

The installer window displays (Licensed) against the licensed components, and (No License) against the components without licenses.

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 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.

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.

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

Whether you selected Full or Custom, the installer displays the components without licenses and provides a warning that these components will be installed but will stop working at the end of 30 days if appropriate licenses are not obtained and installed by then. Click Next.

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

For RepConnector

Select the application server where you want to install RepConnector:
- RepConnector for Sybase EAServer
- RepConnector for BEA WebLogic
  
  Click Next.
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.
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 admininstration account (Username and Password) – your WebLogic user name and password.
For successful installation of RepConnector on BEA Weblogic, you must perform some additional tasks after finishing the procedure defined in this section. See “Completing RepConnector installation on BEA WebLogic”.

For Sybase ASE Active Messaging Enter or select an existing Adaptive Server Enterprise (ASE) installation directory and click Next.

Sybase ASE Active Messaging supports 32-bit version of ASE 12.5.4 ESD #6 or later, 32-bit version of ASE 15.0.2 GA or later, and 64-bit versions of ASE 15.0.2 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 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 a value between 1024 and 65535.
Container RMI Port	Identifies the port number on which the hub container RMI service will run. Enter a value between 1024 and 65535.
Hyena Port	The port number on which the Hyena Web server will run. Enter a 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	Reenter 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 a value between 1024 and 65535. Container RMI Port – identifies the port number on which the hub container RMI service will run. Enter a value between 1024 and 65535.
Satellite Container	Container ID – identifies the unique container ID. Enter a value between 2 and 99. Container RMI Port – identifies the port number on which the hub container RMI service will run. Enter a value between 1024 and 65535. Container Port – identifies the port number on which the satellite container will run. Enter a 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 a 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 a 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 – reenter the Web administrator password.

For Data Federation

If you have selected to install the Grid Server, the installer provides you an option to configure the grid domain controller. To configure the grid domain controller, provide this information:

Grid Domain Name – the name assigned to the new grid domain can contain up to 30 alphanumeric characters, including underscores and periods.
Grid Domain Controller Host – name of the host on which you plan to install the grid server. The host name must be reachable on the network via DNS or IP address at the time the grid domain controller is configured.

Click Next.

If you are upgrading from an earlier version of DI Suite, do not configure the grid domain controller.

The SySAM notification window prompts you to configure e-mail notifications for SySAM events. When configuration is enabled, you receive information about license management events that require attention. Select the Configure SySAM E-mail Alert option 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.

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

If the software is installed successfully, a final window appears, indicating a successful installation. It also advises you to read the configuration guides, 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: