Cognos Analytics

Cognos Analytics

Connect, learn, and share with thousands of IBM Cognos Analytics users! 

 View Only

CAMTool - A utility tool to diagnose and debug CAM related issues

By Patrick Neveu posted 17 days ago

  

When you want to retrieve useful information about CAM, it can sometimes be tedious.

There is a utility tool called CAMTool.jar located in <cognos_location>\bin64 that will help to diagnose and debug CAM related issues. If you are curious, you can take a look at the MANIFEST.MF file, you will see :

Main-Class: com.cognos.accman.jcam.utilities.CAMTool.CAMTool

Open a command prompt and run the following commands:

cd <cognos_location>\bin64

"..\ibm-jre\jre\bin\java.exe" -cp "CAMTool.jar;..\bin\*" -Djava.library.path="..\bin64" com.cognos.accman.jcam.utilities.CAMTool.CAMTool

A graphical tool is launched:

CSK Keys button lists all the names of CSK keys in your local CSK key store:
CSK keys in CAM CSK keystore (CSKKeystore)
1: alias = G0DibvveSjKFmAbcTvNCDvRiPgw=; expiry date = Sat Feb 27 09:17:23 CET 2027; algorithm = AES; key size = 256

CA certificates button lists all trusted CA certificates in your trust store. The first certificate (not shown here) is Cognos root CA certificate. It is useful to check validity.

Encryption certificates button shows encryption certificate or certificate chain. The encryption certificates are used for SSL and requesting newest CSK from Content Manager.

Signing certificates button shows signing certificate or certificate chain.

Check Cognos Analytics connection URLs button checks connection URLs in configuration XML. It will display the following:

1: Connecting to http://<cognos_server>:9300/p2pd/servlet/dispatch... Connected OK. HTTP return code = 200
1: Sending message to http://<cognos_server>:9300/p2pd/servlet/dispatch... Return value (freshness) for testing is 147
 
2: Connecting to http://<cognos_server>:9300/bi/v1/disp... Connected OK. HTTP return code = 200
2: Sending message to http://<cognos_server>:9300/bi/v1/disp... Return value (freshness) for testing is 147

Load CAM libraries button will load and check CAMCrypto JNI libraries. It will display the following:

Loading CAM_Crypto_Interface  at  C:\Cog1212\bin64  ...
Successfully Loaded CAM_Crypto_Interface.
 
Loading CAM_Crypto_POpenSSL  at  C:\Cog1212\bin64  ...
Successfully Loaded CAM_Crypto_POpenSSL.
 
Loading CCLCore  at  C:\Cog1212\bin64  ...
Successfully Loaded CCLCore.
Loading gsk8km_64  at  C:\Cog1212\bin64  ...
Successfully Loaded gsk8km_64.
 
Loading gsk8ssl_64  at  C:\Cog1212\bin64  ...
Successfully Loaded gsk8ssl_64.
The Run all above commands button runs all diagnose tests and saves the results to a text file named 'camcrypto_diagnose.txt' at the same location of the CAMTool command. This may take several minutes.
The command lines were tested with IBM Cognos Analytics version 12.0.4 IF1 and version 12.1.2.
0 comments
14 views

Permalink