Overview

When doing a Gateway Backup of an Ignition instance running the EFM Emerson ROC Driver module, the backup does not include the ROC specific configuration parameters. This procedure outlines how to backup all of the ROC configuration parameters in conjunction with a Gateway Backup. This is required when doing a Ignition Gateway Backup and then a Gateway Restore. Note: This process is only required if using EFM Emerson ROC Module v3.4.9 or before. If using v3.4.10 or later, all Emerson ROC components get properly inserted into a Gateway Backup file.

Procedure

Creating the Backup

• Perform a standard Ignition Gateway backup using the Ignition Gateway Web UI.
  • This procedure is described here: https://docs.inductiveautomation.com/display/DOC79/Gateway+Backups
• Stop the Ignition Gateway.
  • This can be done following this procedure: https://docs.inductiveautomation.com/display/DOC79/Gateway+Control+Utility
• Navigate to the IGNITION_INSTALL_DIR/user-lib/ directory.
  • On Windows the IGNITION_INSTALL_DIRECTORY this is typically C:\Program Files\Inductive Automation\Ignition
  • On Linux or OSX the IGNITION_INSTALL_DIRECTORY this is typically /usr/local/bin/ignition
  • Once in the directory, zip the contents of the efmemersonroc directory.
    • On Windows, right-click and zip the folder

    • On Linux or OSX, run the following commands

      cd /usr/local/bin/ignition/user-lib sudo zip -r efmroc.zip efmemersonroc/

      
      

Applying the Backup

• Install Ignition as normal and apply the Ignition Gateway Backup file that was previously generated.
  • This is described here: https://docs.inductiveautomation.com/display/DOC79/Making+Backups+and+Restoring
  • DO NOT INSTALL the EFM Emerson ROC module yet. This will be done in a later step.
• Navigate to the IGNITION_INSTALL_DIR/user-lib/ directory.
  • On Windows the IGNITION_INSTALL_DIRECTORY this is typically C:\Program Files\Inductive Automation\Ignition
  • On Linux or OSX the IGNITION_INSTALL_DIRECTORY this is typically /usr/local/bin/ignition
  • Once in the directory, unzip the contents of the efmemersonroc directory that you had previously zipped while creating the backup

    • On Windows, just unzip the previously created zip file in C:\Program Files\Inductive Automation\Ignition\user-lib

    • On Linux, run the following commands

      cd /usr/local/bin/ignition/user-lib sudo unzip efmroc.zip

      
      

• Install the EFM Emerson ROC Driver module.
• At this point the EFM Emerson ROC Driver should be fully working and configured as it was on the original Ignition Gateway.

Additional Resources

• Inductive Automation's Ignition download with free trial
  • https://inductiveautomation.com/downloads/
• Azure Injector download with free trial
  • https://inductiveautomation.com/downloads/third-party-modules
• Questions about this tutorial?
  • Check out the Cirrus Link Forum: https://forum.cirrus-link.com/
  • Contact support: support@cirrus-link.com
• Sales questions
  • Email: sales@cirrus-link.com
  • Phone: +1 (844) 924-7787
•  About Cirrus Link
  • https://www.cirrus-link.com/about-us/