IBM Support

Manually Installing and Configuring WebSphere 9.0.x for Maximo 7.6.0.6+

Technical Blog Post


Abstract

This is the first in a series of How To documents that provide step-by-step set of instructions to install the 7.6.0 version of Maximo Asset Management with WebSphere Application Server 9.0.x and DB2 version 11.x

Body

WebSphere Configuration Tasks


 
1. Create WebSphere Profiles

To make profiles that are the same as those that the Maximo Configuration Tool creates, follow these steps.

Launch Profile Management Tool

WebSphere Customization Toolbox
Click Create...

  • Environment: Select Cell (deployment manager and a federated application server)
  • Profile Creation Options: Select Advanced profile creation and click Next
  • Optional Application Deployment: Untick deploy the default application check box and click Next
  • Deployment manager profile name: Change Dmgr01 to ctgDmgr01
  • Application server profile name: Change AppSrv01 to ctgAppSrv01

Click Next

Node, Host, and Cell Names

  • Deployment manager node name: Change <hostname>CellManager01 to ctgCellManager01
  • Application server node name: Change <hostname>Node01 to ctgNode01
  • Hostname: keep
  • Cell name: Change <hostname>Cell01 to ctgCell01

Click Next

Enable Administrative security

  • User name: wasadmin
  • Password: wasadmin
  • Confirm password: wasadmin

Click Next

Security Certificate (Part 1)

  • Keep defaults. Click Next.

Security Certificate (Part 2)

  • The default keystore password is WebAS. If you want to change it, do it here.

Port Values Assignment (Part 1)

  • Deployment manager ports. Keep defaults. Click Next.

Port Values Assignment (Part 2)

  • Node agent ports. Keep defaults. Click Next.

Port Values Assignment (Part 3)

  • Application server ports. This server is deleted later. Keep defaults. Click Next.

Web Service Definition

  • Keep defaults. Click Next.

Web Server Definition (Part 1)

  • Create a Web server definition. Keep defaults. Click Next.

Web Server Definition (Part 2)

  • Change paths if necessary. Click Next.

Profile Creation Summary

  • Click Create.

Clear the Launch the First steps console checkbox and click Finish.

 
2. Configure the WebSphere Plug-In

Launch Web Server Plug-ins Configuration Tool

Web Server Plug-ins Configuration Tool

Under Web Server Plug_in Runtime Locations, click Add...

  • For name, type in IHS_Plugin
  • For Location, type in <WebSphere_Home>\Plugins
  • Click Finish.

image

Under Web Server Plug_in Configurations, click Create...

Note: Be careful on these pages. As with the Maximo Configuration Tool, WebSphere Configuration Toolbox (WCT) does not pull values from IBM Installation Manager's product installation database. The populated values are suggested only.

Web Server Selection: choose IBM HTTP server and click Next.

Web Server Configuration File Selection: Select the existing IBM HTTP Server httpd.conf file, located in <IHS_Home>\conf\httpd.conf. Leave the web server port at 80. Click Next.

Setup IBM HTTP Server Administration Server: Leave HTTP Administration Port at 8008. You can create a User ID and password on this screen, or clear the Create a User ID checkbox and configure the authentication later. Click Next.

Setup IBM HTTP Server Administration Server: Specify whether you want to IBM HTTP Server Administration Server to run as a service, the log on user to start the server and if you want it to start Automatically or Manual. Click Next.

Web Server Definition Name: The unique web server definition name must match the name supplied at the Web Server steps when the profile was created. Click Next.

Configuration Scenario Selection: If your Application Server exists on a different machine than your web server, choose Remote and enter the Hostname or IP address of the Application Server. For this example, the Application server is on the same system, so we chose Local and pointed to <WebSphere_Home>\AppServer. Click Next.

WebSphere Application Server Profile Selection: Choose your Application Server profile (ctgAppServ01). Click Next.

Click Configure. When it completes, click Finish.

image

Close the WebSphere Customization Toolbox window.

3. Create Windows Services

