Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

同じVM上でApstraをアップグレードする(インプレース)

メモ:

インプレースアップグレードの場合、セキュリティの脆弱性の更新を含む Ubuntu Linux OS の修正は受け取りません。これらの更新プログラムを受信するには、 新しい VM でアップグレードする必要があります。代わりにインプレースアップグレードするには、読み続けてください。

Apstraサーバーをアップグレードするには、Apstra OSの管理者ユーザー権限とApstra管理者ユーザーグループ権限が必要です。

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

  1. サポートされているバージョンにアップグレードすることを確認するには、アップグレード パスを参照してください。
  2. デフォルトでは、Apstraアップグレードは追加のDockerサブネット172.18.0.1/16を作成します。ネットワークの他の場所でこのサブネットを使用している場合、Apstraのアップグレードは失敗する可能性があります。これがあなたに適用される場合、異なるサブネットを使用する方法についてはDocker NetworkとApstraのアップグレードを参照してください。
  3. 管理者としてApstraサーバーにログインします(例えば、ApstraサーバーのIPアドレスが10.28.105.3の場合、 コマンドは になりますssh admin@10.28.105.3)。
  4. APstraソフトウェアの2つのバージョンを同時に保持するのに十分なメモリがVMに存在することを確認します。コマンドを実行して、メモリ使用率が 50% 未満かどうかを確認しますfree -h
  5. 使用率が50%を超える場合、Apstraサーバーを正常にシャットダウンし、リソースを追加してから、Apstraサーバーを再起動します。
  6. コマンドservice aos statusを実行して、サーバーがアクティブで問題がないことを確認します。
  7. 各ブループリントを確認して、すべてのサービス設定が成功したことを確認します。必要に応じて、ブループリントからデバイスをアンデプロイして削除し、保留中または失敗したサービス設定を解決します。
  8. データプレーンに影響を与える可能性のある設定レンダリングの変更については、新しいApstraバージョンのリリースノートを確認してください。必要に応じてコンフィグレットを更新します。
  9. プローブ異常の各ブループリントを確認し、可能な限り解決します。残りの異常をメモします。
  10. NOSバージョンが新しいApstraバージョンで認定されていることを確認するには、認定デバイスとNOSを参照してください。必要に応じて、サポートされているバージョンのいずれかにアップグレードまたはダウングレードします。
  11. デバイスAAA設定を削除します。デバイスのアップグレード中に、SSHアクセスには設定されたデバイスエージェント認証情報が必要です。
  12. ファイアウォールの設定に使用するコンフィグレットを削除します。デバイスでFWのルーティングエンジンフィルターを使用する場合は、新しいコントローラとワーカーVMのIPアドレスを含むように更新する必要があります。
  13. デバイスシステムエージェントをアップグレードするには、エージェントの作成時に設定された認証情報を使用して、すべてのデバイスにSSHを実行できる必要があります。Apstra GUIからこれを確認するには、デバイス>エージェントに移動し、確認するデバイスのチェックボックスをオンにして、[エージェント]メニューの[チェック]ボタンをクリックします。すべてのジョブ状態が成功状態であることを確認します。チェックジョブに失敗した場合は、Apstraのアップグレードを続行する前に問題を解決してください。
  14. rootユーザーとして、 コマンドsudo aos_backupを実行してApstraサーバーをバックアップします。
    メモ:
    注意:

    アップグレードされたApstraサーバーにはタイムボイジャーリビジョンは含まれていないため、過去の状態に戻す必要がある場合、このバックアップが必要です。Apstraバージョン間で変更される可能性のあるリファレンスデザインとの緊密な結合により、以前の状態は含まれていません。

  15. バックアップ ファイル/var/lib/aos/snapshot/<shapshot_name>を外部の場所にコピーします。

