IBM Support

Deploying the RMI Registry (rmireg.war) in WebSphere 6.0 and 6.1

Technote (FAQ)

This document applies only to the following language version(s):

Language Independent


What is the procedure for deploying the RMIREG.WAR file to separate the RMI registry from any of the Maximo application server members


Not documented in installation and deployment guides


Note: for information on deploying the rmireg.war file for Maximo in WebSphere 7.0, see the link for Deploying the RMI Registry (rmireg.war) in WebSphere 7.0 for Windows below.

Building the RMI Registry WAR file

With the release of Maximo 6.0 Patch 01, IBM Maximo added the ability to create a stand-alone RMI registry through a web application. The tool used to build the rmireg.war file is <maximo_home>/deployment/buildrmiregwar.cmd. This tool uses the settings in the
<maximo_home>/applications/maximo/properties/ file to build a war (Web Archive) file with the necessary parameters to run in the Maximo environment.

To generate the necessary war file, first modify the file (see the document entitled "Understanding the Maximo implementation of RMI "). When the properties file has been properly modified, execute the<maximo_home>/deployment/buildrmiregwar.cmd to build the <maximo_home>/deployment/default/rmireg.war file.

RMI Definitions

RMI stands for “Remote Method Invocation”. Java developers created this standardized system for using Java objects in a separate memory area from the one calling the remote object. Separate memory areas can reside on the same physical system or on different systems connected by a network.

RMI uses JRMP (Java Remote Method Protocol) to travel over networks to the remote server being called.

For an in-depth tutorial on RMI from Oracle, see

Any time there is more than one Maximo application deployed in a single environment or there is a vertically clustered environment for Maximo the rmireg.war file should be deployed. This will prevent the inadvertent loss of RMI communications if Maximo members are shut down or recycled.

The attached document explains how to deploy the rmireg.war file using IBM WebSphere.


1. Q. Do you set JVM memory parameters for the RMI Registry?
A. It is not necessary to set memory for the RMI Registry.

2. Q. Can the same RMIRegistry Web Application Server be used for two different Maximo installations on the same Node?
A. The RMI Registry is connected to the default_host. This Virtual Host contains all ports used for applications servers on the WebSphere instance. Therefore, it is not necessary to create more than one RMIRegistry application server.

3. Q. When deploying the Maximo application, should we map the rmiregistry to all four Maximo modules (along with webserver and application server)?
A. No, it is a stand-alone Web Application to be used by all Maximo instances on this WebSphere instance.

Related information

Understanding the Maximo implementation of RMI
Remote Method Invocation
Deploying the RMI Registry in WebSphere 7.0

Cross reference information
Segment Product Component Platform Version Edition
Systems and Asset Management Tivoli Asset Management for IT Not Applicable
Systems and Asset Management Tivoli Change and Configuration Management Database Not Applicable
Systems and Asset Management Maximo Asset Management Not Applicable
Systems and Asset Management Tivoli Service Request Manager

Historical Number


Document information

More support for: Maximo Asset Management
System Related

Software version: 6.2.1, 6.2.2, 6.2.3, 6.2.4, 6.2.5, 6.2.6, 6.2.7, 6.2.8, 7.1, 7.1.1

Operating system(s): AIX, HP-UX, Linux, Solaris, Windows

Reference #: 1291015

Modified date: 29 December 2010

Translate this page: