E. Add the required Vault parameters for the CMPIVaultPlugin.

Add the required Vault parameters to allow the HCM database to map the user ID to the host ID.
top Graphic Image
Use the Vault.xml file located in the WAR file as a reference for adding parameters when editing the web.xml file.
  1. The following parameters contain all the relevant information needed to connect to your HCM database, which in this example is a JDBC database table. You can either configure access to an existing database or point to a newly created database. The level of security for the database varies according to database vendor. Refer to the database application's documentation for details.

    CMPI_VAULT_DB_ADDRESS
    This is a URL string that provides the address of the database. An example of this string is jdbc:db2://dtagw:6789/ZIESSO.
    Code example:
    <init-param> 
       <param-name>CMPI_VAULT_DB_ADDRESS</param-name>  
    	 <param-value>jdbc:db2://dtagw.raleigh.hcl.com:6789/ZIESSO
    		</param-value> 
    </init-param>
    CMPI_VAULT_DB_NET_DRIVER
    This string contains the name of the class that acts as the network database driver. An example of this string is COM.ibm.db2.jdbc.net.DB2Driver. The location of this class is assumed to be in the existing class path.
    Code example:
    <init-param> 
       <param-name>CMPI_VAULT_DB_NET_DRIVER</param-name> 
       <param-value>COM.ibm.db2.jdbc.net.DB2Driver</param-value> 
    </init-param>
    CMPI_VAULT_DB_USERID
    This is the ID of the user account to use when accessing the database.
    Code example:
    <init-param> 
       <param-name>CMPI_VAULT_DB_USERID</param-name> 
       <param-value>admin</param-value> 
    </init-param>
    CMPI_VAULT_DB_PASSWORD
    This is the password of the user account to use when accessing the database.
    top Graphic Image
    This parameter should be encrypted using the encrypt password tool. It is decrypted by the HCM plug-in before using it. For more information about the password encryption tool, refer to Password encryption tool.
    Code example:
    <init-param> 
       <param-name>CMPI_VAULT_DB_PASSWORD</param-name> 
       <param-value>tuBu9v8lHiJi1jt08UgHzA==</param-value> 
    </init-param> 
    CMPI_VAULT_DB_TABLE
    This entry identifies the table to use for the needed query.
    Code example:
    <init-param> 
       <param-name>CMPI_VAULT_DB_TABLE</param-name> 
       <param-value>HACP</param-value> 
    </init-param>
  2. The following parameters should correspond directly to the column headings in your HCM database and should clearly indicate the contents of the columns. With some databases, such as IBM DB2, the column headings must be in all upper-case letters, for example, NETWORKID, HOSTADDRESS, HOSTID, and PASSWORD.

    Based on the information provided by the first two of these parameters (network ID and host address), you can make a SQL query of the database to get the host ID. The result of the query is entered in the host ID (HOSTID) column. Assuming that the query is successful, a call is made to the vault-style database to request the password.

    CMPI_VAULT_DB_NETID_COL_NAME
    This entry identifies the name of the column that contains the network ID value (NETWORKID).
    Code example:
    <init-param> 
       <param-name>CMPI_VAULT_DB_NETID_COL_NAME</param-name> 
       <param-value>NETWORKID</param-value> 
    </init-param>
    CMPI_VAULT_DB_HOSTADDR_COL_NAME
    This entry identifies the name of the column that contains the host address value (HOSTADDRESS).
    Code example:
    <init-param> 
       <param-name>CMPI_VAULT_DB_HOSTADDR_COL_NAME</param-name> 
       <param-value>HOSTADDRESS</param-value> 
    </init-param>
    CMPI_VAULT_DB_HOSTADDR_COL_NAME
    This entry identifies the name of the column that contains the host address value (HOSTADDRESS).
    Code example:
    <init-param> 
       <param-name>CMPI_VAULT_DB_HOSTADDR_COL_NAME</param-name> 
       <param-value>HOSTADDRESS</param-value> 
    </init-param>
    CMPI_VAULT_DB_HOSTAPP_COL_NAME
    This entry identifies the name of the column that contains the host application value (APPLICATIONID).
    Code example:
    <init-param> 
       <param-name>CMPI_VAULT_DB_HOSTAPP_COL_NAME</param-name> 
       <param-value>APPLICATIONID</param-value> 
    </init-param>
    CMPI_VAULT_DB_HOSTID_COL_NAME
    This entry identifies the name of the column that contains the user's host identification value (HOSTID).
    Code example:
    <init-param> 
       <param-name>CMPI_VAULT_DB_HOSTID_COL_NAME</param-name> 
       <param-value>HOSTID</param-value> 
    </init-param>
    CMPI_VAULT_DB_HOSTPW_COL_NAME
    This entry identifies the name of the column that contains the host password value (PASSWORD).
    Code example:
    <init-param> 
       <param-name>CMPI_VAULT_DB_HOSTPW_COL_NAME</param-name> 
       <param-value>PASSWORD</param-value> 
    </init-param>