Deploying Cognos TM1 Operations Console to use an IBM WebSphere Application Server

Deprecated in v2.0.9 Use the IBM® WebSphere® administrative console to deploy and run TM1 Operations Console on a WebSphere Application Server.

Before you begin

  • Install IBM WebSphere Application Server.
  • Create a profile using the Profile Management Tool.
  • Start the WebSphere Application Server using the profile that you created.

    In Microsoft Windows, click Start > All Programs > IBM WebSphere Application Server > Profiles > [Profile Name] > Start the server.

    A command window opens and displays the start up progress. After the start up process is complete, the command window displays the message, "Server started." You can minimize this command window, but do not close it. This window must remain open while WebSphere is running.

  • Build the application files using Cognos® Configuration. See Building application files for a WebSphere server. Operations Console and Performance Management Hub are contained in the pmhub.war file.

For information about installing WebSphere and creating a profile, see the WebSphere documentation.

About this task

These steps are based on IBM WebSphere Application Server 8.5.5. The steps for version 8.5 are similar.

Note: After you start completing steps in the WebSphere application installation wizard, click Cancel to exit if you decide not to install the application. Do not simply move to another administrative console page without first clicking Cancel on an application installation page.

Procedure

  1. Open the WebSphere administrative console.
    • In Windows, click Start > All Programs > IBM WebSphere Application Server > Profiles > [Profile Name] > Administrative console. Or, go to https://localhost:9043/ibm/console/.
    • In UNIX, click Applications > IBM WebSphere > IBM WebSphere Application Server > Profiles > [Profile Name] > Admin Console. Or, go to https://localhost:9043/ibm/console/.
  2. Log in using the WebSphere profile that you created.
    The administrative console opens.
  3. Set the JVM stack memory size.
    1. Click Servers > Server Types > WebSphere application servers.
    2. Click the server where you are deploying Operations Console.
    3. Under Server Infrastructure, click Java and Process Management > Process Definition.
    4. Under Additional Properties, click Java Virtual Machine.
    5. In the Generic JVM arguments field, add -Xmso512k.
      Note: Do not deploy Operations Console until you have set the stack memory. If you do so, Operations Console will be deployed but the WebSphere Application Server will not start.

      Do not use the startServer.sh file to set the stack memory size. WebSphere removes the -Xmso setting from the file when the server starts and overrides it with the default value, which is too small.

    6. Click Apply, and then click OK. Click Save.
  4. Click Applications > New Application, and then click New Enterprise Application.
  5. Click Browse to locate and select the pmhub.war file that you generated using the Build Application File command in Cognos Configuration. Click Open.
  6. Click Next.
  7. Click Fast Path, and then click Next.
  8. Click Step 4: Map context roots for Web modules.
  9. In the Context Root box, enter /pmhub. Click Next.
  10. Click Finish.
    WebSphere installs the application. This process can take a few minutes to complete.

    When installation is complete, WebSphere displays Application pmhub_war installed successfully.

  11. Click Save.
  12. Click Applications > Application Types > WebSphere Enterprise Applications.
  13. Select the check box next to pmhub_war, and then click Start.
    WebSphere displays Application pmhub_war on server server_name and node node started successfully. The collection may need to be refreshed to show the current status.

What to do next

The next step is to retrieve SSL certificates from the TM1® Admin Server and TM1 servers.