Bookshelf Home | Contents | Index | PDF     

Security Guide for Siebel Business Applications > Security Adapter Authentication > Installing LDAP Client Software >

Installing the IBM LDAP Client and GSKit on Windows

This section describes different methods of installing the IBM LDAP Client and GSKit on Microsoft Windows platforms.

The IBM LDAP Client and GSKit software are available from the Siebel network image. For instructions on how to create a Siebel network image, see Siebel Installation Guide for the operating system you are using.

NOTE:  After you install the content of ids510fp2refresh-windows-client-us.zip, examine the contents of the other zip files in Windows\Server_Ancillary\IBM_LDAP_5.1_Client\enu. These zip files contain patches that resolve various issues. The Readme file in each zip file describes the issue resolved and how to install the patch. Install a patch if required.

Installing with InstallShield GUI on Windows

Use the procedure below to install the IBM LDAP Client and GSKit on Windows platforms using the InstallShield GUI.

In the procedure below, if the installation program exits without displaying the language window after Step 6, this might be caused by one of the following:

  • Backlevel video drivers. Update your video drivers to correct this.
  • Not enough space in the directory specified by the TEMP environment variable. Be sure that you have at least 100 MB of free space in this directory.

NOTE:  If you use the InstallShield GUI to install, you must also use it to uninstall.

To install IBM LDAP Client and GSKit on Windows—InstallShield GUI

  1. On the computer where you are installing the IBM LDAP Client, stop any programs that are running and close all windows.
  2. Navigate within the Siebel network image to the directory Windows\Server_Ancillary\IBM_LDAP_5.1_Client\enu.
  3. Unzip the file that is stored there, such as by running the following command:

    unzip ids510fp2refresh-windows-client-us.zip

  4. Navigate to the unzip directory, such as, for example:

    C:\Documents and Settings\Administrator\Local Settings\Temp\ids510fp2refresh-windows-client

  5. Navigate to the ids_ismp subdirectory.
  6. Run setup.exe.

    The language window is displayed.

  7. Select the language you want to use during IBM LDAP Client installation. Click OK.

    This is the language used in the installation program, not in the IBM LDAP Client itself. You choose the language used in the IBM LDAP Client in Step 13.

  8. On the Welcome window, click Next.

    If you have a previous version of the IBM LDAP Client installed on your system, you are asked if you want to continue with the installation.

  9. Click Yes to install over the previous version, or click No to exit the installation program.
  10. After reading the software license agreement, click the option "I accept the terms in the license agreement." Click Next.
  11. Any preinstalled components and corresponding version levels are displayed. Click Next.
  12. To install to the default directory, click Next. To specify a different installation location, click Browse.

    NOTE:  Do not use special characters, such as hyphen (-) and period (.), in the name of the installation directory. If you do not use the default location, use a name such as ldap or ldapdir. Do not use a name such as ldap-dir or ldap.dir.

  13. Select the language you want to use in the IBM LDAP Client software. Click Next.
  14. Click Custom, and click Next.

    A list of available components is displayed.

  15. Select both displayed options: Client SDK (LDAP Client) and GSKit. Click Next.

    NOTE:  If you are sure that SSL will never be enabled for your LDAP Client, you can deselect GSKit here.

    A window summarizing the components selected for installation and configuration is displayed.

  16. If you want to change your selection, click Back. To begin installing, click Next.
  17. After the files are installed, the Client README file opens. Click Next.
  18. Specify whether to restart your computer now or later. Click Finish.

You have completed installation of IBM LDAP Client and IBM GSKit.

Installing with InstallShield Console on Windows

Use the procedure below to install the IBM LDAP Client and GSKit on Windows platforms using the InstallShield console. The steps for installing using the InstallShield console are similar to those for installing using the InstallShield GUI.

To install IBM LDAP Client and GSKit on Windows—InstallShield console

  1. Perform Step 1 through Step 5.
  2. In the ids_ismp directory, run the following command:

    setup -is:javaconsole -console

  3. Perform the remaining user interactions through the console rather than the GUI.

Installing with InstallShield Unattended Mode on Windows

Use the procedures below to install the IBM LDAP Client and GSKit on Windows platforms using the InstallShield unattended mode. Separate procedures are provided for installing IBM LDAP Client and IBM GSKit.

To install IBM LDAP Client on Windows—InstallShield unattended mode

  1. Perform Step 1 through Step 5.
  2. In the ids_ismp directory, run the following command:

    .\setup.exe -is:silent -options .\optionsFiles\InstallClient.txt

    This command installs the IBM LDAP Client to the directory C:\Program Files\IBM\LDAP.

  3. To change the installation location, modify the file .\optionsFiles\InstallClient.txt.

    For example, if you want to install the LDAP Client under D:\Program Files\IBM\LDAP, edit the file to include the following:

    # install destination - this can be modified to install location
    -P product.installLocation="D:\Program Files\IBM\LDAP"

To install IBM GSKit on Windows—InstallShield unattended mode

  1. Perform Step 1 through Step 4.
  2. Navigate to the gskit subdirectory.
  3. Run the following command:

    .\SETUP.EXE LDAP -s -f1 .\setup.iss

    This command installs IBM GSKit to the directory C:\Program Files\IBM\GSK6.

  4. To change the installation location, modify the file setup.iss.

    For example, if you want to install GSKit under D:\Program Files\IBM\GSK6, edit the file to include the following:

    [SdAskDestPath-0]
    szDir=D:\Program Files\IBM\GSK6

To uninstall IBM GSKit on Windows—InstallShield unattended mode

  • To uninstall IBM GSKit when it was previously installed with unattended mode, run the following command at the command line:

    gsk6BUI LDAP

Verifying Installation on Windows

Use the procedure below to verify that IBM LDAP Client and GSKit were successfully installed.

To verify installation on Windows

  1. Choose Start > Settings > Control Panel > Add or Remove Programs.
  2. Verify that entries are listed for the IBM LDAP Client, and for IBM GSKit.
  3. Verify that appropriate libraries are installed:
    1. Verify that ldap.dll exists under installation_location\LDAP\bin.
    2. Verify that gsk6ssl.dll exists under installation_location\GSK6\lib.

Uninstalling with InstallShield on Windows

If you have used InstallShield to install IBM LDAP Client and GSKit, you must also use it to uninstall these components.

To uninstall the IBM LDAP Client and GSKit using InstallShield

  1. Choose Start > Settings > Control Panel > Add or Remove Programs.
  2. Select IBM Directory Server 5.1 (or the version appropriate to your installation).
    
Security Guide for Siebel Business Applications