IBM Support

Migrating Maximo Spatial Asset Management configuration data

Question & Answer


Question

How can I migrate Maximo Spatial Asset Management configuration data across environments?

Answer

    IBM Maximo Spatial Asset Management v7.6.0.3 configuration data can be migrated from one environment to another either by using either the application export and import actions of the Map Manager application, or by using Migration Manager.

    *** Import/Export Application ***
      Source Environment:
        One Map Manager Record:
          1. Go to Map Manager Application
          2. Open the map manager record to be exported
          3. Click Common Actions > Application Export
        Multiple Map Manager Records:
          1. Go to Map Manager Application
          2. Filter List View/Tab to show map manager records to be exported
          3. Select Common Actions > Application Export
        1st. Export PLUSSMAXDOMAIN_MIF Object Structure:
          1. Select the following options from the Application Export Dialog:
            Object Structure:
              PLUSSMAXDOMAIN_MIF
            Export Configuration Section:
              XML File Operation:
                Sync
          2. Save XML file.
        2nd. Export PLUSSMAPMANAGER_MIF Object Structure:
          1. Select the following options from the Application Export Dialog:
            Object Structure:
              PLUSSMAPMANAGER_MIF
            Export Configuration Section:
              XML File Operation:
                Sync
          2. Save XML file.


    Target Environment:
    1. Go to Map Manager Application
    2. Click Common Actions > Application Import
      1st. Import PLUSSMAXDOMAIN_MIF Object Structure:
        1. Select the following options from the Application Import Dialog:
          Object Structure:
            PLUSSMAXDOMAIN_MIF
          Operation:
            Sync
          Import Configuration Section:
            Import Preview?:
              unmarked
            Specify Import File:
              Choose the exported PLUSSMAXDOMAIN_MIF xml file
        2. Import the file.
      2nd. Import PLUSSMAPMANAGER_MIF Object Structure:
        1. Select the following options from the Application Import Dialog:
          Object Structure:
            PLUSSMAPMANAGER_MIF
          Operation:
            Sync
          Import Configuration Section:
            Import Preview?:
              unmarked
            Specify Import File:
              Choose the exported PLUSSMAPMANAGER_MIF xml file

    Troubleshooting:
      Verify if there is a application validation error and review your settings, for example:
        MXAT0311E - A map is already active for this site. A site cannot have more than one active map.


    *** Migration Manager ***

        In the target environment:
          Define Target Environments:
            Create FILE Target Environment Settings:
              1. Go To Menu > System Configuration Menu Group > Migration Menu Group > Migration Manager Application
              2. Common Actions > Manage Targets
              3. Add a new row to the Targets Table:
              4. Click OK.
                Target Name: MAP_MANAGER_PKG
                Target Description: Map Manager Package
                Type: FILE
                Database URL or File Path: C:\TEMP
          Migrate PLUSSMAXDOMAIN Object Structure:
            Create Migration Group for PLUSSMAXDOMAIN Object Structure:
              1. Go To Menu > System Configuration Menu Group > Migration Menu Group > Migration Groups Application
              2. Insert a new Migration Group Record
              3. Save the Migration Group record
                Migration Group: PLUSSMAXDOMAIN
                Migration Group Description: Migration Group for PLUSSMAXDOMAIN Object Structure
                Migration Group Order: leave default value.
                Add new row to Migration Objects for DMMAXENDPOINT Table:
                  Migration Object: PLUSSMAXDOMAIN
                  Migration Object Order: 1
            Create Migration Manager Package for PLUSSMAXDOMAIN Object:
              1. Go To Menu > System Configuration Menu Group > Migration Menu Group > Migration Manager Application;
              2. Insert a new Package Definition:
              3. Save the Migration Manager Record
              4. Switch to the Distribution Tab
              5. Add a new row to the Distributions Table
              6. Save the Migration Manager Record
              7. Change the Migration Manager record status to APPROVED
              8. Switch to the Package Tab
              9. Under the Packages Table click Create
              10. Verify that package was created successfully.
                  Package Definition Name: PLUSSMAXDOMAIN
                  Package Definition Description: PLUSSMAXDOMAIN
                  Package Definition Long Description: PLUSSMAXDOMAIN records
                  Type: SNAPSHOT
                  Batch Size: 100
                  Processing Action: Replace
              11. Add new row for Migration Groups Table:
                  Migration Group: PLUSSMAXDOMAIN
                  Target Name: MAP_MANAGER_PKG
              12. Specify the following information in the Upload Compiled Sources Dialog:
                Processing Action:
                  Replace
                    Default processing action will replace current data
                  AddChange
                    Modified processing action will add or update data
                  Read-Me Information:
                    Information entered by the person creating the package that serves as read me when this package is deployed in a target Maximo environment
              13. Click Continue
            Distribute PLUSSMAXDOMAIN package:
              1. Go To Menu > System Configuration Menu Group > Migration Menu Group > Migration Manager Application;
              2. Open the PLUSSMAXDOMAIN package
              3. Switch to the Package Tab
              4. Under the Packages Table click Distribute
              5. Verify that package was distributed successfully to all targets selected.
                  From the Distribute Package Dialog Box, select target environments to distribute package from Distributions Table.
                  Click Ok.
        Migrate Map Manager records: PLUSSMAPMANAGER Object Structure:
          Create the Migration Group for PLUSSMAPMANAGER Object Structure.
            1. Go To Menu > System Configuration Menu Group > Migration Menu Group > Migration Groups Application
            2. Insert a new Migration Group Record
            3. Save the Migration Group record with the following information
              Migration Group: PLUSSMAPMANAGER  
              Migration Group Description: Migration Group for the PLUSSMAPMANAGER   Object Structure
              Migration Group Order: leave the default value.
            4. Add a new row to the Migration Objects for PLUSSMAPMANAGER  Table:
                Migration Object: PLUSSMAPMANAGER  
                Migration Object Order: 1
          Create Migration Manager Package for PLUSSMAPMANAGER Object:
            1. Go To Menu > System Configuration Menu Group > Migration Menu Group > Migration Manager Application;
            2. Insert new Package Definition:
            3. Save Migration Manager Record
            4. Switch to Distribution Tab
            5. Add new row to Distributions Table:
            6. Save Migration Manager Record
            7. Change Migration Manager record status to APPROVED
            8. Switch to Package Tab
            9. Under Packages Table click at Create Button:
            10. Verify that package was created successfully.
                Package Definition Name: PLUSSMAPMANAGER
                Package Definition Description: PLUSSMAPMANAGER
                Package Definition Long Description: PLUSSMAPMANAGER  records
                Type: SNAPSHOT
                Batch Size: 100
                Processing Action: Replace
            11. Add new row for Migration Groups Table:
                Migration Group: PLUSSMAPMANAGER
                Target Name: MAP_MANAGER_PKG
            12. Specify the following information in the Upload Compiled Sources Dialog
              Processing Action:
                Replace
                  Default processing action will replace current data
                AddChange
                  Modified processing action will add or update data
                Read-Me Information:
                  Information entered by the person creating the package that serves as read me when this package is deployed in a target Maximo environment
            13. Click Continue
          Distribute PLUSSMAPMANAGER package
            1. Go To Menu > System Configuration Menu Group > Migration Menu Group > Migration Manager Application;
            2. Open the PLUSSMAPMANAGER package
            3. Switch to the Package Tab
            4. Under the Packages Table, click Distribute
            5. Verify that the package was distributed successfully to all targets selected.
            6. Select target environments to distribute package from Distributions Table.
            7. Click Ok

        For File target environment:
          Deploy PLUSSMAXDOMAIN package:
            1. Go To Menu > System Configuration Menu Group > Migration Menu Group > Migration Manager Application;
            2. Click Common Actions > Upload Package Action
            3. Click Browse... Button from Upload Package Dialog Box
            4. Click Common Actions > Deploy Package Action
            5. Verify that PLUSSMAXDOMAIN is displayed in the Packages Table
            6. Deploy the Package
            7. Source and Target Product Compatibility Dialog box verify that no error is displayed
            8. Verify in the logs Dialog box that the package was successfully deployed
            9. Click Ok
            10. Select PLUSSMAXDOMAIN package
            11. Click Ok
            12. Select Do you have a current backup?
            13. Select Skip prompts to create attribute rules?
            14. Click Deploy
            15. If no error is displayed click Ok
        Deploy PLUSSMAPMANAGER package:
          1. Go To Menu > System Configuration Menu Group > Migration Menu Group > Migration Manager Application;
          2. Click at Common Actions > Upload Package Action
          3. Click at Browse... Button from Upload Package Dialog Box
          4. Click at Common Actions > Deploy Package Action
          5. Verify that PLUSSMAPMANAGER is displayed at Packages Table
          6. Deploy Package:
          7. Source and Target Product Compatibility Dialog box verify that no error is displayed
          8. Verify in the logs dialog box if package was successfully deployed.
          9. Click Ok
          10. Select PLUSSMAPMANAGER package
          11. Click Ok
          12. Select Do you have a current backup?
          13. Select Skip prompts to create attribute rules?
          14. Click Deploy
          15. If no error is displayed click Ok.
          16. If the Yes/No Confirmation Dialog box is displayed, read message and then click Yes.


    *** Reference ***
      PLUSSMAPMANAGER Object Structure

        Source Objects:
          MAPMANAGER
            MAPSITES
            MAPTIPDEFAULTS
            PLUSSGEOCODESERVICE
            MAPTIP
              MAPTIPMENU
            MAXENDPOINT
              LONGDESCRIPTION
              MAXENDPOINTDTL
              MAXHANDLER
            JSONRESOURCE
              JSONOBJECTMAP
                JSONATTRIBUTEMAP
              JSONMERGEOBJECT
                JSONMERGEATTRIBUTE
            JSONMAPPING
              JSONMAPDETAIL
                JSONMAPPROPS
                  JSONMAPPROPVALUES
            PLUSSMAPSERVICE
              PLUSSMAPSERVICELAYER
                CRONTASKDEF
                  LONGDESCRIPTION
                  CRONTASKINSTANCE
                    LONGDESCRIPTION
                    CRONTASKPARAM
            LINEARAPPLAYER
            MAXOBJECTCFG
              L_MAXOBJECTCFG
              MAXTABLECFG
              MAXVIEWCFG
              MAXVIEWCOLUMNCFG
              MAXATTRIBUTECFG
                L_MAXATTRCFG
                AUTOKEY
                MAXATTRIBUTESKIPCOPY
              MAXSYSINDEXES
                MAXSYSKEYS
            MAXRELATIONSHIP

[{"Product":{"code":"SSG2D3","label":"Maximo Spatial Asset Management"},"Business Unit":{"code":"BU005","label":"IoT"},"Component":"--","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"7.6","Edition":""}]

Document Information

Modified date:
17 June 2018

UID

swg21981228