Cisco Meeting Server(CMS)バージョン3 Next Generation StreamerおよびUploaderの設定

はじめに

このドキュメントでは、Cisco Meeting Server(CMS)とNext Generation Streamer and Uploaderの統合を設定およびトラブルシューティングする手順について説明します。次世代ストリーマは、CMSバージョン3.0から導入された、Session Initiation Protocol(SIP)ベースの機能です。

前提条件

要件

次の項目に関する知識があることが推奨されます。

• CMS Callbridge(s)バージョン3.0以降、および録音/ストリーミングライセンス （1つの録音ライセンスで1つのストリーミングコールが可能）
• Vbrick Distributed Media Engine(DME)（CMSストリーミングサービスからのライブストリームの公開に使用）
• Vbrick Rev（オプション：ライブストリーミングを内部ネットワークまたはマルチキャストの外部で共有する必要がある場合にのみ必要）
• ネットワークファイルシステム(NFS)ディレクトリが必要です。Windows ServerまたはLinuxでセットアップできます。
• Windowsサーバの場合は、次の手順に従ってWindowsにネットワークファイルシステム(NFS)を展開します
• Linuxの場合は、Deploy Network File systemon Linuxの手順に従います。 

使用するコンポーネント

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

• 「レコーダー」ライセンスおよび「ストリーマ」ライセンスの両方またはいずれかがある CMS 3.2 以降。 （レコーダーライセンスでもストリーミングが可能）
• VBrick Distributed Media Engine(DME)3.15.0 Rhel7
• Vbrick Rev(UploaderはvBrick Revサーバで使用されます。録画の手動インポートは不要)
• NFSを使用するWindows Server 2012 R2

背景説明

CMSバージョン2.1以降では、標準のReal-Time Messaging Protocol(RTMP)を使用するCMSストリーマによるライブストリーミングがサポートされるようになりました。 CMS 3.0では、SIPベースのコンポーネントである次世代ストリーマが導入されました。3.0より前のバージョンでは、Extensible Messaging and Presence Protocol(XMPP)が使用されていました。CMSバージョン3.1以降はRTMPSプロトコルをサポートしているため、CMSストリーマコンポーネントと外部サーバ間の通信を暗号化できます。これにより、CMSストリーマをRTMP(S)をサポートする任意のストリーミングプラットフォーム（Youtube、Facebook、Wowzaなど）と統合できます。 現在、CMS Streamerは外部ストリーミングサーバとしてVbrick DMEを使用してテストされており、統合に推奨されるプラットフォームです。

ライブストリーミング（Webキャスト）とVBrick DMEの統合により、ユーザはネットワーク内のどこにいても、異なるデバイスからライブストリーミングされたCMS会議を視聴できます。また、VBrick RevをVBrick DMEとともに使用すると、この機能が拡張され、すべてのVBrick Rev認定ユーザを内部ネットワークの外部から表示できるようになります。また、CMS Uploaderコンポーネントにより、会議サーバに接続された設定済みNFSからビデオコンテンツマネージャVbrickに会議サーバの録画をアップロードするワークフローが簡素化されます。録画の手動インポートは不要です。Uploaderコンポーネントを構成して有効にすると、記録はNFSからVbrickにプッシュされます。 

ストリーマ

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。ここで使用するすべてのデバイスは、初期（デフォルト）設定の状態から起動しています。対象のネットワークが実稼働中である場合には、どのようなコマンドについても、その潜在的な影響について確実に理解しておく必要があります。

アップローダ 

Uploaderコンポーネントは、Recorderコンポーネントと同じサーバにインストールすることも、別のサーバにインストールすることもできます。レコーダと同じサーバにインストールされている場合は、使用するvCPUをいくつか追加します。別のサーバ上で実行する場合は、レコーダと同じサーバ仕様、つまり最低4つの物理コアと4 GBのRAMを持つ専用VMを使用します。

アップローダを実行しているMeeting Serverには、ネットワークファイル共有(NFS)の読み取りおよび書き込み権限が必要です。 Uploaderは、会議をホストするCall Bridgeではなく、別のMeeting Serverで実行する必要があります。

設定

ネットワーク図

