Installing and Configuring WebSphere 9.0.0 for Maximo 7.6.0.6+ Part 1: WebSphere Configuration

October 26, 2017 Richard Lesses

Part 1. WebSphere Configuration

Download and install WebSphere Application Server 9.0.0.0

See How to install the 7.6.0 version of Maximo Asset Management with WebSphere Application Server 9.0 and DB2 version 11.1.1 and Maximo 7.6.0.6+ and WebSphere 9.0.0 - Getting Started

* Download IBM Installation Manager
* Download WebSphere 9.0.0.0 packages for platform (see Maximo 7.6.0.6+ and WebSphere 9.0.0 - Getting Started article above)
* Install the four WebSphere packages show below.
* Update WebSphere packages to (minimum) 9.0.0.3 using IBM Installation Manager

Update Packages

WebSphere Configuration Tasks

Create WebSphere Profiles

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

Launch Profile Management Tool

image
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: un-tick deploy the default application 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
Host name: 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 will be 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.

Uncheck Launch the First steps console and click Finish.

 

Configure the WebSphere Plug-In

Launch 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...

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 uncheck the Create a User ID and configure the authentication later. Click Next.

Setup IBM HTTP Server Administration Server: Specify if 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 in Host Name 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.

 

Create the Windows Service

In Windows services, start IBM WebSphere application server V9.0 - ctgCellManager01

Start an Admin command line prompt 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 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 should now be present. Click on Start.

image

Java SDK

Start an Admin command line prompt session and navigate to <WebSphere_Home>\AppServer\bin
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.

 

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 on Application servers.
On the right, select server1 and delete it.
On the left, expand System administration and click on Deployment manager.
On the right, expand Java and Process Management and click on Process Definition.
Under Additional Properties, Click on Java Virtual Machine.
Uncheck verbose garbage collection. Change Initial and Maximum heap size to 1024 MB.
Optional: On the left, click on Console Preferences. Check synchronize changes with Nodes and click apply.

Log out of WebSphere console, and exit the browser.

 

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 on Application servers.
Click New...
   Server name: MXServer
Click Next twice, then Finish.
Save changes and synchronize nodes.

Click on MXServer.
On the right, expand Java and Process Management
Click on Process Definition
Under Additional Properties, click on Java Virtual Machine.
Uncheck verbose garbage collection. Change Initial and Maximum heap size to 6144 MB.
For Generic JVM arguments, use -Dsun.rmi.dgc.ackTimeout=10000 -Djava.net.preferIPv4Stack=true -Xdisableexplicitgc -Xgcpolicy:gencon -Xmn1024m -Xcodecache32m -Xgcthreads4 -XX:PermSize=256m -XX:MaxPermSize=256m -Dmxe.name=MXServer

Click OK. Save changes and synchronize nodes.

JVM settings

Above, at Application servers > MXServer > Process definition, click on MXServer.

Under Additional Properties, click on Thread pools.

Click on Default. Change Maximum Size to 50 and Thread inactivity timeout to 30000.

Click Apply. Save changes and synchronize nodes.

Click on WebContainer. Change Minimum Size to 120 and Maximum size to 150.

Click OK. Save changes and synchronize nodes.

image

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

Name: maximo_host

Create host aliases:

Host Name Port
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 console, and exit the browser.

 

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 on Service Integration. Click on 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 on 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.
Keep the Server option selected, and select ctgNode01:MXServer if not already selected. Click Next.
Check that the Data store radio button is selected, and then click Next.
   Alternatively, you can use a file store to store messages by selecting File store. (You must select File store if you did not manually create a data source for the persistent store.) If you do that, accept the defaults to create the file store and skip to the next section.
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 then 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.
Select Node=ctgNode01:Server=MXServer if not already selected.
Click Finish and Save.
Above, where Buses > intjmsbus > Destinations is displayed, click on 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 on 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 on 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 SQOUTBD

Notification error JMS queue

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

Create JMS activation specifications

To create the activation specification for the continuous inbound queue:

On the left side, expand Resources, then expand JMS. Click on Queues. Click on 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 ms/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 on Service Integration. Click on Buses.
Click on 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.
Select Node=ctgNode01:Server=MXServer if not already selected.
Click Finish and Save.
Above, where Buses > intjmsbus > Destinations is displayed, click on 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 create the continuous inbound error JMS queue:

On the left side, expand Resources, then expand JMS. Click on 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 on Queues. Click on 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 installation and configuration is complete.

 

Part 2, Maximo installation, coming soon.

Previous Article
IBM Control Desk 7.6.0.3 fix pack has been released on 18 Sep 2017

The new IBM Control Desk 7.6.0.3 fix pack has been released on 18 Sep 2017. The previous IBM Control Desk 7...

Next Article
My Blog Posts - Mostly

A blog posts for blog posts. Huh. I will be updating this when I post a new entry, not including Interim Fi...

×

Want our latest news? Subscribe to our blog!

Last Name
First Name
Thank you!
Error - something went wrong!