Skip to main content
Version: 8.3 Beta 🚧

Installing or Upgrading a Module

Inductive University

Installing or Upgrading a Module

Watch the video

Module Configuration​

All module configuration is done from Gateway Webpage in the Platform > System > Modules section. The Modules page shows a list of the currently installed modules, their current version, and if they are running properly with a license. The top of the page shows a quick count of the running and licensed modules, so you can easily tell if anything is not working. It is then easy to scroll down through the list to see which modules are having issues.

From here you can also add, remove, and restart modules. Modules integrate their settings into the Gateway configuration tree, and therefore do not offer settings in this section.

Downloading a Module​

Ignition comes with some default modules when installing the software. There may be a few modules you require that are not included when performing the initial installation, however. To find the module(s) you require, follow the instructions below.

  1. Go to the downloads page on the Inductive Automation website.

  2. Click on "Other Versions", located under the Ignition tablet and mobile device graphic. By default, this will take you to different installers and modules for the latest version of Ignition.

  3. Select which version of Ignition you are currently running.

  4. Scroll down the page until you see which module you are looking for. Once you click on the target module, it will start downloading the .modl file.

Install or Update a Module​

The following procedure assumes you have a .modl already downloaded in preparation for installing or upgrading a module, including for third party modules.

note

Installing a module will require connected Vision Clients and Designers to restart. Perspective Sessions will not require a restart. Production systems using either Clients or Designers should wait for downtime before installing a module.

  1. On the Gateway Webpage, select Platform > System > Modules to open the Modules page.

  2. Click the Install or Upgrade Module +.

  3. Click Choose File, select a .modl file that you have previously downloaded.

  4. Click Install. When the page reloads you can now see the module you installed in the list of modules.

Uninstall a Module​

note

Uninstalling a module will require connected Vision Clients and Designers to restart. Perspective Sessions will not require a restart. Production systems using either Clients or Designers should wait for downtime before uninstalling a module.

  1. On the Gateway Webpage, select Platform > System > Modules to open the Modules page.

  2. Locate the module you want to uninstall.

  3. To the right of module name, click the three dot menu and select Uninstall.

  4. Click Uninstall. The module is no longer installed and is removed form the list.

Disable a Module​

  1. On the Gateway Webpage, select Platform > System > Modules to open the Modules page.

  2. Locate the module you want to disable.

  3. To the right of module name, click the three dot menu and select Disable. A confirmation message appears.

  4. Click Disable.

The module status will change to Active Pending Restart until the Gateway has been restarted, and the Gateway Restart Required banner will appear at the bottom of the page. After the Gateway has been restarted, the module will still be listed but will not be functional.

Enable a Module​

This option is only available for a currently disabled module.

  1. On the Gateway Webpage, select Platform > System > Modules to open the Modules page.

  2. Locate the module you want to enable.

  3. To the right of module name, click the three dot menu and select Enable. A confirmation message appears.

  4. Click Enable.

The Gateway Restart Required banner will appear at the bottom of the page for you to easily restart your Gateway. After the Gateway has been restarted, the module will be enabled.

Module Status​

The installed module list on the Modules page also provides some basic information about each module. The Version, License, and Status columns are all displayed in the list. Module licensing is performed centrally in Platform > System > Licensing, so the values here are only for informational purposes.

Verify Trusted Modules​

Verify the authenticity of Ignition modules on the Platform > System > Modules page. Expand the three dot menu for your module and select View Certificate to see details about each certificate.

A warning message will appear if the module certificate is expired, however this will not have any impact on security or module behavior.

Third Party Modules​

Third Party modules are not produced by Inductive Automation. Ensure that you know who produced the code and perform due diligence as you would with any other software vendor in accordance with organizational policy.

Strategic Partners, such as Cirrus Link, and Premier Technology Providers, such as 4IR and Sepasoft, are trusted parties by Inductive Automation. However, their modules or services are created by separate groups and may need to be vetted separately from the Ignition platform.

The Module Marketplace hosts Ignition modules written by the community. Authors are required to request certificates from Inductive Automation (IA). IA will remove modules with known problems or risk, but hosting does not require a high level of vetting. Your account representative may be able to provide more information on known authors or organizations.

The bundled version of Java in Ignition uses Java 17.0.13, which may impact third party module compatibility. Refer to third party module documentation for further communication about any end-user modifications that may be required.