Thousand Eyes - Enterprise Agent for ASR1k、ISR4k、およびCat8kプラットフォームの設定（ Dockerインストール）

はじめに

このドキュメントでは、Cisco IOS-XE®プラットフォームでThousandEyesを設定する方法について説明します。

前提条件

要件

ThousandEyesのドキュメントポータルで要件を検証することをお勧めします。

支持マトリックス千眼

使用するコンポーネント

このドキュメントの情報は、Cisco IOS-XEを搭載したルータに基づくものです。

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、クリアな（デフォルト）設定で作業を開始しています。本稼働中のネットワークでは、各コマンドによって起こる可能性がある影響を十分確認してください。

ISR4Ks Dockerのインストール

ステップ 1：

https://app.thousandeyes.comから、Cloud & Enterprise Agents > Agent settings > Add New Enterprise Agent > Cisco Application HostingのメニューにあるThousandEyesエージェントをダウンロードします。

ステップ 2：

.tarファイルをルータのブートフラッシュにコピーします。これはTFTPを使用して実行できます。または、USBフラッシュドライブにファイルをダウンロードし、ルータのブートフラッシュにコピーします。

Router#dir bootflash: | sec .tar
24577 -rw- 186705920 May 19 2022 16:26:31 +00:00 thousandeyes-enterprise-agent-4.2.2.cisco.tar

ステップ 3：

ioxコマンドを使用してルータのIOxデーモンを有効にし、サービスステータスを検証します。

Router(config)#iox 
*May 19 16:40:48.485: %UICFGEXP-6-SERVER_NOTIFIED_START: R0/0: psd: Server iox has been notified to start
Router#show iox-service
IOx Infrastructure Summary:
---------------------------
IOx service (CAF)              : Not Running
IOx service (HA)               : Not Supported 
IOx service (IOxman)           : Not Running
IOx service (Sec storage)      : Not Supported 
Libvirtd 5.5.0                 : Running 

ステップ 4：

app-hosting install appid <agent_name> package bootflash:<file.tar>コマンドを使用して、以前にブートフラッシュに保存したエージェントをインストールします。

Router#app-hosting install appid ISR4k_Agent package bootflash:thousandeyes-enterprise-agent-4.2.2.cisco.tar
Installing package 'bootflash:thousandeyes-enterprise-agent-4.2.2.cisco.tar' for 'ISR4k_Agent'. Use 'show app-hosting list' for progress.

ステップ 5：

show app-hosting listコマンドを使用して、エージェントが正しくインストールされていることを確認します。 

Router#show app-hosting list
App id                                   State
---------------------------------------------------------
ISR4k_Agent                              DEPLOYED

手順 6：

仮想ポートインターフェイスを設定します。

interface VirtualPortGroup1
ip address 192.168.2.254 255.255.255.0
no mop enabled
no mop sysid
end

ステップ 8：

アプリケーションホスティング用にVNICを設定します。

