Deploying TM1 Application Server to 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.
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.
- 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.
Open the WebSphere administrative console.
- In Windows, click . Or, go to https://localhost:9043/ibm/console/.
- In UNIX, click . Or, go to https://localhost:9043/ibm/console/.
Log in using the WebSphere profile that you
The administrative console opens.
Set the JVM stack memory size.
- Click .
- Click the server where you are deploying TM1 Application Server.
- Under Server Infrastructure, click .
- Under Additional Properties, click Java Virtual Machine.
In the Generic JVM arguments field, add
DANGERDo not deploy TM1 Application Server until you have set the stack memory.
Do not use the startServer.sh file to set the stack memory size. WebSphere removes the
-Xmsosetting from the file when the server starts and overrides it with the default value, which is too small.
- Click Apply, and then click OK. Click Save.
- Click New Enterprise Application. , and then click
- Click Browse to locate and select the pmpsvc.war file that you generated using the Build Application File command in Cognos Configuration. Click Open.
- Click Next.
- Click Fast Path, and then click Next.
- Click Step 4: Map context roots for Web modules.
- In the Context Root box, enter /pmpsvc. Click Next.
WebSphere installs the application. This process can take a few minutes to complete.
When installation is complete, WebSphere displays "Application pmpsvc_war installed successfully."
- Click Save.
- Click .
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."