Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
このページの内容
 

新しいVM(VM-VM)Apstra DCDのアップグレード

新しいVMでのApstra DCDのアップグレードには、Ubuntu Linux OSの修正とセキュリティアップデートが含まれます。アップグレードには、Apstra DCD OSの管理者権限と管理者グループの権限が必要です。

ステップ1:アップグレード前の検証

  1. サポートされているバージョンにアップグレードすることを確認するには、 アップグレードパス を参照してください。Apstra DCD GUIの左上のナビゲーションメニューにあるJuniper Apstra DCDロゴの下に現在のバージョンがあります。
  2. Apstra DCDサーバーに 管理者 としてログインします(たとえば、Apstra DCDサーバーのIPアドレスが10.28.105.3の場合、コマンドは ssh admin@10.28.105.3になります)。
  3. コマンドservice aos statusを実行して、サーバーがアクティブで問題がないことを確認します。
  4. データプレーンに影響を与える可能性のある構成レンダリングの変更については、 Apstra Data Center Directorのリリースノート を参照してください。
  5. 各ブループリントを確認して、すべての サービス設定 が SUCCEEDED 状態であることを確認します。必要に応じて、デバイスをアンデプロイし、ブループリントから削除して、保留中または失敗したサービス設定を解決します。
  6. プローブ異常がないか各設計図を確認し、可能な限り解決します。残っている異常をメモします。
  7. デバイスモデルとNOSバージョンが新しいApstra DCDバージョンで認定されていることを確認するには、 Apstra Data Center Directorユーザーガイド (>認定デバイスおよびNOSバージョン>リファレンス )を参照してください。必要に応じて、サポートされているバージョンのいずれかにアップグレードまたはダウングレードします。
  8. Junosデバイスを使用している場合は、元の設定に不可欠な mgmt_junos が含まれている必要がありますVRF。
    注意:

    元の設定に mgmt_junos VRFが含まれていない場合、導入は失敗します。
  9. デバイスAAA設定を削除します。デバイスのアップグレード中は、SSHアクセスには設定されたデバイスエージェントの資格情報が必要になります。
  10. ファイアウォールの設定に使用するコンフィグレットをすべて削除します。デバイスでFWのルーティングエンジンフィルターを使用する場合は、新しいコントローラとワーカーVMのIPアドレスが含まれるようにフィルターを更新します。
  11. デバイスシステムエージェントをアップグレードするには、Apstra DCDは、設定された認証情報を使用してすべてのデバイスにSSHアクセスする必要があります。Apstra DCD GUIから、 デバイス>管理対象デバイスに移動し、確認するデバイスを選択し、エージェントメニューで チェック をクリックします。すべてのジョブ状態が「成功」と表示されていることを確認します。Apstra DCDをアップグレードする前に、失敗したチェックジョブを修正します。
  12. root ユーザーとして、コマンド sudo aos_backup を実行して Apstra DCD サーバーをバックアップします。
    注意:

    アップグレードされたApstra DCDサーバーでは、タイムボイジャーのリビジョンは含まれていません。過去の状態に戻すには、このバックアップが必要です。Apstra DCDバージョン間のリファレンスデザインの変更により、これまでの状態は利用できなくなります。
  13. バックアップファイルを /var/lib/aos/snapshot/<shapshot_name> から外部の場所にコピーします。
  14. 新しいVMにApstra DCDサーバー に必要なサーバーリソース があることを確認します。

ステップ2:新しいApstra DCDサーバーを展開する

注:

古いApstra DCDサーバーで /etc/aos/aos.conf ファイルをカスタマイズした場合(たとえば、別のネットワークインターフェイスを使用するように metadb フィールドを更新した場合)、それらの変更を新しいApstra DCDサーバーVMに再適用します。自動移行は行われません。
  1. 登録サポートユーザーは、 Apstra DCD VMイメージをダウンロード し、新しいApstra DCDサーバーに転送します。
  2. 新しいIPアドレスで新しいApstra DCD VMイメージをインストールし、構成します(同じFQDNまたは新しいFQDNを使用できます)。
  3. 新しいApstra DCDサーバーについて以下を確認します。

    • 古いApstra DCDサーバーへのSSHアクセス。

    • システムエージェントへの接続( 必要な通信ポートを参照)。

    • NTP、DNS、vSphereサーバー、LDAP/TACACS+サーバーなどの外部システムへのアクセス。

