CMSエッジの設定例

Updated: 2024 年 3 月 22 日
Document ID:221729

偏向のない言語

この製品のドキュメントセットは、偏向のない言語を使用するように配慮されています。このドキュメントセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブ ランゲージの取り組みの詳細は、こちらをご覧ください。

翻訳について

シスコは世界中のユーザにそれぞれの言語でサポート コンテンツを提供するために、機械と人による翻訳を組み合わせて、本ドキュメントを翻訳しています。ただし、最高度の機械翻訳であっても、専門家による翻訳のような正確性は確保されません。シスコは、これら翻訳の正確性について法的責任を負いません。原典である英語版（リンクからアクセス可能）もあわせて参照することを推奨します。

    はじめに

    このドキュメントでは、Cisco Meeting Server(CMS)エッジを設定する方法について説明します。

    前提条件

    要件

    次のCMS 3.Xコンポーネントに関する知識があることが推奨されます。

    • Webブリッジ3
    • コールブリッジ
    • C2W
    • ファイアウォール
    • Turnサーバ

    使用するコンポーネント

    このドキュメントの情報は、次のソフトウェアとハードウェアのバージョンに基づいています。

    • CMS3.X Open Virtual Appliance(OVA)
    • Chromeブラウザ122.0.6261.112
    • Firefoxブラウザ123.0.1(20240304104836)

    このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、クリアな（デフォルト）設定で作業を開始しています。本稼働中のネットワークでは、各コマンドによって起こる可能性がある影響を十分確認してください。

    設定

    事前設定

    1.ネットワークタイムプロトコル(NTP)サーバを設定します。

    CMSエッジおよびコアサーバに同じNTPサーバを設定することをお勧めします。

    2.ドメインネームサーバ(DNS)を設定します。

    1. CMSコアサーバの内部DNSを設定します（内部DNS CMSエッジAレコードはCMSエッジの内部IPアドレスを指します。不可能な場合は、CMSエッジAレコードを2つ設定する必要があります。1つはCMSの内部IPアドレスを指し、もう1つは外部IPアドレスを指します）。
    2. CMSエッジサーバの外部DNSを設定します。外部DNS A CMSレコードは、CMSエッジの外部IPアドレスを指します。

    3. CMSコアは接続に内部CMSエッジAレコードを使用します。

    4.パブリックユーザは、パブリックIPアドレスを介してCMSエッジにアクセスします。

    5.ユーザードメイン：cms.demo:

    a. CMSエッジの記録：

    • edge.cms.demo (internal user login with this A record)
    • edge.cms.demo (public user also use same A record from internet, you could specify the different external A record)

      •

    b. CMSコアの記録：

    core.cms.demo

    6. CMSコアおよびエッジサーバ認定の作成：

    a.認定の作成

    • cmscore-fullchain.cer （すべてのサービスには、ラボのフルチェーン証明書が含まれます。サーバ証明書も含まれます）
    • cmsedge-fullchain.cer （すべてのサービスには、ラボのフルチェーン証明書が含まれます。サーバ証明書も含まれます）
      •

    b. 2台のサーバのフルチェーン認定を生成します。

    • cmscore-fullchain.cer （この証明書にはルート証明書が含まれています）
    • cmsedge-fullchain.cer （この証明書にはルート証明書が含まれています）
      •

    ネットワーク図

    CMSの機能

    CMSのコンポーネント

    CMSのコアおよびエッジの設定

    1. CMSコアサーバ関連サービスをアクティブ化します。

    a.信号ネットワークを設定します。

    ネットワークインターフェイスをアクティブにします。

    ipv4 a add 10.124.56.224/24 10.124.56.1

    b. Callbridgeコンポーネントをアクティブにします。

    callbridge listen a
    callbridge certs core.key cmscore-fullchain.cer
    callbridge trust c2w cmsedge-fullchain.cer (if not, which result in WebRTC failed)
    callbridge enable

    2. CMSエッジサーバー関連サービスをアクティブ化します：

    a. 2つのネットワークインターフェイスを設定します。

    note-icon

    注:「b」はパブリックネットワークインターフェイスで、aは内部ネットワークインターフェイスです。
    • ネットワークa、bをアクティブにする
    • デフォルトゲートウェイの設定はb（パブリックネットワークインターフェイス）
    • 内部ゲートウェイaの設定
         
      •  
    ipv4 a add 10.124.144.80/24 10.124.144.1
    ipv4 b add 10.124.42.112/24 10.124.42.1
    ipv4 b default

    b. ターンコンポーネントをアクティブ化します。

    turn certs edge.key cmsedge-fullchain.cer
    turn listen a b
    turn credentials <username> <password> <cms.demo> (cms.demo is actual domain deployment)
    turn public-ip x.x.x.x
    turn tls 447
    turn enable
    note-icon

    注： 

    1. x.x.x.x はNATマップのパブリックIPアドレスです。NATマップがない場合は、この手順を設定する必要はありません。
    2. ポートは自分自身で定義できます。関連するCMSガイドを参照してください。
      3.

    c. webbridge3コンポーネントをアクティブにします。

    webbridge3 https certs cmsedge.key cmsedge-fullchain.crt (cmsedge-fullchain.crt ,please refer to CMS fullchain document)
    webbridge3 https listen b:445 (b is public network interface , this step just provide public users WebRTC service)
    webbridge3 https listen a:445 b:445 (this step could provide both internal and external WebRTC service, but need to edge.cms.demo has two A records on internal/external DNS servers.)
    webbridge3 c2w certs edge.key cmsedge-fullchain.crt
    webbridge3 c2w listen a:6000 (a is internal network interface, 6000 is self-defined port which need to keep the same with the below Webbridge URL)
    webbridge3 c2w trust cmscore-fullchain.cer (if no this step, result in WebRTC failed)
    webbridge3 enable

    3.関連コンポーネント間の通信を確立します。

    a. Callbridge <—> Turn（パブリックメディアサービス）
    b. Callbridge <—> WebBridge3（WebRTCサービス） 

    CMS Coreでturnとwebbridge3を設定します。
    a. CallbridgeとTurnの間の接続を設定し、パブリックメディアサービスをアクティブにします。
    webadmin GUIにログインし、に移動しますConfiguration > General。

    TURNの設定

    b. CallbridgeとWebbridge3の間の接続を設定し、WebRTCサービスをアクティブにします。
    CMSでAPIを使用してwebbridgeを作成し、C2W接続を追加します(c2w://edge.cms.demo:6000、たとえば、webbridge3サービス設定でポートを同じにしておく必要があります)。

    C2Wの設定

    restart Callbridge component and apply all configuration
    callbridge restart (go to CLI)

    4.ファイアウォール機能を有効にし、パブリック22ポート(ssh)を無効にします。

    firewall a default allow ( a is the external/public network interface)
    firewall a deny 22
    firewall a enable

    確認

    1.すべてのサービスがCMSコアおよびエッジで実行されていることを確認します。

    CMSコアサービスのステータス：

    CMS> webadmin Enabled : true TLS listening interface : a TLS listening port : 443 Key file : core.key Certificate file : cmscore-fullchain.cer HTTP redirect : Disabled STATUS : webadmin running CMS> callbridge Listening interfaces : a Preferred interface : none Key file : core.key Certificate file : cmscore-fullchain.cer Address : none C2W trusted certs : cmsedge-fullchain.cer Callbridge cluster trusted certs : none Callbridge trust branding certs : none UCM trusted certs : none UCM verification mode : disabled IMPS trusted certs : none IMPS verification mode : disabled WC3 JWT Expiry in hours : 24

    CMSエッジサービスのステータス：

    CMS> webbridge3 Enabled : true HTTPS listening ports and interfaces : a:445 b:445 HTTPS Key file : edge.key HTTPS Full chain certificate file : cmsedge-fullchain.cer HTTPS Frame-Ancestors : none HTTP redirect : Disabled C2W listening ports and interfaces : a:6000 C2W Key file : edge.key C2W Full chain certificate file : cmsedge-fullchain.cer C2W Trust bundle : cmscore-fullchain.cer Meetingapps address : none Meetingapps port : none Audio priority flag : Enabled Beta options : none CMS> turn Enabled : true Username : admin Password : Cisco.123 Short term credentials : disabled Shared secret : none Realm : cms.demo Public IP : none High Capacity Mode : enabled Relay address : 10.124.144.80 TLS port : 447 TLS cert : cmsedge-fullchain.cer TLS key : edge.key TLS bundle : none Listen interface a Listen interface b

    2. webrtcログインステータスを確認し、会議に参加します。

    WebrtcアプリケーションログインWebページ

    Webrtcアプリケーション参加者がコールに参加

    トラブルシュート

    1. CMS Edge:webrtc参加者「Thomas」がコールに参加していることがわかります。参加者ID:fcfe42f4-ac94-4ab2-a14a-f4165ec960a7。

    この参加者IDは、CMS Coreログファイルに記載されています。

    Feb 23 09:02:21.588 local0.info CMS client_backend: INFO : WebApp Audit : Session: a77d94b1-ba12-4e4e-8f3e-86b3e9c1de8f : Participant Thomas performed action of join call
    Feb 23 09:02:21.599 local7.info CMS 3b8086e0e5a0 wb3_frontend: [Join call:fcfe42f4-ac94-4ab2-a14a-f4165ec960a7] 10.140.248.52 - - [23/Feb/2024:09:02:21 +0000] status 200 "POST /api/join HTTP/1.1" bytes_sent 1003 http_referer "https://edge.cms.demo:445/" http_user_agent "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:122.0) Gecko/20100101 Firefox/122.0" toupstream 192.0.2.2:9000: upstream_response_time 0.008 request_time 0.007 msec 1708678941.598 upstream_response_length 1027 200
    Feb 23 09:02:21.633 user.info CMS client_backend: INFO : WebSocket : Got authenticated JWT for guest1573064743 callbridge 320d02c3-7af5-4e4f-b51c-9a7a4dc0b8b9 call 04704220-95a8-4d36-a6ec-3d4d789d9250 participant fcfe42f4-ac94-4ab2-a14a-f4165ec960a7 tracing 0

    Webrtc参加者がコールを終了します。

    Feb 23 09:02:37.982 local0.info CMS client_backend: INFO : WebApp Audit : Session: a77d94b1-ba12-4e4e-8f3e-86b3e9c1de8f : Participant Thomas(fcfe42f4-ac94-4ab2-a14a-f4165ec960a7) performed action of leave call

    2. CMS Core：紫色の回線は会議IDで、他の参加者がこの会議に参加するときに同じ会議IDが使用されます。青い行は特定のユーザIDguest1573064743です。

    Feb 23 09:02:21.594 user.info CMS host:server: INFO : guest login request 1450660605: resolution in progress
    Feb 23 09:02:21.594 user.info CMS host:server: INFO : guest login request 1450660605: call ID lookup scheduled
    Feb 23 09:02:21.594 user.info CMS host:server: INFO : guest login request 1450660605: resolution in progress
    Feb 23 09:02:21.597 user.info CMS host:server: INFO : guest login request 1450660605: credential storage scheduled (queue length: 1)
    Feb 23 09:02:21.597 user.info CMS host:server: INFO : created guest account with user ID "guest1573064743"
    Feb 23 09:02:21.597 user.info CMS host:server: INFO : guest login request 1450660605: credential storage executed
    Feb 23 09:02:21.597 user.info CMS host:server: INFO : guest login request 1450660605: credential storage in progress
    Feb 23 09:02:21.598 user.info CMS host:server: INFO : guest login request 1450660605: successfully stored credentials
    Feb 23 09:02:21.598 user.info CMS host:server: INFO : instantiating user "guest1573064743"
    Feb 23 09:02:21.598 user.info CMS host:server: INFO : conference db0fafc3-ad47-43bd-bcbd-47886416451b: locked due to lack of lock consensus
    Feb 23 09:02:21.598 user.info CMS host:server: INFO : conference db0fafc3-ad47-43bd-bcbd-47886416451b: lock state has changed to locked
    Feb 23 09:02:21.598 user.info CMS host:server: INFO : API "9999" Space GUID: 58ef98d1-5181-4e63-a386-4b60597be7e4 <--> Call Correlator GUID: 5d031ae1-1c94-44ec-afd4-fa0e76230e3f<--> Internal GUID: db0fafc3-ad47-43bd-bcbd-47886416451b
    Feb 23 09:02:21.598 user.info CMS host:server: INFO : unable to apply logo (space '9999') -- no license
    Feb 23 09:02:21.599 user.info CMS host:server: INFO : conference db0fafc3-ad47-43bd-bcbd-47886416451b: lock state has changed to unlocked
    Feb 23 09:02:21.599 user.info CMS host:server: INFO : API call leg fcfe42f4-ac94-4ab2-a14a-f4165ec960a7 in call db0fafc3-ad47-43bd-bcbd-47886416451b (API call 04704220-95a8-4d36-a6ec-3d4d789d9250)
    Feb 23 09:02:21.599 user.info CMS host:server: INFO : conference db0fafc3-ad47-43bd-bcbd-47886416451b has control/media GUID: bf286660-6e5d-403f-8926-514d385dad3c
    Feb 23 09:02:21.599 user.info CMS host:server: INFO : conference db0fafc3-ad47-43bd-bcbd-47886416451b named "9999"
    Feb 23 09:02:21.601 user.info CMS host:server: INFO : new session created for user "guest1573064743"
    Feb 23 09:02:21.603 local0.info CMS postgres[54639]: [6-1] 2024-02-23 09:02:21.603 UTC [54639] LOG: could not send data to client: Broken pipe
    Feb 23 09:02:21.603 local0.err CMS postgres[54639]: [7-1] 2024-02-23 09:02:21.603 UTC [54639] FATAL: connection to client lost
    Feb 23 09:02:21.768 user.info CMS host:server: INFO : call 11: allocated for guest1573064743 / "Thomas" conference participation (Firefox)
    Feb 23 09:02:21.768 user.info CMS host:server: INFO : call 11: configured - API call leg fcfe42f4-ac94-4ab2-a14a-f4165ec960a7
    Feb 23 09:02:21.768 user.info CMS host:server: INFO : call 11: ActiveControlState change, unknown -> unknown
    Feb 23 09:02:21.769 user.info CMS host:server: INFO : call 11: setting up combined RTP session for DTLS (combined media and control)
    Feb 23 09:02:21.770 user.info CMS host:server: INFO : call 11: ActiveControlState change, unknown -> inactive
    Feb 23 09:02:21.770 user.info CMS host:server: INFO : call 11: ActiveControlState finality change (inactive, final=1)
    Feb 23 09:02:21.770 local0.info CMS host:server: INFO : participant "guest1573064743" joined space 58ef98d1-5181-4e63-a386-4b60597be7e4 (9999)
    Feb 23 09:02:21.770 user.info CMS host:server: INFO : participant "guest1573064743" (fcfe42f4-ac94-4ab2-a14a-f4165ec960a7) joined conference db0fafc3-ad47-43bd-bcbd-47886416451bvia WB3
    Feb 23 09:02:21.772 user.info CMS host:server: INFO : call 11: starting DTLS combined media negotiation (as initiator)

    Webrtcユーザがコールを終了：guest1573064743 Space ID：を終了58ef98d1-5181-4e63-a386-4b60597be7e4 (9999)。

    Feb 23 09:02:37.943 user.info CMS host:server: INFO : user "guest1573064743": deactivating due to session resource teardown
    Feb 23 09:02:37.943 user.info CMS host:server: INFO : call 11: tearing down ("guest1573064743" conference media)
    Feb 23 09:02:37.943 user.info CMS host:server: INFO : call 11: destroying API call leg fcfe42f4-ac94-4ab2-a14a-f4165ec960a7
    Feb 23 09:02:37.943 local0.info CMS host:server: INFO : participant "guest1573064743" left space 58ef98d1-5181-4e63-a386-4b60597be7e4 (9999)
    Feb 23 09:02:37.943 user.info CMS host:server: INFO : removing guest account 'guest1573064743' (name 'Thomas') on call drop
    Feb 23 09:02:37.943 user.info CMS host:server: INFO : destroying guest account with user ID "guest1573064743"
    Feb 23 09:02:37.944 user.info CMS host:server: INFO : conference bf286660-6e5d-403f-8926-514d385dad3c destroyed

    関連情報

    更新履歴

    改定 発行日 コメント
    1.0
    22-Mar-2024
    初版
    TAC Authored

    シスコ エンジニア提供

    • トマスドン
      Cisco TACエンジニア
    • フォスター・ソング
      Cisco TACエンジニア

    このドキュメントは役に立ちましたか?

    Feedbackフィードバック

    シスコに問い合わせ

    このドキュメントは次の製品に対応しています