Separation of Maximo industry solution install and configuration actions

Maximo Industry Solution installation programs will, by default, install and configure the product during the installation process. The automated installation and configuration of the industry solution is usually the best way to deploy the product. It is faster, easier, and less error prone than manually configuring the product. However the installation process can be separated into distinct install versus configuration actions. The industry solution can first be installed and then later configured by updating the Maximo database, building the EAR files, and deploying the EAR files. The separation of installation and configuration supports the separation of personnel responsibilities that may exist in an organization. The install administrator can install the product, the database administrator can update the Maximo database, and the application server administrator can build and deploy the Maximo and Maximo help system EAR files.

Installing the product

Follow the steps in the installation program and when the Package Options window opens, check the following check boxes:

1. Defer the Update of the Maximo Database
2. Defer Maximo Application Redeployment

These defer options will defer the configuration of the industry solution. Continue the steps in the installation program to complete the installation.

Configuring the product after a successful installation

To configure the product, complete the following tasks:

1. Update the Maximo Database
2. Build the EAR files
3. Deploy the EAR files

The following sections describe how to perform each task.

Step 1: Updating the Maximo database

Whenever you select the Defer the Update of the Maximo Database option in the installation program, then you must manually update the Maximo database.

Procedure

1. Open a command prompt and change the directory to install_directory\maximo\tools\maximo.
2. Run the updatedb -v1 command.

Step 2: Building EAR files

Whenever you select the Defer the Update of the Maximo Database or the Defer Maximo Application Redeployment options in the installation program, then you must build the Maximo Enterprise Archive (EAR) files manually. The EAR files should only be built after the Maximo database has been successfully updated so complete the manual update of the database by running the updatedb command before you build the EAR files. There are two EAR files: maximo.ear and maximoiehs.ear

Procedure

1. To build the Maximo EAR file, navigate to the following directory and run the command:

   install_directory\maximo\deployment\buildmaximoear.cmd

2. To build the Maximo help system EAR file, navigate to the following directory and run the command:

   install_directory\maximo\deployment\buildmxiehsear.cmd

Step 3: Deploying the EAR files

Deploying EAR files on WebSphere Application Server

Whenever you select the Defer the Update of the Maximo Database or the Defer Maximo Application Redeployment options in the installation program, then you must deploy the EAR files manually. The EAR files should only be deployed after the Maximo database has been successfully updated and the EAR files have been rebuilt so complete the manual update of the database by running the updatedb command and the manual build of the EAR files by running the buildmaximoear and buildmxiehsear commands before you deploy the EAR files.

Procedure

When you deploy the Maximo EAR file and when you deploy the Maximo help system EAR file, you use the following variables:

WASAdminUserName: A WebSphere Application Server Network Deployment account with deployment privileges.
WASAdminPassword: The password of the user who is specified in the WASAdminUserName parameter.
WASNodeName: The name of the WebSphere Application Server Network Deployment node.
WASApplicationServerName: The name of the WebSphere Application Server Network Deployment application server.
WASVirtualHost: The name of the WebSphere Application Server Network Deployment virtual host.
WASWebServerName: The name of the WebSphere Application Server Network Deployment web server.

1. Deploy the Maximo EAR file:

   install_directory\jacl\solutions\DeployApplication.bat WASAdminUserName WASAdminPassword "MAXIMO" WASNodeName 
   WASApplicationServerName "install_directory\maximo\deployment\default\maximo.ear" WASVirtualHost WASWebServerName

2. Deploy the Maximo help system EAR file:

   install_directory\jacl\solutions\DeployApplication.bat WASAdminUserName WASAdminPassword "MAXIMOIEHS" WASNodeName 
   WASApplicationServerName "install_directory\maximo\deployment\default\maximoiehs.ear" WASVirtualHost WASWebServerName

   Note: If you encounter authorization issues after manually deploying the EAR files, then you need to map users to roles or groups as described in this technote http://www-01.ibm.com/support/docview.wss?uid=swg21321974

Deploying EAR files on WebLogic Server

Whenever you select the Defer the Update of the Maximo Database or the Defer Maximo Application Redeployment options in the installation program, then you must deploy the EAR files manually. The EAR files should be deployed only after the Maximo database has been successfully updated and the EAR files have been rebuilt, so complete the manual update of the database by running the updatedb command and the manual build of the EAR files by running the buildmaximoear and buildmxiehsear commands before you deploy the EAR files.

Procedure

1. Change to the mydomain directory.
   1. On Windows operating system: From a command prompt, change the path to drive:\Oracle_installation_location\user_projects\domain\mydomain
   2. On UNIX and Linux operating system: Open a command prompt, and change the path to Oracle_installation_location/user_projects/domains/mydomain
2. Start WebLogic Server.
   1. On Windows operating system: startWebLogic.cmd
   2. On UNIX and Linux operating system: ./startWebLogic.sh
3. Enter the WebLogic Server user name and password.
4. Start the MAXIMOSERVER administration console by entering the following URL in the address bar of your browser: http://hostname:7001/console
5. Log on to the WebLogic Server console.
6. Follow the instructions in the WebLogic Server console help to deploy the maximo.ear file and the maximoiehs.ear file.