IBM Support

Collecting Data: Maximo Migration Manager and Migration Collections

Troubleshooting


Problem

This document describes the process for collecting data for problems with the IBM Maximo Asset Management Migration Manager and Migration Collections problems.

There are two Applications that can Create Migrations Package Definitions. Migration Manager and Migration Collections. 
Migration Manager:  The Migration Manager application, is used to Define, Create, Distribute, Upload and Deploy package configurations from one environment such as DEV or TEST to PROD. It uses Migration Groups(many out of the box, but can be created using consumed by MIGRATIONMGR Object Structures.
Migration Collections: This application is a "pick and choose" the configurations you want to define application. The configuration records you add will decide the MIGRATIONMGR Object Structure that is applied.
Migration Groups: This application is where you can define or see ut of the box Migration Groups, such as DATADICTIONARY, BPM, SECURITY etc..
Object Structures: Only Object Structures that have a Consumed By type of MIGRATIONMGR can be used for Migration Manager applications.

Collecting this MustGather information helps understand the problem and save time analyzing the data.


Expand a selection below to collect the information referent to the bucket or the system property.
  • Migration Manager
    Creating Package Issue
    • Supply the Migration Group
    • If not out of the box, supply the Object Structure that make up the Migration Group
    Distributing Packages
    •  supply mxe.dm.root system property
    • Supply the target form Manage Targets. For IBM Managed environments SRE only support File type targets
    Deploying Packages
    • Download and send in Package zip 
    • Supply mustgather logs. Logging set to dm logger =DEBUG, integration logger =INFO and sql logger =INFO

Here is a recommended documents Migration Manager : Migration Manager Documents. This document includes both Redbooks from 7.1 and 7.5 which are still relevant to Maximo Manage versions. These are comprehensive "How to" documents.
 
  • Troubleshooting steps
    1. Logging application dm logger =DEBUG, integration logger =INFO and sql logger =INFO
    2. Review System Properties configuration in Manage search for mxe.dm there are several properties most are fine out the box, mxe.dm.root is required.
    3. Always supply the zip package to support 
    4. Supply mustgather log(Manage)
Title Description
Search all S3 for Migration Manager documents on IBM Support Portal Shows a list of all documents tagged with this topic.

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSRHPA","label":"IBM Maximo Application Suite"},"ARM Category":[{"code":"a8m50000000CbOhAAK","label":"System Administration-\u003EMisc - Migration Manager"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"8.0.0;8.0.1;8.1.0;8.10.0;8.11.0;8.2.0;8.3.0;8.4.0;8.5.0;8.6.0;8.7.0;8.8.0;8.9.0;9.0.0;9.1.0"},{"Type":"MASTER","Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSLKT6","label":"IBM Maximo Asset Management"},"ARM Category":[{"code":"a8m50000000CbOhAAK","label":"System Administration-\u003EMisc - Migration Manager"}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.6.0;7.6.1"}]

Document Information

Modified date:
20 June 2025

UID

ibm17237487