Configuring Cognos Command Center for the REST API

Before you use the REST API, you must configure it in IBM® Cognos® Command Center.

1. Open cmd.exe.
2. Configure the REST API port to use HTTPS with the following command:

   netsh http add urlacl url=https://+:<port>/ccc user=<UserThatRunsTheCccServerService>

   • The default REST API port is 9004.
   • The default user for the Cognos Command Center server service is \System.
3. Associate an SSL certificate with the port with the following command:

   netsh http add sslcert ipport=0.0.0.0:<port> certhash=<TumbprintOfSSLCertificate> appid={2129459A-5716-4117-B659-E878745D1AB3}

   • The Cognos Command Center thumb print for the self-signed certificate is 8d3b42ffb30eeb15c76efb51cdd99b56425bb69f.
4. Log on to Cognos Command Center.
5. Click Tools > System Configuration.
6. In the REST API subsystem, set the value of Enable API to true. You can also modify the default port number and the session timeout value, which is in minutes.
7. In the Event Listener subsystem, set the value of Request Queue Length to the maximum number of running and pending asynchronous runs of a process allowed. If this value is 0, asynchronous runs of processes are not available using the REST API.
8. Restart the Cognos Command Center server.