Skip to main content
Upgrade Health Checker
日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

Upgrade Health Checkerでアップグレード計画の生成を自動化

共同作成者 netapp-ivanad netapp-yvonneo netapp-barbe

大規模で複雑な環境でONTAPアップグレードを計画する際の手作業を削減するために、アップグレードヘルスチェッカーレポートの生成を自動化できます。

タスク概要

Upgrade Health Checkerは、オンプレミスONTAPバージョン9.11.1以降のアップグレードをサポートしています。Cloud Volumes ONTAPを使用している場合は、システムのアップグレードに関する情報について"Cloud Volumes ONTAPのアップグレード"を参照してください。

手順
  1. アップグレードレポートを確実に作成するには、"ONTAPアップグレードレポートを生成する"に記載されている必要な設定手順と1回限りのタスクを完了してください。

  2. 環境に適したパラメータを使用して Upgrade Health Checker を実行するスクリプトを作成します。

    ./uhc \
      --cluster-ip=<cluster-ip> \
      --cluster-username=<cluster-username> \
      --cluster-password=<cluster-password> \
      --target-ontap-version=<target-ontap-version> \
      --accept-eula=true
  3. Upgrade Health Checkerを実行するためのcronスケジュール用の自動化スクリプトを作成します。以下は、複数のクラスターに対してUpgrade Health Checkerを実行するスクリプトの例です。バイナリファイルとconfig.yamlファイルは/opt/uhc/tool/にインストールされています。

    #!/bin/bash
    # /opt/uhc/tool/uhccron.sh
    # Automated weekly Upgrade Health Checker run for all managed clusters
    # Schedule: Every Monday to Friday at 4am
    
    cd /opt/uhc/tool/
    
    # Cluster1 - keep current version (health check only)
    /opt/uhc/tool/uhc --cluster-ip cluster1-mgmt.example.com \ --target-ontap-version current
    
    # Cluster2 - target upgrade to 9.16.1
    /opt/uhc/tool/uhc --cluster-ip cluster2-mgmt.example.com \ --target-ontap-version 9.16.1
    
    # Cluster3 - target upgrade to 9.17.1
    /opt/uhc/tool/uhc --cluster-ip cluster3-mgmt.example.com \ --target-ontap-version 9.17.1
    
    # Cluster4 - by IP address
    /opt/uhc/tool/uhc --cluster-ip 10.20.30.40 --target-ontap-version 9.16.1
    
    # Add additional clusters as needed
    
    # Make the script executable (one-time setup step)
    chmod +x /opt/uhc/tool/uhccron.sh
  4. 月曜日から金曜日の午前4:00にスクリプトを実行するcronジョブを設定します:

    # Edit the crontab for the uhctool user
    crontab -e
    
    # Add the following line to schedule the script to run Monday through Friday at 4:00 am
    0 4 * * 1-5 /opt/uhc/tool/uhccron.sh
メモ 継続的な健康モニタリングには、特定のアップグレードターゲットを指定せずに `--target-ontap-version current`を使用します。
  1. アップグレードヘルスチェッカーのチェックが完了したら、 `runs`フォルダに移動して、アップグレード計画とクラスタレポートを表示します。

    メモ プログラムの各実行は固有の実行であり、関連するすべてのデータ、ログ、および結果が関連する `runs`フォルダに保存されます。
  2. レポートファイル(名前は uhc_<cluster-name>_<YYYYMMDDHHMMSS>)をWebブラウザ、Microsoft Excel、またはJSONビューアで開いてレポートを表示します。Upgrade Health Checkerをリモートホストで実行している場合は、まずレポートファイルを、Webブラウザ、Excel、またはJSONビューアでレポートを表示できるマシンにダウンロードしてください。

    ログパスとレポートパスは次のとおりです:

    • ログパス: <output-path>/<unique-run-dir>/<cluster-name>/logs

    • HTMLレポートのパス: <output-path>/<unique-run-dir>/<cluster-name>/results/uhc_<cluster-name>_<YYYYMMDDHHMMSS>.html

    • Excelレポートのパス: <output-path>/<unique-run-dir>/<cluster-name>/results/uhc_<cluster-name>_<YYYYMMDDHHMMSS>.xlsx

    • JSONレポートのパス: <output-path>/<unique-run-dir>/<cluster-name>/results/uhc_<cluster-name>_<YYYYMMDDHHMMSS>.json