Configuring the server and client environment for Cognos TM1 Applications

Before you use IBM® Cognos® TM1® Applications, you need to specify the Cognos TM1 Admin Host, Cognos TM1 Server, and client user interfaces that you want to use. The first time that you start Cognos TM1 Applications, the program prompts you to configure these options.

Before you begin

Ensure that the Cognos TM1 Admin Server and at least one Cognos TM1 Server is running on the local computer or a remote computer that you can access.

Ensure that each Cognos TM1 Server that you want to use is configured with the required parameter values. For details, see Configuring a Cognos TM1 Server to work with Cognos TM1 Applications .

If you plan to use the Cognos TM1 Application Web client, ensure that you know the web server name and port number where Cognos TM1 Web is running.

Procedure

  1. Start and log in to Cognos TM1 Applications:
    1. In a web browser, type the URL for Cognos TM1 Applications:

      http://localhost:9510/pmpsvc

    2. Replace localhost with the name of the computer where the Cognos TM1 Application Server is installed.
  2. Open the Cognos TM1 Application Configuration page:
    • If this is the first time that Cognos TM1 Applications has been started since the installation, the Cognos TM1 Application Configuration web page opens.
    • If Cognos TM1 Applications has already been configured, you are prompted for a user name and password and then can open the configuration page by clicking the Administer IBM Cognos TM1 Applications icon Administer IBM Cognos TM1 Application button on the toolbar of the Cognos TM1 Applications main page.
  3. In the Admin Host field, enter the name or IP address of the computer where the Cognos TM1 Admin Server is running.
    Note: The Admin Host and Server Name fields appear blank if you have not started the Cognos TM1 Admin Server and at least one Cognos TM1 server.
  4. In the Server Name field, enter the name of the Cognos TM1 Server that you want to use with Cognos TM1 Application.

    For example, the sample Cognos TM1 server is named GO_new_stores.

    Click the Refresh button to refresh the list of available servers.

  5. Select the data contribution clients that you want to use with Cognos TM1 Applications.

    These clients will be available when you create applications with IBM Cognos TM1 Performance Modeler.

    • Include Cognos Insight - Connected - IBM Cognos Insight client using real time processing with the Cognos TM1 server.
    • Include Cognos Insight - Distributed - IBM Cognos Insight client with local processing of data. Data is updated to the Cognos TM1 server only when a commit data action is performed.
    • Include TM1 Application Web - Default client. Processing is in real time with the server. This option uses the data grid and charting client infrastructure from Cognos TM1 Web and requires that you enter a value for the TM1 Application Web URL option.
  6. If you selected the Include TM1 Application Web option, enter a value for the TM1 Application Web URL option.

    This URL points to the Contributor.jsp file on the web server that is hosting Cognos TM1 Web.

    For example:

    http://WebServer:9510/tm1web/Contributor.jsp

    where WebServer is the name of the computer where Cognos TM1 Web is installed.

  7. Click OK.
  8. If prompted, enter the username and password for the server and click Login.
    Tip: Use admin and apple for the user name and password if you are using one of the installed sample databases.

    The Cognos TM1 Applications main page displays. This page appears blank until you build and deploy applications inside of Cognos TM1 Applications. For more details, see the IBM Cognos Performance Modeler and IBM Cognos Insight documentation.

Results

The following message indicates that the Cognos TM1 server that you are using is not properly configured for use with Cognos TM1 Applications:

The new server can be added but it may not be configured with all the options required by IBM Cognos TM1 Applications.

For information on how to configure this server, see Configuring a Cognos TM1 Server to work with Cognos TM1 Applications.