ゲートウェイ コネクタは、Control Hub への接続を維持し、イベントを調整し、ステータス情報を収集するために、ゲートウェイ GuestShell で実行される小さなアプリケーションです。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 を使用して、トラフィックをゲスト シェルにルーティングします。この機能を無効にするために、ip proxy-arp 彗星を設定しないでください。

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

ゲートウェイ登録用にデバイスを準備します。

• 組織管理者として Control Hub へのアクセス

• 設定するデバイスの IP アドレス、ユーザ名、およびパスワード。

• Cisco IOS XE バージョン:

  • ローカル ゲートウェイ—Cisco IOS XE Bengaluru 17.6.1a 以降

  • サバイバビリティ ゲートウェイ—Cisco IOS XE Dublin 17.12.3 以降

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

• システムの前提条件

  • 最小空きメモリ - 256 MB

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

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

ルータのブートフラッシュが 4GB で、使用可能な容量（最小容量）が 2GB 未満の場合、現在実行中のもの以外のすべての IOS バイナリ（.bin）画像を削除します。ファイルを削除したら、余計なスペースを解放します。

次の手順を使用して、バイナリ画像を展開し、コンポーネントからブートします。

1. mkdir bootflash:/image を使用して新しいディレクトリを作成します。

2. request platform software package expand file bootflash:/.bin to bootflash:/image を使用して IOS バイナリ画像を展開します。

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 プロキシ サーバ。

  • ゲートウェイの資格情報: 特権レベル 15 のアクセス権を持つローカル クレデンシャル（ユーザ名とパスワード）は、NETCONF インターフェイスを介してゲートウェイにアクセスするためにコネクタによって要求されます。

    NETCONF アクセスを認証して承認するには、例に示すようにデフォルトの AAA リストが設定されていることを確認してください。名前付きの aaa リストを使用して NETCONF アクセスを制御することはできません。デフォルト リストが正しく設定されていない場合、システム ログに「無効なメソッド リスト」のエラー メッセージが表示される場合があります。AAA にローカルと一緒に他の方法を使用する場合がありますが、特定の設定の更新が必要です。

    
    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) で仮想 CUBE を使用する場合は、「AWS で仮想 CUBE にセカンダリ IP アドレスを関連付ける 」を参照してください。

  • Control Hub とオンプレミス デバイスに接続して、登録プロセスを完了します。

  • Webex サービスの URL:

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

  • トランスポートプロトコル: Transport Layer Security (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: 

Control Hub に表示されるコネクタの全体的なステータスは、管理対象ゲートウェイの遠隔測定および管理コネクタの状態によって異なります。

Control Hub のコネクタの状態	説明
オンライン	コネクタが 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 に変更します。

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

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 スクリプトとコネクタの最新のログを除くすべての既存のログが削除されます。

Cloud Connector 設定を表示および変更

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. [サービス] に移動し、[Calling] をクリックし、[管理対象ゲートウェイ] をクリックします。

3. 該当するゲートウェイ インスタンスの場合、[アクション] 列の [...] をクリックし、該当するアクションを選択します。