La versione in lingua italiana fornita proviene da una traduzione automatica. Per eventuali incoerenze, fare riferimento alla versione in lingua inglese.

Aggiorna ONTAP Mediator

10/19/2026 Collaboratori

PDF

Per aggiornare ONTAP Mediator a una versione più recente senza aggiornare il sistema operativo host, scarica il pacchetto di installazione della nuova versione ed esegui il programma di installazione sull'host in cui ONTAP Mediator è già installato.

Se devi aggiornare il sistema operativo host a una nuova versione e reinstallare o aggiornare ONTAP Mediator nell'ambito di questo processo, consulta invece "Aggiornare il sistema operativo host e ONTAP Mediator".

Prima di iniziare

Verifica che il tuo host soddisfi i prerequisiti descritti in "Preparati a installare ONTAP Mediator", inclusi i requisiti relativi all'host, al firewall e all'OS.
Scarica il pacchetto di installazione per la nuova versione. Vedi "Scarica il pacchetto di installazione di ONTAP Mediator".
NetApp consiglia di verificare la firma del codice del nuovo pacchetto di installazione. Vedi "Verifica la firma del codice del pacchetto di installazione di ONTAP Mediator".

Informazioni su questa attività

Prima di aggiornare ONTAP Mediator, leggi le seguenti informazioni.

Dovresti aggiornare ONTAP Mediator all'ultima versione. Le versioni meno recenti funzionano ancora con tutte le release di ONTAP, ma quelle più recenti includono patch di sicurezza per i componenti di terze parti.
Quando si esegue l'aggiornamento a una nuova versione di ONTAP Mediator che include il pacchetto SCST, il programma di installazione esegue automaticamente l'aggiornamento alla versione SCST consigliata, a meno che non sia disponibile una versione superiore. Per istruzioni sull'installazione manuale di una versione SCST superiore, consultare "Mantieni il sistema operativo host per ONTAP Mediator". Per le versioni supportate, consultare il "Matrice di supporto SCST".

Se l'aggiornamento non riesce, potresti dover provare una versione più recente di ONTAP Mediator.
Dal 15 giugno 2025, non puoi installare o aggiornare ONTAP Mediator 1.9 e 1.8 perché i relativi certificati di firma del codice sono scaduti. Se l'aggiornamento non riesce, usa invece la versione patch 1.9.1 di ONTAP Mediator.

A partire da ONTAP 9.19.1 e ONTAP Mediator 1.12, puoi installare ONTAP Mediator con supporto per iSCSI e HTTPS, oppure solo con supporto per HTTPS. Se scegli di installare ONTAP Mediator con supporto solo per HTTPS, il pacchetto SCST non viene installato.
Se si esegue l'aggiornamento da ONTAP Mediator 1.11 o versioni precedenti con SCST installato e si sceglie l'opzione solo HTTPS durante l'aggiornamento, il pacchetto SCST viene disinstallato e la nuova versione di ONTAP Mediator non contiene il pacchetto SCST.
Se hai intenzione di usare ONTAP Mediator per monitorare più configurazioni IP di MetroCluster, il supporto dipende dal tipo di Mediator, dalla versione di ONTAP e dal sistema operativo. Per ulteriori informazioni, consulta "Utilizza ONTAP Mediator per monitorare più configurazioni IP MetroCluster".
L'installazione di ONTAP Mediator con supporto solo per HTTPS è supportata nei seguenti casi d'uso:
- Hai intenzione di utilizzare ONTAP Mediator esclusivamente per monitorare i tuoi SnapMirror cluster di sincronizzazione attivi.
- Hai intenzione di configurare ONTAP Mediator con HTTPS per monitorare una o più configurazioni IP MetroCluster.
ONTAP Mediator deve essere installato con il supporto per iSCSI e HTTPS nel seguente scenario:
- Si prevede di configurare ONTAP Mediator con iSCSI per monitorare una o più configurazioni IP MetroCluster.
Quando esegui il programma di installazione su un'installazione ONTAP Mediator esistente, il sistema rileva la versione corrente e ti chiede di confermare l'aggiornamento:

