Installing the stand-alone Controller client

You can download the stand-alone Controller client.

Before you begin

The stand-alone Controller client (download link) is not enabled by default. To enable it, follow the instructions:
  1. Find the config.js file in the installation directory. The default directory path is C:\Program Files\ibm\cognos\ccr_64\frontend.
  2. Open the config.js file in a text editor.
  3. The existing customers, make the following change in the config.js file:
    1. In the 'expressJs' parameter, to enable the Remote Client function, change the value of "enableClient" from false to true.
  4. The new customer, make the following changes in the config.js file:
    1. In the 'Proxies - target - host' parameter:
      1. Locate the "host": "{hostname}" line.
      2. Change it to "host": "myserver.companyname.com".
    2. In the 'expressJs' parameter:
      1. Locate the "host": "{publicInterface}", //interface used by Controller Web UI service line.
      2. Change it to "host": "myserver.companyname.com", //interface used by Controller Web UI service.
      3. To enable the remote client functions, change the value of "enableclient" from false to true.
    3. In the 'expressJsReact' parameter:
      1. Locate the "host": "localhost", //interface used by Controller Web UI service line.
      2. Change it to "host": "myserver.companyname.com", //interface used by Controller Web UI service.
    4. Verify whether the "host": "myserver.companyname.com" is updated at all the three instances.
  5. Save the config.js file.
  6. Open the Microsoft Windows Service Manager console, find IBM® Controller Web UI, and start the service.
Note: The installation of the standalone Controller client will also install the Excel link.

Procedure

  1. Ensure that your computer meets each of these prerequisites:
    • You uninstalled Controller excel link.
    • You installed Microsoft Excel for Microsoft 365.
    • You installed Microsoft Edge Runtime.
    • You installed Microsoft .Net 4.5 or later.
  2. In a browser window, log in to Controller Web.
  3. Download the installer:
    1. On the landing page, click the User icon user icon.
    2. From the User list, click Controller Client.
    3. In the Controller Client License Information window, select I agree.
      The file CCRRemoteClient64.msi is downloaded to your computer.
  4. Install the Controller Client:
    1. Double click the file CCRRemoteClient64.msi
    2. When prompted for the WSS URL, enter https://your_controller_server/ibmcognos/controllerserverand then click Next.
      Important: Cloud users must use https instead of http.
    3. Select the destination folder, and then click Next.
    4. Select default values in the remaining installation windows, and then click Finish.
  5. Open the IBM Controller application.
  6. Select the database.
  7. Enter your Username and Password, and then click Login.
    Important: It may take a minute or two for the login to finish. Do not click in Controller or navigate to another application during this time.

Results

You should now be able to connect to IBM Controller.

Note: If you cannot connect to Controller Client, it may be related to an incorrect registry setting. If you continue to experience an issue with your Controller Client installation, uninstall it completely, and then reinstall it.