Skip to main content
ONTAP Mediator
简体中文版经机器翻译而成,仅供参考。如与英语版出现任何冲突,应以英语版为准。

升级 ONTAP Mediator

贡献者 netapp-aoife netapp-camdenc

要将 ONTAP Mediator 升级到较新版本而不升级主机操作系统,请下载新版本的安装包,并在已安装 ONTAP Mediator 的主机上运行安装程序。

备注 如果您需要将主机操作系统升级到新版本,并作为该过程的一部分重新安装或升级 ONTAP Mediator,请改为参见 "升级主机操作系统和 ONTAP Mediator"。
开始之前
关于此任务

在升级 ONTAP Mediator 之前,请查看下列信息。

  • 您应该将 ONTAP Mediator 升级到最新版本。旧版本仍然适用于所有 ONTAP 版本,但新版本包含第三方组件的安全补丁。

  • 当您升级到包含 SCST 包的新 ONTAP Mediator 版本时,安装程序会自动升级到推荐的 SCST 版本,除非有更高版本可用。有关手动安装更高 SCST 版本的说明,请参见 "维护 ONTAP Mediator 的主机操作系统"。有关支持的版本,请参见 "SCST 支持矩阵"。

备注
  • 如果升级失败,您可能需要尝试更新版本的 ONTAP Mediator。

  • 从 2025 年 6 月 15 日起,您无法安装或升级 ONTAP Mediator 1.9 和 1.8,因为它们的代码签名证书已过期。如果升级失败,请改用 ONTAP Mediator 1.9.1 补丁版本。

  • 从 ONTAP 9.19.1 和 ONTAP Mediator 1.12 开始,您可以选择安装支持 iSCSI 和 HTTPS 的 ONTAP Mediator,或仅支持 HTTPS。如果您选择安装仅支持 HTTPS 的 ONTAP Mediator,则不会安装 SCST 软件包。

  • 如果您从安装了 SCST 的 ONTAP Mediator 1.11 或更早版本升级,并且在升级期间选择了 HTTPS only 选项,则会卸载 SCST 包,并且新的 ONTAP Mediator 版本不包含 SCST 包。

  • 如果您计划使用 ONTAP Mediator 来监控多个 MetroCluster IP 配置,则支持取决于您的 Mediator 类型、ONTAP 版本和操作系统。有关详细信息,请参见"使用 ONTAP Mediator 监控多个 MetroCluster IP 配置"。

  • 仅对以下用例支持安装支持 HTTPS 的 ONTAP Mediator:

    • 您计划仅使用 ONTAP Mediator 来监控您的 SnapMirror 活动同步集群。

    • 您计划使用 HTTPS 配置 ONTAP Mediator 以监视一个或多个 MetroCluster IP 配置。

  • 在以下情况下,必须安装支持 iSCSI 和 HTTPS 的 ONTAP Mediator:

    • 您计划使用 iSCSI 配置 ONTAP Mediator 以监视一个或多个 MetroCluster IP 配置。

  • 当您针对现有的 ONTAP Mediator 安装运行安装程序时,它会检测到当前版本并提示您确认升级:

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

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

  • 作为升级的一部分,安装程序会收集升级前配置的支持包,并在升级 ONTAP Mediator 软件之前迁移数据库。

  • 对于自动化用例,您可以使用 `./ontap-mediator-1.13.0/ontap-mediator-1.13.0 -y`命令跳过安装程序提示。

步骤
  1. 在升级之前,如果您要升级到与以下版本之一配对的 ONTAP Mediator 实例上的 ONTAP Mediator 1.13 或更高版本,请完成以下子步骤:

    • ONTAP 9.11.1 及更早版本

    • 早于 9.12.1P15、9.13.1P12、9.14.1P8 和 9.15.1P2 的 ONTAP 补丁程序版本

      1. 将以下行添加到 `/opt/netapp/lib/ontap_mediator/ontap_mediator/server_config/ontap_mediator.user_config.yaml`文件中。

        'generate_unique_ca_name': false

    此文件在 ONTAP Mediator 升级过程中保留。

  2. 运行新版本的安装程序并根据需要响应提示:

    ./ontap-mediator-1.13.0/ontap-mediator-1.13.0
    备注

    要跳过升级期间的签名检查,请使用 `./ontap-mediator-1.13.0/ontap-mediator-1.13.0 --skip-code-signature-check`命令

    安装程序检测到现有安装并提示您升级,然后安装所需的程序包并迁移配置。

    支持 HTTPS 和 iSCSI 的 ONTAP Mediator 升级示例(控制台输出)
    [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 ~]#
    仅支持 HTTPS 的 ONTAP Mediator 升级示例(控制台输出)
    [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 ~]#