Cisco Meeting Server (CMS) versie 3 Streamer en Uploader van de volgende generatie configureren

Inleiding

Dit document beschrijft de stappen om Cisco Meeting Server (CMS) te configureren en problemen op te lossen met Next Generation Streamer en Uploader. De Next Generation Streamer is geïntroduceerd in CMS versie 3.0 en is op Session Initiation Protocol (SIP) gebaseerd.

Voorwaarden

Vereisten

Cisco raadt kennis van de volgende onderwerpen aan:

• CMS Callbridge(s) versie 3.0 of hoger met opname-/streaminglicentie(s). (één opnamelicentie maakt één streaming gesprek mogelijk)
• Vbrick Distributed Media Engine (DME) (gebruikt voor het publiceren van de live stream van CMS Streaming-service)
• Vbrick Rev (optioneel: alleen vereist als Live Streaming moet worden gedeeld buiten een intern netwerk of multicast
• De map Network File System (NFS) is nodig en kan worden ingesteld op Windows Server of Linux.
• Volg voor Windows-server de stappen om Network File System (NFS) op Windows te implementeren
• Voor Linux, volg de stappen om Network File systemon Linux te implementeren 

Gebruikte componenten

De informatie in dit document is gebaseerd op de volgende software- en hardware-versies:

• CMS 3.2 en hoger met 'Recorder' en/of 'Streamer'-licentie(s). (met de recorder-licentie kunt u ook streamen)
• VBrick gedistribueerde media engine (DME) 3.15.0 Rel7
• Vbrick Rev (Uploader) wordt gebruikt met vBrick Rev-server. Handmatige invoer van opnamen is niet vereist.)
• Windows Server 2012 R2 met NFS

Achtergrondinformatie

CMS versie 2.1 en later geïntroduceerd ondersteuning voor live streaming met de CMS streamer met behulp van standaard Real-Time Messaging Protocol (RTMP). In CMS 3.0 werd de Next Generation Streamer geïntroduceerd, die een op SIP gebaseerde component is. Eerdere versie dan 3.0 gebruikte Extensible Messaging and Presence Protocol (XMPP) . CMS versie 3.1 en hoger ondersteunen het RTMPS-protocol en dus kan de communicatie tussen de CMS streamer component en de externe server worden versleuteld. Hierdoor kan de CMS streamer integreren met elk streaming platform dat RTMP(S) ondersteunt (Youtube, Facebook, Wowza, enzovoort). Momenteel is de CMS Streamer getest met Vbrick DME als externe streamingserver en is het aanbevolen platform voor integratie.

Dankzij de integratie van Live Streaming (Webcast) met VBrick DME kunnen gebruikers elke live gestreamed CMS-conferentie vanuit verschillende apparaten overal in het netwerk bekijken. Bovendien, wanneer VBrick Rev wordt gebruikt langs VBrick DME, breidt deze mogelijkheid voor het bekijken van buiten het interne netwerk voor elke VBrick Rev gemachtigde gebruiker uit.Ook, CMS Uploader component vereenvoudigt de werkstroom voor het uploaden van Meeting Server opnamen naar de video content manager, Vbrick, van een geconfigureerde NFS aangesloten op een Meeting Server. Handmatige invoer van opnames is niet vereist. Als de Uploader-component eenmaal is geconfigureerd en ingeschakeld, worden de opnames van de NFS naar Vbrick geduwd. 

Streamer

De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die hier worden gebruikt, zijn gestart met gewist (standaard) configuraties. Als uw netwerk live is, moet u de potentiële impact van elke opdracht begrijpen.

Uploader 

De Uploader-component kan op dezelfde server als de Recorder-component of op een afzonderlijke server worden geïnstalleerd. Indien geïnstalleerd op dezelfde server als de recorder, voeg dan een aantal vCPU’s toe voor het gebruik. Als u op een andere server draait, gebruikt u dezelfde serverspecificatie als voor de recorder: speciale VM met minimaal 4 fysieke kernen en 4 GB RAM.

De vergaderserver die de Uploader uitvoert, heeft lees- en schrijftoegang nodig voor het delen van netwerkbestanden (NFS). Uploader moet op een andere vergaderserver draaien en niet op Call Bridge die de conferenties host.

Configureren

Netwerkdiagram

Er zijn verschillende scenario's die worden ondersteund om Streamer en Uploader te implementeren met CMS, zoals: één callbridge met meerdere streaming servers, een callbridge-cluster met één streamingserver en een callbridge-cluster met meerdere streaming servers. Dit document is gebaseerd op een basisimplementatie met een cluster van callbridge die verbinding maakt met één enkele streamer, Uploader-server, aangezien alle configuratiestappen met dit scenario ook van toepassing zijn op andere scenario's.

