エフサステクノロジーズ株式会社

本ページの製品は2024年4月1日より、エフサステクノロジーズ株式会社に統合となり、順次、切り替えを実施してまいります。一部、富士通表記が混在することがありますので、ご了承ください。

ONTAP 9 マニュアル ( CA08871-402 )

to English version

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

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

開始する前に

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

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

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

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

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

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

    • 31784

    • 3260

  • サードパーティのファイアウォールを使用している場合は、ONTAP Mediatorサービスの設定を参照してください。

  • 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の新しいバージョンを検出しようとするためです。

ONTAP Mediatorインストーラによって.rpmファイルはインストールされているため、この検出の対象となります。ただし、この.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 Active Syncの手順

SnapMirror Active Syncでは、/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