升级 ONTAP Mediator
要将 ONTAP Mediator 升级到较新版本而不升级主机操作系统,请下载新版本的安装包,并在已安装 ONTAP Mediator 的主机上运行安装程序。
|
|
如果您需要将主机操作系统升级到新版本,并作为该过程的一部分重新安装或升级 ONTAP Mediator,请改为参见 "升级主机操作系统和 ONTAP Mediator"。 |
-
确认您的主机满足"准备安装 ONTAP Mediator"中所述的先决条件,包括主机、防火墙和操作系统要求。
-
下载新版本的安装软件包。请参阅 "下载 ONTAP Mediator 安装包"。
-
NetApp 建议验证新安装包的代码签名。请参阅 "验证 ONTAP Mediator 安装包的代码签名"。
在升级 ONTAP Mediator 之前,请查看下列信息。
-
您应该将 ONTAP Mediator 升级到最新版本。旧版本仍然适用于所有 ONTAP 版本,但新版本包含第三方组件的安全补丁。
-
当您升级到包含 SCST 包的新 ONTAP Mediator 版本时,安装程序会自动升级到推荐的 SCST 版本,除非有更高版本可用。有关手动安装更高 SCST 版本的说明,请参见 "维护 ONTAP Mediator 的主机操作系统"。有关支持的版本,请参见 "SCST 支持矩阵"。
|
|
|
-
从 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`命令跳过安装程序提示。
-
在升级之前,如果您要升级到与以下版本之一配对的 ONTAP Mediator 实例上的 ONTAP Mediator 1.13 或更高版本,请完成以下子步骤:
-
ONTAP 9.11.1 及更早版本
-
早于 9.12.1P15、9.13.1P12、9.14.1P8 和 9.15.1P2 的 ONTAP 补丁程序版本
-
将以下行添加到 `/opt/netapp/lib/ontap_mediator/ontap_mediator/server_config/ontap_mediator.user_config.yaml`文件中。
'generate_unique_ca_name': false
-
此文件在 ONTAP Mediator 升级过程中保留。
-
-
运行新版本的安装程序并根据需要响应提示:
./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 ~]#