Zoals aangegeven in de bovenstaande afbeelding.

CMS CallBridge-cluster 

CMS-streamer/recorder

CMS-uploader

VMVrick DME voor streaming

VBrick omgekeerd voor streaming

Configuraties

Streamer 

Men veronderstelt dat callbridge reeds opstelling en het goedkeuren van vraag is. 

Stap 1. Certificaten

De nieuwe streamer componenten hoeven niet te luisteren naar https verbindingen, maar het luisteren naar SIP verbindingen, de streamer server moet een geldig certificaat hebben voor TLS communicatie. 

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

Ontvang het certificaat dat is ondertekend door een lokale certificeringsinstantie (CA). Upload het generatiecertificaat met Secure File Transfer Protocol (SFTP) naar de Streamer-server. Gecontroleerd om de geüploade certificaten te bevestigen.

In dit document worden jokerteken certificaten gebruikt voor streamer. Gebruik de certificaatgids ter referentie.

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

Stap 2. MMP/SSH-configuratie

• Configureer de luisterinterface van de streamer en de SIP TCP- en TLS-poorten om mee te luisteren met de opdracht MMP

       Streamer sip-luisteren <interface> <tcp-poort|none> <tls-poort|none>

       streamer> streamer sip luisteren een 7000 7001 

       Alleen TLS-sip-verbinding gebruiken. TCP sip verbinding configureren als "niets" de opdracht is hieronder

       streamer> streamer sip luister naar een geen 7001

• Certificaten toepassen voor de streamer server 
     wimpel> wimpel sip certs tac.key tac.cer 

• Selecteer de kwaliteit voor streaming

       Streamer> Streamer SIP-resolutie 720p  

• Streamer inschakelen

       streamer> streamer activeren 

• Als TLS is geconfigureerd, kunt u TLS-verificatie voor SIP op de streamer uitvoeren

       streamer> tls sip trust ROOTCA.cer

Opmerking: voor een veilige TLS-verbinding raden we aan TLS-verificatie in te schakelen.
streamer> TLS sip verify-actief 

• Controleer of de hierboven ingevoerde configuratie-informatie juist is 

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

• Schakel de streamer in met de opdracht: "Streamer activeren". Alle berichten moeten als volgt "SUCCES" vertonen

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

Stap 3. API-configuratie

Deze configuratie wordt uitgevoerd in de CMS-hosting CallBridge. Hieronder, API op Webadmin interface van CMS. Elke REST client zoals Postman, Poster kan ook worden gebruikt om dit uit te voeren.
Zodra de nieuwe SIP-streamer is ingeschakeld, kan deze worden geconfigureerd en gebruikt in de Call Bridge onder /callProfiles voor sipStreamerUri.

Om API op CMS server te gebruiken. Ga naar Webadmin > Configuratie > API

• Gespreksprofiel maken

• Configureer sipStreamuri=demo@streamer.com & StreamingMode= automatisch/handmatig

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.

Configureer sipStreamuri=demo@streamer.com & StreamingMode= automatisch/handmatig

• Voeg de aangelegde streamer callProfile hierboven toe aan de /system/profielen. Dit is een globale configuratie en de geconfigureerde "sipStreamerUri" wordt gebruikt voor een streamer-bediening.

CallProfile toevoegen aan systeem/profielen

• Voeg de VBrick 'streamURL' toe aan de ruimte(n) die voor streaming wordt(worden) gebruikt. Ter referentie is een ruimte met de naam 'stream' gecreëerd met behulp van de CMS-webinterface

Ruimte die wordt gebruikt voor streaming

• Wijzig de ruimte om "StreamURL" toe te voegen. De 'streamURL' in de volgende indeling:  rtmp://<VbRickBroadcastGebruikersnaam>:<VoRickBroadcastPassword>@<VoRick IP of FQDN>/live/NameoftheStream. In het voorbeeld heb ik het ingesteld op "rtmp://broadcast:broadcast@10.106.81.40/live/SpaceStream77"

Stap 4. Maak "uitgaande regels" aan

Configureren, een aangepaste URI die toewijst aan een uitgaande DialPlan regel (het domein kan alles zijn, bijvoorbeeld "streamer.com"). Gelieve te vormen een uitgaande regel DialPlan om het domein aan te passen dat in streamerUri aan route wordt gebruikt.

Uitgaande regels maken

Zoals in de bovenstaande afbeelding, voor SIP-streamer, als de standaardpoorten voor SIP (5060.5061) niet worden gebruikt, is het verplicht om poorten te specificeren in de configuratie van de streamer en het volgende poortnummer op te nemen om verbinding te maken met het veld "SIP proxy to use" wanneer outboundDialPlanRule is geconfigureerd voor de service.

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

Uploader

