Maximo 7.6.1.2 Installing the feature pack

Installing the feature pack

Use the Maximo Asset Management installation files to install the feature pack.

Before you begin

If you are not using the updateDBLite process, ensure that no database configuration changes are pending. Shut down all Maximo Asset Management applications and backup the database. Copy the Maximo Asset Management directory and save it to another location.

For Microsoft Windows Server, log in as a member of the local Administrators group. If you attempt to upgrade when you are not logged in as an administrator, the installation fails. This feature pack is provided as an Installation Manager compressed file. When the feature pack is installed by using the Installation Manager program, the existing Maximo Asset Management directory structure is overwritten. The feature pack also contains database scripts that modify the existing database.

To reverse the changes, you must restore the earlier version of the Maximo Asset Management directory and database that you saved to another location.

Procedure

1. Download the 7.6.1.2-TIV-MAMMT-FP0002 compressed file. Copy it to the administrative server machine.
2. Run the Installation Manager from the following directory:
   • Windows: Start > All Programs > IBM Installation Manager > IBM Installation Manager
   • UNIX: In the /opt/IBM/InstallationManager/eclipse directory, run the IBMIM command.
3. In the Installation Manager main window, click File > Preferences.
4. Click Add Repository.
5. Add the repository for IBM® Maximo Asset Management. Click OK.
6. In the Preferences dialog box, click OK.
7. Click the Update icon.
8. In the Update Packages dialog, select the IBM Tivoli's process automation suite package group. Click Next.
9. To complete the installation, follow the on-screen instructions.
10. When the installation is complete, exit Installation Manager.
11. To complete the installation, you must configure Maximo Asset Management and rebuild and redeploy the .ear file. See the Configuring the Maximo Asset Management 7.6.1.2 feature pack section of this readme for details on this process.

What to do next

Before users use the updated software, delete the web browser cache on every computer that uses the product.

Configuring the feature pack

You can configure the feature pack by using the automated user interface (UI) configuration tool, the command line (CLI) interface configuration tool, or manually.

Configuring the feature pack by using the UI configuration tool

You can automatically configure the feature pack by using the UI configuration tool, which removes the need for manual tasks.

Before you begin

Before you use the UI configuration tool to update the database, you must manually stop the Maximo application server, for example, MXServer.

Procedure

1. Start the UI configuration tool.
   • Navigate to C:\IBM\SMP\ConfigTool\ConfigUI.exe or <InstallLocation>\ConfigTool\ConfigUI.exe.
   • For UNIX, navigate to the <installLocation>/ConfigTool directory and run ConfigUI. For example, /opt/IBM/SMP/ConfigTool/ConfigUI.
2. In the Deployment Operations pane, select Update Database, Build and Deploy Application EAR Files.
3. To complete the configuration, follow the on-screen instructions.

Configuring the feature pack using the CLI configuration tool

You can automatically configure the feature pack by using the CLI configuration tool, which removes the need for manual tasks.

Before you begin

Before you use the CLI configuration tool to update the database, you must manually stop the Maximo application server, for example, MXServer.

Procedure

1. Change to the <installLocation>/ConfigTool/scripts directory, for example: C:\IBM\SMP\ConfigTool\scripts
2. To update the system, run the configuration tool command: reconfigurePae.bat -action updateApplication -updatedb -deploymaximoear -deployhelpear -wasuser -wasadmin -waspwd <wasadmin_password>

Configuring the feature pack manually

To manually configure the feature pack, use the updateDB utility.

Before you begin

Before you update the database, you must manually stop the Maximo application server, for example, MXServer.

Procedure

1. To use the updateDB utility to run all of the feature pack database scripts, change the directory to the <maximo root>\tools\maximo directory, and run the updateDB utility.
   • For Windows, from a command prompt, change the directory to C:\IBM\SMP\maximo\tools\maximo and run the updatedb.bat file.
   • For UNIX, from a terminal window, change the directory to /opt/IBM/SMP/maximo/tools/maximo and run the /updatedb.sh file.
2. Delete the application server cache folders:
   • For Oracle WebLogic Server delete the cache and tmp folders. For example, for Windows, delete C:\Oracle\Middleware\Oracle_Home\user_projects\domains\wl_server\servers\AdminServer\cache and C:\Oracle\Middleware\Oracle_Home\user_projects\domains\wl_server\servers\AdminServer\tmp.
   • For the WebSphere Application Server, delete the cache folder in the <WebSphere_Root>\AppServer\profiles\Custom01\temp\<machinename>Node01\MAXIMOSERVER\MXServer directory.
3. Delete the web browser cache on every computer that uses Maximo base services.
4. Rebuild and redeploy the EAR files, and then restart the application server.

Importing report design files into Maximo Asset Management

This feature pack contains new and updated report design files. If you previously customized BIRT reports, the customizations might be overwritten when this feature pack is installed. You can also review any reports that you created to ensure that they are displayed correctly. After you install the feature pack, use the report import utility to import any necessary design file updates to your existing reports. Learn more about importing reports by accessing the Maximo 7.6 Report Development Guide.

Procedure

1. On the administrative server, browse to <install_home>\maximo\reports\birt\tools.
2. Open the reporttools.properties file. This file indicates the location that the reports are imported to.
3. Edit the reporttools.properties file to meet your system requirements.
4. Run the importreports.cmd to import your report design files. You can also run variations of this command to import only a subset of reports. Learn more about reporting by accessing the Maximo 7.6 Report Development Guide.