ステップ3:状態をインポートする

注:

新しいVMのインポートを開始した後は、古いApstra DCDサーバーでAPI/GUI書き込み操作を実行しないようにします。加えた変更は、新しいApstra DCDサーバーには転送されません。
  1. 新しいApstra DCDサーバーにユーザー 管理者としてログインします。
  2. sudo aos_import_stateコマンドを実行して、古いサーバーからSysDBをインポートし、必要な変換を適用して、設定をインポートします。必要に応じて、以下の引数を含めます。
    • --ip-address <old-Apstra DCD-server-ip>
  3. 管理者のユーザー名を入力します。
    • 使用する --username <admin-username>
    • 新しいワーカーノードIPを持つApstra DCDクラスターの場合、以下を含めます。 --cluster-node-address-mapping <old-node-ip> <new-node-ip>

    • 古いApstra DCDサーバーを保持するには、 --disable-original-Apstra DCD-server {prompt,disable,keep}を使用します。例: --disable-original-Apstra DCD-server keep。

    • --dry-run-connectivity-validationを使用してアップグレードせずに、アップグレード前提条件チェックを実行します。

    • 接続の検証をスキップします iwith --skip-connectivity-validation。

    • 古いApstra DCDバージョンのSSH認証情報が新しいバージョンよりも厳格でない場合は、アップグレードの失敗を回避するために、データベースのインポート中にaos_import_stateコマンドに--override-cluster-node-credentialsを追加してください。

    • 管理VRFが設定されていないJunosデバイスの場合、失敗のないアップグレードプロセスに---skip-junos-mgmt-vrf-check を使用します。

    コマンド例:同じワーカーノードを持つ単一のVMまたはApstra DCDクラスター

    コマンド例:新しいワーカーノードを持つApstra DCDクラスター

    上記の例では、 10.28.105.4 と 10.28.105.7 は古いワーカーノードIPアドレスで、 10.28.105.6 と 10.28.105.8 は新しいワーカーノードIPアドレスです。

    データベースのインポートにはrootが必要なため、リモートのApstra DCD VMのSSHパスワードとrootパスワードを求められます。

    注:

    Apstra DCDクラスターをアップグレードする際は、古いコントローラ、古いワーカー、新しいワーカーのSSHパスワードが同じであることを確認してください。それ以外の場合、アップグレードは認証に失敗します。「リモートAOS VMのSSHパスワード」は、リモートコントローラー、古いワーカー、および新しいワーカーVMに適用されます。アップグレード後、ワーカーVMのSSHパスワードを変更した場合は、Apstra DCD GUI(プラットフォーム>Apstra Data Center Director>ノード)で更新します。
    注:

    ブループリントのサイズとApstra DCDサーバーVMリソースによって、インポートが完了するまでにかかる時間が決まります。データベースのインポートがデフォルト値(40分または2400秒)を超えると、操作が「タイムアウト」する可能性があります。必要に応じて、 AOS_UPGRADE_DOCKER_EXEC_TIMEOUT コマンドを使用してタイムアウト値をインクルードします。

    例えば、以下のコマンドは、タイムアウトまでの時間を2時間(7200秒)に増やします。

    admin@aos-server:~$ sudo AOS_UPGRADE_DOCKER_EXEC_TIMEOUT=7200 aos_import_state --ip-address 10.10.10.10 --username admin

    アップグレードスクリプトは、アップグレード中に設定変更を受けるファブリック内のデバイスの概要を示しています。 警告が表示され、最初に Apstra DCDリリースノート と アップグレードパス のドキュメントを読むことをお勧めします。リリースノートには、 構成レンダリング変更のカテゴリが含まれています。構成レンダリングの変更は、リリースノートの上部に記載されており、ネットワークへの影響が詳しく説明されています。

    Apstraアップグレードサマリーには、デバイスの役割別(スーパースパイン、スパイン、リーフ、リーフペア、アクセススイッチ)別の情報が表示されます。フル設定ではなく増分設定が適用された場合は、変更に関する詳細が表示されます

  4. AOSアップグレード:インタラクティブメニューでは、各デバイスの設定変更を確認できます。アップグレードの新しい設定が既存のコンフィグレットと競合しないことを確認します。
    注意:

    新しいApstra DCDリリースでは、Apstra DCDリファレンスデザインが変更され、コンフィグレットが無効になる場合があります。コンフィグレットを検証して、更新されたコンフィグとの競合を回避します。アップデートが必要な場合は、アップグレードを終了し、コンフィグレットを修正してから、アップグレードを再開してください。
  5. 保留中の変更を確認した後にアップグレードを続行する場合は、「 c」と入力します。
  6. アップグレードを停止する場合は、 q を入力してプロセスを中止します。この時点で終了し、後でアップグレードすることにした場合は、プロセスを最初から開始する必要があります。
    注:

    Apstra DCDのアップグレードに失敗した場合(またはその他の誤動作が発生した場合)、新しいApstra DCDサーバーを正常にシャットダウンし、古いApstra DCDサーバーを再起動して運用を続行できます。

