IBM Support

GSKit V8 - Install, Uninstall and Upgrade instructions for Windows systems

Question & Answer


Question

How to Install, Uninstall or Upgrade of GSKit V8 used with Security/Tivoli Directory Server on Windows systems?

Cause

GSKit V8 provided with Security/Tivoli Directory server needs to be upgraded as part of periodic preventive maintenance.

Answer

Refer to Recommended Fixes for latest recommended level of GSKit for a given version of Security/Tivoli Directory Server.
The required / latest GSKit V8 can be downloaded from IBM Fix Central.

Tab navigation

Windows 32-bit - GSKit V8 - Install Instructions


Use Administrator login for the following procedure.
The following provide instructions for initial installation.
  1. Download the required GSKit V8 file for Windows 32-bit platform from IBM Fix Central.
    The name of the file will be of the form: 8.r.m.f-TIV-GSKIT-Win32-FPnnnn.zip
    Note: r.m.f are release, maintenance and fix level of GSKit V8 and nnnn is the fix level.
  2. After download, transfer(copy) the file to the target Windows system and extract the same:
    For example, consider 8.0.14.14-TIV-GSKIT-Win32-FP0014.zip file downloaded/copied into C:\Temp\gsk8\ folder:


    Right click on the zip file and select "Extract All..."


    Extraction wizard shows up:

    Click Next.

    Update folder to extract files to be "C:\temp\gsk8" (same as where zip files are available)

    Click Next.

    Unselect "Show extracted files".

    Click Finish.

    Note: The above creates a folder with name 8.r.m.f-TIV-GSKIT-Win32-FPnnnn and extracts all files into that folder.
  3. The contents of the folder 8.r.m.f-TIV-GSKIT-Win32-FPnnnn :

    After extracting all files:


    ... > dir *exe
    ...
    10/19/2011 07:15 AM 6,949,032 gsk8crypt32.exe
    10/19/2011 07:16 AM 14,441,768 gsk8ssl32.exe
    ...

    Description of the files:

    For TDS 32 bit Server and Client components:
    Global Security Kit V8.r.m.f for Windows 32-bit Crypto - gsk8crypt32.exe
    Global Security Kit V8.r.m.f for Windows 32-bit SSL - gsk8ssl32.exe
  4. Stop Security/Tivoli Directory Server related processes (ibmdiradm and ibmslapd) and any other processes (such as TAM) which use gskit.
  5. First install GSKit8 Crypt 32-bit by running gsk8crypt32.exe:
    The following panel shows up after initialization:

    Click Next.

    Select appropriate destination folder by choosing Browse option (in case if you would like to customize the install location of GSKit) OR leave the default install location:

    Click Next.


    Click Install.

    After successful completion of installation, the following shows up.

    Click Finish.
  6. Then Install GSKit SSL 32-bit by running gsk8ssl32.exe:
    The following panel shows up after initialization:

    Click Next.

    Select appropriate destination folder by choosing Browse option (in case if you would like to customize the install location of GSKit) OR leave the default install location:

    Click Next.


    Click on Install.

    Upon successful completion of installation the following shows up.

    Click Finish.
  7. Verify the registry:

    C:\> reg query HKLM\SOFTWARE\IBM\GSK8\CurrentVersion /s
  8. Start Security/Tivoli Directory Server related processes (ibmdiradm and ibmslapd) and any other processes (such as TAM) which use gskit.


Windows 32-bit - GSKit V8 - Uninstall Instructions


