Skip to main content

Prepare to install or upgrade the ONTAP Mediator service

Contributors netapp-folivia netapp-thomi netapp-ahibbard netapp-aherbin

To install the ONTAP Mediator service, you must ensure all prerequisites are met, fetch the installation package and run the installer on the host. This procedure is used for an installation or an upgrade of an existing installation.

About this task
  • Beginning with ONTAP 9.7, you can use any version of ONTAP Mediator to monitor a MetroCluster IP configuration.

  • Beginning with ONTAP 9.8, you can use any version of ONTAP Mediator to monitor an SM-BC relationship.

Before you begin

You must meet the following prerequisites.

ONTAP Mediator version

Supported Linux versions

1.7

  • Red Hat Enterprise Linux: 8.5, 8.6, 8.7, 8.8, 8.9, 9.0, 9.1, 9.2, and 9.3

  • Rocky Linux 8 and 9

1.6

  • Red Hat Enterprise Linux: 8.4, 8.5, 8.6, 8.7, 8.8, 9.0, 9.1, 9.2

  • Rocky Linux 8 and 9

1.5

  • Red Hat Enterprise Linux: 7.6, 7.7, 7.8, 7.9, 8.1, 8.2, 8.3, 8.4, 8.5

  • CentOS: 7.6, 7.7, 7.8, 7.9

1.4

  • Red Hat Enterprise Linux: 7.6, 7.7, 7.8, 7.9, 8.1, 8.2, 8.3, 8.4, 8.5

  • CentOS: 7.6, 7.7, 7.8, 7.9

1.3

  • Red Hat Enterprise Linux: 7.6, 7.7, 7.8, 7.9, 8.1, 8.2, 8.3

  • CentOS: 7.6, 7.7, 7.8, 7.9

1.2

  • Red Hat Enterprise Linux: 7.6, 7.7, 7.8, 8.1

  • CentOS: 7.6, 7.7, 7.8

Note The kernel version must match the operating system version.
  • 64-bit physical installation or virtual machine

  • 8 GB RAM

  • 1 GB disk space (used for applications installation, server logs, and the database)

  • User: Root access

Any library packages except the kernel can safely be updated but might require a reboot to take affect within the ONTAP Mediator application. A service window is recommended when a reboot is required.

If you install the yum-utils package, you can use the needs-restarting command.

The kernel core can be updated if it is being updated to a version that is still supported by the ONTAP Mediator version matrix. A reboot will be mandatory, so a service window is required.

The SCST kernel module must be uninstalled prior to the reboot, then re-installed after the reboot.

Note Upgrading to a kernel beyond the supported OS release for the specific ONTAP Mediator release is not support. (This likely indicates that the tested SCST module won’t compile).

Register a security key when UEFI Secure Boot is enabled

If UEFI Secure Boot is enabled, to install ONTAP Mediator, you will have to register a security key before the ONTAP Mediator service can start. To determine if the system is UEFI-enabled and Secure Boot is turned on, perform the following steps:

Steps
  1. If mokutil is not installed, run the following command:

    yum install mokutil

  2. To determine if UEFI Secure Boot is enabled on your system, run the following command:

    mokutil --sb-state

    The results show whether UEFI Secure Boot is enabled on this system.

    Note ONTAP Mediator 1.2.0 and previous versions do not support this mode.

Disable UEFI Secure Boot

You can also choose to disable UEFI Secure Boot before installing ONTAP Mediator.

Steps
  1. In the physical machine BIOS settings, disable the "UEFI Secure Boot" option.

  2. In the VMware settings for the VM, disable the "Safe Start" option for vSphere 6.x or the "Secure Boot" option for vSphere 7.x.