Table of Contents

Upgrade Guide

for MaxTAF

Before you begin

You upgrade MaxTAF to version 7.x- on a Windows administrative workstation where IBM Maximo Asset Management version 7.x and a previous version of MaxTAF are already installed.

This guide will refer to the Maximo install home as <MAXIMO_ROOT>. You will need to substitute this with the actual Maximo install home path (for example C:\IBM\SMP\Maximo).
It will also refer to your current MaxTAF folder as <MAXTAF_ROOT>. Please substitute this with the actual MaxTAF install home path (for example C:\MaxTAF).

Product Installation Files

To perform the upgrade of MaxTAF, you need the following files:

where 'x' is the version of your Maximo system (e.g. for any of 7.5 versions, or for any of 7.1.1 versions).


  1. Prepare for upgrade of MaxTAF
  2. Access MaxTAF product software from the supplied ZIP files
  3. Upgrade Core component on the administrative workstation
  4. Upgrade MXML component on the administrative workstation
  5. Upgrade Recorder component in Firefox
MaxTAF Core component can be upgraded independent of MaxTAF MXML and Recorder components. However, MXML and Recorder components depend on each other and must be upgraded simultaneously.

Prepare for the upgrade

The upgrade of MaxTAF will modify configuration and content of your application server, database server, and directory server. These servers are known as the middleware servers.
Prior to upgrade, make sure to backup the middleware servers, database, administrative workstation, as well as your current <MAXTAF_ROOT> folder.

MaxTAF Core component resides within Maximo EAR file. The upgrade will require a rebuild and redeployment of Maximo EAR file.

Upgrade Procedure

  1. Stop your Maximo application server
  2. Extract to <MAXIMO_ROOT> folder
  3. Extract latest Core patch zip (e.g. to <MAXIMO_ROOT> folder
  4. Run command prompt as administrator and navigate to <MAXIMO_ROOT>\tools\maximo folder
  5. Run maxtaf_install.bat
  6. Rebuild and redeploy your Maximo EAR file
  7. Start your Maximo application server

MaxTAF MXML component is located in your current <MAXTAF_ROOT> folder. The upgrade involves overriding existing files in your <MAXTAF_ROOT> folder. After the upgrade is completed it is strongly advised that you recompile all of the existing MaxTAF test cases.

Upgrade Procedure

  1. Go to your <MAXTAF_ROOT> folder
  2. Extract to the location that contains MaxTAF folder
  3. Extract latest MXML patch zip (e.g. to the location that contains MaxTAF folder
  4. Recompile all the existing MaxTAF test cases

MaxTAF's Recorder component is a firefox extension that provides test recording functionality. This component works in conjunction with the MXML component, so make sure that those two components are in sync.

Upgrade procedure

  1. Open Firefox
  2. Go to Tools > Add-ons > Extensions
  3. Click the Settings button and select Install Add-on from File

  4. Navigate to your maxtaf-recorder-2.3.0.x.xpi file
  5. Wait for the countdown and then click "Install Now"

  6. When prompted, restart Firefox

You can now start using MaxTAF. Please consult the User's and Developer's Guides for further information.