Router(config)#app-hosting appid ISR4k_Agent
Router(config-app-hosting)#app-vnic gateway1 virtualportgroup 1 guest-interface 1
Router(config-app-hosting-gateway1)#guest-ipaddress 192.168.2.10 netmask 255.255.255.0
Router(config-app-hosting-gateway#)#exit
Router(config-app-hosting)#app-default-gateway 192.168.2.254 guest-interface 1
Router(config-app-hosting)#name-server1 8.8.8.8
Router(config-app-hosting)#end

注：name-serverコマンドのIPアドレスは、内部または外部のDNSサーバです。

手順 7：

Dockerをセットアップします。必要なトークンは、https://app.thousandeyes.comのCloud & Enterprise Agents > Agent settings > Add a New Enterprise Agent > Cisco Application Hostingのメニューで取得できます。

小さな目のアイコンをクリックします。暗号化されていないトークン番号が表示されます。文字列をコピーし、ルータへのインストールを続行します。

Dockerインストールコマンド：

Router(config-app-hosting)#app-resource docker
Router(config-app-hosting-docker)#prepend-pkg-opts
Router(config-app-hosting-docker)#run-opts 1 "-e TEAGENT_ACCOUNT_TOKEN= EAGENT_ACCOUNT_TOKEN= xxxxxxxxxxxxxxxxxxxx"
Router(config-app-hosting-docker)#run-opts 2 "--hostname ISR_Agent"
Router(config-app-hosting)#start
Router(config-app-hosting)#end
Router#
*May 30 20:10:00.282: %SYS-5-CONFIG_I: Configured from console by console
*May 30 20:10:06.980: %IM-6-START_MSG: R0/0: ioxman: app-hosting: Start succeeded: ISR_Agent started successfully Current state is RUNNING

ステップ 9：

show app-hosting listコマンドを使用して、エージェントがアクティブであることを確認します。

Router#show app-hosting list
App id                                   State
---------------------------------------------------------
ISR_Agent                                RUNNING

ASR1K Dockerのインストール

ステップ 1：
Thousandeyes-enterprise-agent-x.x.x.cisco.tarというThousandeyesのWebサイトからエージェントの.tarアーカイブをダウンロードします。

ステップ 2：

.tarファイルをルータのブートフラッシュにコピーします。これはTFTPを使用して実行できます。または、USBフラッシュドライブにファイルをダウンロードし、ルータのブートフラッシュにコピーします。

Router#dir bootflash: | sec .tar
16 -rw- 186705920 Sep 21 2022 15:02:21 +00:00 thousandeyes-enterprise-agent-4.2.2.cisco.tar

ステップ 3：

ioxコマンドを使用してルータでIOxデーモンを有効にし、サービスステータスを検証します。

Router(config)#iox
Router#show iox-service
IOx Infrastructure Summary:
---------------------------
IOx service (CAF)              : Running
IOx service (HA)               : Not Supported
IOx service (IOxman)           : Running
IOx service (Sec storage)      : Not Supported
Libvirtd 5.5.0                 : Running 

ステップ 4：

app-hosting install appid <agent_name> package bootflash:<file.tar>コマンドを使用して、以前にブートフラッシュに保存したエージェントをインストールします。

Router#app-hosting install appid ASR_TE package bootflash:thousandeyes-enterprise-agent-4.2.2.cisco.tar
Installing package 'bootflash:thousandeyes-enterprise-agent-4.2.2.cisco.tar' for 'ASR_TE'. Use 'show app-hosting list' for progress.
*Sep 21 16:10:12.900: %IOXCAF-6-INSTALL_MSG: R0/0: ioxman: app-hosting: ASR_TE installed successfully Current state is DEPLOYED

Router#show app-hosting list
App id                                   State
---------------------------------------------------------
ASR1k_TE                                 DEPLOYED

ステップ 5：

仮想ポートインターフェイスにプライベートIPアドレスを設定します。

interface VirtualPortGroup0
ip address 192.168.2.254 255.255.255.0
no mop enabled
no mop sysid
end

手順 6：
アプリケーションホスティング用にVNICを設定します。

Router(config)#app-hosting appid ASR1k_TE
Router(config-app-hosting)#app-vnic gateway1 virtualportgroup 0 guest-interface 0
Router(config-app-hosting-gateway0)#guest-ipaddress 192.168.2.1 netmask 255.255.255.0
Router(config-app-hosting-gateway0)#exit
Router(config-app-hosting)#app-default-gateway 192.168.2.254 guest-interface 0
Router(config-app-hosting)#name-server0 8.8.8.8
Router(config-app-hosting)#app-resource docker
Router(config-app-hosting-docker)#prepend-pkg-opts
Router(config-app-hosting-docker)#run-opts 1 "--hostname ASR1kTE"
Router(config-app-hosting-docker)#run-opts 1 "-e TEAGENT_ACCOUNT_TOKEN=XXXXXXXXXXXXXXXXX"
Router(config-app-hosting-docker)#exit

手順 7：

引用したアプリIDのアプリケーションホスティングをアクティブにします。

Router(config)#app-hosting appid ASR1k_TE
Router(config-app-hosting)#start

ステップ 8：

ThousandEyesエージェントをインストールし、show app-hosting listコマンドを使用してエージェントがアクティブであることを確認します。

Router#app-hosting install appid ASR1k_TE package bootflash:thousandeyes-enterprise-agent-4.2.2.cisco.tar
Installing package 'bootflash:thousandeyes-enterprise-agent-4.2.2.cisco.tar' for 'ASR1k_TE'. Use 'show app-hosting list' for progress.

Router#show app-hosting list
App id                                   State
---------------------------------------------------------
ASR1k_TE                                 RUNNING

Catalyst 8K Dockerのインストール

Catalyst 8200 の設定

ステップ 1：

Thousaneyes-enterprise-agent-x.x.x.cisco.tarというWebサイトからエージェントの.tarファイルをダウンロードします。

ステップ 2：

.tarファイルをデバイスのハードディスクにコピーします。

C8200k#dir harddisk:thousandeyes-enterprise-agent-4.3.0.cisco.tar
Directory of harddisk:/thousandeyes-enterprise-agent-4.3.0.cisco.tar

12      -rw-        123064320  Nov 12 2022 21:35:06 +00:00  thousandeyes-enterprise-agent-4.3.0.cisco.tar

15239921664 bytes total (14280880128 bytes free)
C8200k#

ステップ 3：
ioxコマンドを使用してルータでIOxデーモンを有効にし、サービスステータスを検証します。

C8200k(config)#iox 
*Nov 12 21:46:51.539: %UICFGEXP-6-SERVER_NOTIFIED_START: R0/0: psd: Server iox has been notified to start
*Nov 12 21:46:52.443: %SYS-5-CONFIG_I: Configured from console by console
*Nov 12 21:47:13.866: %IM-6-IOX_ENABLEMENT: R0/0: ioxman: IOX is ready.

C8200k#show iox-service 
IOx Infrastructure Summary:
---------------------------
IOx service (CAF)              : Running
IOx service (HA)               : Not Supported 
IOx service (IOxman)           : Running 
IOx service (Sec storage)      : Not Supported 
Libvirtd 5.5.0                 : Running

ステップ 4：

プラットフォームリソースをapp-heavyに設定します。 設定変更を保存し、シャーシをリロードします。

C8200k(config)#platform resource service-plane-heavy 
C8200k(config)#end
C8200k#wr
C8200k#reload

ステップ 5：

仮想ポートインターフェイスを設定します。

interface virtualportgroup 0
ip address 192.168.2.254 255.255.255.0
exit

手順 6：
アプリケーションホスティング用にVNICを設定します。

C8200k(config)#app-hosting appid TEcat8k
C8200k(config-app-hosting)#app-vnic gateway1 virtualportgroup 0 guest-interface 0    
C8200k(config-app-hosting-gateway1)#guest-ipaddress 192.168.2.10 netmask 255.255.255.0   
C8200k(config-app-hosting-gateway1)#exit 
C8200k(config-app-hosting)#app-default-gateway 192.168.2.254 guest-interface 0
C8200k(config)#app-hosting appid TEcat8k 
C8200k(config-app-hosting)#app-resource docker
C8200k(config-app-hosting-docker)#prepend-pkg-opts
C8200k(config-app-hosting-docker)#run-opts 1 "-e TEAGENT_ACCOUNT_TOKEN=xxxxxxxxxxxxxxxxxxxx" 
C8200k(config-app-hosting-docker)#run-opts 2 "--hostname TEcat8k"              
C8200k(config-app-hosting)#name-server0 8.8.8.8
C8200k(config-app-hosting)#end

手順 7：
引用したアプリIDのアプリケーションホスティングをアクティブにします。

C8200k(config)#app-hosting appid TEcat8k 
C8200k(config-app-hosting)#start 

ステップ 8：

ThousandEyesエージェントをインストールし、実行されていることを確認します。

C8200k#app-hosting install appid TEcat8k package harddisk:thousandeyes-enterprise-agent-4.3.0.cisco.tar  
Installing package 'harddisk:thousandeyes-enterprise-agent-4.3.0.cisco.tar' for 'TEcat8k'. Use 'show app-hosting list' for progress.

*Jan 21 21:30:17.194: %IM-6-INSTALL_MSG: R0/0: ioxman: app-hosting: Install succeeded: TEcat8k installed successfully Current state is DEPLOYED
*Jan 21 21:30:41.019: %IM-6-START_MSG: R0/0: ioxman: app-hosting: Start succeeded: TEcat8k started successfully Current state is RUNNING

C8200k#show app-hosting list 
App id                                   State
---------------------------------------------------------
TEcat8k                                  RUNNING

Catalyst 8300 の設定

ステップ 1：
Thousandeyes-enterprise-agent-x.x.x.cisco.tarのWebサイトからエージェント.tarファイルをダウンロードします。

ステップ 2：

.tarファイルをデバイスのハードディスクにコピーします。

Router#dir harddisk:thousandeyes-enterprise-agent-4.2.2.cisco.tar
Directory of harddisk:/thousandeyes-enterprise-agent-4.2.2.cisco.tar

12 -rw- 186705920 Sep 14 2022 19:02:02 +00:00 thousandeyes-enterprise-agent-4.2.2.cisco.tar

ステップ 3：
ioxコマンドを使用してルータでIOxデーモンを有効にし、サービスステータスを検証します。

Router(config)#iox
*Sep 5 17:48:31.952: %UICFGEXP-6-SERVER_NOTIFIED_START: R0/0: psd: Server iox has been notified to start
*Sep 5 17:48:40.953: %IM-6-IOX_ENABLEMENT: R0/0: ioxman: IOX is ready.
Router#show iox-service
IOx Infrastructure Summary:
---------------------------
IOx service (CAF)              : Running
IOx service (HA)               : Not Supported
IOx service (IOxman)           : Running
IOx service (Sec storage)      : Not Supported
Libvirtd 5.5.0                 : Running

ステップ 4：

仮想ポートインターフェイスを設定します。

interface VirtualPortGroup1
ip address 192.168.2.254 255.255.255.0
no mop enabled
no mop sysid
end

ステップ 5：
アプリケーションホスティング用にVNICを設定します。

Router(config)#app-hosting appid Cat8k_TE
Router(config-app-hosting)#app-vnic gateway1 virtualportgroup 1 guest-interface 1
Router(config-app-hosting-gateway1)#guest-ipaddress 192.168.2.1 netmask 255.255.255.0
Router(config-app-hosting)#app-default-gateway 192.168.2.254 guest-interface 1 
Router(config-app-hosting)#app-resource docker
Router(config-app-hosting-docker)#prepend-pkg-opts
Router(config-app-hosting-docker)#run-opts 1 "--hostname C8k_TE"
Router(config-app-hosting-docker)#run-opts 2 "-e TEAGENT_ACCOUNT_TOKEN=xxxxxxxxxxxxxxxxxxxx"
Router(config-app-hosting)#name-server1 8.8.8.8
Router(config-app-hosting)#start

手順 6：
startコマンドを設定して、アプリケーションを起動します。

Router(config)#app-hosting appid Cat8k_TE
Router(config-app-hosting)#start

手順 7：
ThousandEyesエージェントをインストールし、展開されていることを確認します。

Router#app-hosting install appid TEcat8k package harddisk:thousandeyes-enterprise-agent-4.2.2.cisco.tar

Router#show app-hosting list
App id                                   State
---------------------------------------------------------
Cat8k_TE                                 DEPLOYED

  Catalyst 8500Lの設定

ステップ 1：
Thousaneyes-enterprise-agent-x.x.x.cisco.tarというWebサイトからエージェントの.tarファイルをダウンロードします。

ステップ 2：

.tarファイルをデバイスのハードディスクにコピーします。

Router#dir harddisk:thousandeyes-enterprise-agent-4.2.2.cisco.tar
Directory of harddisk:/thousandeyes-enterprise-agent-4.2.2.cisco.tar

12 -rw- 186705920 Sep 14 2022 19:02:02 +00:00 thousandeyes-enterprise-agent-4.2.2.cisco.tar

ステップ 3：
ioxコマンドを使用してルータでIOxデーモンを有効にし、サービスステータスを検証します。

Router#conf t
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)#iox
Router(config)#end
*Sep 15 15:41:23.992: %UICFGEXP-6-SERVER_NOTIFIED_START: R0/0: psd: Server iox has been notified to startsh
*Sep 15 15:41:25.006: %SYS-5-CONFIG_I: Configured from console by console
*Sep 15 15:41:32.914: %IM-6-IOX_ENABLEMENT: R0/0: ioxman: IOX is ready.

