切断時のRoving Edge Deviceソフトウェアのアップグレード

デバイスがOracle Cloud Infrastructure (OCI)テナンシに接続されていない間にRoving Edgeデバイス・ソフトウェアをアップグレードする方法について学習します。

ノート

デバイスの切断中にデバイス・ソフトウェアをアップグレードする機能は、Roving Edgeソフトウェア・バージョン2.6で導入されました。デバイスで以前のバージョン(2.5以前)が実行されている場合は、接続中にデバイスソフトウェアを更新する必要があります。デバイス・ソフトウェア・バージョンを検索するには、デバイス・ソフトウェア・バージョンの識別を参照してください。

切断されたアップグレード・プロセスは、次のいくつかのタスクで構成されます。

  1. デバイスの現在のソフトウェア・バージョンを取得します。
  2. OCIで、システム・アップグレード・バンドルをリクエストします。
  3. アップグレード・バンドルをRoving Edgeデバイスのバケットに転送します。
  4. デバイスで、アップグレードバンドルをインポートします。
  5. デバイスをアップグレードします。

この項では、各タスクのステップを説明します。

切断されたRoving Edge Infrastructureデバイスでソフトウェア・アップグレードを実行するために必要な権限を持っている必要があります。切断されたアップグレード・バンドル配信の有効化を参照してください。

ノート

システム・アップグレード・バンドルは非常に大きい場合があります。ダウンロードとアップロードに時間がかかる場合があります。適切に計画してください。

