Skip to content

Cisco Catalyst上にThousandEyesのEnterpriseAgentをインストールする

ThousandEyesでネットワークを可視化するにはエージェントを用意する必要があります。エージェントはLinuxへインストールすることもできますが、Cisco製のネットワーク機器上へインストールすることもできます。Catalystにはコンテナを動作させることができるApp-Hostingという機能があり、ThousandEyesのエージェントはこの機能を使ってコンテナとして動作させます。今回はCatalyst9300上へエージェントをインストール手順をメモしておきます。

検証環境

対象 バージョン
IOS-XE 17.12.05
EnterpriseAgent 5.0.1

事前準備

Catalystへエージェントをインストールする前に事前準備が必要です。

空き容量の確保

エージェントのインストールにはある程度、ストレージの容量が必要になります。空き容量を確保する為、事前に不要なファイルは削除しておきます。もし何度かバージョンアップを繰り返している環境であれば、不要となった古いOSバイナリが残っているかもしれません。こういった場合はinstall remove inactiveを実行して古いOSバイナリを削除します。

install remove inactive

App Hostingの有効化

コンテナを利用する為にApp Hostingを有効化します。ioxを設定します。

Catalyst# configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
Catalyst(config)# iox
Catalyst(config)# end

App Hostingサービスの起動状態はshow iox-serviceで確認できます。サービスが起動(Running)状態になるまでしばらく時間がかかります。サービスが完全に起動していないと後の手順でコンテナが起動出来ない為、サービスが完全に起動するまで待ってから以降の手順に進みます。

インターネット疎通性の設定

エージェントをインストールする際はインターネットからバイナリをダウンロードします。その為、IPアドレスやデフォルトルートの設定が必要になります。

interface GigabitEthernet1/0/1
 switchport trunk allowed vlan 1234
 switchport mode trunk
!
interface Vlan1234
 ip address 10.0.0.1 255.255.255.0
!
ip route 0.0.0.0 0.0.0.0 10.0.0.254

名前解決の設定

上記と同様の理由から名前解決の設定も必要です。名前解決できるようにDNSサーバも設定しておきます。

ip domain lookup
ip name-server 1.1.1.1 1.0.0.1

AppGigabitEthernetインターフェイスの設定

Catalystスイッチ/ルータ上のコンテナが外部宛に通信する設定方法は幾つかあります。Catalystスイッチの場合、ThousandEyesで自動生成されるコンフィグは「AppGigabitEthernetインターフェイスをTrunk設定して、ここを経由して通信する」ことになります。その為、予めAppGigabitEthernetインターフェイスへTrunk設定をしておきます。

interface AppGigabitEthernet1/0/1
 switchport trunk allowed vlan 1234
 switchport mode trunk

Web管理画面からインストールコマンドの確認

ThousandEyesのWeb管理画面へログインし、Network & App SyntheticsEnterprise AgentsAgentsAdd New Enterprise Agentをクリックします。

image

Cisco Application HostingCatalyst Switchingから必要情報を入力します。

項目 値の例 説明
App ID TE-AGENT App Hosting上のコンテナへ割り当てる名前
Agent Hostname (Optional) - TEのWeb管理画面上に表示する名前。省略した場合、Cisco機器と同じ名前になる
VLAN ID 1234 AppGigabitEthernetでTrunk設定しているVLAN ID
Name Server IP 1.1.1.1 エージェントが名前解決に利用するDNSサーバ
IP Address 10.0.0.100 エージェントに割り当てるIPアドレス。上記で指定したVLANから払い出す
Netmask 255.255.255.0 エージェントに割り当てるネットマスク
Gateway IP 10.0.0.254 エージェントに割り当てるネットワーク。上記で指定したVLAN上のゲートウェイを指定する

入力した値に従ってCLI用のコンフィグが生成されます。後の手順で順次、これをCatalystへ設定していきます。

image

生成されたコンフィグのサンプルは以下です。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
enable
app-hosting install appid DESIRED_APP_ID package https://downloads.thousandeyes.com/enterprise-agent/thousandeyes-enterprise-agent-x86_64-5.0.1.cisco.tar
configure terminal
app-hosting appid DESIRED_APP_ID
app-vnic AppGigabitEthernet trunk
vlan DESIRED_VLAN guest-interface 0
guest-ipaddress DESIRED_IP netmask DESIRED_NETMASK
exit
exit
app-default-gateway GATEWAY_IP guest-interface 0
name-server0 NAMESERVER1_IP
app-resource docker
prepend-pkg-opts
run-opts 1 "-e TEAGENT_ACCOUNT_TOKEN=12345678901234567890123456789012"
exit
exit
exit
write memory
app-hosting activate appid DESIRED_APP_ID
app-hosting start appid DESIRED_APP_ID

エージェントのインストール

Catalystへ順次、設定していきます。まず、以下を実行してEnterprise Agentをインストールします。

enable
app-hosting install appid TE-AGENT package https://downloads.thousandeyes.com/enterprise-agent/thousandeyes-enterprise-agent-x86_64-5.0.1.cisco.tar

インストールが完了するまでしばらく時間がかかります。Stateの表示がINSTALLINGからDEPLOYEDに変わったらインストール完了です。

Catalyst# show app-hosting list
App id                                   State
---------------------------------------------------------
TE-AGENT                                 DEPLOYED

App Hostingの設定

残りの設定を実施します。実際にはIPアドレスやネットマスク、ゲートウェイなどを入力したコンフィグを設定します。最後にwrite memoryを実行してコンフィグを保存します。

configure terminal
app-hosting appid DESIRED_APP_ID
app-vnic AppGigabitEthernet trunk
vlan DESIRED_VLAN guest-interface 0
guest-ipaddress DESIRED_IP netmask DESIRED_NETMASK
exit
exit
app-default-gateway GATEWAY_IP guest-interface 0
name-server0 NAMESERVER1_IP
app-resource docker
prepend-pkg-opts
run-opts 1 "-e TEAGENT_ACCOUNT_TOKEN=12345678901234567890123456789012"
exit
exit
exit
write memory

コンテナの開始

設定が完了したのでコンテナを開始します。以降はCatalystを再起動してもコンテナは自動起動します。

app-hosting activate appid DESIRED_APP_ID
app-hosting start appid DESIRED_APP_ID

これでインストールは完了です。ThousandEyesのWeb管理画面でエージェントが認識されていることを確認します。

コンテナへの接続

通常は不要ですが、何らかの問題があり、コンテナへ接続してトラブルシューティングしたい場合は以下を実行します。

app-hosting connect appid DESIRED_APP_ID session