Setting up an agent in the Cognos Command Center server

The agent must be added to the IBM Cognos Command Center and its connection properties must be configured in order for the Cognos Command Center server to interact with the agent.


  1. In the Cognos® Command Center navigation tree, click Setup and Design.
  2. On the Setup and Design tab, click Agents.
  3. To create an agent, either click the New icon New icon or right-click the agent item and click New.
  4. Specify a name for the new agent.
  5. Specify the following properties:
    • Host name For example,
    • Port For example, 443.
    • Platform For example, Windows.
    • Agent user name For example, admin.
    • Agent password For example, the fifty-character password included in the IBM Planning Analytics Welcome Kit..
  6. Click Test the Agent to verify that a connection to the agent is working properly.
    • The agent must be running on the host for a test connection to work.
    • If you see a Host name exceeds maximum length of 50 warning, enter in the Host name field. On the IBM Command Center Server host, edit the %WINDIR%\system32\drivers\etc\hosts file and add the following line:
      Public IP address of your IBM PA environment

What to do next

For more information about creating agents, see Agents (

You can also set up role-based authorization for Cognos Command Center. For more information, see Creating roles (