コメントありがとうございます。

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

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

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

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

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

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

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

• 管理コネクター

• テレメトリーコネクター

インタラクティブなメニュー方式のTCLスクリプトは、GuestShellの設定だけでなく、 管理コネクタのインストールとメンテナンスにも役立ちます。

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

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

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

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

• 外部インターフェース

• DNSサーバーアドレス

• プロキシの詳細

• コネクターのIPアドレス

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

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

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

• ゲストシェル

• ネットコンフヤン

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

• 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コマンドを設定してこの機能を無効にしないでください。

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

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

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

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

• Cisco IOSXE バージョン:

  • ローカルゲートウェイ— Cisco IOS XEバンガロール 17.12.3以降

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

  推奨バージョンについては、シスコソフトウェアリサーチを参照してください。 プラットフォームを検索して、推奨リリースの1つを選択してください。

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

• システムの前提条件

  • 最小空きメモリ—256 MB

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

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

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

以下の手順でバイナリイメージを拡張し、コンポーネントから起動してください。

1. を使用して新しいディレクトリを作成します。mkdir ブートフラッシュ:/image

2. を使用してIOSバイナリイメージを拡張してください。リクエストプラットフォームソフトウェアパッケージファイル bootflash: /.bin をブートフラッシュ:/image に展開します <image>

3. 設定モードで、を使用して現在のブートオプションを削除してください。ブートシステムはありません

4. 新しいブートステートメントを設定します： ブートシステムブートフラッシュ：/image/packages.conf。

5. 設定モードを終了し、設定を保存して再起動します。

6. ルーターが再起動したら、を使用してバージョンを表示して、ルーターがブートフラッシュから起動したことを確認します:/image/packages.conf。 もしそうなら：

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

   2. 残りのIOSバイナリイメージを削除します。

   3. を使用してコアイメージをすべて削除します。/f /r ブートフラッシュを削除してください:/core/*

   4. を使用してトレースログファイルを削除します。/f /r ブートフラッシュを削除してください:/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 <password>
    

  ネットワークの前提条件

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

    ローカルゲートウェイとしてアマゾンウェブサービス（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 <alerts> level and they would be changed to <notifications>
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: ステータスページの表示メニューオプションを使用してください。 システムは、 さまざまなコネクタモジュールの状態を表示します。

===============================================================
                 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: Guestshellを有効にするメニューオプションを使用してクラウドコネクタを有効にします。 これにより、 コネクタのステータスがINACTIVEからACTIVEに変わります。

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

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

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

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

ログを集める

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

<case-number><cxd-token>で現在サポートケースがある場合はCisco TAC、copy bootflash: /guest-share/ scp://: <log-filename>@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: クラウドコネクタ設定の表示と変更メニューオプションを使用して、クラウドコネクタの既存の設定に次の変更を加えます。

===============================================================
                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: ゲートウェイ認証情報の更新メニューオプションを使用して、ゲートウェイのユーザー名とパスワードを更新します。

外部インターフェースを更新してください

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

プロキシの詳細を更新してください

p: プロキシの詳細の更新メニューオプションを使用して、次のタスクを実行できます。

• i: プロキシIPとポートを更新してください

• c: プロキシ認証情報を更新します

• r: プロキシ認証情報を削除します

• a: プロキシの詳細をすべて削除します

• h: ホームメニューに移動

コネクタパッケージの検証キーを更新してください

技術的な問題が発生した場合、 サポートエンジニアからパッケージ検証キーの交換を依頼された場合は、 新しいgateway-webex-connectors.gpgファイルをbootflash: /gateway_connector/にアップロードし、k: コネクターパッケージ検証キーの更新メニューオプションを使用して確認してください。

管理コネクタのログレベルを変更してください

l: Cloud Connectorのログレベルを変更メニューオプションを使用してコネクタのログレベルを変更し、 次のオプションのいずれかを選択します。

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

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

1. コントロールハブにサインインしてください。

2. [サービス] > [PSTNとルーティング] > [ゲートウェイの設定] > [ゲートウェイの管理] に移動します

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