Table of Contents

Upgrade Guide

for MaxTAF 3.0.0

Before you begin

You upgrade MaxTAF to version 7.x-3.0.0 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 3.0.0, you need the following files:

where 'x' is the version of your Maximo system (e.g. for any of 7.6 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. Edit <MAXIMO_HOME>\tools\maximo\maxtaf\ file. Set the value of <MAXTAF_ROOT> property to point to the MaxTAF folder.
    If you are using backslashes in the path, you will need to escape them with another backslash (e.g. C:\\maxtaf). If you are using forward slashes a single one will suffice.
  5. Open terminal window as Administrator
    It is important to run terminal as Administrator, otherwise the upgrade will fail.
  6. From terminal, go to <MAXIMO_HOME>\tools\maximo
  7. Perform your standard UpdateDB procedure. This mainly consists of running <MAXIMO_HOME>\tools\maximo\updatedb.bat (for Linux:
    You will need to perform any procedures that you may have associated with the running of updatedb. E.g. you may need to run an sql script prior to updatedb to save all the custom class names of your objects, attributes etc. and then restore them once the updatedb is done.
  8. Rebuild and redeploy your Maximo EAR file
  9. 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. Remove bin and lib folder
  3. From script folder remove js and rs folders.
    Make sure that you do not accidentally remove your tests from the script folder.
  4. Extract to the location that contains MaxTAF folder
  5. Extract latest MXML patch zip (e.g. to the location that contains MaxTAF folder
  6. Recompile all the existing MaxTAF test cases

MaxTAF's Recorder component is an extension for Firefox and Chrome that provides session recording functionality. This component works in conjunction with the MXML component, so make sure that those two components are in sync.

Chrome automatically updates new releases for it's extensions, but Firefox requires you to reinstall with the current version.

Upgrade procedure for Firefox

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

  4. Navigate to your maxtaf-recorder-3.0.x.xpi file
  5. Click "Add"

  6. When prompted, restart Firefox

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