All learning series · Manage add-on · Part 1
Maximo Spatial
Connect a maintenance record to its geographical context.
Start here
Confirm this product is ready, then use the lesson. The readiness checks are the gate for configuration, for a first journey and for production.
- Are you ready to use Maximo Spatial? Licensing and AppPoints, the records that must exist, and three checklists.
- Basics
- Configuration
- Practical example
- Practice and verify
- Advanced concepts
Are you ready to use Maximo Spatial?
Spatial puts a map on the asset, location and work record. The map service and the link between a Maximo record and a map feature have to exist before anyone configures a Map tab, and an Esri licence is separate from the Maximo install AppPoints.
Before configuration
Manage is entitled, the Spatial install AppPoints are available, and you have an Esri ArcGIS service the workspace can reach. Decide whether this journey only displays a feature or also writes geometry back.
Before the first successful journey
One map is enabled in Map Manager, one training asset or location carries the identifier the feature uses, and a planner can open the Map tab.
Before production use
Agree which system owns geometry, who refreshes the feature service, and which security groups may see the map. A displayed sample feature is not a writable operational layer.
Licensing, entitlement and AppPoints
Spatial is entitled as part of Maximo Manage at the Base and Limited tiers. The MAS 9.2 licensing guidance also requires a separate installation, allocated at 20 AppPoints. Those 20 points are an install charge, reserved for the life of the environment, and they are not a per-user charge. Users who open maps still consume the Limited, Base or Premium user ratio for their user type. Manage includes Linear, Calibration and Spatial users at Base and Limited. Spatial is the one of those three that requires the installation. Customers purchase Esri ArcGIS, and any analyst desktop licences, from Esri or an Esri agent. That purchase is outside the 20 AppPoints.
Keep four facts separate for Maximo Spatial. Entitlement is the proof of entitlement and the License Information for IBM Maximo Application Suite. The MAS 9.2 licensing guidance supplements that agreement. Available AppPoints are the pool shown on the AppPoints Usage dashboard: Suite administration, then Suite, then Administration, then AppPoints Usage. Assigned access is the security group together with the user type on the person: Limited, Base or Premium, and Authorized or Concurrent. Consumption is what that assignment draws. Authorized users and administrators reserve AppPoints continuously. Concurrent users draw AppPoints while they are signed in. Install AppPoints stay reserved for the life of that environment. A non-production install of a component draws no install AppPoints when the same component is already installed in production. Administrators and User Management users open the dashboard. Other people need the LICENSEUSAGE security group. Compliance enforcement and idle timeout sit on the dashboard Configuration tab and are suite-administrator settings.
The same guidance publishes these user conversion ratios: Limited is 5 AppPoints for one concurrent user and 2 for one authorized user; Base is 10 concurrent and 3 authorized; Premium is 15 concurrent and 5 authorized; an administrative Base user is 10 AppPoints and an administrative Premium user is 15, both as authorized users. A Base administrator who already reserves 10 AppPoints can be given Premium application access with no further AppPoints. Those ratios were read from the MAS 9.2 licensing guidance on 18 October 2026. Your agreement sets how many AppPoints you purchased. An application that opens shows that the component is deployed. Read the proof of entitlement and the dashboard as well.
Installed and enabled applications
Confirm three different states. Installed: the catalog shows Spatial deployed on the Manage workspace and AppPoints Usage shows the 20-point install. Enabled: Map Manager has a map service that opens. Configured: the map is linked to the site and to the object you will show. Usable: a user in the right security group opens an asset and sees that asset on the map. A deployed tile with no map service is only the first of those states.
Foundation configuration
Spatial needs the site and the asset or location you will show. The minimum is one site, one asset or operating location, and a stable identifier both Maximo and the feature service share, such as the asset number written into the feature. Classifications help you style the layer. They are not required for a single training point. Linear measures and calibration data sheets are not Spatial prerequisites. A linear asset can also be drawn on a map later. That is a second product.
Product configuration
In Map Manager, register the map service and create the training map for the site. Bind the layer to the Maximo object and the identifier field you agreed. Grant the Map tab to the planner group. Review any default that shows every site’s features on first open before you point the map at a production service.
Infrastructure and integration
The workspace needs a route to the ArcGIS service: DNS, TLS, and the proxy or firewall path your platform uses. The service account or token that Map Manager stores is an Esri credential, not a Maximo user. A public sample basemap can prove the tab opens. An internal feature service is what carries your assets. Capacity and availability of that service are the GIS team’s responsibility.
Data and operational readiness
The first journey needs one feature whose identifier matches one training asset in the site, with a location the service actually returns. A missing feature is a data gap. A refused Map tab is security. A map service that does not answer is an infrastructure dependency. Check those three separately.
Setup order for a map
- 1. Manage entitlement and the 20-point Spatial install User tier and install AppPoints are different lines on the dashboard.
- 2. Esri ArcGIS service and its own licence Bought from Esri. Reachable from the workspace over TLS.
- 3. Site, asset and shared identifier The value on the Maximo record is the value on the feature.
- 4. Map Manager map, enabled for the site This is the configured state. Deployment alone is not enough.
- 5. Security group and the Map tab The planner opens one asset and sees that feature.
| Requirement | Why needed | Mandatory/Conditional/Optional | Where to configure or verify | Minimum working example | Verification procedure | Consequence if missing | Remediation | Source |
|---|---|---|---|---|---|---|---|---|
| Manage user entitlement that includes Spatial | Spatial users are included at Limited and Base. The person still needs a security group that exposes the map. | Mandatory | Suite administration → Suite → Administration → AppPoints Usage. Manage → Security → Security Groups, and the suite user type. | A planner on Base, or a Limited user whose three modules include the map applications you will open. | Grant the group, then read the tier AppPoints Usage assigns to that person. | The Map tab is absent for that user while other planners see it. | Add the application to the group and confirm the tier still matches the entitlement you purchased. | Licensing in Maximo Application Suite 9.2 |
| Spatial install, 20 AppPoints | The guidance requires a separate installation even though the user entitlement is included with Manage. | Mandatory | Suite administration → Catalog. Install line on Suite administration → Suite → Administration → AppPoints Usage. | One Spatial install on the workspace. A non-production install draws no install AppPoints when production already has Spatial. | Match the catalog deployment to the install line of 20 AppPoints. | Map Manager is not in the workspace. | Apply the install entitlement and deploy Spatial. Do not reuse Optimizer or Civil install quantities. | Licensing in Maximo Application Suite 9.2 |
| Esri ArcGIS licence | Maximo Spatial must be used with Esri ArcGIS. The ArcGIS purchase is not an AppPoint quantity. | Mandatory | Your Esri agreement, plus the token or named user Map Manager will use. | One ArcGIS service the training map can call, and a desktop licence only if an analyst will edit features outside Maximo. | Sign in to the ArcGIS endpoint with the service identity and list the feature layer. | The map control has no service to draw. | Complete the Esri purchase and issue a service identity. Keep that licence record with the GIS owner. | Licensing in Maximo Application Suite 9.2 |
| A reachable map service | The workspace has to open the service on the network path users will use. | Mandatory | DNS, TLS certificate, proxy and firewall between the Manage route and the ArcGIS host. | The feature service URL saved in Map Manager, using the same host the workspace resolves. | From the workspace network, open the service URL and receive the layer description. | Map Manager saves the URL and the tab stays empty. | Open the path or correct the URL. A browser on your laptop is a different network from the workspace. | Licensing in Maximo Application Suite 9.2 |
| Site and one linked asset or location | The map shows Maximo records. It needs a record and a feature that share an identifier. | Mandatory | Sites, Assets or Locations, and the identifier field you bind in Map Manager. | Asset SP-1 in the training site, with the same value stored on one point feature. | Search the feature for SP-1 and open the asset. The point and the record are the same object. | The tab draws a basemap and no asset, or it draws a feature you cannot open as a record. | Write the identifier on both sides. Do not start by styling a layer that has no key. | Modules and applications in Maximo Application Suite 9.2 |
| Map enabled and bound in Map Manager | Installed, enabled, configured and usable are different. This row is the configured state. | Mandatory | Map Manager, map service, site, object and identifier. | One map, one layer, bound to asset number, active for the training site. | Open Map Manager and confirm the map is active, then open the asset as a user in the planner group. | The service is up and this site still has no map. | Activate the map for the site and bind the identifier. | Modules and applications in Maximo Application Suite 9.2 |
| A writable layer, only if the journey edits geometry | Displaying a feature and writing geometry back are different integrations. | Conditional | The feature service capability, and the security option that allows the edit. | Skip this for a display-only journey. For a write, one feature service that accepts edits from the service identity. | Edit one training vertex and read it back from ArcGIS and from the Maximo record. | Users can pan the map and cannot save a change, or a save never reaches the service. | Use a display layer until the feature service and the signature option both allow the edit. | Licensing in Maximo Application Suite 9.2 |
A. Ready to configure
- Manage entitlement covers the user’s tier, and the Spatial install of 20 AppPoints is on the proof of entitlement and on the dashboard.
- The Esri agreement covers the ArcGIS service you will call.
- The workspace route can resolve and trust the service URL.
- Map Manager opens.
- The training site exists.
B. Ready for the first end-to-end journey
- One training asset or location shares an identifier with one feature.
- The map is active for that site and bound to that identifier.
- A planner in the security group opens the record and sees the feature.
- A user outside the group does not see the map, which confirms the group rather than the service.
- If the journey writes geometry, the feature service accepts the edit and both systems show the new shape.
C. Ready for production operation
- The GIS owner and the Maximo owner agree which system is the source of geometry.
- The service identity’s secret is stored for the workspace, and an analyst desktop licence exists only for people who edit outside Maximo.
- The production feature service, its capacity and its change window are known to the people who publish maps.
- A failed service is distinguishable from a missing identifier and from a missing security group, using the checks in the table.
- Linear or calibration data is in scope only when those products are part of the same journey.
Sources for this readiness check
Licence statements come from the IBM topic named on the row. Installation of a component is a separate check from entitlement.
- Licensing in Maximo Application Suite 9.2 — MAS 9.2 licensing guidance, verified 2026-10-18
- User access and entitlements in MAS 9.1 and later — MAS 9.1 and later, verified 2026-10-18
- Accessing the AppPoints Usage Dashboard — MAS 9.2, verified 2026-10-18
- Modules and applications in Maximo Application Suite 9.2 — MAS 9.2, verified 2026-10-18
Before you start
MAS learning path. Match the component documentation to your installed release and maintenance build before configuring it.
- Spatial deployed with compatible Manage and GIS versions.
- A test map/service, a known feature and a training asset; access for a planner and a restricted user.
IBM sources + Assetize exercise
01 · Basics — Understand the building blocks
Spatial connects Maximo records with GIS features. A feature is the mapped object; an asset, location or work order is the operational record. Their identifiers must be linked deliberately.
Map Manager configures maps and map services for spatially enabled applications. A map that opens successfully does not by itself prove that records, layers or editing permissions are correct.
Topics in this series
- GIS and Maximo identities
- Map Manager and map services
- Record linking
- Spatial work planning
- Synchronization and troubleshooting
02 · Configuration — Work through the setup
Use a training environment and match the actions to the IBM guide for your installed build.
- Identify the GIS feature identifier, Maximo asset identifier and site before configuring the link.
- In Map Manager, inspect or create a training map and configure the approved map service using your installed-version instructions.
- Associate the map with the intended site and verify that the test user can access the map service.
- Link one training asset using the supported record-linking mechanism. Open it in a spatially enabled application.
- Select the feature and compare its identity with the record. Reopen the record and repeat as the restricted user.
03 · Practical example
Fictional teaching example
Riverbend Water has two pumps with similar descriptions at different sites. The map must select the intended feature for asset RB-PUMP-01 in site RB01; matching descriptions are insufficient.
04 · Practice and verify
Link one asset and one work location. Record the feature key, site, map/layer and the result of record-to-map and map-to-record navigation.
Expected result
Both directions resolve the same site-qualified record. An unlinked feature remains unlinked, rather than opening a similarly named asset.
Common mistakes
- Confusing map availability with feature linkage.
- Ignoring coordinate systems, service authentication or site assignment.
05 · Advanced concepts
Next examine GIS synchronization, ownership of geometry and attributes, and recovery from an unavailable service. Treat offline/mobile mapping as a separately configured and tested path.
IBM references
Product explanations link to IBM sources. Scenarios and exercises are original Assetize teaching material. Reviewed 2026-10-01.
Maximo ecosystem overview · Manage learning paths · Practice data in Workbench