CAM-CRP-0016 Unable to process the configuration data in the cryptographic engine

This error message can occur when Cognos® Analytics is bundled with a product that connects to an external database. When you create a data server connection to the database, the password for the database is stored in an encrypted file. However, if the database password changes, the data server connection no longer works.

Initially, the following message appears:

The IBM Cognos gateway is unable to connect to the IBM Cognos Analytics server. The server may be unavailable or the gateway may not be correctly configured.

Another, more precise error message appears in the file cogaudit.log:

CAM-CRP-0016 Unable to process the configuration data in the cryptographic engine.<errorCode>-13</errorCode>CAM-CRP-0277 Unable to open the key store file '/data/ibm/cognos/analytics/cgi-bin/../configuration/encryptkeypair/jEncKeystore'.

Resolving the problem

When the database password changes, you must update the database password file for the bundled product, encrypt it, and then use it to replace the encrypted password file in the Cognos Analytics environment.

For example, to resolve this issue when Cognos Analytics is bundled with IBM Maximo, follow these steps:

  1. In the Maximo environment, update the database password file.
    1. Go to Maximo_installation_location\reports\cognos\analytics\configuration
    2. Edit the file mxcognosdatasources.properties.
    3. Change the database password in this line:
      maximoDataSource.password=cognos_password
  2. Encrypt the password file.
    1. Go to Maximo_installation_location\reports\cognos\tools
    2. Run encryptproperties.cmd (in Windows)

      OR

      Run encryptproperties.sh (in UNIX/Linux)

    A new, encrypted password file mxcognosdatasources_enc.properties appears in Maximo_installation_location\reports\cognos\analytics\configuration

  3. Replace the old encrypted password file in the Cognos Analytics environment with the one you just created.
    1. Copy the file mxcognosdatasources_enc.properties from Maximo_installation_location\reports\cognos\analytics\configuration
    2. Paste the copied file into this folder: Cognos_Analytics_installation_location\configuration
    3. Rename the copied file mxcognosdatasources_enc.properties to mxcognosdatasources.properties

    The old encrypted password file is overwritten by the new one.

  4. In Cognos_Analytics_installation_location\configuration, grant full read/write privileges to the files csk and cogconfig.prefs.
  5. Restart the Cognos and Maximo services.