複数のストリーミングサーバを持つ単一のコールブリッジ、単一のストリーミングサーバを持つコールブリッジクラスタ、複数のストリーミングサーバを持つコールブリッジクラスタなど、CMSでストリーマとアップローダを展開するためにサポートされているいくつかのシナリオがあります。このドキュメントは、このシナリオのすべての設定手順が他のシナリオにも適用されるため、単一のストリーマ、アップロードサーバに接続するコールブリッジのクラスタを使用した基本的な導入に基づいています。

上の図に示すように、

CMS CallBridgeクラスタ 

CMSストリーマ/レコーダ

CMSアップローダ

ストリーミング用VBrick DME

ストリーミング用のVBrick Rev

コンフィギュレーション

ストリーマ 

コールブリッジがすでに設定され、コールを受け入れていることを前提としています。 

ステップ 1：証明書

新しいストリーマコンポーネントはHTTPS接続をリッスンする必要はありませんが、SIP接続（ストリーミングデータを含む）をリッスンするため、ストリーマサーバにはTLS通信に対する有効な証明書が必要です。 

streamer> pki csr tac CN:.*.tptac9.com subjectAltName:streamer.tptac9.com
..............
......
Created key file tac.key and CSR tac.csr
CSR file tac.csr ready for download via SFTP

ローカル認証局(CA)から署名された証明書を取得します。 Secure File Transfer Protocol(SFTP)を使用して生成した証明書をストリーマサーバにアップロードします。証明書が正常にアップロードされたことを確認。

このドキュメントでは、ストリーマにワイルドカード証明書を使用します。証明書ガイドを参照してください。

https://www.cisco.com/c/dam/en/us/td/docs/conferencing/ciscoMeetingServer/Deployment_Guide/Version-3-1/Certificate-Guidelines-for-all-Deployments-3-1.pdf

streamer> pki list
User supplied certificates and keys:
tac.key
tac.cer
ROOTCA.cer
example.key
example.csr
tac.csr

ステップ 2： MMP/SSHの設定

• MMPコマンドを使用して、ストリーマのリスニングインターフェイスと、リッスンするSIP TCPおよびTLSポートを設定します

       streamer sip listen <インターフェイス> <tcp-port|none> <tls-port|none>

       streamer> streamer sip listen a 7000 7001（ストリーミングフィルタ） 

       TLS SIP接続のみを使用します。TCP sip接続を「none」に設定します。コマンドは次のとおりです。

       streamer> streamer sip listen a none 7001

• ストリーマサーバへの証明書の適用 
     streamer> streamer sip certs tac.key tac.cer（ストリーマ> sip証明書tac.key tac.cer） 

• ストリーミングの品質を選択します

       streamer> streamer sip resolution 720p（ストリーマ> sipストリーマ解像度720p）  

• ストリーマの有効化

       streamer> streamer enable（ストリーマ>ストリーマの有効化） 

• オプションで、TLSが設定されている場合、ストリーマでSIPのTLS検証を実行できます

       streamer> tls sip trust ROOTCA.cer（ストリーマ> tls sip trust ROOTCA.cer）

注:TLS接続のセキュリティを確保するために、TLS検証を有効にすることを推奨します。
streamer> tls sip verify enable（ストリーマ> tls sip verify enable） 

• 上記で入力した設定情報が正しいことを確認します 

streamer> streamer
Enabled                 : false
SIP interfaces          : tcp a:7000, tls a:7001
SIP key file            : tac.key
SIP certificate file    : tac.cer
SIP CA Bundle file      : none
SIP Resolution          : 720p
SIP traffic trace       : Disabled
Call Limit              : none

• コマンド「streamer enable」を使用して、ストリーマを有効にします。 すべてのメッセージは次のように「SUCCESS」と表示される必要があります。

streamer> streamer enable
SUCCESS: Key and certificate pair match
SUCCESS: Streamer enabled

ステップ 3： APIの設定

この設定は、CallBridgeをホストするCMSで実行されます。次に、CMSのWebadminインターフェイス上のAPIを示します。Postman、PosterなどのRESTクライアントを使用して、これを実行することもできます。
新しいSIPストリーマを有効にすると、その設定を行い、sipStreamerUriの/callProfilesの下のCall Bridgeで使用できます。

CMSサーバでAPIを使用する。Webadmin > Configuration > APIの順に選択します。

• コールプロファイルの作成

• sipStreamuri=demo@streamer.com & StreamingMode=Automatic/Manualの設定

