Migrating legacy plugins to Industrial IoT 5.0.1.1 - Industrial IoT 5.0.1.1 | BACnet | Modbus | OPC Client | SNMP Manager

Industrial IoT Plugin Guide 5.0.1.1

Applies to
Industrial IoT 5.0.1.1 | BACnet | Modbus | OPC Client | SNMP Manager
Last updated
2023-02-09
Content type
Guides > Plugin and extension guides
Language
English
Product
Industrial IoT
Version
5.0

If you were using one of the legacy plugin roles, BACnet, Modbus, OPC Client, or SNMP Manager, you must migrate the entities they manage to the new Industrial IoT plugin role.

What you should know

  • Starting with version 5.0.0.0, only the Industrial IoT plugin role is needed to manage all IoT protocols. For this reason, only the Time Series settings for the Industrial IoT plugin role are preserved. The Time Series settings for the legacy plugin roles will be lost.
  • For the migration to work, the Industrial IoT database must use Windows authentication.

Procedure

  1. From the Config Tool home page, open the Plugins task.
  2. Select the Industrial IoT plugin role and click the Properties tab.
    When you have legacy plugin roles on your system, a third section is displayed under the Time Series section in the Properties page.
    Config Tool showing the Industrial IoT plugin role's Properties page with a section for importing legacy plugin databases.
  3. In the Import section, click the drop-down list, select a plugin to migrate, and click Import.
    The Importation dialog box opens.
    Importation dialog box - Before the import.
  4. (Optional) Select the Import reports option to preserve the historical data.
    The historical data include the health events, the input activities, and the rule activities. You can view these historical data with the Industrial IoT investigation tasks.
  5. Click Import to start the importation.
    The import of the selected plugin starts. Do not close this window before the progress bar shows 100%.
    Importation dialog box - Import completed.
  6. When the importation is finished, do one of the following:
    • Click Delete old database to delete the old database before clicking Close.
    • Click Close and delete the old database yourself from the Resources page of the disabled plugin role.
  7. Repeat the same process for all legacy plugins that you have on your system.
  8. Delete all legacy plugin roles that are no longer needed: BACnet, Modbus, OPC Client, and SNMP Manager.