ステップ4:インテントベースの分析のために状態をインポートする

注:

Apstra DCD 5.0.0以降、プローブとステージにタグを割り当てたり、 evpn-host-flap-count テレメトリサービスをサポートしたりすることはなくなりました。

インテントベースの分析用のウィジェットまたはプローブを削除または無効にするには、 sudo aos_import_state コマンドに以下の引数を追加します。

  • --iba-remove-unused widgets: ダッシュボードから未使用のウィジェットを削除します。

  • --iba-remove-probe-and-stage-tags: プローブとステージからタグを削除します。

  • --iba-number-non-unique-probe-labels:一意でないプローブラベルにシリアル番号を追加します。

  • --iba-number-non-unique-dashboard-labels:一意でないダッシュボードラベルにシリアル番号を追加します。

  • --iba-disable-probe-with-evpn-host-flap-count-service:evpn-host-flap-countサービスを使用して、事前定義されていないプローブを無効にします。

  • --iba-strip-dashboard-labels-widget-labels: ダッシュボードとウィジェットのラベルから先頭/末尾のスペースを削除します。

  • --iba-strip-probe-labels-processor-names: プローブラベルとプロセッサ名から先頭/末尾のスペースを削除します。

手順 5: 古い VM の IP アドレスを保持する (オプション)

動作モードを変更し、デバイスのエージェントをアップグレードする前に、以下の手順を実行してください。

古いVMのIPアドレスを保持するには:

  1. 古いVMをシャットダウンするか、そのIPアドレスを別のアドレスに変更して、IPアドレスを解放します。これは、IPアドレスの重複の問題を回避するために必要です。
  2. CLIから新しいVMのApstra DCDインタラクティブメニューに移動します。
  3. ネットワークをクリックしてIPアドレスを更新し、その他のパラメーターを確認します。
  4. 新しいIPアドレスを有効にするには、終了前に同じメニューから、またはメニューを終了した後にCLIからネットワークサービスを再起動します。

ステップ6:Apstra DCDアップグレード後にフロー設定でApstra DCD IPを変更する(元のIPを再使用しない場合)

VMからVMへのApstra DCDアップグレード中は、 ステップ5で古いIPを再利用しない限り、Apstra DCD IPアドレスは変更されます。

IPアドレスが変更された場合は、以下のようにApstra DCD Flowコンポーネントを更新して、新しいIPをキャプチャします。

  1. Apstra DCDフローCLIへのSSH接続(デフォルトの認証情報はApstra DCD/Apstra DCD)。
  2. /etc/juniper/flowcoll.ymlを開きます。
  3. EF_JUNIPER_Apstra DCD_API_ADDRESSフィールドを新しいIPアドレスで変更します。
  4. sudo systemctl restart flowcoll.serviceを実行します。

ステップ 7: 動作モードを通常に変更する

Apstra DCDサーバーのアップグレードを開始すると、モードが 通常 から メンテナンス に自動的に切り替わります。メンテナンスモードは、オフボックスエージェントのオンラインをブロックし、設定のプッシュを停止し、テレメトリプルを停止します。以前のバージョンに戻すには、新しいサーバーをシャットダウンします。アップグレードを完了するには、モードを 通常に戻します。

  1. Apstra DCD GUIにログインします。
  2. 保留中のサービス設定変更を表示するには、ブループリントのダッシュボードに移動し、 保留中 をクリックして影響を受けるデバイスを確認します。
  3. 左側のナビゲーションメニューから、 プラットフォーム>Apstra DCDクラスター>クラスター管理に移動します。


  4. 「 動作モードの変更」 ボタンをクリックし、「 通常」を選択してから 「更新」をクリックします。オフボックスエージェントは、それがコントローラ上にあるか、ワーカーVM上にあるかにかかわらず、自動的にオンラインになり、デバイスを再接続し、保留中の設定変更をプッシュします。しばらくすると、ダッシュボードの一時的な異常が解消され、サービス設定セクションに操作が 成功したことが示されます。

    また、任意のページの左下セクションからクラスター 管理 ページにアクセスすることもできます。ここからも、色に基づいてプラットフォームの正常性を継続的に可視化できます。

    左側のナビゲーションメニューの下部で、ドットの1つをクリックし、 動作モードをクリックして クラスター 管理に移動します。「 動作モードの変更」 ボタンをクリックし、「 通常」を選択してから 「更新」をクリックします。