Start an Administrative command-line session and navigate to <WebSphere_Home>\AppServer\bin. Run wasservicehelper.bat

  • Menu Options: At (default 1)[q to Quit], click Enter
  • Profile: At select number next to the profile [q to Quit]: enter 1 and click Enter
  • Servers: At select number next to server [q to Quit]: enter 1 and click Enter
  • Service Name: At [q to Quit], enter ctgNode01 and click Enter
  • Restart Policy: At (default 1)[q to Quit], click Enter
  • Start Type: At (Default 1)[q to Quit], click Enter
  • WebSphere Security: At (default N)[Y/N][q to Quit], enter Y and click Enter. Username and password are wasadmin.
  • Log on user: default N[q to Quit], click Enter
  • Execute: At (default=Yes) [Y/N][q to Quit], click Enter
  • Menu Options: At (default 1)[q to Quit], enter q and click Enter

Open Windows services, or refresh it if already open. IBM WebSphere Application Server V9.0 - ctgCellManager01 is now available. Right-click and select Properties. Click Start.

Windows Services

Back at the Command Window prompt, run wasservicehelper.bat again.

Menu Options: At (default 1)[q to Quit], click Enter
Profile: At select number next to the profile [q to Quit]: enter 2 and click Enter
Servers: At select number next to server [q to Quit]: enter 1 and click Enter
Service Name: At [q to Quit], enter ctgNode01 and click Enter
Restart Policy: At (default 1)[q to Quit], click Enter
Start Type: At (Default 1)[q to Quit], click Enter
WebSphere Security: At (default N)[Y/N][q to Quit], enter Y and click Enter. Username and password are wasadmin.
Log on user: default N[q to Quit], click Enter
Execute: At (default=Yes) [Y/N][q to Quit], click Enter
Menu Options: At (default 1)[q to Quit], enter q and click Enter

Open Windows services, or refresh it if already open. IBM WebSphere Application Server V9.0 - ctgNode01 is now available. Click Start.

Windows Services with both WAS services

Java SDK

Start an Admin command line prompt session and navigate to <WebSphere_Home>\AppServer\bin and run managesdk -listavailable
It should show something like the following:

C:\IBM\WebSphere\AppServer\bin>managesdk -listavailable
CWSDK1003I: Available SDKs :
CWSDK1005I: SDK name: 8.0_64
CWSDK1001I: Successfully performed the requested managesdk task.

C:\IBM\WebSphere\AppServer\bin>

WebSphere 9.0 only runs Java 8.

4. Basic WebSphere console configuration

Start a browser session. Go to the WebSphere console, https://<fully qualified hostname>:9043/ibm/console

  • On the left, Expand Server > Server Types, and click Application servers.
  • On the right, select server1 and delete it.
  • On the left, expand System administration and click Deployment manager.
  • On the right, expand Java and Process Management and click Process Definition.
  • Under Additional Properties, Click Java virtual machine.
  • Clear the verbose garbage collection checkbox. Change Initial and Maximum heap size to 1024 MB.
  • Optional: On the left, click Console Preferences. Check Synchronize changes with Nodes and click apply.

Log out of WebSphere console, and exit the browser.

5. WebSphere MXServer configuration

Start a browser session. Go to the WebSphere console, https://<fully qualified hostname>:9043/ibm/console

  • On the left, Expand Server > Server Types, and click Application servers.
  • Click New...
  •    Server name: MXServer
  • Click Next twice, then Finish.
  • Save changes and synchronize nodes.

Click MXServer.

  • On the right, expand Java and Process Management.
  • Click Process Definition.
  • Under Additional Properties, click Java virtual machine.
  • Clear the verbose garbage collection checkbox. Change Initial and Maximum heap size to 6144 MB.
  • For Generic JVM arguments, use -Dsun.rmi.dgc.ackTimeout=10000 -Djava.net.preferIPv4Stack=true -Xmn1536m -Xcodecache32m -Xgcthreads4 -Dmxe.name=MXServer.

Click OK. Save changes and synchronize nodes.

JVM settings

At Application servers > MXServer > Process definition, click MXServer.

  • Under Additional Properties, click Thread pools.
  • Click Default. Change Maximum Size to 50 and Thread inactivity timeout to 30000.
  • Click Apply. Save changes and synchronize nodes.
  • Click WebContainer. Change Minimum Size to 120 and Maximum size to 150.

Click OK. Save changes and synchronize nodes.

