ゲートウェイ コネクタは、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 スクリプトは次の設定を実行します。

! インターフェイス VirtualPortGroup 0 ip 番号なし GigabitEthernet1 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 ! ! 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 ! ! のロギング snmp-trap 緊急事態のロギング snmp-trap アラート ロギング snmp-trap クリティカルロギング snmp-trap エラー snmp-trap 警告のロギング snmp-trap 通知 ! ! snmp-server コミュニティ 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 以降

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

• システムの前提条件

  • 最小空きメモリ - 256 MB

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

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

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

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

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

2. プラットフォームソフトウェアパッケージの拡張ファイルブートフラッシュを要求する:/.bin から ブートフラッシュ:/imageを使用して IOS バイナリ画像を展開します。

3. 設定モードで、ブートシステムなしを使用して現在のブートオプションを削除します。

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

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

6. ルータが再起動したら、バージョンを表示 を使用して、ルータが bootflash:/image/packages.conf から起動されたことを確認します。その場合:

   1. ブートフラッシュ:/sysboot ディレクトリが空であることを確認します。

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

   3. /f /r bootflash:/core/* を削除します。 を使用して、コア画像を削除します。

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

   5. ディスク容量がまだ足りない場合は、ブートフラッシュ で残りのファイルを確認してください。ログや CDR など、その他の必須ではないファイルを削除します。

• サポートされている Cisco ルーター。インターネットへのパスを持つネットワークに接続されています。基本設定には次のものが必要です。

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

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

    • ip name サーバ

  • プロキシ経由でインターネットにアクセスする場合は、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 <パスワード> 

  ネットワークの前提条件

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

    ローカル ゲートウェイとして アマゾン ウェブ サービス (AWS) で仮想 CUBE を使用する場合は、「AWS で仮想 CUBE にセカンダリ IP アドレスを関連付ける 」を参照してください。

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

  • Webex サービスの URL:

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

  • トランスポートプロトコル: トランスポート層セキュリティ (TLS) バージョン 1.2

  • IOS パブリック認証局バンドルをインポートします。ゲートウェイの信頼プールに追加された証明書は、Webex サーバーへのアクセスを検証するために使用されます。バンドルをインポートするには、次の設定コマンドを使用します。

    暗号 pki trustpool インポート URL https://www.cisco.com/security/pki/trs/ios.p7b

 =============================================================== Webex ゲートウェイコネクタ のインストール =============================================================== 以下の利用可能なインターフェイスから外部インターフェイスを選択します。 =============================================================== 番号インターフェイス IP-Address ステータス =============================================================== 1 GigabitEthernet1 10.65.125.142 アップ =============================================================== 外部インターフェイスを選択するための番号を入力します。1 

 これらの DNS 設定は、ゲートウェイ構成で検出されました。72.163.128.140 これらの設定をコネクタに使用しますか? [Y/n]: 

 これらの DNS 設定は、ゲートウェイ構成で検出されました。72.163.128.140 これらの設定をコネクタに使用しますか? [Y/n]:n 

 これらのプロキシ設定は、ゲートウェイ構成で検出されました。プロキシサーバー: proxy-wsa.esl.cisco.com プロキシ ポート: 80 これらの設定をコネクタに使用しますか? [Y/n]: 

 syslog メッセージの SNMP トラップは  レベルで設定され、Webex Cloud に通知をプッシュするために  レベルに変更されます。続行してもよろしいか確認してください: [Y/n]: 

 コネクタの IP アドレスを入力します。10.65.125.227 

 ゲートウェイのユーザー名の入力:lab ゲートウェイパスワードの入力: *** ゲートウェイパスワードの確認: ***

 =============================================================== Webex 管理対象ゲートウェイ コネクタ =============================================================== *** クラウドコネクタが正常にインストールされました。 *** ------------------------------------------------------- ** インターフェイス ステータス *** ------------------------------------------------------- インターフェイス IP-Address ステータス ------------------------------------------------------- GigabitEthernet1 10.65.125.142 アップ VirtualPortGroup0 10.65.125.142 アップ コネクタ 10.65.125.188 アップ ------------------------------------------------------- *** アプリ ステータス *** ------------------------------------------------------- サービス ステータス ------------------------------------------------------- ゲストシェル 実行中 管理コネクタ 実行中 ------------------------------------------------------- =============================================================== ホーム メニューまたは q を選択して終了: 

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

Control Hub のコネクタの状態	説明
オンライン	コネクタが Cisco Webex クラウドに接続済み であることを示します。
オフライン	コネクタが Cisco Webex クラウドに接続されていない ことを示します。
一時停止	コネクタが接続されていますが、一時的に一時停止 されていることを示します。

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

コネクタを正常にインストールすると、ゲートウェイで Webex Calling を使用できます。必要に応じて、スクリプト メニューで利用可能なオプションを使用して、多くのコネクタ設定を更新できます。

次のコマンドを使用して、いつでもスクリプトを再起動できます。tclsh ブートフラッシュ:/gateway_connector/gateway_onboarding.tcl。

 =============================================================== Webex 管理対象ゲートウェイ コネクタ =============================================================== オプション: ステータス ページの表示 v: Cloud Connector 設定を表示および変更する e: ゲストシェル d を有効化: ゲストシェル l を無効にする: ログの収集 r: ログのクリア: コネクタ q のアンインストール: 終了 =============================================================== メニューからオプションを選択します。

表示ステータス

を使用します。[ステータス ページの表示] メニュー オプションを選択します。システムには、さまざまなコネクタ モジュールのステータスが表示されます。

 =============================================================== Webex 管理対象ゲートウェイ コネクタ =============================================================== ------------------------------------------------------- *** インターフェイス ステータス *** ------------------------------------------------------- インターフェイス IP-アドレスステータス ギガビットイーサネット1 10.123.221.224 アップ コネクタ 10.123.221.223 アップ ------------------------------------------------------- *** アプリのステータス *** ------------------------------------------------------- サービスステータス ゲストシェル実行中 管理コネクタ ランニング ------------------------------------------------------- =============================================================== ホーム メニューまたは q で終了: q 

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

e を使用してクラウド コネクタを有効にします。ゲストシェル メニュー オプションを有効にします。これは、コネクタのステータスを [非アクティブ] から [アクティブ] に変更します。

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

d を使用して クラウドコネクタ を無効にします。ゲストシェル メニュー オプションを無効にします。これにより、コネクタのステータスを [アクティブ] から [非アクティブ] に変更します。

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

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

ログの収集

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

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

以下はコマンドのサンプルです。

vcubeprod#bootflash:/guest-share/gateway_webex_cloud_logs_2022114090628.tar.gz scp://123456789:a1b2c3d4e5@cxd.cisco.com にコピーします

ログを消去

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

クラウドコネクタ 設定を表示および変更

v を使用して、クラウド コネクタの既存の設定に次の変更を加えます。クラウドコネクタ 設定の表示と変更 メニュー オプションを選択します。

 =============================================================== Webex 管理対象ゲートウェイ コネクタ =============================================================== スクリプト バージョン: 2.0.2 ホスト名/IP アドレス: 10.65.125.188 DNS サーバ: 10.64.86.70 ゲートウェイ ユーザ名: ラボ外部インターフェイス: GigabitEthernet1 プロキシホスト名/IP Addr: proxy-wsa.esl.cisco.com:80 =============================================================== オプション c: ゲートウェイの資格情報を更新: 外部インターフェイスを更新 p: プロキシの詳細を更新: DNS サーバーの更新: コネクタ パッケージ検証キーを更新 l: Cloud Connector のログ レベルを変更する h: ホーム メニュー q: 終了 =============================================================== メニューからオプションを選択します。c

ゲートウェイの資格情報を更新

c を使用して、ゲートウェイのユーザー名とパスワードを更新します。[ゲートウェイ資格情報の更新] メニュー オプション。

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

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

プロキシの詳細を更新

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

• i: プロキシ IP とポートの更新

• c: プロキシ資格情報を更新

• r: プロキシ資格情報の削除

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

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

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

サポートエンジニアがパッケージ検証キーを置き換えるよう、技術的な問題が発生した場合は、新しい gateway-webex-connectors.gpg ファイルを ブートフラッシュ:/gateway_connector/ にアップロードし、k: を使用します。[コネクタ パッケージ検証キーを更新] メニュー オプションを確認します。

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

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

 ===================================== 番号ログレベル ===================================== 1 件のデバッグ2 件の情報3 つの警告4 件のエラー5 クリティカル ====================================== 

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

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

2. [サービス] に移動し、[Calling] をクリックし、[管理対象ゲートウェイ] をクリックします。

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