Skip to main content
ONTAP Mediator
La versione in lingua italiana fornita proviene da una traduzione automatica. Per eventuali incoerenze, fare riferimento alla versione in lingua inglese.

Aggiorna ONTAP Mediator

Collaboratori netapp-aoife netapp-camdenc

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.

Nota 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
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".

Nota
  • 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.13.0/ontap-mediator-1.13.0 -y per saltare le richieste dell'installer.

Passaggi
  1. Prima dell'aggiornamento, completa il seguente sottofase se stai eseguendo l'aggiornamento a ONTAP Mediator 1.13 o versione successiva su un'istanza di ONTAP Mediator associata a una delle seguenti release:

    • ONTAP 9.11.1 e versioni precedenti

    • Versioni patch di ONTAP precedenti alla 9.12.1P15, 9.13.1P12, 9.14.1P8 e 9.15.1P2

      1. Aggiungi la seguente riga al /opt/netapp/lib/ontap_mediator/ontap_mediator/server_config/ontap_mediator.user_config.yaml file.

        'generate_unique_ca_name': false

    Questo file viene conservato anche dopo gli aggiornamenti di ONTAP Mediator.

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

    ./ontap-mediator-1.13.0/ontap-mediator-1.13.0
    Nota

    Per saltare il controllo della firma durante l'aggiornamento, usa il ./ontap-mediator-1.13.0/ontap-mediator-1.13.0 --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.13.0/ontap-mediator-1.13.0
    
    + 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
    Error querying OCSP responder
    40B70028217F0000:error:1E800080:HTTP routines:OSSL_HTTP_REQ_CTX_nbio:failed reading data:crypto/http/http_client.c:596:
    40B70028217F0000:error:1E800067:HTTP routines:OSSL_HTTP_REQ_CTX_exchange:error receiving:crypto/http/http_client.c:1046:server=http://ocsp.entrust.net:80
       WARNING: The OCSP check failed while attempting to test the Code-Signature-Check certificate
       Continue without code signature checking (only recommended if integrity has been established manually)? y(es)/N(o): yes
     SKIPPING: Code signature check, manual override due to lack of OCSP response
    + 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 HTTPS support 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.12.1 to 1.13.0.
    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...
    
    Running 1/11: apis...
    
    Creating tar archive...
    Support bundle has been generated at /opt/netapp/data/support_bundles/sdot-r730-0003a-d4.gdl.englab.netapp.com_1792143997_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: 45ca93e60653, Head revision: 086df085a190
    Performing database migrations against clone...
    Migrations successful.
    Database upgrade operation complete.
    + Adding python312 specific packages
    + Upgrading ONTAP Mediator. (Log: /root/ontap_mediator.FO5UgL/ontap-mediator-1.13.0/ontap-mediator-1.13.0/upgrade_20261016054617.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_20261016054617.log)\n
    + WARNING: This system supports UEFI
               Secure Boot (SB) is currently enabled on this system.
               The following action need be taken:
               Using the keys in /opt/netapp/lib/ontap_mediator/ontap_mediator/SCST_mod_keys follow
               instructions in /opt/netapp/lib/ontap_mediator/ontap_mediator/SCST_mod_keys/README.module-signing
               to sign the SCST kernel module. Note that reboot will be needed.
         SCST will not start automatically when Secure Boot is enabled and not configured properly.
    
    + 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
    
    + 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 ~]#
    Esempio di aggiornamento di ONTAP Mediator con supporto solo per HTTPS (output della console)
    [root@mediator-host ~]# ontap-mediator-1.13.0/ontap-mediator-1.13.0 --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
    Error querying OCSP responder
    40A73D8E847F0000:error:1E800080:HTTP routines:OSSL_HTTP_REQ_CTX_nbio:failed reading data:crypto/http/http_client.c:614:
    40A73D8E847F0000:error:1E800067:HTTP routines:OSSL_HTTP_REQ_CTX_exchange:error receiving:crypto/http/http_client.c:1075:server=http://ocsp.entrust.net:80
       WARNING: The OCSP check failed while attempting to test the Code-Signature-Check certificate
       Continue without code signature checking (only recommended if integrity has been established manually)? y(es)/N(o): yes
     SKIPPING: Code signature check, manual override due to lack of OCSP response
    + 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 'HTTPS_ONLY'
    + Selected install package mode: HTTPS_ONLY
    ONTAP Mediator will be upgraded from version 1.12.1 to 1.13.0.
    
    
    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/sdot-r730-0003a-d4.gdl.englab.netapp.com_1792151055_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: 45ca93e60653, Head revision: 086df085a190
    Performing database migrations against clone...
    Migrations successful.
    Database upgrade operation complete.
    + Adding python312 specific packages
    + Upgrading ONTAP Mediator. (Log: /root/ontap_mediator.qmrGsH/ontap-mediator-1.13.0/ontap-mediator-1.13.0/upgrade_20261016074342.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_20261016074342.log)\n
    + WARNING: This system supports UEFI
    + Note: Not signing the SCST modules since they were not installed by this installation.
    + Note: SCST will not start automatically if Secure Boot is enabled and not configured properly.
    
    + 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
    
    + 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 ~]#