------
README
------

Date:  July, 2003


Patch:  P510W-01A


Update:  GSKIT 6.0.4.41


Component: SSL for IBM Directory Server (IDS) version 5.1


General description:

    The version of GSKIT provided with IBM Directory Server 5.1 does not
    correctly operate for creating a new key database file.  This archive
    includes an updated GSKIT.  The updated GSKIT corrects the problem and
    allows for creating new key database files.

Applying the fix:


    The set of instructions below include commands which are to be invoked in
    a command prompt window.  Obtain a command prompt window before proceeding.

    1). The provided archive is named gsk6bas.zip.  Use an unzip utility to
        extract the contents of the archive into a temporary folder.  Make sure
        the temporary folder has no prior files before unzipping the archive.

    2). The unzip will result in two files - gsk6bas.exe and readme.  The
        file gsk6bas.exe is a self-extracting executable.  Extract the files
        from the self-extracting executable.  Assuming the temporary folder
        is named c:\temp, the command sequence below is an example of how to
        perform this step.

        #  c:
        #  \temp
        #  gsk6bas .

    3). Now install the GSKIT.  Use the command listed below.

        #  setup LDAP -s -f1 setup.iss


        The label LDAP is used in the registry and is important for
        the uninstall step.


    4). Modify the PATH environment variable to include the string listed
        below:

        c:\program files\ibm\gsk6\bin;c:\program files\ibm\gsk6\lib


        To set the environment variable in the current command prompt window,
        use the command listed below:

        #  set PATH=%PATH%;c:\program files\ibm\gsk6\bin;c:\program files\ibm\gsk6\lib

        To establish the PATH environment variable system-wide,  use the control
        panel to modify the environment variable.


    5). If the PATH environment variable was set in the current command window,
        the installation can be verified as complete by issuing the command
        listed below:

        # gsk6ver

        What will result is a long sequence of lines, and the final set of lines
        are seen as:

        KJNI
        ============
        @(#)CompanyName:      IBM Corporation
        @(#)LegalTrademarks:  IBM
        @(#)FileDescription:  IBM Global Security Toolkit
        @(#)FileVersion:      6.0.4.41

        (etc)

        If the lines are seen, the GSKIT 6 package has been installed correctly.


    After successful installation,  use gsk6ikm to begin the procedure of
    creating a keyring database file.


Uninstalling the fix:


    To uninstall the GKSIT package, at a command prompt, issue the command
    below:

        #  gsk6BUI LDAP


Addendum:

    The filesize for the self-extracting executable is:  gsk6bas.exe  6280936
    The crc value, using the unix command sum -r is:     gsk6bas.exe  26173


-------------
END OF README
-------------