ONTAP Mediator will be upgraded from version <current-version> to <new-version>.

Do you wish to continue? Y(es)/n(o):
Nell'ambito dell'aggiornamento, il programma di installazione acquisisce un pacchetto di supporto della configurazione precedente all'aggiornamento e migra il database prima di aggiornare il software ONTAP Mediator.
Per i casi d'uso di automazione, puoi usare il comando ./ontap-mediator-1.12.1/ontap-mediator-1.12.1 -y per saltare le richieste dell'installer.

Passaggi

Esegui il programma di installazione della nuova versione e rispondi alle richieste come richiesto:

./ontap-mediator-1.12.1/ontap-mediator-1.12.1

Per saltare il controllo della firma durante l'aggiornamento, usa il ./ontap-mediator-1.12.1/ontap-mediator-1.12.1 --skip-code-signature-check comando

Il programma di installazione rileva l'installazione esistente e ti invita ad aggiornare, quindi installa i pacchetti necessari e migra la tua configurazione.

Esempio di aggiornamento di ONTAP Mediator con supporto HTTPS e iSCSI (output della console)

[root@mediator_host ~]# ontap-mediator-1.11.0/ontap-mediator-1.11.0

ONTAP Mediator: Self Extracting Installer

+ Extracting the ONTAP Mediator installation/upgrade archive
+ Performing the ONTAP Mediator run-time code signature check
Using openssl from the path: /usr/bin/openssl configured for CApath:/etc/pki/tls
+ Unpacking the ONTAP Mediator installer
ONTAP Mediator requires two user accounts. One for the service (netapp), and one for use by ONTAP to the mediator API (mediatoradmin).
Using default account names: netapp + mediatoradmin

Enter ONTAP Mediator user account (mediatoradmin) password:

Re-Enter ONTAP Mediator user account (mediatoradmin) password:

+ Checking if SELinux is in enforcing mode

+ Checking for default Linux firewall

+ Installing required packages.

Last metadata expiration check: 0:03:56 ago on Mon 20 Apr 2026 02:49:08 PM EDT.
Package openssl-1:3.5.1-7.el9_7.x86_64 is already installed.
Package openssl-devel-1:3.5.1-7.el9_7.x86_64 is already installed.
Package kernel-devel-5.14.0-611.45.1.el9_7.x86_64 is already installed.
Package kernel-modules-core-5.14.0-611.45.1.el9_7.x86_64 is already installed.
Package gcc-11.5.0-11.el9.x86_64 is already installed.
Package make-1:4.3-8.el9.x86_64 is already installed.
Package which-2.21-30.el9_6.x86_64 is already installed.
Package libselinux-utils-3.6-3.el9.x86_64 is already installed.
Package patch-2.7.6-16.el9.x86_64 is already installed.
Package perl-Data-Dumper-2.174-462.el9.x86_64 is already installed.
Package perl-ExtUtils-MakeMaker-2:7.60-3.el9.noarch is already installed.
Package bzip2-1.0.8-10.el9_5.x86_64 is already installed.
Package efibootmgr-16-12.el9.x86_64 is already installed.
Package mokutil-2:0.7.2-1.el9.x86_64 is already installed.
Package python3-pip-21.3.1-1.el9.noarch is already installed.
Package elfutils-libelf-devel-0.193-1.el9.x86_64 is already installed.
Package policycoreutils-python-utils-3.6-3.el9.noarch is already installed.
Package python3.12-3.12.12-4.el9_7.2.x86_64 is already installed.
Package python3.12-devel-3.12.12-4.el9_7.2.x86_64 is already installed.
Dependencies resolved.
Nothing to do.
Complete!
OS package installations finished
+ Installing ONTAP Mediator. (Log: /root/ontap_mediator.uigddi/ontap-mediator-1.11.0/ontap-mediator-1.11.0/install_20260420145003.log)
This step will take several minutes. Use the log file to view progress.
Sudoer config verified
ONTAP Mediator rsyslog and logging rotation enabled
+ Install successful. (Moving log to /opt/netapp/lib/ontap_mediator/log/install_20260420145003.log)

