シスコ デバイス エージェント

デバイスシステムエージェントのインストールにはApstra GUIからインストールすることをお勧めしますが、CLIから手動でApstraエージェントをインストールする こともできます 。まれな例外でのみ、エージェントを手動でインストールする必要がありますが、これにはより多くの労力が必要であり、エラーが発生しやすくなります。エージェントを手動でインストールする前に、デバイスのさまざまな状態、構成段階、およびエージェントの操作について十分に理解しておく必要があります。ご不明な点がございましたら、 ジュニパーサポートにお問い合わせください。

手記：

また、Apstra ZTPを使用して、スイッチ上のエージェントと前提条件の構成を自動的に起動してインストールすることもできます。Apstraを使用すると、ZTPはエージェントを手動でインストールするよりもシンプルで簡単に大規模にサポートできます。

シスコ デバイスのエージェントを手動でインストールするには、次の手順に従います。

• guestshell のディスク サイズ、メモリ、および CPU を更新し、guestshell を有効化/再起動します。
• デバイスエージェントをインストールします。
• aos.config ファイルを更新します。
• サービスを開始します。

注意：

Cisco GuestShellは、Apstraで一意になるようにパーティション化されていません。ゲストシェルでホストされている他のアプリケーションがある場合、ゲストシェルの変更はそれらに影響を与える可能性があります。

注意：

「Bootstrap」または「Pristine」設定のコマンドは、ファブリックの導入時に追加されたApstra設定に干渉する可能性があります。

Apstraが使用するMTUよりも低い値でNX-OSの「システムジャンボムツ」を設定すると、ApstraのMTUコマンドは失敗します。

VRF、NXAPI、GuestShell、管理 VRF の作成の順番でデバイスを設定します。エージェントとサーバー間の通信を可能にするために、ApstraのデバイスエージェントはVRF名 managementを使用します。これらの行が実行コンフィギュレーションに表示されることを確認します。

1. 次のコマンドを実行して、ディスク容量、メモリ、およびCPUのサイズを変更します。
2. ゲストシェルが有効になっていない場合は、コマンド guestshell enable を実行して変更を有効にします。
3. guestshell がすでに有効になっている場合は、コマンド guestshell reboot を実行してシェルを再起動し、変更を有効にします。
4. コマンド switch# show guestshell detail を実行し、guestshell がアクティブ化されていることを確認します。

ApstraサーバーからHTTPS経由でインストールエージェントをコピーできます。ダウンロード後、ダウンロードしたコピーのMD5sumがApstraの保存内容と一致することを確認します。

手記：

エージェントファイルを取得するために、シスコデバイスはHTTPSを使用してApstraサーバーに接続します。先に進む前に、この接続が機能していることを確認してください。

Apstraには、Apstraサーバーのエージェントが同梱されています。それを /volatileまたは volatile: ファイルシステムの場所にコピーできます。また、Apstraには、Apstraサーバーの /home/admin フォルダにmd5sumファイルも同梱されています。

以下の実行ファイルから aos_server_ip 変数と aos_version を置き換えます。(Apstra GUIからApstraサーバーのバージョンを確認するには、[ Platform >About]に移動します)。

ファイルが正しくダウンロードされたことを確認します。

手記：

問題が発生した場合に備えて、コマンド copy running-config startup-config を実行して最新の変更を保存することをお勧めします。

次に示すように、Cisco NX-OS スイッチのゲストシェルから コマンドを実行してエージェントをインストールします。

エージェントをインストールした後、サービスを開始する前に、 aos.conf ファイルを更新してサーバーに接続します。

/etc/aos/aos.conf にある Cisco NX-OS デバイス エージェント 構成ファイルを設定します。パラメータについては、「Apstraデバイスエージェント構成ファイル」を参照してください。

ファイルを更新したら、コマンド service aos start を実行してApstraデバイスエージェントを起動します。

Apstraデバイスエージェントは、Apstraと通信する際に、「デバイスキー」を使用して自身を識別します。Cisco NXOS スイッチの場合、デバイス キーは管理インターフェイス「eth0」の MAC アドレスです。

Apstra GUIの左側のナビゲーションメニューから、[ デバイス]>[管理対象デバイス]に移動します。エージェントが起動して実行されると、このリストに表示され、GUIを使用して標準的な手順に従って確認してブループリントに割り当てることができます。

なんらかの理由(ブループリントの変更、再展開、バックアップからのデバイスの復元など)でApstraエージェントをリセットする必要がある場合は、Apstraエージェントのメタデータをクリアし、デバイスを再登録して、ブループリントに再展開することをお勧めします。

エージェントをアンインストールするには、まず GUI を使用して、標準的な手順に従ってブループリントからエージェントをアンデプロイし、割り当てを解除します。[管理対象デバイス]ページから完全に削除することもできます。

NX-OSからApstraパッケージを削除するには、ゲストシェルを破棄します。これは、他のアプリケーションがゲストシェルを使用していない場合にのみ行ってください。

Apstraデバイスエージェントは、テレメトリを支援するためにイベントマネージャーアプレットをインストールします。これらは安全に取り外すことができます

C9K-172-20-65-5(config)#no event manager applet AOS_PROTO_VSH_LAUNCH C9K-172-20-65-5(config)# no event manager applet AOS_STATS_VSH_LAUNCH C9K-172-20-65-5(config)# no event manager applet aos_bgp_applet C9K-172-20-65-5(config)# no event manager applet aos_ifdown_applet C9K-172-20-65-5(config)# no event manager applet aos_ifup_applet

ApstraエージェントはNXOSゲストシェルで実行され、基盤となるbashおよびLinux環境と対話します。これは、Apstraが動作する内部Linuxコンテナ(LXC)です。LXCでは、ApstraはNXAPIやその他の方法を使用してNXOSと直接通信します。セキュリティ上の理由から、CiscoはLXCインターフェイスの大部分をNXOSデバイスの残りの部分から離してパーティション化しているため、さらにトラブルシューティングコマンドを実行するには、ゲストシェルのbashプロンプトにドロップする必要があります。

ゲストシェルがNX-OSで実行されていることを確認する ApstraエージェントはNXOSゲストシェルで実行され、基盤となるbashおよびLinux環境と対話します。これは、Apstraが動作する内部Linuxコンテナ(LXC)です。ゲストシェルがアクティブ化され、実行されていることを確認しています。

登録済みサービスの表示

• Apstraへのネットワーク到達可能性の確認
• エージェントのインストールの確認
• Apstraエージェントが実行されていることを確認する
• /etc/aos にファイルが存在するかどうかの確認
• /var/log/aosにあるApstraデータを確認する
• Apstraエージェントのバージョンを確認する
• DNS 解決の失敗
• Cisco NX-OSでのApstraサービスの開始に時間がかかる
• Apstraがエラーなしで停止し、障害が発生する(MGMT VRF)
• NX-OSゲストシェルでのMGMT VRFの確認