Deploying TM1 Application Server to a WebSphere Application Server

You can deploy and run IBM® TM1® Application Server to an IBM 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 progress. After the start 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.

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 move to another administrative console page without first clicking Cancel on an application installation page.


  1. Verify that you have a minimum of 6 GB of free disk space on the computer where WebSphere is installed.
    On UNIX, ensure that the disk mounted to /tmp has at least 6 GB available. Use df to check both the total space and percent used for tmpfs.
    Note: Do not deploy TM1 Application Server until you have verified that sufficient disk space is available.
  2. 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/.
  3. Log in using the WebSphere profile that you created.
    The administrative console opens.
  4. Set the JVM stack memory size.
    1. Click Servers > Server Types > WebSphere application servers.
    2. Click the server where you are deploying TM1 Application Server.
    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.
      Do not deploy TM1 Application Server until you have set the stack memory.

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

    When installation is complete, WebSphere displays "Application pmpsvc_war installed successfully."

  12. Click Save.
  13. Click Applications > Application Types > WebSphere Enterprise Applications.
  14. Select the check box next to pmpsvc_war, and then click Start.
    WebSphere displays "Application pmpsvc_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

See What if my TM1 Application Server deployment fails with a Java heap space error?