• Geef de NFS en map op waarin opnames worden opgeslagen die door de Uploader worden bewaakt

    streamer> uploader nfs 192.168.15.38:Opnemen

• Specificeer de Meeting Server die Uploader zal vragen voor opnameinformatie

    streamer> Uploader cms host Josef.mextp.local

    

• Specificeer de Web Admin poort op de Meeting Server waarop de Call Bridge wordt uitgevoerd

    streamer> uploader cms-poort 445

    

• Specificeer de gebruiker met API-toegang op de vergaderserver waarop de Call Bridge wordt uitgevoerd

    streamer> uploader cms gebruiker apiadmin
    streamer> uploader cms wachtwoord
    Voer het wachtwoord in:

   

• Voeg de certificaatbundel van CMS toe aan de vertrouwensopslag voor Meeting Server 
   Maak een certificaatbundel (crt-bundel) met een kopie van het Root CA-certificaat en alle tussenliggende certificaten in de keten voor de Web Admin op de vergaderserver waarop de Call Bridge wordt uitgevoerd.
   streamer> uploader cms trust ROOTCA.cer
  
  
• De Vbrick-host en de poort waarop de Uploader verbinding zal maken configureren
   streamer> Uploader rev host ciscotac.rev-na.demo.vbrick.com
   streamer> Uploader rev-poort 443 

Opmerking: de poortstandaard is 443, tenzij anders aangegeven

• Voeg een Vbrick Rev-gebruiker toe die API-toestemming heeft om video-opnamen te uploaden
  streamer> tacuser voor uploader versie
  streamer> wachtwoord voor uploader versie
  Voer het wachtwoord in:
• Voeg de certificaatbundel toe aan de Vbrick Rev trust store

      Maak een certificaatbundel (crt-bundle) met een kopie van het Root CA-certificaat en alle tussencertificaten in de keten voor de Vbrick Rev-server
      streamer> uploader rev trust vbrickbundle.cer

• Controleer de configuratie van de uploader en schakel de uploader in
  
  

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

 Als de configuratie correct is, gebruikt u de opdracht "Uploader Enable" om de Uploader-component in te schakelen. Alle berichten moeten "SUCCES" tonen zoals hieronder getoond.

streamer> uploader enable
SUCCESS: uploader enabled

Verifiëren

 Streamer

Werken via streaming en een sip streaming call connected

Uploader 

 U kunt logbestand zien voor een geslaagde gebeurtenis in syslog follow van uploader.

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

Probleemoplossing

Streamer 

1. Geen licentie

Streamer heeft een "recorder"-licentie nodig op de server met een CallBridge-component. Als dat er niet is, of als er onvoldoende licentie aanwezig is, dan zullen fouten zoals hieronder getoond worden gezien in gebeurtenislogboeken.

Zorg ervoor dat u de vereiste licentie toevoegt. De status van de licentie kan worden gecontroleerd via de opdracht "licentie"

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-poort 

· Als de TLS-poort is geconfigureerd en er geen certificaten worden toegepast. certs voor streamer configureren voor gebruik van TLS

· Indien er geen certificaat beschikbaar is. Alleen de TCP-poort configureren

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

Nu hebt u 2 opties, ofwel om de TLS-poort te verwijderen, of om SIP TLS Trust en Streamer Certificate toe te voegen

Cisco raadt aan de TLS-poort in te schakelen.

3. RTMP-stream niet correct geconfigureerd

Er wordt een fout in de logbestanden weergegeven

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

Controleer de procedure in streamer-configuratie en configureer de RTMP-URL correct in het formaat "rtmp://<VBrickBroadcastUsername>:<VBrickBroadcastPassword>@<VBrick IP of FQDN>/live/NameoftheStream"

4.Verwante problemen met gespreksrouting

Omdat de CMS-streamer een op SIP gebaseerde client is en zoals eerder besproken, moet er een routing zijn. Dit zou scenario's kunnen veroorzaken waar de vraag zou kunnen ontbreken. Neem dit voorbeeld, waar de CMS Callbridge een uitgaande oproep verstuurde, maar het faalde met de volgende 'transactie timeout - geen voorlopige antwoorden verzenden INVITE' fout 

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)

Controleer de instellingen voor uitgaande oproepen op de CMS CallBridge-servers om de locatie te valideren waarnaar wordt verzonden en indien deze correct is ingesteld. Controleer ook of het callprofiel is geconfigureerd met de juiste streamer URI en hetzelfde is gekoppeld aan Cospace.

Uploader

1. Vbrick-gegevens zijn niet correct.  

U kunt de fout in het Uploader-logbestand zien 

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

Zorg ervoor dat u de juiste aanmeldingsgegevens en poort voor de brick-server hebt ingesteld.  Zorg er ook voor dat Uploader in staat moet zijn om CMS callbridge webadmin poort te bereiken.