Router#show iox-service

IOx Infrastructure Summary:
---------------------------
IOx service (CAF)              : Not Running
IOx service (HA)               : Not Supported 
IOx service (IOxman)           : Not Running
IOx service (Sec storage)      : Not Supported 
Libvirtd 5.5.0                 : Running 

ステップ 4：

仮想ポートインターフェイスを設定します。

interface VirtualPortGroup1
ip address 192.168.2.254 255.255.255.0
no mop enabled
no mop sysid
end

ステップ 5：

アプリケーションホスティング用にVNICを設定します。

Router(config)#app-hosting appid Cat8500L_TE
Router(config-app-hosting)#app-vnic gateway0 virtualportgroup 0 guest-interface 0
Router(config-app-hosting-gateway0)#guest-ipaddress 192.168.2.1 netmask 255.255.255.0
Router(config-app-hosting-gateway0)#exit
Router(config-app-hosting)#guest-gateway 192.168.2.254 guest-interface 0
Router(config-app-hosting)#app-resource docker
Router(config-app-hosting-docker)#prepend-pkg-opts
Router(config-app-hosting-docker)#run-opts 1 "--hostname Cat8500L_TE"
Router(config-app-hosting-docker)#run-opts 2 "-e TEAGENT_ACCOUNT_TOKEN=TEAGENT_ACCOUNT_TOKEN=xxxxxxxxxxxxxxxxxxxx"
Router(config-app-hosting)#name-server1 8.8.8.8
Router(config-app-hosting)#start