image

  • Click MXServer. Under Communications, expand Ports. Note the port numbers for WC_adminhost, WC_defaulthost, WC_adminhost_secure and WC_defaulthost_secure.
  • On the left, expand Environment. Click Virtual hosts.
  • Click New...

Name: maximo_host

Create host aliases:

Port
Hostname
80 <IP address>
80 <hostname>
80 <fully qualified hostname>
* Port WC_adminhost port number
* Port WC_defaulthost port number
* WC_adminhost_secure port number
* WC_defaulthost_secure

Save changes and synchronize nodes.

image

Log out of WebSphere administrative console, and exit the browser.

6. WebSphere JMS Queue configuration (7.6.0.6+ version)

To configure the JMS queues, complete the following steps:

Start a browser session. Go to the WebSphere console, https://<fully qualified hostname>:9043/ibm/console

Create service integration bus(SIBus)

  • On the left, click Service Integration. Click Buses.
  • Click New.
  • Enter intjmsbus as the name of the new bus in the Name field.
  • Clear the Bus security check box.
  • Click Next.
  • Click Finish and Save.
  • Click intjmsbus.
  • Enter SIBus intjmsbus as Description.
  • Click OK and Save.

Add a server to the SIBus

  • Click intjmsbus.
  • Under Topology, click Bus members.
  • Click Add.
  • If not already selected, keep Server option selected, and select ctgNode01:MXServer. Click Next.
  • Check that the Data store radio button is selected, and then click Next.
  • From the Specify data store properties panel, select Use existing data source.
  • For Data source JNDI name, enter jdbc/intjmsds. For Authentication alias, select ctgCellManager01/maxJaasAlias, and click Next.
  • From the Tune application server for messaging performance panel, click Next.
  • Click Finish and Save.

Create the SIBus destinations for queues

To create the Continuous queue inbound bus destination:

  • Click intjmsbus.
  • Under Destination resources, click Destinations. Click New.
  • Leave Queue checked as the destination type and click Next.
  • Type CQINBD in the Identifier field and Continuous Queue Inbound Bus Destination in the Description field. Click Next.
  • If not already selected, select Node=ctgNode01:Server=MXServer.
  • Click Finish and Save.
  • Where Buses > intjmsbus > Destinations is displayed, click intjmsbus.
  • Under Destination resources, click Destinations.
  • Click CQINBD.
  • In Exception destination, select None.

Click OK and Save.

Follow the same steps for these additional SIBus destinations, including setting the Exception destination to None.

Sequential inbound

Identifier SQINBD
Description Sequential Queue Inbound Bus Destination
Node ctgNode01:Server=MXServer

Sequential outbound

Identifier SQOUTBD
Description Sequential Queue Outbound Bus Destination
Node ctgNode01:Server=MXServer

Notification

Identifier NOTFBD
Description Notification Bus Destination
Node ctgNode01:Server=MXServer

Notification Error

Identifier NOTFERRBD
Description Notification Error Bus Destination
Node ctgNode01:Server=MXServer

Create the JMS connection factory

  • On the left side, expand Resources, then expand JMS. Click Connection factories.
  • Select Cell=ctgCell01. Click New.
  • Verify that the Default Messaging Provider is selected and click OK.
  • Enter the following information:
Name intjmsconfact
JNDI name jms/maximo/int/cf/intcf
Description JMS Connection Factory
Bus name intjmsbus

Click OK and Save.

image

Create the JMS Queues

To create the continuous inbound JMS queue:

  • On the left side, expand Resources, then expand JMS. Click Queues.
  • Select Cell=ctgCell01. Click New.
  • Verify that the Default Messaging Provider is selected and click OK.
  • Enter the following information.
Name CQIN
JNDI name jms/maximo/int/queues/cqin
Description Continuous Inbound Queue
Bus name intjmsbus
Queue name CQINBD

Click OK and Save.

Follow the same steps for these additional queues:

Sequential inbound JMS queue

Name SQIN
JNDI name jms/maximo/int/queues/sqin
Description Sequential Inbound Queue
Bus name intjmsbus
Queue name SQINBD

Sequential outbound JMS queue

Name SQOUT
JNDI name jms/maximo/int/queues/sqout
Description Sequential Outbound Queue
Bus name intjmsbus
Queue name SQOUTBD