+ Note: ONTAP Mediator generated a self-signed server certificate for temporary use on
this host. If the DNS name or IP address for the host is changed, the certificate
will no longer be valid. The default certificates should be replaced with secure
trusted certificates signed by a known certificate authority prior to use for production.
For more information, see /opt/netapp/lib/ontap_mediator/README

ONTAP Mediator: Self Extracting Installer

+ Extracting the ONTAP Mediator installation/upgrade archive
+ Performing the ONTAP Mediator run-time code signature check
Using openssl from the path: /usr/bin/openssl configured for CApath:/etc/pki/tls
+ Unpacking the ONTAP Mediator installer
+ ONTAP_MEDIATOR_INSTALL_HTTPS_ONLY is set to '0', args are: ''
+ Starting ONTAP Mediator install/update process: previous installation_mode is ''

ONTAP Mediator can be installed with iSCSI and HTTPS support, or support for HTTPS only.
Do you wish to install ONTAP Mediator with iSCSI and HTTPS support? Y(es)/n(o): yes
ONTAP Mediator will be installed with mode: ISCSI_HTTPS
+ Selected install package mode: ISCSI_HTTPS
ONTAP Mediator will be upgraded from version 1.11.0 to 1.12.1.

Do you wish to continue? Y(es)/n(o): yes
Capturing support_bundle to save pre-upgrade configuration. API Credentials are required.
Mediator API User Name: mediatoradmin
Password: Running plugins, please wait...

Creating tar archive...
Support bundle has been generated at /opt/netapp/data/support_bundles/scs001097036-1_1776711598_BASIC.tgz
Testing the DB can be upgraded
Cloning database...
Cloning successful.
Verifying database is up-to-date...
Database out-of-date.Migrations are necessary:
Current revision: 0d5dcf349b27, Head revision: 758e4873c40d
Performing database migrations against clone...
Migrations successful.
Database upgrade operation complete.
+ Adding python312 specific packages
+ Upgrading ONTAP Mediator. (Log: /root/ontap_mediator.gwaGmU/ontap-mediator-1.12.1/ontap-mediator-1.12.1/upgrade_20260420145942.log)

Esempio di aggiornamento di ONTAP Mediator con supporto solo per HTTPS (output della console)

[root@mediator_host~]# ontap-mediator-1.11.0/ontap-mediator-1.11.0

ONTAP Mediator: Self Extracting Installer

Enter ONTAP Mediator user account (mediatoradmin) password:

Re-Enter ONTAP Mediator user account (mediatoradmin) password:

+ Checking if SELinux is in enforcing mode

+ Checking for default Linux firewall

+ Installing required packages.

Last metadata expiration check: 0:33:41 ago on Tue 21 Apr 2026 10:48:35 AM EDT.
Package openssl-1:3.5.1-7.el9_7.x86_64 is already installed.
Package openssl-devel-1:3.5.1-7.el9_7.x86_64 is already installed.
Package kernel-devel-5.14.0-611.45.1.el9_7.x86_64 is already installed.
Package kernel-modules-core-5.14.0-611.45.1.el9_7.x86_64 is already installed.
Package gcc-11.5.0-11.el9.x86_64 is already installed.
Package make-1:4.3-8.el9.x86_64 is already installed.
Package which-2.21-30.el9_6.x86_64 is already installed.
Package libselinux-utils-3.6-3.el9.x86_64 is already installed.
Package patch-2.7.6-16.el9.x86_64 is already installed.
Package perl-Data-Dumper-2.174-462.el9.x86_64 is already installed.
Package perl-ExtUtils-MakeMaker-2:7.60-3.el9.noarch is already installed.
Package bzip2-1.0.8-10.el9_5.x86_64 is already installed.
Package efibootmgr-16-12.el9.x86_64 is already installed.
Package mokutil-2:0.7.2-1.el9.x86_64 is already installed.
Package python3-pip-21.3.1-1.el9.noarch is already installed.
Package elfutils-libelf-devel-0.193-1.el9.x86_64 is already installed.
Package policycoreutils-python-utils-3.6-3.el9.noarch is already installed.
Package python3.12-3.12.12-4.el9_7.2.x86_64 is already installed.
Package python3.12-devel-3.12.12-4.el9_7.2.x86_64 is already installed.
Dependencies resolved.
Nothing to do.
Complete!
OS package installations finished
+ Installing ONTAP Mediator. (Log: /root/ontap_mediator.JclgnS/ontap-mediator-1.11.0/ontap-mediator-1.11.0/install_20260421112205.log)
This step will take several minutes. Use the log file to view progress.
Sudoer config verified
ONTAP Mediator rsyslog and logging rotation enabled
+ Install successful. (Moving log to /opt/netapp/lib/ontap_mediator/log/install_20260421112205.log)

