Using the ERM Installer to install and upgrade components

This topic explains how to upgrade the ERM Installer, upgrade an ERM module, and how to uninstall a module.

Upgrading the ERM Installer

If your primary ERM VM runs in online mode with direct access to the ERM docker image registry and OS update service then the latest installer images are automatically downloaded. The new installer version will start either when the VM is rebooted or when the administrator forces an upgrade via Settings → Upgrade Installer and selecting Start upgrade, followed by clicking reload in the terminal panel.

Note that the installer services will be unavailable for a short period as the upgrade completes and the services restart.

If the primary ERM VM is used offline, then an offline bundle must be prepared from the online ERM VM:

You must ensure that the ERM Installer version is the same on each ERM deployment (online and offline).

  1. On the online ERM VM, go to Settings > Upgrade Installer and select Export offline bundle of installer to prepare the installer image.

    The offline file can be large and take several minutes to prepare. Please be patient and do not navigate away from the page.

  2. Transfer the exported file using your preferred method (for example, a USB stick) to the second offline (air-gapped) VM.
  3. Using the Installer on the second VM, go to Settings > Handle offline bundle and Import the file that was just exported.

For full details about offline bundles, see Installing and upgrading ERM in an offline environment.

ERM module upgrades/downgrades

If the ERM VM runs in online mode with direct access to the ERM docker image registry and OS update services, new versions of the licensed modules will show as available in the Upgrade dropdown box via Installation > Installed Product > Details. When a more recent (or a previous) version of the module is selected, you should click Deploy changes to complete the process.

To apply any security-related updates to modules that may be available, you need to select Install available bugfix/security updates for services.

The module's services will be unavailable for a short period as the changes are applied, and the services restart.

If the primary ERM VM is used offline, then an offline bundle must be prepared from the online ERM VM:

You must ensure that the ERM Installer version is the same on each ERM deployment (online and offline).

  1. On the online VM, go to Installation > Installed Product > Details, select the version to upgrade (or downgrade) to via the Upgrade dropdown box, and then select Export offline bundle to prepare the module image.

    The offline file can be large and take several minutes to prepare. Please be patient and do not navigate away from the page.

  2. Transfer the exported file using your preferred method (for example, a USB stick) to the second offline (air-gapped) VM.
  3. Using the Installer on the second VM, go to Settings > Handle offline bundle and Import the file that was just exported.

For full details about offline bundles, see Installing and upgrading ERM in an offline environment.

Uninstalling a module

To uninstall a module, select the Uninstall option from the bottom of the version selection box, and select Deploy changes.