Skip to main content

Configure the Ignition Module

availability
Platform:WebMobile
Plan Type:BasicEssentialPremiumEnterprise
User Type:RequesterFull UserAdministrator

This article explains how to configure the MaintainX® Ignition Module and troubleshoot your configuration.

Create Your Connector Instance and Token​

To configure the MaintainX Ignition Module, you need an access token. The token authenticates the MaintainX Ignition Module with the MaintainX platform.

danger

It's important to keep your token secure. Do not share it with unauthorized users.

  1. Log into MaintainX as an Administrator.

  2. From the sidebar, select Settings, and under ORGANIZATION SETTINGS, select Integrations.

  3. On the Integrations page, go to the Connectors tab.

  4. Navigate to the Ignition Module tile, and select Connect. An Ignition Module dialog appears.

  5. Select + Create New Instance.

  6. Follow the steps to create a new instance until the Token appears.

  7. Copy the Token and save it for later use.

  8. Select Connect to finish provisioning the Ignition Module connector with the token you saved.

  9. When the confirmation message appears, select Done to close the dialog.

info

The Token is only displayed once when you create the Ignition Module connector. If you lose the token for an Ignition Module instance, you can revoke it and create a new one. See Revoke and Regenerate an Ignition Module Access Token.

Add a Connector in the Ignition Gateway​

  1. Go to the MaintainX Module Settings page in the Ignition Gateway:

    • Navigate to Config > Overview.
    • In the Connections section, select Configure the MaintainX Module.

  2. Select + New Connector.

  3. Name the connector according to your naming conventions.

  4. In the API Token field, paste the Token you generated when creating your connector token.

  5. Select Save Changes.

info

Each gateway supports up to 20 connectors, and each connector supports up to 6,000 tags. For the full list of limits, see Limitations.

Locate Your Ignition Tag Paths​

  1. In the Ignition Gateway:

    • Navigate to Status > Tags.

  2. To browse to the tags you want to monitor:

    • Select Browse on a specific folder to see other folders and tags underneath it.

    • Select Details on a specific tag.

    • After you find the tag you want to monitor and navigate to its details page:

      • Copy the Path value only (e.g., [default]Boiler1) to monitor all the tags in the folder.
      • Copy the Path value with the tag name appended (e.g., [default]Boiler1/Temperature) to monitor the specific tag.

Enter Your Ignition Tag Paths in the MaintainX Module​

  1. Go to the MaintainX Module Settings page in the Ignition Gateway:

    • Navigate to Config > Overview.
    • In the Connections section, select Configure the MaintainX Module.

  2. On the connector you set up earlier, select the (pencil) icon.

  3. Select + New Path.

  4. Enter the tag paths you want to monitor in the Tag Paths field:

    • Add the tag paths:
      • For a specific tag example: [default]Boiler1/Temperature
      • To monitor all tags in a folder, for example: [default]Boiler1

  5. Select Save Changes.

info

Each connector supports up to 300 distinct tag paths and a total of 6,000 tags. For the full list of limits, see Limitations.

Map Tags to Meters​

After you enter your Ignition tag paths in the MaintainX Module, use smart tag mapping to connect your tags to meters in MaintainX.

The smart tag mapping system uses AI to analyze data tags you make available through your organization's Ignition connectors. For each tag, the system suggests a meter name, a unit of measurement, and an asset to assign the meter to. Using the tag management tool, you can:

  • View the Ignition tags that are available through your organization's Ignition connectors.
  • Review MaintainX's suggestions for mapping tags to assets in your organization.
  • Automatically create meters for your tags and associate them with the correct assets.

The tag mapping AI provides a confidence rating for each suggestion. You can edit any suggestion before creating the meter, and easily update mapped tags at any time.

For detailed instructions, see Smart Tag Mapping for OT Data.

info

The smart tag mapping system replaces the Auto Create Meters feature, which is no longer available. If you have existing OT connectors that connect to meters you configured using the Auto Create Meters feature, the smart tag mapping system will not affect them.

What Happens Next​

Once configured, the MaintainX Ignition module:

  • Subscribes to the tags you mapped.
  • Automatically syncs your Ignition Tags with MaintainX Meters.
  • Sends tag value changes to MaintainX as Meter readings.
  • You can view and manage from the tag management tool.

Update the MaintainX Module​

We recommend keeping the MaintainX Module up to date to receive security patches and compatibility improvements. Updates can be installed at any time and do not affect your existing configuration or interrupt data flow to MaintainX.

  1. Open the Ignition Gateway web UI.
  2. Go to Config > Modules.
  3. Select Install or Upgrade a Module.
  4. Upload the .modl file you downloaded.
    1. For more information, see Download the MaintainX Ignition Module.
  5. Select Install.

Manage Access Tokens​

