Cisco IOSゲートウェイをコントロールハブに登録することで、デバイス管理が簡素化され、新しいWebex Callingサービスを利用できるようになります。ゲートウェイはコントロールハブとの接続を維持しているため、他のWebex Callingデバイスと同様に、どこからでも管理および監視できます。ゲートウェイを登録するには、管理コネクタアプリケーションをインストールし、Cisco Webexクラウドとの安全な接続が確立されていることを確認する必要があります。この接続を確立したら、コントロールハブにログインしてゲートウェイを登録できます。

このプロセスは、VG400などのCisco IOS音声ゲートウェイには適用されません。これらのゲートウェイは、コントロールハブでデバイスとして完全に管理されます。

GuestShellと呼ばれる小型コネクタアプリケーションは、ゲートウェイからコントロールハブへの接続を確立および維持する役割を担っています。GuestShellとコネクタアプリケーションは、登録プロセス中にWebexクラウドからゲートウェイ上で実行されるスクリプトを使用して構成および設定されます。

インストールプロセスを簡素化するために、このスクリプトは必要なゲートウェイ設定をいくつか追加します。

ゲートウェイコネクタは、ゲートウェイのゲストシェル内で実行される小型アプリケーションであり、コントロールハブへの接続を維持し、イベントを調整し、ステータス情報を収集します。GuestShell の詳細については、 GuestShellを参照してください。

ゲートウェイコネクタは、Cisco IOS XE GuestShellコンテナにインストールされます。

コネクタには2種類あります。

• 管理コネクタ

• テレメトリコネクタ

対話型のメニュー駆動型TCLスクリプトは、ゲストシェルの設定、および管理コネクタのインストールとメンテナンスを支援します。

管理コネクタは、ゲートウェイの登録とテレメトリコネクタのライフサイクル管理を担当します。

登録が正常に完了すると、管理コネクタは最新のテレメトリコネクタをダウンロードしてインストールします。

以下の図は、Webex Callingソリューションにおける各コンポーネントの接続方法を示しています。

TCLスクリプトの実行の一環として、ユーザーから以下の情報が収集されます。

• 外部インターフェース

• DNSサーバーアドレス

• プロキシの詳細

• コネクタのIPアドレス

• ゲートウェイ認証情報（ユーザー名とパスワード）

TCLスクリプトは以下の設定を実行します。

• 仮想ポートグループ - guestshellの設定に必要です。

• ゲストシェル

• NETCONF Yang

• SNMPトラップの設定 - Cisco IOS XEからの通知に必要です。

• IPルーティング—コネクタ関連のトラフィックを仮想ポートグループ経由でルーティングします。

TCLスクリプトは以下の設定を実行します。

!
interface VirtualPortGroup 0
 ip unnumbered GigabitEthernet1
 no mop enabled
 no mop sysid
!

!
app-hosting appid guestshell
 app-vnic gateway0 virtualportgroup 0 guest-interface 0
  guest-ipaddress 10.65.125.227 netmask 255.255.255.128
 app-default-gateway 10.65.125.142 guest-interface 0
 app-resource profile custom
  cpu 800
  memory 256
  persist-disk 500
 name-server0 72.163.128.140
 name-server1 8.8.8.8
!

!
netconf-yang
netconf-yang cisco-ia snmp-trap-control trap-list 1.3.6.1.4.1.9.9.41.2.0.1
netconf-yang cisco-ia snmp-community-string Gateway-Webex-Cloud
!

!
logging snmp-trap emergencies
logging snmp-trap alerts
logging snmp-trap critical
logging snmp-trap errors
logging snmp-trap warnings
logging snmp-trap notifications
!

!
snmp-server community Gateway-Webex-Cloud RO
snmp-server enable traps syslog
snmp-server manager
!

!
ip route 10.65.125.227 255.255.255.255 VirtualPortGroup0
!
 

インストール前に、コネクタアプリケーションは以下の機器では使用できないことに注意してください。

• Cisco 1100統合サービスルータプラットフォーム
• 高可用性（HA）モードで構成されたプラットフォーム
• SD-WANネットワーク向けにコントローラーモードで構成されたプラットフォーム

コネクタアプリケーションで使用するためにルーターを設定する際には、以下の点を考慮してください。

