Configuring Controller Web

You must configure three IBM® Controller Web components.

Before you begin

Install IBM Controller and select the following check boxes:
  • Controller Web
  • Controller Web Frontend
  • Controller GLASS UI
Note: Starting from IBM Controller version 11.1.0, it is no longer possible to perform a distributed installation of IBM Controller Web. All IBM Controller Web components must be installed on the same server.

Procedure

  1. Find the server.env file in the installation directory.
    The default directory path is C:\Program Files\ibm\cognos\ccr_64\fcmweb\wlp\etc\.
  2. Open server.env and set the JAVA_HOME installation directory to the location of the jre folder.
    The default location of the jre folder is JAVA_HOME=C:/Program Files/ibm/cognos/ccr_64/fcmweb/jre.
  3. Open a command prompt window and run SyncDBConf.bat with the following parameters:
    UDL files folder
    Path to the folder that contains the UDL files (specifying database connections) defined for Controller
    Data source folder
    Output path for the folder that contains the data sources that are generated from the UDL files
    Note: You must have administrator permission to run this file.

    This file synchronizes Controller Web with the Uniform Data Language (UDL) files that are defined for databases used by Controller Web.

    For example, 
    cd C:\Program Files\ibm\cognos\ccr_64\fcmweb\
SyncDBConf.bat ..\Data wlp\usr\shared\config\datasources
  4. Locate the com.ibm.cognos.fcm.web.properties file in the installation directory.
  5. Open com.ibm.cognos.fcm.web.properties and set the following values:
    • ccrwsUrl=<the WSSUrl to which /ccrws.asmx is appended>. For example, ccrwsUrl=http://myControllerServer/ibmcognos/controllerserver/ccrws.asmx.
    • loginMode=NATIVE
  6. Optional: You can change the available memory by doing the following steps:
    1. Find the jvm.options file in the C:\Program Files\IBM\cognos\ccr_64\fcmweb\wlp\etc\ folder.
    2. Change the Xms/Xmx settings.
  7. Open the Microsoft Windows Service Manager console, find IBM Controller Web, and start the service.
  8. Find the config.js file in C:\Program Files\IBM\cognos\ccr_64\frontend.
  9. Open the file in a text editor and make the following changes:
    1. Change the proxies – options – target – host parameter to the FQDN of the application server that is running Controller Web
      The parameter proxies – options – target refers to the connection to Controller Web Backend.
      For example, host: myhost.domain.com.
    2. Change the expressJs – host parameter to the address through which you want to access Controller Web UI service (FQDN/IP/machine name).
      Change the expressJs – port parameter to the port through which you want to access Controller Web UI service. Current default value is 9085.
      The expressJs parameter configures the way the Controller Web UI service is exposed.
      For example, host: myhost.domain.com.
      Change the expressJs – glassHost parameter to the FQDN of the application server that is running IBM Controller UI service (FQDN/IP/machine name).
      Change the expressJs – glassPort parameter to the port through which you want to access IBM Controller UI service. Current default value is 9080.
  10. If the IBM Controller UI service default installation path has changed, follow these steps:
    1. Find the server.env file of fcm.glass in the installation directory. This file can be found in the fcmweb folder. The default directory path is C:\Program Files\ibm\cognos\ccr_64\fcmweb\wlp\usr\servers\fcm.glass. Correct the values of the following variables:
      • Correct the values for STATIC_RESOURCE_PATHS. It should point to the build folder of pa_controller_data and pa_controller_home_data separated by a comma. The default path of pa_controller_data build folder is C:/Program Files/ibm/cognos/ccr_64/frontend/pa_controller_data/build. The default path of pa_controller_home_data build folder is C:/Program Files/ibm/cognos/ccr_64/frontend/pa_controller_home_data/build.
      • Correct the values for PERSPECTIVE_PATHS. It should point to the perspectives folder of pa_controller_data and pa_controller_home_data separated by a comma. The default path of pa_controller_data perspectives folder is C:/Program Files/ibm/cognos/ccr_64/frontend/pa_controller_data/perspectives and the default path of pa_controller_home_data perspectives folder is C:/Program Files/ibm/cognos/ccr_64/frontend/pa_controller_home_data/perspectives.
    2. Find the bootstrap.properties file of the fcm.glass file in the installation directory. This file can be found in the fcmweb folder. The default directory path is C:\Program Files\ibm\cognos\ccr_64\fcmweb\wlp\usr\servers\fcm.glass. Edit the value for the http.port file. It should point to the port on which IBM Controller UI service is supposed to be hosted. The default value of the port is 9080.
  11. Save the file.
  12. Open the Microsoft Windows Service Manager console, find IBM Controller Web, IBM Controller Web UI, and IBM Controller UI and start the services.
  13. Open a web browser, enter the following URL, and log in to Controller Web:
    http://[servername]:9085/