手順 6：

プラットフォームリソースapp-heavyを設定します。次に、設定の変更を保存し、シャーシをリロードします。

Router(config)#platform resource app-heavy
Please reboot to activate this template
Router(config)#exit
Router#wr
Router#reload

手順 7：

ThousandEyesエージェントをインストールし、展開されていることを確認します。

Router#app-hosting install appid Cat8500L_TE package harddisk:thousandeyes-enterprise-agent-4.2.2.cisco.tar
Installing package 'harddisk:thousandeyes-enterprise-agent-4.2.2.cisco.tar' for 'Cat8500L_TE'. Use 'show app-hosting list' for progress.

Router#show app-hosting list
App id                                   State
---------------------------------------------------------
Cat8500L_TE                              DEPLOYED

注：NATはThousandEyesで使用できます。

仮想ポートインターフェイスは、NATの内部インターフェイスとして使用できます。

以下に例を挙げます。

Router(config)#ip nat inside source list NAT interface gi0/0/0 overload
Router(config)#ip access-list extended NAT
Router(config-ext-nacl)#permit ip 192.168.2.0 0.0.0.255 any

interface VirtualPortGroup1
description ThousandEyes
192.168.2.254 255.255.255.0
ip nat inside

interface GigabitEthernet0/0/0
description WAN interface
192.168.114.10 255.255.255.252
ip nat outside