The user part of the configured "sipStreamuri" (i.e. the part before '@' symbol) has no significant meaning, and for the new SIP streamer component, although required, it can usually be anything, e.g. "streamer@streamer.com".The important part of the URI is the "domain" part.

sipStreamuri=demo@streamer.com & StreamingMode=Automatic/Manualの設定

• 作成したストリーマcallProfileを/system/profilesに追加します。これはグローバル設定であり、設定された「sipStreamerUri」がストリーマ動作に使用されます。

システム/プロファイルへのcallProfileの追加

• ストリーミングに使用するスペースにVBrick「streamURL」を追加します。 参考までに、CMS Webインターフェイスを使用して「Stream」というスペースを作成しました

ストリーミングに使用される領域

• スペースを変更して「StreamURL」を追加します。rtmp://<VBrickBroadcastUsername>:<VBrickBroadcastPassword>@<VBrick IPまたはFQDN>/live/NameoftheStream形式の「streamURL」。例では、「rtmp://broadcast:broadcast@10.106.81.40/live/SpaceStream77」と設定しました。

ステップ 4： 「アウトバウンドルール」の作成

outboundDialPlanルールにマッピングするカスタムURI（ドメインは「streamer.com」など）を設定します。 StreamerUriでルーティングに使用されるドメインと一致するように、outboundDialPlanルールを設定してください。

送信ルールの作成

上記の図に示すように、SIPストリーマでは、SIPのデフォルトポート(5060、5061)が使用されない場合、必ずストリーマの設定でポートを指定し、outboundDialPlanRuleがサービスに設定されているときに「使用するsipプロキシ」フィールドに接続するために、次のポート番号を含める必要があります。

streamer> streamer
Enabled                 : true
SIP interfaces          : tcp a:7000, tls a:7001
SIP key file            : tac.key
SIP certificate file    : tac.cer
SIP CA Bundle file      : none
SIP Resolution          : 720p
SIP traffic trace       : Disabled
Call Limit              : none

アップローダ

• アップローダが監視する記録が保存されるNFSおよびディレクトリを指定します

    streamer> uploader nfs 192.168.15.38：録音

• アップローダがレコーディング情報を照会するMeeting Serverを指定します

    streamer> uploader cms host join.mextp.localを設定します。

    

• Call Bridgeを実行しているMeeting ServerのWeb Adminポートを指定します

    streamer> uploader cmsポート445

    

• Call Bridgeを実行しているMeeting Server上でAPIアクセスを行うユーザを指定します

    streamer> uploader cmsユーザapiadmin
    streamer> uploader cmsパスワード
    パスワードを入力してください：

   

• CMSからMeeting Server信頼ストアに証明書バンドルを追加します。 
   Call Bridgeを実行するMeeting Server上のWeb Admin用に、ルートCAの証明書とすべての中間証明書のコピーを保持する証明書バンドル(crt-bundle)をチェーン内に作成します。
   streamer> uploader cms trust ROOTCA.cer（ストリーミングファイルのアップロード）
  
  
• Vbrickホストと、アップローダが接続するポートを設定します
   streamer> uploader rev host ciscotac.rev-na.demo.vbrick.com
   streamer> uploader rev port 443 

注：特に指定がない限り、ポートはデフォルトの443です​

• ビデオ録画をアップロードするAPI権限を持つVbrick Revユーザを追加します。
  streamer> uploader rev user tacuser
  streamer> uploader rev password
  パスワードを入力してください：
• 証明書バンドルをVbrick Rev信頼ストアに追加します。

      ルートCAの証明書のコピーと、Vbrick Revサーバのチェーン内のすべての中間証明書を保持する証明書バンドル(crt-bundle)を作成します
      streamer> uploader rev trust vbrickbundle.cer（ストリーミングフィルタ> rev trust vbrickbundle.cer）

• アップローダーの構成を確認し、アップローダーを有効にする
  
  