Regenerate the connector's access token whenever:

  • You cannot retrieve the original token (it is only shown once) or the token has been exposed to anyone who is not a trusted administrator.
  • An administrator with access to the token leaves your organization or you rotate credentials as part of a security review.
  • The MaintainX UI or module logs show Invalid API Token, which indicates that the token was revoked.
  • While troubleshooting connectivity issues, MaintainX Support instructs you to reissue the token.
warning

Running the connector with an invalid or revoked token stops data flow until you generate a new token and paste it into the module.

Revoke and Regenerate an Ignition Module Access Token​

The access token for an Ignition Module connector is only displayed once, when you first create it. If you lose the token, you can revoke it and generate a new one.

To revoke and regenerate a token:

  1. Log into MaintainX as an Administrator.

  2. From the sidebar, select Settings, and under ORGANIZATION SETTINGS, select Integrations.

  3. On the Integrations page, go to the Connectors tab.

  4. Navigate to the Ignition Module connector, and select Manage.

  5. In the Ignition Module dialog, go to the Instances list and select the instance whose token you want to revoke.

  6. In the Manage Instance dialog, select Revoke Token.

    The instance's Status changes to Disconnected, and the Token field shows Revoked.

  7. Refer to the section on generating a new token and applying the token.

MaintainX Module Statuses​

This indicates the overall status of the module, which is displayed in the upper-left corner of the module page.

StatusDescription
DisabledThe module is currently disabled.
InitializingThe module is initializing its connection with MaintainX.
MigratingThe module is performing a database migration.
SyncingThe module is syncing tags to monitor with MaintainX.
Sync ErrorAn error occurred while syncing tags.
RunningThe module is enabled and ready to send tag values to MaintainX.
Shutting DownThe module is shutting down.
Fatal ErrorThe module is in a fatal error state.

MaintainX Connector Statuses​

This indicates the status of an individual connector, as shown in the Connector table.

StatusDescription
DisabledThis connector is currently disabled.
RunningThe connector is enabled and sending tag values to MaintainX.
Invalid API TokenThe connector has an invalid API token.
SyncingThe module is syncing tags to monitor with MaintainX.
Sync ErrorAn error occurred while syncing tags.

MaintainX Redundancy Statuses​

This indicates the redundancy status of the module, which is displayed in the upper-right corner of the module page. This status is only shown when the Gateway is configured in a redundant setup. For more information, see Use Ignition Gateway Redundancy.

StatusDescription
ActiveThe module is active and sending data to MaintainX.
StandbyThe module is waiting for failover and not sending data to MaintainX.

Troubleshooting​

Not seeing data in MaintainX​

  • Check Status > System in the Ignition Gateway to verify the module status is Running.
  • Confirm the connector status is Running on the MaintainX Module settings page.
  • Confirm your tag paths are valid and exist in Ignition.
  • Double-check that the access token is correct and has not been revoked.
  • Check Status > Logs in the Ignition Gateway for any MaintainX Module errors.

The MaintainX Ignition Module is in a Sync Error State​

The module shows Sync Error when one or more connectors have a tag synchronization issue. To resolve this, identify the affected connector and refer to The Connector in the Module is in a Sync Error State.

The Connector in the Module is in a Sync Error State​

A connector displays Sync Error when one or more configured tag paths are invalid or not found in Ignition. Valid tags will continue to be monitored, but invalid ones are not added to MaintainX.

To identify the invalid tags, check the Ignition Gateway logs at Status > Logs. Each invalid tag path will be logged with an error message.

The MaintainX Ignition Module is in a Fatal Error State​

If the MaintainX Module is in a Fatal Error state, it means that the module encountered an unrecoverable error and cannot continue running. You can restart the module to try to recover from the error. To do this, go to the Config > Modules page in the Ignition Gateway and select Restart for the MaintainX Module.

If the error persists, you can contact our support team at support@getmaintainx.com. Make sure to download your logs and share them with us to help us investigate the issue.

The Connector is Unable to Reach the MaintainX Service​

This usually means your Ignition Gateway cannot reach MaintainX. Common causes include a firewall rule blocking outbound traffic or the Gateway not using the proxy server configured in your organization. For the required network settings, see Secure Outbound Communication.

To test whether your Ignition Gateway can reach MaintainX:

  1. Open the Ignition Designer for your Gateway.
  2. From the top menu, select Tools > Script Console.
  3. Paste the following script and run it:
from java.lang import Exception as JavaException

url = "https://agent.maintainx.com/"

try:
    client = system.net.httpClient()
    response = client.get(url)
    status = response.getStatusCode()

    if status >= 200 and status < 500:
        print "MaintainX is reachable."
    else:
        print "MaintainX is unreachable."

except JavaException as e:
    print "MaintainX is unreachable."
    print str(e)
  1. If the output shows "MaintainX is unreachable", your Gateway cannot connect to MaintainX. Review the network settings with your IT administrator.

Still Stuck?​

Contact MaintainX Support. Make sure to download your logs and share them with us to help us investigate the issue.