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 .
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.
Procedure
- 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
created.
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
-Xmso512k.
DANGER
Do 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 -Xmso
setting 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 , and then click New Enterprise Application.
-
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.
-
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."
-
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."