Creating a key database

Use GSKit iKeyman utility to create a key database file for storing the certificate for the trusted Certificate Authority of your LDAP server's certificates.

To use the iKeyman utility, you must set the JAVA_HOME environment variable. See Setting the JAVA_HOME environment variable.

The following variable is used in path specifications in this topic:
RATIONAL_COMMON
Directory where the Rational common files are installed

To create a key database file, perform the following steps on your administrative computer:

  1. In Windows® Explorer, navigate to the \Program Files\IBM\GSK7\bin directory and double-click gsk7ikm.exe. The iKeyman GUI opens.
  2. Click Key Database File > New. The New window opens.
  3. Select CMS in the Key database type list.
    1. Enter a name for the key database file in the File Name field. At runtime, Rational® ClearQuest® can use several methods to find the key database file. If all other methods fail, ClearQuest looks for a key database file named ldapkey.kdb in the default location:
      On Windows:
      install-drive:\%RATIONAL_COMMON%
      On the UNIX system and Linux:
      /$RATIONAL_COMMON

      See Distributing the key database file for details about how ClearQuest finds the key database file.

    2. Enter the path name for the directory that contains the key database file in the Location field. Click OK. The Password Prompt window opens.
  4. Enter a password for accessing the key database file in the fields Password and Confirm Password.
    1. Select the Stash the password to a file? check box, which stores an encrypted version of the password in a file with a .sth extension. The Ikeyman utility stores the file in the same location as the key database file and uses the same root name as the key database file. For example, if you named the key database file ldapkey.kdb, the password stash file is ldapkey.sth.
    2. Click OK.

Feedback