ONTAP 9.13

to English version

ホスト オペレーティング システム→ONTAP Mediatorの順にアップグレード

ONTAP MediatorのホストOSを新しいバージョンにアップグレードするには、最初にONTAP Mediatorをアンインストールする必要があります。

開始する前に

Red Hat Enterprise LinuxまたはCentOSとその関連リポジトリをシステムにインストールする際のベストプラクティスは次のとおりです。システムのインストールや構成が異なっていると、追加の手順が必要になる場合があります。

  • Red Hat Enterprise LinuxまたはCentOSのインストールについては、Red Hatのベストプラクティスに従う必要があります。CentOS 8.xバージョンのサポートは終了しているため、互換性があるバージョンでもCentOS 8.xは推奨されません。

  • Red Hat Enterprise LinuxまたはCentOSへのONTAP Mediatorサービスのインストール中にインストール プログラムが必要なすべてのソフトウェアにアクセスしてインストールできるように、システムには該当するリポジトリへのアクセスが必要です。

  • yumインストーラがRed Hat Enterprise Linuxリポジトリから依存するソフトウェアを検出できるようにするには、Red Hat Enterprise Linuxのインストール時またはインストール後に有効なRed Hatサブスクリプションを使用してシステムを登録しておく必要があります。

    Red Hat Subscription Managerについては、Red Hatのドキュメントを参照してください。

  • 次のポートをMediator用に空けておく必要があります。

    • 31784

    • 3260

  • サードパーティのファイアウォールを使用している場合は、「MetroClusterのドキュメント」を参照してください。

  • Linuxホストがインターネットにアクセスできない場所にある場合は、必要なパッケージがローカル リポジトリにあることを確認する必要があります。

    Linux環境でLink Aggregation Control Protocol(LACP)を使用している場合は、カーネルを正しく設定し、sysctl net.ipv4.conf.all.arp_ignoreが「2」に設定されていることを確認する必要があります。

要件

ONTAP Mediatorサービスで必要なパッケージは次のとおりです。

RHEL / CentOSのすべてのバージョン

RHEL 8.x / Rocky Linux 8用の追加パッケージ

RHEL 9.x / Rocky Linux 9用の追加パッケージ

  • openssl

  • openssl-devel

  • kernel-devel-$(uname -r)

  • gcc

  • make

  • libselinux-utils

  • patch

  • bzip2

  • perl-Data-Dumper

  • perl-ExtUtils-MakeMaker

  • efibootmgr

  • mokutil

  • python3-pip

  • elfutils-libelf-devel

  • policycoreutils-python-utils

  • redhat-lsb-core

  • python39

  • python39-devel

  • python3-pip

  • elfutils-libelf-devel

  • policycoreutils-python-utils

  • python3

  • python3-devel

Mediatorのインストール パッケージは自己解凍形式の圧縮tarファイルで、次のものが含まれます。

  • サポートされているリリースのリポジトリから取得できないすべての依存関係を含むRPMファイル。

  • インストール スクリプト。

有効なSSL証明書を使用することを推奨します。

タスク概要

leapp-upgradeツールを使用してONTAP MediatorのホストOSを新しいメジャー バージョンにアップグレードする(例:7.xから8.x)場合は、ONTAP Mediatorをアンインストールする必要があります。これは、leapp-upgradeがシステムに登録されているリポジトリにインストールされているRPMの新しいバージョンを検出しようとするためです。

rpmファイルはONTAP Mediatorインストーラによってインストールされているため、この検出の対象となります。ただし、この.rpmファイルはインストーラによって展開されもので、登録されたリポジトリからダウンロードされたものではないため、アップグレード版は見つかりません。この場合、leapp-upgradeツールはパッケージをアンインストールします。

サポート ケースの優先順位付けに使用されるログ ファイルを保持するには、OSのアップグレード前にファイルをバックアップして、ONTAP Mediatorパッケージの再インストール後にリストアする必要があります。ONTAP Mediatorが再インストールされるため、Mediatorに接続されているONTAPクラスタをインストール後に再接続する必要があります。