streamer> uploader
Enabled                          : false
NFS hostname                     : 192.168.15.38
NFS directory                    : Recording
CMS host                         : join.mextp.local
CMS port                         : 445
CMS user                         : apiadmin
CMS trust bundle                 : ROOTCA.cer
Vbrick Rev hostname              : ciscotac.rev-na.demo.vbrick.com
Vbrick Rev port                  : 443
Vbrick Rev username              : tacuser
Vbrick Rev trust bundle          : brick.cer
View access                      : Public
cospace_member_access            : edit
recording_owned_by_cospace_owner : false
fallback_owner                   : admin
comments_enabled                 : true
ratings_enabled                  : true
downloads_enabled                : true
active_upon_upload               : true
delete_after_upload              : false

 設定が正しければ、「uploader enable」コマンドを使用してUploaderコンポーネントを有効にします。すべてのメッセージは、次に示すように「SUCCESS」と表示される必要があります。

streamer> uploader enable
SUCCESS: uploader enabled

確認

 ストリーマ

ストリーミングが機能しており、SIPストリーミングコールが接続されている

アップローダ 

 Uploaderのsyslog followで、成功したイベントのログを確認できます。

Jun 17 22:24:41.867 user.info cms-02 Uploader[1]: scanning directory: /mnt/recordings/forwardedCalls
Jun 17 22:24:41.867 user.info cms-02 Uploader[1]: scanning directory: /mnt/recordings/spaces
Jun 17 22:24:41.869 user.info cms-02 Uploader[1]: checking the status of /mnt/recordings/spaces/8a7076e2-6db6-47e9-98ee-3bd063e32559/20210618032309+0000_vid-id=c4605aaf-dc49-4cd7-9174-c46185ba1983@vbrick.mp4
Jun 17 22:24:41.870 user.info cms-02 Uploader[1]: Getting from: https://ciscotac.rev-na.demo.vbrick.com:443/api/v1/videos/c4605aaf-dc49-4cd7-9174-c46185ba1983/status
Jun 17 22:24:42.035 user.info cms-02 Uploader[1]: Received vbrick response status code: 200
Jun 17 22:24:42.035 user.info cms-02 Uploader[1]: vbrick response: main.vbrickStatusResp{Status:"Ready"}
Jun 17 22:24:42.035 user.info cms-02 Uploader[1]: file 20210618032309+0000_vid-id=c4605aaf-dc49-4cd7-9174-c46185ba1983@vbrick.mp4 vid c4605aaf-dc49-4cd7-9174-c46185ba1983 status Ready
Jun 17 22:24:42.035 user.info cms-02 Uploader[1]: Getting from: https://ciscotac.rev-na.demo.vbrick.com:443/api/v1/videos/c4605aaf-dc49-4cd7-9174-c46185ba1983/playback-url
Jun 17 22:24:42.200 user.info cms-02 Uploader[1]: Received vbrick response 200

トラブルシューティング

ストリーマ 

1. ライセンスなし

ストリーマは、callbridgeコンポーネントを含むサーバ上で「レコーダ」ライセンスを必要とした。ライセンスがない場合、またはライセンスが不足している場合は、次のエラーがイベントログに表示されます。

必要なライセンスを追加してください。ライセンスのステータスは、CLIで「license」コマンドを使用して確認できます。

cms1> license
Feature: callbridge status: Activated expiry: 2023-Apr-28 (690 days remain)
Feature: turn status: Activated expiry: 2023-Apr-28 (690 days remain)
Feature: webbridge status: Activated expiry: 2023-Apr-28 (690 days remain)
Feature: customizations status: Activated expiry: 2023-Apr-28 (690 days remain)
Feature: local_license_mode status: Activated expiry: 2023-Apr-28 (690 days remain)
Feature: recording status: Activated expiry: 2023-Apr-28 (690 days remain)
Feature: personal status: Activated expiry: 2023-Apr-28 (690 days remain)
Feature: shared status: Activated expiry: 2023-Apr-28 (690 days remain)

2.TLSポート 

・ TLSポートが設定されていて、証明書が適用されていない場合。ストリーマでTLSを使用するための証明書の設定

・ 証明書が使用できない場合。TCPポートのみを設定する

streamer> streamer sip listen a 7000 7001
streamer> streamer enable
FAILURE: TLS port set but no certificates configured
FAILURE: Streamer configuration not complete

これで、TLSポートを削除するか、SIP TLS信頼およびストリーマ証明書を追加するかという2つのオプションが表示されます

シスコでは、TLSポートを有効にすることを推奨しています。

3. RTMPストリームが正しく設定されていない

ログにエラーが表示されます

