Cisco IOS 管理ゲートウェイを Webex Cloud に登録する

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

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

コネクタには 2 つのタイプがあります。

• 管理コネクタ

• テレメトリ コネクタ

インタラクティブなメニュー駆動のTCLスクリプトは、GuestShellの設定、および管理コネクタのインストールとメンテナンスに役立ちます。

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

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

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

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

• 外部インターフェイス

• DNS サーバー アドレス

• プロキシの詳細

• コネクタ IP アドレス

• ゲートウェイの資格情報 (ユーザー名とパスワード)

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

• Virtual Port Group - ゲストシェルの設定に必要です。

• ゲストシェル

• NETCONFヤン

• [SNMP トラップ設定（SNMP Trap configuration）]:Cisco IOS XE からの通知に必要です。

• [IP ルート（Ip Route）]:仮想ポート グループを介してコネクタ関連のトラフィックをルーティングします。

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プロキシなしだ
• 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 の空き容量が必要です。 また、ブートフラッシュには50MBの空き容量が必要です。 ログと RPM ファイルを保存するために使用されます。

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

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

バイナリイメージを展開し、コンポーネントから起動するには、次の手順を使用します。

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

2. IOS バイナリ画像を展開する request platform software package expand file bootflash:/<image>.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 リストが設定されていることを確認します。 デフォルト リストの任意のメソッド オプションを使用できます。 名前付き aaa リストを使用して NETCONF アクセスを制御することはできません。 デフォルト リストが正しく設定されていない場合、システム ログに「無効なメソッド リスト」エラー メッセージが表示されます。

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

  ネットワーク前提条件

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

    Amazon Web Services（AWS）で仮想 CUBE をローカル ゲートウェイとして使用する場合は、コネクタの使用にセカンダリ IP アドレスを関連付ける手順については、「AWS での仮想 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: 

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 です。

Guestshell を無効にする

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

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

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

ログの収集

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

Cisco TAC でアクティブなサポート ケースがある場合、コマンドを使用してログをサービス リクエストに直接添付できます。 copy bootflash:/guest-share/<log-filename> scp://<case-number>:<cxd-token>@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 メニュー オプション。

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

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

プロキシの詳細を更新

次のタスクを実行できます: 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. ［サービス］の［Calling］をクリックし、次に［管理対象ゲートウェイ］タブをクリックします。

2. 該当するゲートウェイインスタンスについては、[アクション]列で隣接するドット（…）をクリックし、該当するアクションを選択します。