Use Administrator login for the following procedure.
  1. Stop Security/Tivoli Directory Server related processes (ibmdiradm and ibmslapd) and any other processes (such as TAM) which use gskit.
  2. Important NOTES:
    - The GSKit v8 may not be completely uninstalled from a system while DB2 v9.7 installed.
    - DB2 V9.7 installs GSKit V8 as merge module, whereas TDS 6.3 installs GSKit V8 as separate product.
    - In order to upgrade to a later level of GSKit v8 just use the upgrade procedure above.
  3. First uninstall GSKit 8 SSL 32-bit using:
    Windows Start -> Control Panel -> Add/Remove Programs -> GSKit8 SSL 32-bit.

    Click Remove.

    Confirm by Clicking Yes.


    After successful uninstall, the "GSKit8 SSL 32-bit" entry from Add or Remove Programs Panel gets deleted.
  4. Then uninstall GSKit8 Crypt 32-bit by using:
    Add/Remove Programs -> GSKit8 Crypt 32-bit.

    Click Remove.

    Confirm by Clicking Yes.


    After successful uninstall, the "GSKit8 Crypt 32-bit" entry from Add or Remove Programs Panel gets deleted.
  5. Verify the registry:
    C:\> reg query HKLM\SOFTWARE\IBM\GSK8\CurrentVersion /s
  6. Manual Uninstall/Removal of GSKit: (Use this method only if the above mentioned method doesn't succeed)
    - Find the InstallPath folder:
    C:\> reg query HKLM\SOFTWARE\IBM\GSK8\CurrentVersion

    - Delete the "InstallPath" folder:
    C:\> rmdir /S /Q "C:\Program Files\ibm\gsk8"

    - Delete the registry:
    C:\> reg delete HKLM\SOFTWARE\IBM\GSK8
    Permanently delete the registry key HKEY_LOCAL_MACHINE\SOFTWARE\IBM\GSK8 (Yes/No)? Yes
    The operation completed successfully.

    - Verify the registry:
    C:\> reg query HKLM\SOFTWARE\IBM\GSK8\CurrentVersion /s


Windows 32-bit - GSKit V8 - Update Instructions


Use Administrator login for the following procedure.
The following provide instructions for update installation.
  1. Download the required GSKit V8 file for Windows 32-bit platform from IBM Fix Central.
    The name of the file will be of the form: 8.r.m.f-TIV-GSKIT-Win32-FPnnnn.zip
    Note: r.m.f are release, maintenance and fix level of GSKit V8 and nnnn is the fix level.
  2. After download, transfer(copy) the file to the target Windows system and extract the same:
    For example, consider 8.0.14.14-TIV-GSKIT-Win32-FP0014.zip file downloaded/copied into C:\Temp\gsk8\ folder:


    Right click on the zip file and select "Extract All..."


    Extraction wizard shows up:

    Click Next.

    Update folder to extract files to be "C:\temp\gsk8" (same as where zip files are available)

    Click Next.

    Unselect "Show extracted files".

    Click Finish.

    Note: The above creates a folder with name 8.r.m.f-TIV-GSKIT-Win32-FPnnnn and extracts all files into that folder.
  3. The contents of the folder 8.r.m.f-TIV-GSKIT-Win32-FPnnnn :

    After extracting all files:


    ... > dir *exe
    ...
    10/19/2011 07:15 AM 6,949,032 gsk8crypt32.exe
    10/19/2011 07:16 AM 14,441,768 gsk8ssl32.exe
    ...

    Description of the files:

    For TDS 32 bit Server and Client components:
    Global Security Kit V8.r.m.f for Windows 32-bit Crypto - gsk8crypt32.exe
    Global Security Kit V8.r.m.f for Windows 32-bit SSL - gsk8ssl32.exe
  4. Stop Security/Tivoli Directory Server related processes (ibmdiradm and ibmslapd) and any other processes (such as TAM) which use gskit.
  5. First update GSKit8 Crypt 32-bit by running gsk8crypt32.exe:
    The following panel shows up after initialization:

    Click Next. This will start the update installation.

    After successful completion of update installation, the following shows up.

    Click Finish.
  6. Then update GSKit SSL 32-bit by running gsk8ssl32.exe:
    The following panel shows up after initialization:

    Click Next. This will start the update installation.

    Upon successful completion of update installation the following shows up.

    Click Finish.
  7. Verify the registry:

    C:\> reg query HKLM\SOFTWARE\IBM\GSK8\CurrentVersion /s
  8. Start Security/Tivoli Directory Server related processes (ibmdiradm and ibmslapd) and any other processes (such as TAM) which use gskit.


Windows X64 - 64-bit GSKit V8 - Install Instructions


Use Administrator login for the following procedure.
The following provide instructions for initial installation.
  1. Download the required GSKit V8 file for Windows 64-bit platform from IBM Fix Central.
    The name of the file will be of the form: 8.r.m.f-TIV-GSKIT-WinX64-FPnnnn.zip
    Note: r.m.f are release, maintenance and fix level of GSKit V8 and nnnn is the fix level.
  2. After download, transfer(copy) the file to the target Windows system and extract the same:
    For example, consider 8.0.14.14-TIV-GSKIT-WinX64-FP0014.zip file downloaded/copied into C:\Temp\gsk8\ folder:


    Right click on the zip file and select "Extract All..."


    Extraction wizard shows up:

    Click Next.

    Update folder to extract files to be "C:\temp\gsk8" (same as where zip files are available)

    Click Next.

    Unselect "Show extracted files".

    Click Finish.

    Note: The above creates a folder with name 8.r.m.f-TIV-GSKIT-WinX64-FPnnnn and extracts all files into that folder.
  3. The contents of the folder 8.r.m.f-TIV-GSKIT-WinX64-FPnnnn :

    After extracting all files:


    Under 32 folder:


    Under 64 folder:


    Description of the files:

    For TDS 64 bit Server and 64 bit Client components on Windows 64-bit system:
    Global Security Kit V8.r.m.f for Windows 64-bit Crypto - gsk8crypt64.exe
    Global Security Kit V8.r.m.f for Windows 64-bit SSL - gsk8ssl64.exe

    For TDS 32 bit Client components on Windows 64-bit system:
    Global Security Kit V8.r.m.f for Windows 32-bit Crypto - gsk8crypt32.exe
    Global Security Kit V8.r.m.f for Windows 32-bit SSL - gsk8ssl32.exe
  4. The remaining part of the instructions below provide initial installation method for 64-bit GSKit.
  5. Stop Security/Tivoli Directory Server related processes (ibmdiradm and ibmslapd) and any other processes (such as TAM) which use gskit.
  6. First install GSKit8 Crypt 64-bit by running gsk8crypt64.exe:
    The following panel shows up after initialization:

    Click Next.

    Select appropriate destination folder by choosing Browse option (in case if you would like to customize the install location of GSKit) OR leave the default install location:

    Click Next.


    Click Install.

    After successful completion of installation, the following shows up.

    Click Finish.
  7. Then Install GSKit SSL 64-bit by running gsk8ssl64.exe:
    The following panel shows up after initialization:

    Click Next.

    Select appropriate destination folder by choosing Browse option (in case if you would like to customize the install location of GSKit) OR leave the default install location:

    Click Next.


    Click on Install.

    Upon successful completion of installation the following shows up.

    Click Finish.
  8. Verify the registry:

    C:\> reg query HKLM\SOFTWARE\IBM\GSK8\CurrentVersion /s
  9. Start Security/Tivoli Directory Server related processes (ibmdiradm and ibmslapd) and any other processes (such as TAM) which use gskit.


Windows X64 - 64-bit GSKit V8 - Uninstall Instructions


Use Administrator login for the following procedure.
  1. Stop Security/Tivoli Directory Server related processes (ibmdiradm and ibmslapd) and any other processes (such as TAM) which use gskit.
  2. Important NOTES:
    - The GSKit v8 may not be completely uninstalled from a system while DB2 v9.7 installed.
    - DB2 V9.7 installs GSKit V8 as merge module, whereas TDS 6.3 installs GSKit V8 as separate product.
    - In order to upgrade to a later level of GSKit V8 just use the upgrade procedure.
  3. First uninstall GSKit 8 SSL 64-bit using:
    Windows Start -> Control Panel -> Add/Remove Programs -> GSKit8 SSL 64-bit.

    Click Remove.

    Confirm by Clicking Yes.


    After successful uninstall, the "GSKit8 SSL 64-bit" entry from Add or Remove Programs Panel gets deleted.
  4. Then uninstall GSKit8 Crypt 64-bit by using:
    Add/Remove Programs -> GSKit8 Crypt 64-bit.

    Click Remove.

    Confirm by Clicking Yes.


    After successful uninstall, the "GSKit8 Crypt 64-bit" entry from Add or Remove Programs Panel gets deleted.
  5. Verify the registry:
    C:\> reg query HKLM\SOFTWARE\IBM\GSK8\CurrentVersion /s
  6. Manual Uninstall/Removal of GSKit: (Use this method ONLY if the above mentioned method doesn't succeed)
    - Find the InstallPath folder:
    C:\> reg query HKLM\SOFTWARE\IBM\GSK8\CurrentVersion

    - Delete the "InstallPath" folder:
    C:\> rmdir /S /Q "C:\Program Files\ibm\gsk8"

    - Delete the registry:
    C:\> reg delete HKLM\SOFTWARE\IBM\GSK8
    Permanently delete the registry key HKEY_LOCAL_MACHINE\SOFTWARE\IBM\GSK8 (Yes/No)? Yes
    The operation completed successfully.

    - Verify the registry:
    C:\> reg query HKLM\SOFTWARE\IBM\GSK8\CurrentVersion /s


Windows X64 - 64-bit GSKit V8 - Update Instructions


Use Administrator login for the following procedure.
The following provide instructions for initial installation.
  1. Download the required GSKit V8 file for Windows 64-bit platform from IBM Fix Central.
    The name of the file will be of the form: 8.r.m.f-TIV-GSKIT-WinX64-FPnnnn.zip
    Note: r.m.f are release, maintenance and fix level of GSKit V8 and nnnn is the fix level.
  2. After download, transfer(copy) the file to the target Windows system and extract the same:
    For example, consider 8.0.14.14-TIV-GSKIT-WinX64-FP0014.zip file downloaded/copied into C:\Temp\gsk8\ folder:


    Right click on the zip file and select "Extract All..."


    Extraction wizard shows up:

    Click Next.

    Update folder to extract files to be "C:\temp\gsk8" (same as where zip files are available)

    Click Next.

    Unselect "Show extracted files".

    Click Finish.

    Note: The above creates a folder with name 8.r.m.f-TIV-GSKIT-WinX64-FPnnnn and extracts all files into that folder.
  3. The contents of the folder 8.r.m.f-TIV-GSKIT-WinX64-FPnnnn :

    After extracting all files:


    Under 32 folder:


    Under 64 folder:


    Description of the files:

    For TDS 64 bit Server and 64 bit Client components on Windows 64-bit system:
    Global Security Kit V8.r.m.f for Windows 64-bit Crypto - gsk8crypt64.exe
    Global Security Kit V8.r.m.f for Windows 64-bit SSL - gsk8ssl64.exe

    For TDS 32 bit Client components on Windows 64-bit system:
    Global Security Kit V8.r.m.f for Windows 32-bit Crypto - gsk8crypt32.exe
    Global Security Kit V8.r.m.f for Windows 32-bit SSL - gsk8ssl32.exe
  4. The remaining part of the instructions below provide update installation method for 64-bit GSKit.
  5. Stop Security/Tivoli Directory Server related processes (ibmdiradm and ibmslapd) and any other processes (such as TAM) which use gskit.
  6. First update install GSKit8 Crypt 64-bit by running gsk8crypt64.exe:
    The following panel shows up after initialization:

    Click Next. This will start the update installation.

    After successful completion of installation, the following shows up.

    Click Finish.
  7. Then update install GSKit SSL 64-bit by running gsk8ssl64.exe:
    The following panel shows up after initialization:

    Click Next. This will start the update installation.

    Upon successful completion of installation the following shows up.

    Click Finish.
  8. Verify the registry:

    C:\> reg query HKLM\SOFTWARE\IBM\GSK8\CurrentVersion /s
  9. Start Security/Tivoli Directory Server related processes (ibmdiradm and ibmslapd) and any other processes (such as TAM) which use gskit.


Windows X64 - 32-bit GSKit V8 - Install Instructions


Use Administrator login for the following procedure.
The following provide instructions for initial installation.
  1. Download the required GSKit V8 file for Windows 64-bit platform from IBM Fix Central.
    The name of the file will be of the form: 8.r.m.f-TIV-GSKIT-WinX64-FPnnnn.zip
    Note: r.m.f are release, maintenance and fix level of GSKit V8 and nnnn is the fix level.
  2. After download, transfer(copy) the file to the target Windows system and extract the same:
    For example, consider 8.0.14.14-TIV-GSKIT-WinX64-FP0014.zip file downloaded/copied into C:\Temp\gsk8\ folder:


    Right click on the zip file and select "Extract All..."


    Extraction wizard shows up:

    Click Next.

    Update folder to extract files to be "C:\temp\gsk8" (same as where zip files are available)

    Click Next.

    Unselect "Show extracted files".

    Click Finish.

    Note: The above creates a folder with name 8.r.m.f-TIV-GSKIT-WinX64-FPnnnn and extracts all files into that folder.
  3. The contents of the folder 8.r.m.f-TIV-GSKIT-WinX64-FPnnnn :

    After extracting all files:


    Under 32 folder:


    Under 64 folder:


    Description of the files:

    For TDS 64 bit Server and 64 bit Client components on Windows 64-bit system:
    Global Security Kit V8.r.m.f for Windows 64-bit Crypto - gsk8crypt64.exe
    Global Security Kit V8.r.m.f for Windows 64-bit SSL - gsk8ssl64.exe

    For TDS 32 bit Client components on Windows 64-bit system:
    Global Security Kit V8.r.m.f for Windows 32-bit Crypto - gsk8crypt32.exe
    Global Security Kit V8.r.m.f for Windows 32-bit SSL - gsk8ssl32.exe
  4. The remaining part of the instructions below provide initial installation method for 32-bit GSKit on 64 bit windows servers.
  5. Stop Security/Tivoli Directory Server Client related processes and any other processes (such as TAM) which use gskit.
  6. First install GSKit8 Crypt 32-bit by running gsk8crypt32.exe:
    The following panel shows up after initialization:

    Click Next.

    Select appropriate destination folder by choosing Browse option (in case if you would like to customize the install location of GSKit) OR leave the default install location:

    Click Next.


    Click Install.

    After successful completion of installation, the following shows up.

    Click Finish.
  7. Then Install GSKit SSL 32-bit by running gsk8ssl32.exe:
    The following panel shows up after initialization:

    Click Next.

    Select appropriate destination folder by choosing Browse option (in case if you would like to customize the install location of GSKit) OR leave the default install location:

    Click Next.


    Click on Install.

    Upon successful completion of installation the following shows up.

    Click Finish.
  8. Verify the registry:

    C:\> reg query HKLM\SOFTWARE\Wow6432Node\IBM\GSK8 /s
  9. Start Security/Tivoli Directory Server Client related processes and any other processes (such as TAM) which use gskit.


Windows X64 - 32-bit GSKit V8 - Uninstall Instructions


Use Administrator login for the following procedure.
  1. Stop Security/Tivoli Directory Server Client related processes and any other processes (such as TAM) which use gskit.
  2. Important NOTES:
    - The GSKit v8 may not be completely uninstalled from a system while DB2 v9.7 installed.
    - DB2 V9.7 installs GSKit V8 as merge module, whereas TDS 6.3 installs GSKit V8 as separate product.
    - In order to upgrade to a later level of GSKit V8 just use the upgrade procedure.
  3. First uninstall GSKit 8 SSL 32-bit using:
    Windows Start -> Control Panel -> Add/Remove Programs -> GSKit8 SSL 32-bit.

    Click Remove.

    Confirm by Clicking Yes.


    After successful uninstall, the "GSKit8 SSL 32-bit" entry from Add or Remove Programs Panel gets deleted.
  4. Then uninstall GSKit8 Crypt 32-bit by using:
    Add/Remove Programs -> GSKit8 Crypt 32-bit.

    Click Remove.

    Confirm by Clicking Yes.


    After successful uninstall, the "GSKit8 Crypt 32-bit" entry from Add or Remove Programs Panel gets deleted.
  5. Verify the registry:
    C:\> reg query HKLM\SOFTWARE\Wow6432Node\IBM\GSK8 /s
  6. Manual Uninstall/Removal of GSKit: (Use this method ONLY if the above mentioned method doesn't succeed)
    - Find the InstallPath folder:
    C:\> reg query HKLM\SOFTWARE\Wow6432Node\IBM\GSK8 /s

    - Delete the "InstallPath" folder:
    C:\> rmdir /S /Q "C:\Program Files (x86)\ibm\gsk8\"

    - Delete the registry:
    C:\> reg delete HKLM\SOFTWARE\Wow6432Node\IBM\GSK8
    Permanently delete the registry key HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\IBM\GSK8 (Yes/No)? Yes
    The operation completed successfully.

    - Verify the registry:
    C:\> reg query HKLM\SOFTWARE\Wow6432Node\IBM\GSK8 /s


Windows X64 - 32-bit GSKit V8 - Update Instructions


Use Administrator login for the following procedure.
The following provide instructions for initial installation.
  1. Download the required GSKit V8 file for Windows 64-bit platform from IBM Fix Central.
    The name of the file will be of the form: 8.r.m.f-TIV-GSKIT-WinX64-FPnnnn.zip
    Note: r.m.f are release, maintenance and fix level of GSKit V8 and nnnn is the fix level.
  2. After download, transfer(copy) the file to the target Windows system and extract the same:
    For example, consider 8.0.14.14-TIV-GSKIT-WinX64-FP0014.zip file downloaded/copied into C:\Temp\gsk8\ folder:


    Right click on the zip file and select "Extract All..."


    Extraction wizard shows up:

    Click Next.

    Update folder to extract files to be "C:\temp\gsk8" (same as where zip files are available)

    Click Next.

    Unselect "Show extracted files".

    Click Finish.

    Note: The above creates a folder with name 8.r.m.f-TIV-GSKIT-WinX64-FPnnnn and extracts all files into that folder.
  3. The contents of the folder 8.r.m.f-TIV-GSKIT-WinX64-FPnnnn :

    After extracting all files:


    Under 32 folder:


    Under 64 folder:


    Description of the files:

    For TDS 64 bit Server and 64 bit Client components on Windows 64-bit system:
    Global Security Kit V8.r.m.f for Windows 64-bit Crypto - gsk8crypt64.exe
    Global Security Kit V8.r.m.f for Windows 64-bit SSL - gsk8ssl64.exe

    For TDS 32 bit Client components on Windows 64-bit system:
    Global Security Kit V8.r.m.f for Windows 32-bit Crypto - gsk8crypt32.exe
    Global Security Kit V8.r.m.f for Windows 32-bit SSL - gsk8ssl32.exe
  4. The remaining part of the instructions below provide update installation method for 32-bit GSKit on 64 bit windows servers.
  5. Stop Security/Tivoli Directory Server Client related processes and any other processes (such as TAM) which use gskit.
  6. First update install GSKit8 Crypt 32-bit by running gsk8crypt32.exe:
    The following panel shows up after initialization:

    Click Next. This will start the installation.

    After successful completion of installation, the following shows up.

    Click Finish.
  7. Then update install GSKit SSL 32-bit by running gsk8ssl32.exe:
    The following panel shows up after initialization:

    Click Next. This will start the installation.

    Upon successful completion of installation the following shows up.

    Click Finish.
  8. Verify the registry:

    C:\> reg query HKLM\SOFTWARE\Wow6432Node\IBM\GSK8 /s
  9. Start Security/Tivoli Directory Server Client related processes and any other processes (such as TAM) which use gskit.


[{"Product":{"code":"SSVJJU","label":"IBM Security Directory Server"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"General","Platform":[{"code":"PF033","label":"Windows"}],"Version":"6.3;6.3.1;6.4","Edition":"","Line of Business":{"code":"LOB24","label":"Security Software"}}]

Document Information

Modified date:
16 June 2018

UID

swg21631462