以下の手順は記載された順番で実行してください。 ONTAP Mediatorの再インストール後、すぐにontap_mediatorサービスを停止してログ ファイルを置き換え、サービスを再起動する必要があります。これは、ログが失われないようにするためです。
手順
  1. ログ ファイルをバックアップします。

    [rootmediator-host ~]# tar -czf ontap_mediator_file_backup.tgz -C /opt/netapp/lib/ontap_mediator ./log ./ontap_mediator/server_config/ontap_mediator.user_config.yaml
    [rootmediator-host ~]# tar -tf ontap_mediator_file_backup.tgz
    ./log/
    ./log/ontap_mediator.log
    ./log/scstadmin.log
    ./log/ontap_mediator_stdout.log
    ./log/ontap_mediator_requests.log
    ./log/install_20230419134611.log
    ./log/scst.log
    ./log/ontap_mediator_syslog.log
    ./ontap_mediator/server_config/ontap_mediator.user_config.yaml
    [rootmediator-host ~]#
  2. leapp-upgradeツールを使用してアップグレードを実行します。

    [rootmediator-host ~]# leapp preupgrade --target 8.4
      ..<snip upgrade checks>..
      ..<fix issues found>..
    [rootmediator-host ~]# leapp upgrade --target 8.4
      ..<snip upgrade>..
    [rootmediator-host ~]# cat /etc/os-release | head -2
    NAME="Red Hat Enterprise Linux"
    VERSION="8.4 (Ootpa)"
    [rootmediator-host ~]#
  3. ONTAP Mediatorを再インストールします。

    ログ ファイルが失われないように、ONTAP Mediatorの再インストール後すぐに残りの手順を実行してください。
    [rootmediator-host ~]# ontap-mediator-1.6.0/ontap-mediator-1.6.0
    
    ONTAP Mediator: Self Extracting Installer
    
      ..<snip installation>..
    [rootmediator-host ~]#
  4. ontap_mediatorサービスを停止します。

    [rootmediator-host ~]# systemctl stop ontap_mediator
    [rootmediator-host ~]#
  5. ログ ファイルを置き換えます。

    [rootmediator-host ~]# tar -xf ontap_mediator_log_backup.tgz -C /opt/netapp/lib/ontap_mediator
    [rootmediator-host ~]#
  6. ontap_mediatorサービスを開始します。

    [rootmediator-host ~]# systemctl start ontap_mediator
    [rootmediator-host ~]#
  7. アップグレードしたONTAP MediatorにすべてのONTAPクラスタを再接続します。

    MetroCluster over IPの手順
    siteA::> metrocluster configuration-settings mediator show
    Mediator IP     Port    Node                    Configuration Connection
                                                    Status        Status
    --------------- ------- ----------------------- ------------- -----------
    172.31.40.122
                    31784   siteA-node2             true          false
                            siteA-node1             true          false
                            siteB-node2             true          false
                            siteB-node2             true          false
    siteA::> metrocluster configuration-settings mediator remove
    Removing the mediator and disabling Automatic Unplanned Switchover. It may take a few minutes to complete.
    Please enter the username for the mediator: mediatoradmin
    Please enter the password for the mediator:
    Confirm the mediator password:
    Automatic Unplanned Switchover is disabled for all nodes...
    Removing mediator mailboxes...
    Successfully removed the mediator.
    
    siteA::> metrocluster configuration-settings mediator add -mediator-address 172.31.40.122
    Adding the mediator and enabling Automatic Unplanned Switchover. It may take a few minutes to complete.
    Please enter the username for the mediator: mediatoradmin
    Please enter the password for the mediator:
    Confirm the mediator password:
    Successfully added the mediator.
    
    siteA::> metrocluster configuration-settings mediator show
    Mediator IP     Port    Node                    Configuration Connection
                                                    Status        Status
    --------------- ------- ----------------------- ------------- -----------
    172.31.40.122
                    31784   siteA-node2             true          true
                            siteA-node1             true          true
                            siteB-node2             true          true
                            siteB-node2             true          true
    siteA::>
    SnapMirror Business Continuityの手順

    SnapMirror Business Continuityでは、/opt/netappディレクトリー以外にTLS証明書をインストールした場合、証明書を再インストールする必要はありません。デフォルトの自己署名証明書を使用していた場合、または独自の証明書を/opt/netappディレクトリーに配置していた場合は、証明書をバックアップしてリストアする必要があります。

    peer1::> snapmirror mediator show
    Mediator Address Peer Cluster     Connection Status Quorum Status
    ---------------- ---------------- ----------------- -------------
    172.31.49.237    peer2            unreachable       true
    
    peer1::> snapmirror mediator remove -mediator-address 172.31.49.237 -peer-cluster peer2
    
    Info: [Job 39] 'mediator remove' job queued
    
    peer1::> job show -id 39
                                Owning
    Job ID Name                 Vserver    Node           State
    ------ -------------------- ---------- -------------- ----------
    39     mediator remove      peer1      peer1-node1    Success
         Description: Removing entry in mediator
    
    peer1::> security certificate show -common-name ONTAPMediatorCA
    Vserver    Serial Number   Certificate Name                       Type
    ---------- --------------- -------------------------------------- ------------
    peer1
            4A790360081F41145E14C5D7CE721DC6C210007F
                            ONTAPMediatorCA                        server-ca
        Certificate Authority: ONTAP Mediator CA
            Expiration Date: Mon Apr 17 10:27:54 2073
    
    peer1::> security certificate delete -common-name ONTAPMediatorCA *
    1 entry was deleted.
    
     peer1::> security certificate install -type server-ca -vserver peer1
    
    Please enter Certificate: Press <Enter> when done
      ..<snip ONTAP Mediator CA public key>..
    
    You should keep a copy of the CA-signed digital certificate for future reference.
    
    The installed certificate's CA and serial number for reference:
    CA: ONTAP Mediator CA
    serial: 44786524464C5113D5EC966779D3002135EA4254
    
    The certificate's generated name for reference: ONTAPMediatorCA
    
    peer2::> security certificate delete -common-name ONTAPMediatorCA *
    1 entry was deleted.
    
    peer2::> security certificate install -type server-ca -vserver peer2
    
     Please enter Certificate: Press <Enter> when done
    ..<snip ONTAP Mediator CA public key>..
    
    
    You should keep a copy of the CA-signed digital certificate for future reference.
    
    The installed certificate's CA and serial number for reference:
    CA: ONTAP Mediator CA
    serial: 44786524464C5113D5EC966779D3002135EA4254
    
    The certificate's generated name for reference: ONTAPMediatorCA
    
    peer1::> snapmirror mediator add -mediator-address 172.31.49.237 -peer-cluster peer2 -username mediatoradmin
    
    Notice: Enter the mediator password.
    
    Enter the password:
    Enter the password again:
    
    Info: [Job: 43] 'mediator add' job queued
    
    peer1::> job show -id 43
                                Owning
    Job ID Name                 Vserver    Node           State
    ------ -------------------- ---------- -------------- ----------
    43     mediator add         peer1      peer1-node2    Success
        Description: Creating a mediator entry
    
    peer1::> snapmirror mediator show
    Mediator Address Peer Cluster     Connection Status Quorum Status
    ---------------- ---------------- ----------------- -------------
    172.31.49.237    peer2            connected         true
    
    peer1::>
Top of Page