Installing the stand-alone Controller client

You can download the stand-alone Controller client.

Notes:
  • The installation of the standalone Controller client will also install the Excel link.
  • The Excel link is provided in 64-bit format and can be installed only on computers with a 64-bit operating system and a 64-bit version of Microsoft Office. 32-bit versions are not supported.
  • If you are switching from an MSI based installation to the ZIP installation, check the registry for the ADXStartMode entry. If it exists, delete it. For more information, see Uninstalling the stand-alone Controller Client (ZIP installation).

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 are logged into Microsoft account.
    • You installed Microsoft .Net 4.8
      Note: .NET Framework 4.8 is included by default in Windows 10 Version 1903 and newer. For earlier versions of Windows OS, you must manually install .NET Framework 4.8 from the official Microsoft download page.
  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 to proceed.
  4. Install the Controller Client:
    Proceed with the following steps:
    1. Open the Downloads folder or the directory where the ZIP file was saved.
    2. Unzip the downloaded .zip file to a preferred location on your computer.
      Note: Always unzip the installation file into a newly created, empty folder. If you unzip it into a folder that already contains other files, all contents of that folder may be deleted during the uninstallation process.
    3. Inside the extracted folder, double-click the client.bat file to execute the client setup.
    4. When prompted, for the WSS URL, enter https://your_controller_server/ibmcognos/controllerserver and click Enter.
  5. Open the Controller Client.
    Note: Make sure you are logged into Controller Classic before accessing Excel client.
    Proceed with the following steps:
    1. Navigate to the CCRRemoteClient64.zip extracted folder
    2. Double-click CCR.exe to start the application.
    3. Select the database.
    4. Enter your Username and Password, and then click Login.
    Note: If you are accessing the embedded Excel from the Controller application and the Controller tab is missing, please refer to the instructions provided in Controller Tab Missing Under Excel Ribbon or Error on Opening Embedded Excel Link.
    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.