+ Note: ONTAP Mediator uses a kernel module compiled specifically for the current
OS. Using 'yum update' to upgrade the kernel might cause service interruption.
For more information, see /opt/netapp/lib/ontap_mediator/README
[root@mediator_host~]#
[root@mediator_host~]# tar -zxvf ontap-mediator-1.12.1.tgz
ontap-mediator-1.12.1/
ontap-mediator-1.12.1/csc-prod-chain-ONTAP-Mediator.pem
ontap-mediator-1.12.1/tsa-prod-ONTAP-Mediator.pem
ontap-mediator-1.12.1/csc-prod-ONTAP-Mediator.pem
ontap-mediator-1.12.1/tsa-prod-chain-ONTAP-Mediator.pem
ontap-mediator-1.12.1/ONTAP-Mediator-production.pub
ontap-mediator-1.12.1/ontap-mediator-1.12.1
ontap-mediator-1.12.1/ontap-mediator-1.12.1.sig
ontap-mediator-1.12.1/ontap-mediator-1.12.1.tsr
ontap-mediator-1.12.1/ontap-mediator-1.12.1.sig.tsr
[root@mediator_host~]#
[root@mediator_host~]# ontap-mediator-1.12.1/ontap-mediator-1.12.1 --https-only

ONTAP Mediator: Self Extracting Installer

+ Extracting the ONTAP Mediator installation/upgrade archive
+ Performing the ONTAP Mediator run-time code signature check
Using openssl from the path: /usr/bin/openssl configured for CApath:/etc/pki/tls
+ Unpacking the ONTAP Mediator installer
+ ONTAP_MEDIATOR_INSTALL_HTTPS_ONLY is set to '1', args are: ''
+ Starting ONTAP Mediator install/update process: previous installation_mode is ''
+ Selected install package mode: HTTPS_ONLY
ONTAP Mediator will be upgraded from version 1.11.0 to 1.12.1.

Creating tar archive...
Support bundle has been generated at /opt/netapp/data/support_bundles/scs001097036-1_1776785423_BASIC.tgz
Testing the DB can be upgraded
Cloning database...
Cloning successful.
Verifying database is up-to-date...
Database out-of-date.Migrations are necessary:
Current revision: 0d5dcf349b27, Head revision: 758e4873c40d
Performing database migrations against clone...
Migrations successful.
Database upgrade operation complete.
+ Adding python312 specific packages
+ Upgrading ONTAP Mediator. (Log: /root/ontap_mediator.cRy0mN/ontap-mediator-1.12.1/ontap-mediator-1.12.1/upgrade_20260421113003.log)
fapolicyd not installed or no rules.d directory found, skipping fapolicyd configuration
ONTAP Mediator rsyslog and logging rotation enabled
+ Upgrade successful. (Moving log to /opt/netapp/lib/ontap_mediator/log/upgrade_20260421113003.log)\n

[root@mediator_host ~]#

Aggiorna ONTAP Mediator

Creating your file...