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

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

コネクタには次の 2 つの種類があります。

• 管理コネクタ

• テレメトリコネクタ

対話型のメニュー方式の TCL スクリプトは、GuestShell のセットアップ、および管理コネクタのインストールとメンテナンスに役立ちます。

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

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

次の図は、Webex Calling ソリューションでさまざまなコンポーネントがどのように接続されるかを示しています。

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

• 外部インターフェース

• DNSサーバーアドレス

• プロキシの詳細

• コネクタIPアドレス

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

TCL スクリプトは次の構成を実行します。

• 仮想ポート グループ - ゲストシェルの設定に必要です。

• ゲストシェル

• NETCONFヤン

• 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.6.1a 以降

  • 存続可能性ゲートウェイ - Cisco IOS XE Dublin 17.12.3 以降

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

• システムの前提条件

  • 最小空きメモリ - 256 MB

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

    ゲートウェイにハードディスクが接続されていない場合は、コネクタのインストールにブートフラッシュが使用されます。その場合、ブートフラッシュには 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. まだディスク容量が不足している場合は、ブートフラッシュ内の残りのファイルを確認します。ログや 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 アドレスは、外部接続用に選択した IP アドレスと同じネットワーク内にある必要があります。プライベート ネットワーク アドレスでも構いませんが、インターネットへの HTTPS アクセスが必要です。

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

  • 登録プロセスを完了するには、Control Hub とオンプレミスのデバイスに接続する必要があります。

  • 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 

ゲストシェルを有効にする

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

ゲストシェルを無効にする

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. サービスに移動し、 通話をクリックして、 マネージド ゲートウェイをクリックします。

3. 該当するゲートウェイインスタンスについて、 アクション 列の [ … をクリックし、該当するアクションを選択します。