ステップ8:デバイス用エージェントのアップグレード

オンボックスエージェントのアップグレード

Apstra DCDサーバーとオンボックスエージェントは、同じバージョンのApstra DCDを実行している必要があります。バージョンが異なる場合、エージェントはApstra DCDサーバーに接続しません。

マルチステートブループリント(特に5ステージ)を実行している場合は、エージェントを段階的にアップグレードします。

  • まず、スーパースパインをアップグレードします。

  • 次に、スパインをアップグレードします。

  • 最後に、リーフをアップグレードします。

この順序により、パスハンティングの問題が最小限に抑えられます。ルーティングは、一時的にリーフからスパインに移動し、別のリーフに戻り、次に別のスパインに移動する場合があります。段階的なアップグレードは、このリスクを軽減します。

オンボックスエージェントをアップグレードするには:

  1. ユーザー 管理者としてApstra DCD GUIにログインします。

  2. 左側のナビゲーションメニューから、 デバイス>管理対象デバイス に移動し、アップグレードするデバイスのチェックボックスを選択します(一度に最大100台のデバイス)。複数のオンボックスエージェントを同時にアップグレードできますが、デバイスのアップグレード順序が重要です。

    • まずスーパースパイン用のエージェントをアップグレードします。
    • 次に、スパイン用のエージェントをアップグレードします。
    • 3番目に、リーフ用アップグレードエージェントです。

    1つ以上のデバイスを選択すると、テーブルの上にデバイスメニューとエージェントメニューが表示されます。

  3. インストール ボタンをクリックして 、インストールプロセスを開始します。

    ジョブの状態が 「進行中」に変わります。エージェントが以前のバージョンのApstra DCDソフトウェアを使用している場合、自動的に新しいバージョンにアップグレードされます。次にサーバーに接続し、保留中の設定変更をデバイスにプッシュします。テレメトリも再開され、ジョブの状態が 「成功」に変わります。

  4. 設計図ダッシュボードの [Liveness ] セクションで、デバイスの異常がないことを確認します。

    注:エージェントのアップグレード後に以前のApstra DCDバージョンにロールバックするには、以前のApstra DCDバージョンで新しいVMを構築し、新しいVMに設定を復元します。サポートが必要な場合は、ジュニパーテクニカルサポートにお問い合わせください。

OffBoxエージェントのアップグレード

Apstra DCD 6.1以降では、管理対象デバイスのオフボックスエージェントで ホストキーを更新 ボタンをクリックします。

Upgrade OffBox Agent(s)
注:Apstra DCDは、管理対象デバイスのホストフィンガープリントキーを追跡します。コントローラを更新すると、学習したホストキーが削除され、SSH接続が確立されるまでエージェントのプロセスが開始されなくなります。手順については、「Apstra DCDサーバーで新しいSSHキーを設定する」を参照してください。

ステップ9:古いApstra DCDサーバーをシャットダウンする

以下の手順に従って、古いApstra DCDサーバーをシャットダウンします。
  1. 設定に基づいて、新しいApstra DCDサーバーIP/FQDNを使用するようにDNSエントリを更新します。
  2. Apstra DCDサーバーにプロキシを使用している場合は、それが新しいサーバーを指していることを確認してください。
  3. 古いApstra DCDサーバーを正常にシャットダウンします。シャットダウンを確認した場合は、 service aos stop コマンドが自動的に実行されます。
  4. Apstra DCDクラスターをアップグレードする際にワーカーノードを新しいVMに置き換えた場合は、古いワーカーVMをシャットダウンします。
次のステップ:

デバイスのNOSバージョンが新しいApstra DCDバージョンと互換性がない場合は、認定バージョンにアップグレードしてください。詳細については、 『Apstra Data Center Directorユーザーガイド 』を参照してください。