ステップ2:新しいApstraサーバーを導入する

  1. Juniper Support Downloadsからプラットフォーム用のApstraインストーラパッケージをダウンロードし(例えば)、aos_server_4.1.2-269Apstraサーバーに転送します。
  2. Apstraインストーラパッケージを解凍します。
  3. Apstraクラスター(オフボックスエージェント、IBAプローブ)を使用している場合は、インストーラパッケージをワーカーノードにもダウンロードします。ワーカー ノードは後のステップでアップグレードします。
  4. 管理者としてApstraサーバーにログインします。
  5. 実行ファイルのsudo bash aos_<aos_version>.runバージョンである <aos_version> コマ ンドを実行します。例えば、バージョンが コマンドである場合、4.0.1-1045以下に示すようにコマンドになりますsudo bash aos_4.1.1-287.run
    このコマンドを実行すると、以前のApstraバージョンが検出された場合、スクリプトは新しいインストールモードではなくアップグレードモードに入ります。新しい Docker コンテナは、以前のバージョンの Docker コンテナの横にインストールされます。このスクリプトは、以前のバージョンのデータをインポートし、新しいバージョンのApstra SysDBに移行します。

    アップグレードスクリプトには、アップグレード中に設定変更を受け取るファブリック内のデバイスの概要ビューが表示されます。Apstraバージョン4.1.2では、続行する前に リリースノートアップグレードパス のドキュメントを読むよう推奨する警告が画面に表示されます。リリースノートには、Apstraバージョン4.1.2の 設定レンダリングの変更のカテゴリが含まれています。構成レンダリングの変更は、各変更がネットワークに与える影響について、上部に明確に記載されています。

    Apstraバージョン4.0.1では、 Apstraアップグレードサマリー には、デバイスの役割(スーパースパイン、スパイン、リーフ、リーフペア、アクセススイッチなど)で区切られた情報が表示されています。完全な設定ではなく増分構成を適用した場合、変更に関する詳細が表示されます。

  6. サマリーを確認したら、を入力qしてサマリーを終了します。AOSアップグレード:インタラクティブメニューが表示され、各デバイスの正確な設定変更を確認できます。コンフィグレットを使用している場合、アップグレードによってプッシュされた新しい構成が既存のコンフィグレットと競合しないことを確認します。
    注意:

    新しいApstraリリースのApstraリファレンスデザインは、コンフィグレットを無効にする方法で変更されている場合があります。予期しない結果を避けるために、コンフィグレットが新しくレンダリングされたコンフィグと競合しないように確認します。コンフィグレットを更新する必要がある場合は、アップグレードを終了し、コンフィグレットを更新してから、もう一度アップグレードを実行してください。

  7. 保留中の変更を確認した後にアップグレードを続行する場合は、 を入力しますc。古いApstraバージョンが削除され、新しいApstraバージョンがサーバーで有効になります。アップグレードが完了したら、Apstra GUIの[Platform > About]に移動してバージョンを確認します。
    注意:

    Apstraサーバーのアップグレードは、混乱を招くプロセスです。インプレース(同じ VM)をアップグレードし、この時点からアップグレードを続行する場合、アップグレードをロールバックすることはできません。以前のバージョンに戻す唯一の方法は、以前のバージョンを持つ新しい VM を再インストールし、以前に作成したバックアップからデータベースを復元することです。バックアップを作成しましたよね?

  8. アップグレードを停止する場合は、と入力qしてプロセスを中止します。この時点で終了し、後でアップグレードを決定した場合は、最初からプロセスを開始する必要があります。
  9. Apstraクラスタを使用している場合、ワーカーノードはApstraコントローラから切断され、FAILED状態に変更されます。この状態は、ワーカーノード上にあるオフボックスエージェントとIBAプローブコンテナが利用できないことを意味します。オフボックスエージェントによって管理されるデバイスはサービスを継続します後のステップでエージェントをアップグレードした後、Apstraクラスター内のワーカーノードをアップグレードします。エージェントやプローブが利用可能になります。

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

Apstraサーバーのアップグレードを開始すると、運用モードが「 通常」 から「 メンテナンス 」に自動的に変更されます。アップグレードが完了したら、手動でモードを [Normal]に戻す必要があります。

  1. Apstra GUIの左ナビゲーションメニューから、プラットフォーム>Apstraクラスタ>クラスタ管理に移動します。
  2. [動作モードの変更] ボタンをクリックし、[通常] を選択して [更新] をクリックします。モードを[通常]に変更すると、設定済みのオフボックスエージェントがアクティブになりますが、オンボックスエージェントのアップグレードを開始する必要があります(次のセクション)。

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

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

    まだアップグレード中のため、エージェントは接続されません。アップグレードが完了すると、エージェントはサーバーに再接続してオンラインに戻ります。ブループリントダッシュボードで、スパインとリーフの ライブ性 の異常も解決します。

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

注意:

エージェントアップグレードを開始すると、以前のバージョンにロールバックすることはできません。以前のバージョンに戻す唯一の方法は、以前のバージョンを持つ新しい VM を再インストールし、以前に作成したバックアップからデータベースを復元することです。

  1. ユーザー管理者としてApstra GUIにログインします。
  2. 左側のナビゲーションメニューから、デバイス>システムエージェント>エージェントに移動し、アップグレードするデバイスを選択します(Apstraバージョン4.0.1時点で一度に最大100台のデバイス)。複数のオンボックスエージェントを同時にアップグレードすることはできますが、デバイスのアップグレード順序は重要です。
    • 最初にスーパーピン用のエージェントをアップグレードします。
    • エージェントをスパイン用にアップグレードします。
    • リーフのエージェントを3分の1にアップグレードします。
  3. [インストール] ボタンをクリックしてインストール プロセスを開始します。ジョブの状態が IN PROGRESS に変わります。エージェントが以前のバージョンのApstraソフトウェアを使用している場合、エージェントは自動的に新しいバージョンにアップグレードされます。その後、サーバーに接続し、保留中の設定変更をデバイスにプッシュします。テレメトリも再開され、ジョブの状態は成功に変わります
  4. ブループリント ダッシュボードの [ライブネス] セクションで、デバイスに異常がないことを確認します。
    メモ:

    エージェントのアップグレードを開始した後に、以前のApstraバージョンにロールバックする必要がある場合は、以前のApstraバージョンを持つ新しいVMを構築し、そのVMに設定を復元する必要があります。サポートが必要な場合は、 ジュニパーの技術サポートにお問い合わせください。

ステップ5:ワーカーノードのアップグレード(Apstraクラスタのみ)

Apstraクラスタ(オフボックスエージェントやIBAプローブ用)を使用している場合は、ワーカーノードと、すでにアップグレード済みのコントローラノードをアップグレードする必要があります。

  1. ApstraサーバーにダウンロードしたときにApstraインストーラパッケージをワーカーノードにダウンロードしなかった場合は、今すぐダウンロードしてください。
  2. 各Apstraワーカーノードから、 コマンド<aos_version>sudo bash aos_<aos_version>.run実行します。これは実行ファイルのバージョンです。例えば、バージョンが コマンドである4.1.1-287場合、(オプションなし)になりますsudo bash aos_4.1.1-287.run。これは、コントローラのアップグレードに使用したファイルと同じです。ワーカー ノードのアップグレード中にプロンプトはありません。

次のステップ:

デバイスのNOSバージョンが新しいApstraバージョンで認定されていない場合は、認定されたバージョンにアップグレードします。(詳細については 、Juniper Apstraユーザーガイド を参照してください)。