• IOS XEはプロキシARPを使用して、トラフィックをゲストシェルにルーティングします。この機能を無効にするには、 no ip proxy-arp コマンドを設定しないでください。

• Cisco Unified Border Element (CUBE) 用に設定されているプラットフォームでは、ネットワークアドレス変換 (NAT) を使用しないでください。したがって、コネクタアプリケーションにルーティング可能なIPアドレスを設定してください。つまり、ルーターのインターフェースアドレスを共有することはできません。

ゲートウェイ登録のためにデバイスを準備してください。

• 組織管理者としてコントロールハブにアクセスする

• 設定したいデバイスのIPアドレス、ユーザー名、パスワード。

• Cisco IOS XE バージョン:

  • ローカル ゲートウェイ：Cisco IOS XE Bengaluru 17.12.3 以降

  • 耐障害性ゲートウェイ - Cisco IOS XE Dublin 17.12.3以降

  推奨バージョンについては、 Cisco Software Researchを参照してください。プラットフォームを検索し、 推奨 リリースのいずれかを選択してください。

• デバイスにNTPサーバーの詳細情報が設定され、システムクロックが指定されたNTPサーバーと同期されることを確認してください。

• システム要件

  • 最小空きメモリ：256MB

  • 最小ディスク容量—コネクタのインストールに使用されるゲートウェイに接続されたハードディスク（SSD）には、2000MBの空き容量が必要です。また、ブートフラッシュには50MBの空き容量が必要です。これはログファイルとRPMファイルを保存するために使用されます。

    ゲートウェイにハードディスクが接続されていない場合は、コネクタのインストールにbootflashが使用されます。次に、bootflashには2000MBの空き容量が必要です。

ルーターのブートフラッシュが4GBで、利用可能な容量が2GB未満（最小容量）の場合は、現在実行中のもの以外のすべてのIOSバイナリ（.bin）イメージを削除してください。ファイルを削除した後、空き容量を確保してください。

バイナリイメージを展開し、コンポーネントから起動するには、以下の手順に従ってください。

1. 新しいディレクトリを作成するには、以下を使用します。mkdir bootflash:/image

2. IOSバイナリイメージを展開するには、以下を使用します。request platform software package expand file bootflash:/.bin to bootflash:/image

3. 設定モードで、以下のコマンドを使用して現在のブートオプションを削除します。no boot system

4. 新しいブートステートメントを設定します。boot system bootflash:/image/packages.conf.

5. 設定モードを終了し、設定を保存して、再起動してください。

