9.5.5 ahf software

ahf softwareコマンドを使用して、AHFソフトウェアの詳細の取得、月次推奨パッチ(MRP)の取得、ダウングレード・ターゲットの取得、ダウングレード・インストーラの検証、更新履歴の取得およびダウングレード履歴の取得を行います。

ahf softwareコマンドの使用目的は次のとおりです。
  • インストールされているAHFのバージョンを問い合せます。
  • Oracleホームが存在する月次推奨パッチ(MRP)レベルを見つけます。
  • 特定のMRPレベルのインストール済および欠落しているパッチのリストをフェッチします。これは、OracleホームにすべてのMRPのパッチがインストールされているかどうかの判断に役立ちます。
  • ダウングレード・ターゲットを取得します
  • ダウングレード・インストーラを検証します
  • 更新履歴を取得します
  • ダウングレード履歴を取得します
出力をJSON形式で取得するには、次のコマンドで--to-jsonオプションを使用します。
  • ahf software get-version
  • ahf software compare-mrp-level
  • ahf software get-latest-mrp-level

次のコマンドを使用して、ダウングレード・ターゲットの取得、ダウングレード・インストーラの検証、更新履歴の取得およびダウングレード履歴の取得を行います。

  • ahf software get-downgrade-target [options]
    オプション:
    • --to-json: 出力をJSON形式で取得します
    • --version: ダウングレード・ターゲットのバージョンを取得します
    • --location: ダウングレード・ターゲット・インストーラの場所を取得します
  • ahf software validate-downgrade-installer [options]
    オプション:
    • --to-json: 出力をJSON形式で取得します
    • --installer INSTALLER: インストーラ・ファイルを指定します
  • ahf software get-update-history [options]
    オプション:
    • --to-json: 出力をJSON形式で取得します
    • --update-id UPDATE_ID: 更新IDオプションはフレームワーク更新にのみ適用可能です
    • --all: すべての更新の情報を取得します
  • ahf software get-upgrade-history [options]

    オプション:

    • --to-json: 出力をJSON形式で取得します
  • ahf software downgrade

    AHFダウングレードをリクエストするには、このコマンドを実行します。これにより、インストーラがAHFに保存されている場合、AHFはバックグラウンドで以前のバージョンに戻ります。詳細は、「Oracle Autonomous Health Frameworkのダウングレード」を参照してください。

  • ahf software get-update-history [options]

    オプション:

    • --to-json: 出力をJSON形式で取得します
    • --update-id UPDATE_ID: このオプションはフレームワークの更新にのみ適用されます
    • --all: すべての更新の情報を取得します
  • ahf software rollback-update [options]

    オプション:

    • --to-json: 出力をJSON形式で取得します
    • --update-id UPDATE_ID: ロールバックする更新のIDを指定します
  • ahf software delete-update-backup [options]

    オプション:

    • --to-json: 出力をJSON形式で取得します
    • --update-id UPDATE_ID: 削除する更新のIDを指定します
  • ahf software move [options]

    オプション:

    • --to-json: 出力をJSON形式で取得します
    • --destination DESTINATION: AHFディレクトリを移動する宛先ディレクトリを指定します
    • --with-data-dir: AHFホーム・ディレクトリとデータ・ディレクトリの両方を指定された宛先に移動します

構文: ahf software

  • AHFのインストール・バージョンを取得するには、次のようにします。
    ahf software get-version --component all
    たとえば:
    ahf software get-version --component all
    AHF version: 24.2.0
    Build Timestamp: 20240224222447
    TFA version: 24.2.0
    Compliance version: 24.2.0
    Compliance metadata version: 20240224
  • 指定したOracleホームのMRPレベルを取得するには、次のようにします。
    ahf software get-mrp-level --oracle_home ORACLE_HOME
    たとえば:
    • データベース: 準拠しており、欠落パッチなし

      ahf software get-mrp-level --oracle-home /u01/oracle
      Database MRP 19.17.0.0.221115
    • グリッド・インフラストラクチャ: 準拠しており、欠落パッチなし

      ahf software get-mrp-level --oracle-home /u01/oracle/grid
      GI MRP 19.17.0.0.230221
    • Oracleホーム: MRP未インストール

      ahf software get-mrp-level --oracle-home /u01/oracle
      No MRP installed in the Oracle Home
  • Oracleホームと特定のMRPレベルを比較し、インストール済および欠落しているパッチを取得するには、次のようにします。
    ahf software compare-mrp-level --oracle-home TEXT --mrp-level TEXT
    たとえば:
    • データベース: 特定のレベルとの比較

      ahf software compare-mrp-level --oracle-home /u01/oracle --mrp-level "Database MRP 19.17.0.0.221220"
      Installed:
          <bug-id-1>
          <bug-id-2>
            ...
          <bug-id-5>
       Missing:
          <bug-id-8>
          <bug-id-9>
            ...
          <bug-id-10>
    • グリッド・インフラストラクチャ: 特定のレベルとの比較

      ahf software compare-mrp-level --oracle-home /u01/oracle/grid --mrp-level "GI MRP 19.17.0.0.230321"
      Installed:
          <bug-id-1>
          <bug-id-2>
            ...
          <bug-id-5>
       Missing:
          <bug-id-8>
          <bug-id-9>
            ...
          <bug-id-10>
  • 最新のMRPレベルを問い合せるには:
    ahf software get-latest-mrp-level 
    19.22
        Database: Database MRP 19.22.0.0.240220
        GI      : None
    19.21
        Database: Database MRP 19.21.0.0.240220
        GI      : GI MRP 19.21.0.0.240116
    19.20
        Database: Database MRP 19.20.0.0.240116
        GI      : GI MRP 19.20.0.0.240116
    19.19
        Database: Database MRP 19.19.0.0.231017
        GI      : GI MRP 19.19.0.0.231017
    19.18
        Database: Database MRP 19.18.0.0.230718
        GI      : GI MRP 19.18.0.0.230718
    19.17
        Database: Database MRP 19.17.0.0.230418
        GI      : GI MRP 19.17.0.0.230418
    ahf software get-latest-mrp-level --ru 19.21
    19.21
        Database: Database MRP 19.21.0.0.240220
        GI      : GI MRP 19.21.0.0.240116
    ahf software get-latest-mrp-level --ru 19.22
    19.22
        Database: Database MRP 19.22.0.0.240220
        GI      : None
  • 特定のファイルを使用して更新を適用するには:
    ahf software apply-update --update-file <zip-file-name>

    たとえば:

    ahf software apply-update --update-file /tmp/ahf_data_20240127.zip
    Successfully updated Data files from version 20240111 to 20240127
  • アップグレード履歴を取得するには:
    ahf software get-upgrade-history
    +----------------+----------------+----------------+-----------------------------+----------------+
    |   install_type |   from_version |    to_version  |         install_date        |  upgrade_status|
    +----------------+----------------+----------------+-----------------------------+----------------+
    |        UPGRADE |         24.4.0 |         24.5.0 | 2024-04-19 22:35:22.165 UTC |     SUCCESSFUL |
    |        INSTALL |                |         24.4.0 | 2024-04-16 20:36:02.049 UTC |     SUCCESSFUL |
    +----------------+----------------+----------------+-----------------------------+----------------+
  • ダウングレード・ターゲットを取得するには:
    ahf software get-downgrade-target
    Installation file is unavailable
    Valid version target for downgrade is: 24.4.0