Skip to main content
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

Mettre à niveau ONTAP Mediator

Contributeurs netapp-aoife netapp-camdenc

Pour mettre à niveau ONTAP Mediator vers une version plus récente sans mettre à niveau le système d'exploitation hôte, téléchargez le package d'installation de la nouvelle version et exécutez le programme d'installation sur l'hôte sur lequel ONTAP Mediator est déjà installé.

Remarque Si vous devez mettre à niveau le système d’exploitation hôte vers une nouvelle version et réinstaller ou mettre à niveau ONTAP Mediator dans le cadre de ce processus, consultez plutôt "Mettez à niveau le système d'exploitation hôte et ONTAP Mediator".
Avant de commencer
À propos de cette tâche

Veuillez consulter les informations suivantes avant de mettre à niveau ONTAP Mediator.

  • Vous devez mettre à niveau ONTAP Mediator vers la dernière version. Les versions antérieures restent compatibles avec toutes les versions d’ONTAP, mais les versions plus récentes intègrent des correctifs de sécurité pour les composants tiers.

  • Lors de la mise à niveau vers une nouvelle version d'ONTAP Mediator incluant le package SCST, le programme d'installation effectue automatiquement la mise à niveau vers la version SCST recommandée, sauf si une version supérieure est disponible. Pour obtenir des instructions sur l'installation manuelle d'une version SCST supérieure, consultez "Maintenir le système d'exploitation hôte pour ONTAP Mediator". Pour les versions prises en charge, consultez le "Matrice de prise en charge SCST".

Remarque
  • Si la mise à niveau échoue, vous devrez peut-être essayer une version plus récente d'ONTAP Mediator.

  • À compter du 15 juin 2025, vous ne pourrez plus installer ni mettre à niveau ONTAP Mediator 1.9 et 1.8, car leurs certificats de signature de code ont expiré. Si la mise à niveau échoue, utilisez plutôt la version de correctif ONTAP Mediator 1.9.1.

  • À partir d'ONTAP 9.19.1 et ONTAP Mediator 1.12, vous avez la possibilité d'installer ONTAP Mediator avec la prise en charge d'iSCSI et d'HTTPS, ou uniquement avec la prise en charge d'HTTPS. Si vous choisissez d'installer ONTAP Mediator avec la prise en charge d'HTTPS uniquement, le package SCST n'est pas installé.

  • Si vous effectuez une mise à niveau depuis ONTAP Mediator 1.11 ou une version antérieure avec SCST installé, et que vous choisissez l'option HTTPS uniquement lors de la mise à niveau, le package SCST est désinstallé et la nouvelle version d'ONTAP Mediator ne contient pas le package SCST.

  • Si vous prévoyez d'utiliser ONTAP Mediator pour surveiller plusieurs configurations IP MetroCluster, la prise en charge dépend de votre type de Mediator, de la version d'ONTAP et du système d'exploitation. Consultez "Utilisez ONTAP Mediator pour surveiller plusieurs configurations IP MetroCluster" pour plus d'informations.

  • L'installation ONTAP Mediator avec prise en charge du protocole HTTPS uniquement est prise en charge pour les cas d'utilisation suivants :

    • Vous prévoyez d'utiliser uniquement ONTAP Mediator pour surveiller vos clusters de synchronisation active SnapMirror.

    • Vous prévoyez de configurer ONTAP Mediator avec HTTPS pour surveiller une ou plusieurs configurations IP MetroCluster.

  • ONTAP Mediator doit être installé avec la prise en charge d'iSCSI et de HTTPS dans le scénario suivant :

    • Vous prévoyez de configurer ONTAP Mediator avec iSCSI pour surveiller une ou plusieurs configurations IP MetroCluster.

  • Lorsque vous exécutez le programme d'installation sur une installation existante de ONTAP Mediator, il détecte la version actuelle et vous invite à confirmer la mise à niveau :

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

    Do you wish to continue? Y(es)/n(o):

  • Dans le cadre de la mise à niveau, le programme d'installation capture un ensemble de support de votre configuration antérieure à la mise à niveau et migre la base de données avant de mettre à niveau le logiciel ONTAP Mediator.

  • Pour les cas d'utilisation d'automatisation, vous pouvez utiliser la commande ./ontap-mediator-1.13.0/ontap-mediator-1.13.0 -y pour ignorer les invites de l'installateur.

Étapes
  1. Avant la mise à niveau, effectuez la sous-étape suivante si vous effectuez une mise à niveau vers ONTAP Mediator 1.13 ou une version ultérieure sur une instance ONTAP Mediator associée à l’une des versions suivantes :

    • ONTAP 9.11.1 et versions antérieures

    • Correctifs ONTAP antérieurs aux versions 9.12.1P15, 9.13.1P12, 9.14.1P8 et 9.15.1P2

      1. Ajoutez la ligne suivante au fichier /opt/netapp/lib/ontap_mediator/ontap_mediator/server_config/ontap_mediator.user_config.yaml.

        'generate_unique_ca_name': false

    Ce fichier est conservé lors des mises à niveau d’ONTAP Mediator.

  2. Exécutez le programme d'installation de la nouvelle version et répondez aux invites comme demandé :

    ./ontap-mediator-1.13.0/ontap-mediator-1.13.0
    Remarque

    Pour ignorer la vérification de signature lors de la mise à niveau, utilisez la ./ontap-mediator-1.13.0/ontap-mediator-1.13.0 --skip-code-signature-check commande

    Le programme d'installation détecte l'installation existante et vous invite à la mettre à niveau, puis installe les paquets requis et migre votre configuration.

    Exemple de mise à niveau d'ONTAP Mediator avec prise en charge HTTPS et iSCSI (sortie 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 ~]#
    Exemple de mise à niveau d'ONTAP Mediator avec prise en charge de HTTPS uniquement (sortie 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 ~]#