daemon.info streamer streamer-sip[2280]:  144500.368 : INFO    : call 3: retrieved stream URL from RTCP: "rtmp://broadcast:broadcast@10.106.81.40/test"
daemon.info streamer streamer-sip[2280]:  144500.368 : INFO    : call 3: parsing rtmp://broadcast:broadcast@10.106.81.40/test
daemon.info streamer streamer-sip[2280]:  144500.368 : INFO    : call 3: RTMP stream="test"
daemon.info streamer streamer-sip[2280]:  144500.368 : INFO    : call 3: RTMP server="rtmp://10.106.81.40:1935/test"
daemon.info streamer streamer-sip[2280]:  144500.370 : INFO    : call 3: Connected to RTMP server
daemon.info streamer streamer-sip[2280]:  144500.370 : INFO    : call 3: C2 pending - len 1536
daemon.info streamer streamer-sip[2280]:  144500.370 :         : call 3: snd: create new chunk stream 2
daemon.info streamer streamer-sip[2280]:  144500.370 :         : call 3: snd: create new chunk stream 3
daemon.info streamer streamer-sip[2280]:  144500.370 : INFO    : call 3: RTMP sent chunk size of 4096 and connect message
daemon.info streamer streamer-sip[2280]:  144500.410 : ERROR   : call 3: connection : far end closed connection 5

ストリーマ設定の手順を確認し、「rtmp://<VBrickBroadcastUsername>:<VBrickBroadcastPassword>@<VBrick IPまたはFQDN>/live/NameoftheStream」の形式でRTMP URLを正しく設定してください。

4. コールルーティングに関する問題

CMSストリーマはSIPベースのクライアントであり、前述のようにルーティングが必要です。これにより、コールが失敗する可能性のあるシナリオが発生する可能性があります。たとえば、CMSコールブリッジが発信コールを送信したが、失敗して次の「transaction timeout - no provision responses sending INVITE」エラーが発生した場合を考えます 

2021-06-28  17:37:02.412  Info     user 'guest300535034' starting streaming (space 'test')
2021-06-28  17:37:02.413  Info     API call leg bc0917df-589c-4628-887d-79481d322fed in call 63f0b174-831e-4a12-b4ee-27186d4162af (API call 00286960-9af9-4d5d-9ca7-20dd40425292)
2021-06-28  17:37:02.413  Info     call 44: outgoing SIP call to "demo@streamer.com" from space "test"
2021-06-28  17:37:02.413  Info     call 44: configured - API call leg bc0917df-589c-4628-887d-79481d322fed with SIP call ID "7d37a80e-7996-4e8d-aa87-77c9d4729cec"
2021-06-28  17:37:04.482  Info     call 42: receiver report 1 interval for rx video 0 = 6113ms (period 6108ms) 00000000
2021-06-28  17:37:22.074  Info     call 44: falling back to unencrypted control connection...
2021-06-28  17:37:54.075  Info     call 44: ending; local SIP teardown with reason 7 (transaction timeout - no provisional responses sending INVITE) - not connected after 0:52
2021-06-28  17:37:54.075  Info     call 44: destroying API call leg bc0917df-589c-4628-887d-79481d322fed
2021-06-28  17:37:54.076  Info     streaming call leg for space 'test' disconnected with reason 7 (transaction timeout - no provisional responses sending INVITE)

CMSコールブリッジサーバの発信コールの設定を確認して、送信先の場所と、正しく設定されているかどうかを検証します。また、コールプロファイルに正しいストリーマURIが設定されていて、それがCospaceに関連付けられていることも確認します。

アップローダ

1. Vbrickの詳細が正しくありません。  

Uploaderログでエラーを確認できます 

Jun 27 11:29:27.864 user.info streamer Uploader[1]: Received vbrick response 500
Jun 27 11:29:27.864 user.info streamer Uploader[1]: posting to: https://sales.vbrick.com:443/api/v1/user/login
Jun 27 11:29:47.870 user.info streamer Uploader[1]: Received vbrick response 500
Jun 27 11:29:47.870 user.err streamer Uploader[1]: Failed to initialise Vbrick Client
Jun 27 11:29:47.870 user.err streamer Uploader[1]: vbrick returned status code: 500

vbrickサーバの正しいクレデンシャルとポートが設定されていることを確認します。  また、UploaderがCMSコールブリッジのwebadminポートに到達できることを確認します。