6. ルーターが再起動したら、show version を使用してルーターが bootflash:/image/packages.confから起動したことを確認します。もしそうなら：

   1. bootflash:/sysboot ディレクトリが空であることを確認してください。

   2. 残っているIOSバイナリイメージを削除します。

   3. コアイメージをすべて削除します。delete /f /r bootflash:/core/*

   4. トレースログファイルを削除します。delete /f /r bootflash:/tracelogs/*

   5. それでもディスク容量が不足する場合は、bootflash内の残りのファイルを確認してください。また、ログやCDRなどの不要なファイルもすべて削除してください。

• インターネットへの経路を持つネットワークに接続されている、サポートされているCiscoルーター。基本構成には以下の項目が含まれている必要があります。

  • DNSサーバーは、パブリックドメイン名を解決するように設定されています。

  • DNSサーバーを設定するには、次のコマンドを使用します。

    • IPネームサーバー <IP address>

  • HTTPプロキシサーバーは、プロキシ経由でインターネットにアクセスしたい場合に使用します。

  • ゲートウェイ認証情報: コネクタがNETCONFインターフェースを介してゲートウェイにアクセスするには、権限レベル15のアクセス権限を持つローカル認証情報（ユーザー名とパスワード）が必要です。

    NETCONFへのアクセスを認証および認可するには、デフォルトのaaaリストが次の例に示すように設定されていることを確認してください。マネージドゲートウェイで検証され、サポートされているコマンドは、このドキュメントに記載されているコマンドのみです。他の方法（例えば、TACACSやISE）を用いた構成は検証されておらず、現在サポートされていません。

    
    aaa new-model
    aaa authentication login default local
    aaa authorization exec default local if-authenticated
    username test privilege 15 secret 
    

  ネットワークの前提条件

  • コネクタのIPアドレスは、外部接続用に選択したネットワークと同じネットワーク内にある必要があります。プライベートネットワークアドレスでも構いませんが、インターネットへのHTTPSアクセスが必要です。

    Amazon Web Services (AWS) 上の Virtual CUBE をローカル ゲートウェイとして使用する場合は、コネクタで使用するセカンダリ IP アドレスを関連付ける手順については、 AWS 上の Virtual CUBE にセカンダリ IP アドレスを関連付ける を参照してください。

  • 登録プロセスを完了するには、コントロールハブとオンプレミスデバイスに接続してください。

  • WebexサービスのURL：

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

  • 輸送プロトコル：トランスポート層セキュリティ（TLS）バージョン1.2

  • IOS公開認証局バンドルをインポートします。ゲートウェイの信頼プールに追加された証明書は、Webexサーバーへのアクセスを検証するために使用されます。バンドルをインポートするには、以下の設定コマンドを使用してください。

    crypto pki trustpool import url https://www.cisco.com/security/pki/trs/ios.p7b

 ===============================================================
             Webex Gateway Connector Installation
 ===============================================================


 Choose the external-interface from the below list of available interfaces:
 ===============================================================
   Number          Interface          IP-Address        Status
 ===============================================================
     1          GigabitEthernet1      10.65.125.142       up    
 ===============================================================

 Enter a number to choose the external interface: 1

These DNS settings were detected in the gateway configuration:
 72.163.128.140 
Do you want to use these settings for the connector? [Y/n]: 

These DNS settings were detected in the gateway configuration:
72.163.128.140
Do you want to use these settings for the connector? [Y/n]: n

These proxy settings were detected in the gateway configuration:
 Proxy Server : proxy-wsa.esl.cisco.com
 Proxy Port   : 80
Do you want to use these settings for the connector? [Y/n]: 

SNMP Traps for syslog messages are
configured at  level and they would be changed to 
level in order to push notifications to the Webex Cloud.
Please confirm if it is ok to proceed?:  [Y/n]: 

 Enter Connector IP address: 10.65.125.227

Enter Gateway username: lab
Enter Gateway password: ***
Confirm Gateway password: ***

===============================================================
                 Webex Managed Gateway Connector
===============================================================

  *** Cloud connector is installed successfully. ***
-------------------------------------------------------
         *** Interface Status ***
-------------------------------------------------------
   Interface               IP-Address          Status
-------------------------------------------------------
   GigabitEthernet1        10.65.125.142       up    
   VirtualPortGroup0       10.65.125.142       up    
   Connector               10.65.125.188       up
   
-------------------------------------------------------

          *** App Status ***
-------------------------------------------------------
 Service                 Status
-------------------------------------------------------
 Guestshell              RUNNING
 Management Connector    RUNNING
-------------------------------------------------------

===============================================================
 Select option h for home menu or q to quit: 

コントロールハブに表示されるコネクタの全体的なステータスは、管理対象ゲートウェイ上のテレメトリコネクタと管理コネクタの状態によって異なります。

コントロールハブ内のコネクタの状態	説明
オンライン	コネクタがCisco Webexクラウドに 接続されている ことを示します。
オフライン	コネクタがCisco Webexクラウドに 接続されていない ことを示します。
一時停止	コネクタは接続されているが、一時的に 一時停止 していることを示します。

管理コネクタのローカル管理

コネクタのインストールが正常に完了すると、ゲートウェイを使用してWebex Callingを利用できるようになります。必要に応じて、スクリプトメニューにあるオプションを使用して、コネクタの設定をいくつか更新できます。

以下のコマンドを使用すると、いつでもスクリプトを再起動できます。tclsh bootflash:/gateway_connector/gateway_onboarding.tcl.

===============================================================
Webex Managed Gateway Connector
===============================================================
Options
s : Display Status Page
v : View and Modify Cloud Connector Settings
e : Enable Guestshell
d : Disable Guestshell
l : Collect Logs
r : Clear Logs
u : Uninstall Connector
q : Quit
===============================================================
Select an option from the menu:

表示ステータス

s: Display Status Page メニューオプションを使用してください。システムは、さまざまなコネクタモジュールの状態を表示します。

===============================================================
                 Webex Managed Gateway Connector
===============================================================
     -------------------------------------------------------
                     *** Interface Status ***
     -------------------------------------------------------
       Interface               IP-Address          Status
     -------------------------------------------------------
       GigabitEthernet1        10.123.221.224        up    
       Connector               10.123.221.223        up
     -------------------------------------------------------
                       *** App Status ***
     -------------------------------------------------------
		Service                   Status
     -------------------------------------------------------
            Guestshell                  RUNNING
            Management Connector        RUNNING
     -------------------------------------------------------
===============================================================
          Select option h for home menu or q to quit: q 

Guestshellを有効にする

e: Enable Guestshell メニューオプションを使用してクラウドコネクタを有効にします。これにより、コネクタの状態が INACTIVE から ACTIVEに変更されます。

Guestshellを無効にする

d: Disable Guestshell メニューオプションを使用してクラウドコネクタを無効にします。これにより、コネクタの状態が ACTIVE から INACTIVEに変更されます。

コネクタをアンインストール

u: Uninstall Connector メニューオプションを使用してクラウドコネクタをアンインストールします。これにより、Guestshellコンテナ内のすべてのデータが削除され、クラウドコネクタに関連するすべての設定が削除されます。

ログの収集

l: Collect Logs メニューオプションを使用してログを収集します。システムは、ログを収集した後、これらのログが保存される場所を表示します。

Cisco TAC でアクティブなサポートケースがある場合は、コマンド copy bootflash:/guest-share/ scp://:@cxd.cisco.comを使用してログをサービスリクエストに直接添付できます。

以下はコマンドの例です。

vcubeprod#copy bootflash:/guest-share/gateway_webex_cloud_logs_2022114090628.tar.gz scp://123456789:a1b2c3d4e5@cxd.cisco.com

ログをクリアする

r: Clear Logs メニューオプションを使用して、デバイス内のすべてのログファイルを消去します。これにより、TCLスクリプトとコネクタの最新ログを除く、既存のすべてのログが削除されます。

クラウドコネクタ設定の表示と変更

v: View and Modify Cloud Connector Settings メニューオプションを使用して、クラウドコネクタの既存の設定に以下の変更を加えます。

===============================================================
                Webex Managed Gateway Connector
===============================================================
		Script Version         : 2.0.2
		Hostname/IP Addr       : 10.65.125.188
		DNS Server(s)          : 10.64.86.70
		Gateway Username       : lab
		External Interface     : GigabitEthernet1
		Proxy Hostname/IP Addr : proxy-wsa.esl.cisco.com:80
===============================================================
             Options
               c :  Update Gateway Credentials
               e :  Update External Interface
               p :  Update Proxy Details
               n :  Update DNS Server
               k :  Update Connector Package Verification Key
               l :  Modify log level for Cloud Connector
               h :  Go to home menu
               q :  Quit

===============================================================
                        Select an option from the menu: c

ゲートウェイ認証情報を更新する

c: Update Gateway Credentials メニューオプションを使用して、ゲートウェイのユーザー名とパスワードを更新してください。

外部インターフェースの更新

v: View and Modify Cloud Connector Settings メニューオプションを使用して、コネクタがバインドされているインターフェースとコネクタのIPアドレスを変更します。

プロキシの詳細を更新

p: Update Proxy Details メニューオプションを使用すると、以下のタスクを実行できます。

• i: Update Proxy IP and Port

• c: Update Proxy Credentials

• r: Remove Proxy Credentials

• a: Remove All Proxy Details

• h: Go to home menu

コネクタパッケージ検証キーの更新

技術的な問題が発生した場合、サポートエンジニアがパッケージ検証キーの交換を要求した場合は、新しい gateway-webex-connectors.gpg ファイルを bootflash:/gateway_connector/ にアップロードし、 k: Update Connector Package Verification Key メニューオプションを使用して検証してください。

管理コネクタのログレベルを変更する

l: Modify log level for Cloud Connector メニューオプションを使用してコネクタのログレベルを変更し、以下のいずれかのオプションを選択してください。

=====================================
  Number      Log Level 
=====================================
   1           DEBUG 
   2           INFO 
   3           WARNING 
   4           ERROR 
   5           CRITICAL 
======================================

ゲートウェイインスタンスを管理するには：

1. Control Hub にサインインします。

2. サービス へ移動 > PSTN & ルーティング > ゲートウェイ構成 > ゲートウェイの管理

3. 該当するゲートウェイインスタンスについて、 をクリックして、該当するアクションを選択してください。