Notification JMS queue

Name NOTF
JNDI name jms/maximo/int/queues/notf
Description Notification Queue
Bus name intjmsbus
Queue name NOTFBD

Notification error JMS queue

Name NOTFERR
JNDI name jms/maximo/int/queues/notferr
Description Notification Error Queue
Bus name intjmsbus
Queue name NOTFERRBD

Create JMS activation specifications

To create the activation specification for the continuous inbound queue:

  • On the left side, expand Resources, then expand JMS. Click Queues. Click Activation specifications.
  • From the Scope drop-down list, select Cell=ctgCell01.
  • Click New.
  • Select Default messaging provider and then click OK.
  • Enter the following information.
Name intjmsact
JNDI name intjmsact
Description Continuous Inbound Queue JMS Activation Specification
Destination type Queue
Destination lookup jms/maximo/int/queues/cqin
Bus name intjmsbus

Click OK and Save.

Follow the same steps for these additional activation specifications:
 

Activation specification for the notification queue

Name notfact
JNDI name notfact
Description Notification Queue JMS Activation Specification
Destination lookup jms/maximo/int/queues/notf
Destination type Queue
Bus name

intjmsbus

Activation specification for the notification error queue

Name notfacterr
JNDI name notfacterr
Description Notification Error Queue JMS Activation Specification
Destination lookup jms/maximo/int/queues/notferr
Destination type Queue
Bus name

intjmsbus

To create the SIBus destination for the Continuous inbound error queue:

  • On the left, click Service Integration. Click Buses.
  • Click intjmsbus
  • Under Destination resources, click Destinations. Click New.
  • Leave Queue checked as the destination type and click Next.
  • Type CQINERRBD in the Identifier field and Continuous Inbound Error Queue Bus Destination in the Description field. Click Next.
  • If not already selected, select Node=ctgNode01:Server=MXServer.
  • Click Finish and Save.
  • Where Buses > intjmsbus > Destinations is displayed, click intjmsbus.
  • Under Destination resources, click Destinations.
  • Click CQINERRBD.
  • In Exception destination, select the Specify option and enter CQINERRBD as the exception destination value.
  • Make sure the Maximum failed deliveries value to 5.

Click OK and Save.

image

To change the exception destination of CQINBD destination to CQINERRBD:

Click CQINBD.

  • In Exception destination, select the Specify option and enter CQINERRBD as the exception destination value.
  • Make sure the Maximum failed deliveries value to 5.

Click OK and Save.

To create the continuous inbound error JMS queue:

  • On the left side, expand Resources, then expand JMS. Click Queues.
  • Select Cell=ctgCell01. Click New.
  • Verify that the Default Messaging Provider is selected and click OK.
  • Enter the following information.
Name CQINERR
JNDI name jms/maximo/int/queues/cqinerr
Description Continuous Inbound Error Queue
Bus name intjmsbus
Queue name CQINERRBD

Click OK and Save.

image

To create the Activation Specification for the continuous inbound queue:

  • On the left side, expand Resources, then expand JMS. Click Queues. Click Activation specifications.
  • From the Scope drop-down list, select Cell=ctgCell01.
  • Click New.
  • Select Default messaging provider and then click OK.
  • Enter the following information.
Name intjmsacterr
JNDI name intjmsacterr
Description Continuous Inbound Error Queue JMS Activation Specification
Destination type Queue
Destination lookup jms/maximo/int/queues/cqinerr
Bus name intjmsbus

Click OK and Save.

image

WebSphere Application Server installation and configuration for Maximo Asset Management is complete.


Once completed, go to Custom Properties for improving application startup in WebSphere Application Server.

To install DB2 11.1 for Maximo, go to Installing and Configuring DB2 11.1.1 for Maximo 7.6.0.6+

To Maximo 7.6.0.6, go to Installing and Deploying Maximo 7.6.0.6+ to DB2 11.1.1 and WebSphere 9.0.0

[{"Type":"MASTER","Line of Business":{"code":"LOB59","label":"Sustainability Software"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSLKT6","label":"IBM Maximo Asset Management"},"ARM Category":[{"code":"a8m50000000CbKNAA0","label":"Install"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.6.0;7.6.1"}]

UID

ibm11113909