アップグレード後、デバイスがリブートし、シリアルコンソールを使用してデバイスのロックを解除する必要があります。シリアルコンソールを使用する準備をするには、Operating the Serial Consoleを参照してください。

  • タスク1– デバイスの現在のソフトウェアバージョンの取得
    1. アップグレードする予定のRoving Edgeデバイスのデバイス・コンソールにサインインします。

    2. デバイス・コンソールの右上隅にある「システム・ステータス」アイコン(「システム・ステータス」アイコン)をクリックします。

      「システム・アップグレード」には、現在のソフトウェア・バージョンが表示されます。

    3. 現在のシステム・ソフトウェア・バージョンを記録します。後でアップグレード・プロセスで使用します。

    タスク2– システムアップグレードバンドルのリクエスト
    1. OCI Cloudコンソールにサインインします。

    2. ナビゲーション・メニューを開き、「ハイブリッド」をクリックします。「Roving Edge Infrastructure」で、「ノード」をクリックします。「ノード」ページが表示されます。

    3. アップグレードするデバイス・ノードを含むコンパートメントを選択します。

    4. アップグレードするデバイスノードをクリックします。

      ノードの詳細ページが表示されます。

      システム・アップグレード・バンドルをリクエストするには、デバイス・ノードが「顧客受領済」または「顧客デプロイ済」状態である必要があります。

    5. 「リソース」で、「システム・アップグレード」をクリックします。

    6. 「システム・アップグレード・バンドルのリクエスト」をクリックします。

      「ノード・アップグレード・バンドルのリクエスト」ダイアログ・ボックスが表示されます。

    7. 必須情報を入力します:

      • 「現在のソフトウェア・バージョン」ボックスにデバイス・ノードの現在のソフトウェア・バージョンを入力し、「次のアップグレード・バージョンの取得」をクリックします。

        入力したバージョン番号が使用可能なアップグレード・バンドルと比較され、どのバージョンが適切であるかが確認されます。最適な一致が「互換アップグレード・バージョン」ボックスに表示されます。場合によっては、必要なアップグレードを実行する前に、システムソフトウェアの暫定的なアップグレードを実行することが必要な場合があります。「互換アップグレード・バージョン」ボックスでは、必要なアップグレード順序に従います。

      • 「宛先バケット」リストからバケットを選択します。選択したバケットは、リクエストしているシステム・バンドルを受信します。別のコンパートメントに存在する宛先バケットを選択するには、「コンパートメントの変更」をクリックします。

    8. 「システム・アップグレード・バンドルのリクエスト」をクリックします。

      「システム・アップグレード・バンドル・リクエスト」リストには、指定された宛先バケットへのバンドルの転送の進行状況が表示されます。

      転送が完了すると、アップグレード・バンドル・ファイルはObject Storageバケットに格納され、ユーザーが削除するまでそこに残ります。

    9. (オプション)「アクション」メニュー(3つのドット・アイコンのイメージです。)で、「詳細の表示」をクリックして、システム・アップグレード・バンドル・リクエストの詳細を表示します。

      アップグレード・バンドル・リクエスト作業リクエストは、48時間リストされたままです。
    タスク3– アップグレード・バンドルのデバイスへの転送
    1. (OCIへのサインイン中)アップグレード・バンドルの転送が完了したら、宛先バケット名をクリックして、オブジェクト・ストレージ・バケット内のファイルを表示します。
    2. アップグレード・バンドル・ファイルの横にある「アクション」メニュー(「アクション」メニュー(3つのドット・アイコンのイメージです。))をクリックし、「ダウンロード」を選択します。

      オブジェクトのダウンロード中に「オブジェクトのダウンロード」ダイアログ・ボックスが表示され、ダウンロード・ステータスが表示されます。

    3. ダウンロードしたバンドルを、Roving Edge Infrastructureデバイスと同じネットワークに接続できるコンピュータにコピーします。

    4. Roving Edge Object Storageのrover-system-upgrade-stagingバケットにアップグレード・バンドルをアップロードします。デバイス上のオブジェクト・ストレージ・バケットへのオブジェクトのアップロードを参照してください。

    タスク4– デバイスでのアップグレード・バンドルのインポート
    1. アップグレードする予定のRoving Edgeデバイスのデバイス・コンソールにサインインします。

    2. ナビゲーション・メニューで、「ノード管理」「オフライン・システム・アップグレード」の順にクリックします。

      以前のアップグレード・バンドルがリストされます。これが最初のアップグレード・バンドル・リクエストの場合、リストは空です。

    3. 「バンドルのインポート」をクリックします。

      「バンドル・リクエストのインポート」パネルが表示されます。

    4. 「オブジェクト名」で、ドロップダウン・メニューからアップグレード・バンドルを選択します。

    5. 「バンドルのインポート」をクリックします。

      アップグレード・バンドルはデバイスにインポートされ、rover-system-upgrade-stagingという名前のオブジェクト・ストレージ・バケットに配置されます。インポートが完了すると、インポートされたバンドルの状態が「インポート済」に変わり、デバイスのアップグレードに進むことができます。

    タスク5– デバイスのアップグレード
    1. (デバイス・コンソールにサインインしたまま)アップグレード・バンドルのインポートが終了していることを確認します。デバイス・コンソールの右上隅にある「システム・ステータス」アイコン(「システム・ステータス」アイコン)をクリックします。

      「システム・アップグレード」ダイアログ・ボックスに、インポート・プロセスの様々なステージのステータスが表示されます。インポートが完了すると、ダイアログボックスにデバイスの現在のシステムソフトウェアバージョンと新しいインポートバージョンが表示されます。

    2. ナビゲーション・メニューで、「ノード管理」→「ノード」を選択します。

    3. デバイス・ノード行で、「アクション」メニュー(3つのドット・アイコンのイメージです。)をクリックし、「アップグレード」を選択します。

    4. アップグレード・リクエストを確認します。

      「システム・アップグレード」ダイアログ・ボックスに、アップグレードが完了した日時が表示されます。

      デバイスは、アップグレード・プロセスの最後に自動的に再起動されます。シリアルコンソールを使用して、リブートしたデバイスのロックを解除する必要があります。Operating the Serial Consoleを参照してください。

  • CLIを使用してアップグレード準備タスクを実行できますが、CLIを使用してアップグレードを実行することはできません。デバイスコンソールを使用してデバイスをアップグレードします。

    アップグレード準備 CLIコマンド

    ノート

    次のコマンドは、OCIテナンシで実行されます。OCIテナンシに到達するように構成されたCLIプロファイルを使用していることを確認してください。

    • 互換性のあるアップグレード・バージョンの取得: oci rover node rover-bundle-version getコマンドおよび必要なパラメータを実行して、Roving Edge Infrastructureデバイスの互換性のあるアップグレード・バージョンを取得します:

      oci rover node rover-bundle-version get --current-rover-bundle-version current_rover_bundle_version --rover-node-id rover_node_ocid [OPTIONS]
    • システム・アップグレード・バンドルのリクエスト: oci rover node rover-bundle copy-to-customerコマンドおよび必要なパラメータを実行して、Roving Edge Infrastructureデバイスのシステム・アップグレード・バンドルをリクエストします。

      oci rover node rover-bundle copy-to-customer --bundle-version bundle_version \
      --destination-bucket-name destination_bucket_name --destination-compartment-id destination_compartment_ocid \
      --rover-node-id rover_node_ocid [OPTIONS]
    • アップグレード・バンドルのリクエストのリスト: oci rover node rover-bundle-request listコマンドおよび必要なパラメータを実行して、Roving Edge Infrastructureデバイスのアップグレード・バンドル・リクエストをリストします:

      oci rover node rover-bundle-request list --rover-node-id rover_node_ocid [OPTIONS]
                              
    • アップグレード・リクエストの転送の進行状況の表示: oci rover node rover-bundle get-statusコマンドおよび必要なパラメータを実行して、Roving Edge Infrastructureデバイスのアップグレード・リクエストの転送の進行状況を表示します:

      oci rover node rover-bundle get-status --rover-node-id rover_node_ocid --work-request-id work_request_ocid [OPTIONS]
                              
    ノート

    Roving Edge Deviceでは、次のコマンドが実行されます。(OCIテナンシではなく)デバイスに到達するように構成されたCLIプロファイルを使用していることを確認してください。

    • rover-system-upgrade-stagingという名前のオブジェクト・ストレージ・バケット上のデバイスにシステム・バンドルをアップロードします: oci rover device system-upgrade upload-bundleコマンドおよび必要なパラメータを実行します。

      oci rover device system-upgrade upload-bundle --endpoint device_object_storage_endpoint --file bundle_file_path
    • アップグレード・バンドルをデバイスのオブジェクト・ストレージ・バケットにインポートします: oci rover device system-upgrade import-bundleコマンドを実行します。

      oci rover device system-upgrade import-bundle --object-name object_name

      object_nameは、アップグレード・バンドル・オブジェクトの名前です。たとえば: 2.5.3.20230808163434.rover_disconnected_release.tar

    • すべてのインポート・タスクの表示: oci rover device system-upgrade get-import-historyコマンドを実行します。

      oci rover device system-upgrade get-import-history --endpoint upgrade_endpoint
    • 特定のタスクの表示: oci rover device system-upgrade get-import-statusコマンドを実行します。

      oci rover device system-upgrade get-import-status --endpoint upgrade_endpoint --task-id task_ocid --wait true|false

    インポート・ステータスがCOMPLETEDと示されたら、デバイス・コンソールを使用して通常のシステム・ソフトウェアのアップグレードを続行できます。

  • このタスクはAPIを使用して実行できません。