Configuration et dépannage de la diffusion en continu et de la vidéo à la demande TCS Live avec VBrick DME et VBrick Rev

Introduction

Ce document décrit les étapes à suivre pour configurer et dépanner l'intégration de la diffusion en continu et de la vidéo à la demande (VoD) de Cisco Telepresence Content Server (TCS) avec le serveur VBrick Distributed Media Engine (DME) et le serveur VBrick Rev. L'intégration de VBrick avec TCS a été ajoutée à partir de la version s6.2.1 et ultérieure. 

Avec la collaboration de Christian Ruiz et Cesar Coria, ingénieurs du TAC Cisco.

Conditions préalables

Conditions requises

• Cisco TCS s6.2.1 et versions ultérieures
• DME VBrick
• VBrick Rev (requis pour l'intégration VoD)

Attention : Cisco TCS s7.2 et versions ultérieures est requis pour la configuration VoD FTP sur SSL (FTPS)

Components Used

Les informations de ce document sont basées sur les versions logicielles et matérielles suivantes :

1. TCS 7.2
2. VBrick DME 3.15.0 Rhel7
3. VBrick Rev 7.14 (intégration VoD)

The information in this document was created from the devices in a specific lab environment. Tous les périphériques utilisés ici ont démarré avec des configurations effacées (par défaut). If your network is live, make sure that you understand the potential impact of any command.

Informations générales

Deux types d'intégration peuvent être configurés :

1. Diffusion en direct (Webcast) et

2. VoD 

L'intégration de la diffusion en direct avec VBrick DME permet aux utilisateurs de regarder n'importe quelle conférence TCS diffusée en direct n'importe où dans le réseau à partir de différents périphériques, en outre, lorsque VBrick Rev est utilisé le long de VBrick DME, cela étend cette fonctionnalité d'affichage depuis l'extérieur du réseau pour chaque utilisateur autorisé VBrick Rev. 

L'intégration de la VoD avec VBrick DME et VBrick Rev permet aux utilisateurs autorisés de VBrick Rev de regarder tout enregistrement envoyé créé par TCS à l'intérieur et à l'extérieur du réseau à partir de différents périphériques.

Configuration

Diagramme du réseau

Configurations

1. Intégration de la diffusion en continu (Webcast) en direct.

1a Ajoutez la configuration du serveur VBrick Live.

 Dans l'interface Web de TCS, accédez à Management > Recording setup > Media server configurations et cliquez sur le lien '+ Add VBrick Live Server Configuration' :

Complétez les champs de configuration du serveur multimédia :

Name (nom)	Nom permettant d'identifier le serveur multimédia
Adresse du serveur	IP ou FQDN de Vbrick DME
Port RTSP	Numéro de port RTSP du serveur multiprotocole configuré dans Vbrick. Le défaut est 5544.
Nom de l'utilisateur	Nom d'utilisateur de l'authentification d'entrée de flux configuré dans Vbrick. Le nom d'utilisateur par défaut est 'broadcast'
Mot de passe	Mot de passe d'authentification d'entrée de flux configuré dans Vbrick. Le mot de passe par défaut est 'broadcast'
Confirmation du mot de passe	Confirmer le mot de passe
Nom du flux statique	Le nom qui vous accompagne identifie le flux dans le réseau. Si ce n'est pas rempli, TCS ajoute un nom aléatoire pour le flux lors de sa création. Même lorsque l'interface Web suggère que cette option est facultative, il est fortement recommandé de la configurer. De même, si Vbrick Rev est utilisé avec VBrick DME, la configuration de ce champ est obligatoire.

 Si la connexion à VBrick DME réussit, vous recevrez le message de confirmation suivant : " Test RTSP réussi sur le serveur 'Votre adresse IP DME ou nom d'hôte'. Le serveur est un serveur VBrick. » :

1b Ajouter un modèle à utiliser avec VBrick Live streaming :

Dans l'interface Web de TCS, accédez à Management > Recording setup > Templates et cliquez sur le lien '+ Add template' :

Complétez et sélectionnez dans les champs de configuration du modèle VBrick Live :

Name (nom)	Nom permettant d'identifier le modèle Vbrick Live.
Choisissez la façon dont vous voulez rendre disponibles les enregistrements effectués avec ce modèle et modifiez vos options ci-dessous :	Cochez uniquement l'option Visible dans l'interface Web du serveur de contenu.
Sorties à afficher dans l'interface Web du serveur de contenu > Sorties à afficher dans l'interface Web du serveur de contenu	Sélectionnez l'un de vos choix en fonction de vos besoins en matière d'enregistrement et de diffusion.
Sorties à afficher dans l'interface Web du serveur de contenu > À la demande	Formats : Sélectionnez le format 'MPEG-4 pour Flash' (obligatoire car Vbrick ne fonctionne qu'avec lui) Facultatif pour choisir des types de format supplémentaires tant que le format 'MPEG-4 pour Flash' est sélectionné également. Tailles : Sélectionnez l'un de vos choix en fonction de vos besoins en matière d'enregistrement et de diffusion.
Sorties à afficher dans l'interface Web du serveur de contenu > Paramètres de configuration du serveur multimédia à la demande	MPEG-4 pour Flash sera automatiquement sélectionné et les formats Windows Media et MPEG-4 pour QuickTime seront grisés lorsque vous sélectionnez le format MPEG-4 pour Flash ci-dessus. La case à cocher « Optimiser pour le mouvement » est facultative.
Sorties à afficher dans l'interface Web du serveur de contenu > Flux dynamique	Activez le flux dynamique. Format : Confirmer MPEG-4 pour Flash est sélectionné. Taille : Choisissez l'un de vos choix. Retranscoder les films en temps réel : Facultatif. Configuration du serveur multimédia : Vérifiez que la configuration de votre serveur multimédia pour Vbrick Live est sélectionnée.

 Cliquez sur le bouton `Enregistrer` pour sauvegarder la configuration.

1c Ajouter un alias d'enregistrement à utiliser avec VBrick Live streaming :

Complétez et sélectionnez dans les champs de configuration d'alias d'enregistrement VBrick Live :

Alias d'enregistrement	Nom' : Nom permettant d'identifier l'alias d'enregistrement Vbrick. 'Propriétaire d'alias d'enregistrement personnel' : Sélectionnez l'utilisateur qui aura des autorisations de modification pour ces enregistrements.
Propriétés de numérotation	Selon le plan de numérotation de votre réseau vidéo. Saisissez les informations de numérotation H.323 et/ou SIP.
Paramètres d'enregistrement	Dans le modèle, sélectionnez le modèle Vbrick Live créé dans 1b. Tous les autres paramètres de cette section peuvent être laissés par défaut ou personnalisés selon vos besoins.
Informations d'enregistrement par défaut	Peut être laissé en blanc ou personnalisé selon vos besoins.
Autorisations d'enregistrement par défaut	Peut laisser les paramètres par défaut ou les personnaliser si nécessaire.

 Cliquez sur le bouton `Enregistrer` pour sauvegarder la configuration.

Si vous configurez l'intégration de diffusion en direct (Webcast) uniquement, vous avez terminé. Vous pouvez ignorer les étapes suivantes jusqu'à notre section Vérifier afin de commencer à tester cette intégration. Si vous configurez également la vidéo à la demande, suivez les étapes suivantes.

2. Intégration VBrick VoD (Video on Demand).

2a. Ajoutez la configuration du serveur VBrick VoD.

Dans l'interface Web de TCS, accédez à Management > Recording setup > Media server configurations et cliquez sur le lien '+ Add VBrick VoD server configuration':

Il existe deux options pour configurer le serveur multimédia VoD : Vous pouvez le configurer pour se connecter via FTP ou FTPS (Secure FTP utilisant SSL).

Configuration FTP.

• Pour le configurer de manière à utiliser FTP, renseignez les champs de configuration du serveur multimédia, comme ci-dessous :

Name (nom)	Nom permettant d'identifier le serveur multimédia VoD Vbrick
Adresse du serveur	IP ou FQDN de Vbrick DME
Protocole FTP (File Transfer Protocol)	Choisir FTP
Port de commande	Champ désactivé lorsque FTP est sélectionné
Nom de l'utilisateur	Utilisateur administrateur du serveur Vbrick DME. La valeur par défaut est 'admin'
Mot de passe	Mot de passe de l'utilisateur admin dans le serveur Vbrick DME. La valeur par défaut est 'admin'
Confirmation du mot de passe	Confirmez le mot de passe défini dans le champ précédent.

Avant d'enregistrer la configuration, vous pouvez utiliser le bouton 'Test FTP' pour confirmer que vous accédez au serveur et que les informations d'identification de l'administrateur sont correctes, si vous obtenez une coche verte avec le message : 'Test FTP réussi sur le serveur YourDMEServer:21' alors vous pouvez enregistrer la configuration du serveur multimédia : 

Configuration FTPS :

• Pour le configurer pour utiliser FTPS (Secure FTP using SSL), renseignez les champs de configuration du serveur multimédia comme ci-dessous, veuillez noter que cette option est disponible uniquement dans TCS s7.2 et versions ultérieures :

Name (nom)	Nom permettant d'identifier le serveur multimédia VoD Vbrick
Adresse du serveur	IP ou FQDN de Vbrick DME
Protocole FTP (File Transfer Protocol)	Choisir FTPS
Port de commande	Ceci doit correspondre au 'Port de commande FTP' configuré dans l'interface Web Vbrick DME : Configuration du système > Ports.
Nom de l'utilisateur	Utilisateur administrateur du serveur Vbrick DME. La valeur par défaut est 'admin'
Mot de passe	Mot de passe de l'utilisateur admin dans le serveur Vbrick DME. La valeur par défaut est 'admin'
Confirmation du mot de passe	Confirmez le mot de passe défini dans le champ précédent.

Avant d'enregistrer la configuration, vous pouvez utiliser le bouton 'Test FTPS' pour confirmer que vous accédez au serveur et que les informations d'identification d'administrateur sont correctes, si vous obtenez une coche verte avec le message : 'Le test FTPS a réussi pour le serveur YourDMEServer:YourCommandPortNumber', alors vous pouvez enregistrer la configuration du serveur multimédia :

Note: Pour que FTPS fonctionne sur le serveur DME VBrick, FTPS doit être activé, le port de commande configuré est différent de la valeur par défaut 21 et le certificat SSL est téléchargé.

 Activez FTPS dans VBrick DME à l'aide de l'interface Web sous Configuration système > Sécurité :

Spécifiez un port différent pour que FTPS fonctionne sous Configuration système > Ports :

Téléchargez un certificat SSL sur le serveur VBrick sous Configuration système > Certificats SSL. Pour plus d'informations sur le téléchargement et la signature de votre certificat, reportez-vous à la documentation VBrick : Guide d'administration VBrick.

2 ter. Ajouter un modèle à utiliser avec VBrick VoD :

Dans l'interface Web de TCS, accédez à Management > Recording setup > Templates et cliquez sur le lien '+ Add template' :

Complétez et sélectionnez dans les champs de configuration du modèle VBrick Live :

Name (nom)	Nom permettant d'identifier le modèle VoD Vbrick.
Choisissez la façon dont vous voulez rendre disponibles les enregistrements effectués avec ce modèle et modifiez vos options ci-dessous :	Cochez uniquement l'option Distributed to Media Experience Engine 3500, VBrick, Show and Share, Podcast Producer ou iTunes U.
Sorties pour distribution vers Media Experience Engine 3500, Show and Share, VBrick, Podcast Producer ou iTunes U	Pour les sorties, sélectionnez l'un de vos choix en fonction de vos besoins d'enregistrement et de diffusion en continu, puis activez la case à cocher Vbrick, choisissez la configuration du serveur multimédia créée pour Vbrick VoD à l'étape précédente. Sélectionnez une taille pour la diffusion en continu.

Cliquez sur le bouton `Enregistrer` pour sauvegarder la configuration.

2 quater. Ajouter un alias d'enregistrement à utiliser avec VBrick VoD :

Complétez et sélectionnez dans les champs de configuration d'alias d'enregistrement VBrick VoD :

Alias d'enregistrement	Nom' : Nom permettant d'identifier l'alias Vbrick VoD Recording. 'Propriétaire d'alias d'enregistrement personnel' : L'utilisateur sélectionné ici doit correspondre exactement à un utilisateur qui existe dans le serveur VBrick Rev.
Propriétés de numérotation	Selon le plan de numérotation de votre réseau vidéo. Saisissez les informations de numérotation H.323 et/ou SIP.
Paramètres d'enregistrement	Dans le modèle, sélectionnez le modèle VoD Vbrick créé dans 2b. Tous les autres paramètres de cette section peuvent être laissés par défaut ou personnalisés selon vos besoins.
Informations d'enregistrement par défaut	Peut être laissé en blanc ou personnalisé selon vos besoins.
Autorisations d'enregistrement par défaut	Peut laisser les paramètres par défaut ou les personnaliser si nécessaire.

Note: Si l'utilisateur choisi comme propriétaire d'alias d'enregistrement personnel ne correspond pas exactement à un utilisateur avec tous les rôles 'Media' assignés qui existent dans VBrick Rev Server, l'intégration VoD ne fonctionnera pas. Cet utilisateur sera le téléchargeur de la vidéo vers Rev et doit être reconnu par lui. 

Reportez-vous à la section Dépannage de ce document pour obtenir des informations détaillées sur la façon de : Créez un utilisateur dans TCS qui correspond à un utilisateur existant dans Rev et/ou comment créer un utilisateur dans Rev qui correspond exactement à l'utilisateur sélectionné dans TCS. 

Cliquez sur le bouton `Enregistrer` pour sauvegarder la configuration.

Si tous ces paramètres ont été configurés, passez à la section Vérifier de ce document.

Vérification

Utilisez cette section pour confirmer que votre configuration fonctionne correctement.

Diffusion en continu VBrick :Pour vérifier que cela fonctionne correctement, vérifiez les éléments suivants :

Lors de la connexion d'un appel à l'alias SIP ou H.323 de Live Streaming Recording dans TCS, l'enregistrement se déroulant dans l'interface Web de TCS dans l'onglet Afficher les enregistrements :

Dans l'interface Web du serveur DME VBrick, accédez à Monitor and Logs >Multi-Protocol Connections, si la diffusion en continu passe de TCS à DME, vous devriez voir tous les détails du flux dans cette fenêtre :

Utilisez n'importe quel lecteur de flux comme le Lecteur VLC pour capturer le flux et tester le fonctionnement audio et vidéo en utilisant les liens rtsp ou rtmp affichés dans l'interface Web VBrick Monitor and Logs >Multi-Protocol Connections.

Si l'une de ces étapes ne montre pas le comportement correct, reportez-vous à la section « Dépannage » de ce document pour voir les causes possibles et les actions à entreprendre pour les corriger.

VBrick VoD : Pour vérifier que cela fonctionne correctement, vérifiez les éléments suivants :

Une fois l'enregistrement terminé, accédez à l'interface Web de TCS et accédez à l'onglet Gestion et vérifiez que le transcodage de l'enregistrement est terminé. Ce n'est qu'une fois l'enregistrement entièrement transcodé qu'il commencera à être téléchargé sur le serveur VBrick Rev :

Une fois le travail de transcodage terminé dans TCS, accédez à l'interface Web du serveur VBrick DME et accédez à Monitor and Logs > Upload Log, si le téléchargement se déroule sans problème, des messages confirmant l'entrée vidéo et le téléchargement ont réussi sur le serveur Rev :

Après cela, accédez à l'interface Web du serveur VBrick Rev pour vérifier que votre vidéo a été téléchargée correctement et qu'elle est correctement lue, souvenez-vous que la vidéo s'affichera comme inactive jusqu'à ce qu'elle soit activée pour affichage. 

Si l'une de ces étapes n'indique pas le comportement correct, reportez-vous à la section Dépannage de ce document pour voir les causes possibles et les actions à entreprendre pour les corriger.

Dépannage

Les captures de paquets de TCS et DME vous aideront dans la plupart des problèmes liés à la communication.

TCS : Utilisez Wireshark ou un système similaire dans Windows Server où TCS est installé pour récupérer les captures de paquets.

DME : Utilisez l'interface Web dans Diagnostics > Trace Capture, appuyez sur le bouton Start capture. Appuyez sur le bouton 'Arrêter la capture' pour arrêter le suivi. Appuyez sur Télécharger le fichier de suivi pour télécharger la capture de paquets.

Vérifiez que les ports sont configurés correctement.

Les ports DME VBrick utilisés pour la diffusion en continu et FTP(S) peuvent être vérifiés et configurés dans l'interface Web du serveur DME sous Configuration système > Ports :

TCS Live Streaming vers VBrick problèmes les plus courants :

Problèmes de configuration du serveur multimédia : 

Message d'erreur : "Échec de la connexion au serveur ».

Cause : port RTSP incorrect.

Solution : Vérifiez que le port RTSP du serveur multiprotocole configuré dans Configuration système > Ports de l'interface Web VBrick DME est identique.

Message d'erreur : 'Échec de l'authentification sur l'annonce RTSP au serveur'.

Motif: nom d'utilisateur et/ou mot de passe erronés.

Solution : Vérifiez le 'Nom d'utilisateur d'authentification d'entrée de flux' dans Configuration utilisateur —> Authentification d'entrée de flux dans l'interface Web DME VBrick est identique.

Impossible de voir la diffusion à partir de TCS dans l'interface Web DME Journaux >Connexions multiprotocole :

Cause : problèmes de communication entre TCS et DME.

Solution :

Dans TCS : Vérifiez que l'enregistrement est actif dans l'onglet Enregistrements (cercle rouge indiquant qu'il est en cours d'enregistrement). Vérifiez que tous les services TCS fonctionnent correctement.

Dans DME : Vérifiez dans l'interface Web que les services RTSP et RTMP affichent True.

Si les étapes précédentes sont correctes, nous avons un problème de communication entre TCS et DME et peut-être un problème lié au réseau ou une défaillance dans un des serveurs, prenez des captures de paquets de TCS et DME pour affiner le problème, filtrer par leurs adresses IP respectives. Vérifiez que la communication est en cours. Par exemple, la capture de paquets TCS montre que TCS envoie des paquets à DME et que la capture de paquets DME ne montre aucun paquet reçu de TCS. Dans cet exemple, vous voudrez vérifier si un élément du réseau bloque ou empêche cette communication ou s'il y a une défaillance majeure du serveur DME. Si vous n'êtes pas familier avec les captures de paquets, ouvrez un dossier TAC et fournissez les deux captures de paquets afin qu'un ingénieur puisse vous aider à identifier le problème de communication entre TCS et DME.

Impossible d'attraper le flux en direct à partir d'un lecteur de diffusion en continu :

Vérifiez que le lien rtsp est affiché dans l'interface Web VBrick sous Monitor and Logs > Multi-Protocol Connections et pas seulement dans rtmp. S'il ne s'affiche pas, suivez les étapes mentionnées dans « Impossible de voir la diffusion à partir de TCS dans les journaux de l'interface Web DME > Connexions multiprotocoles ».

Si les détails et les liens de diffusion en continu de TCS Live sont affichés dans l'interface Web de VBrick DME sous Monitor and Logs > Multi-Protocol Connections, il faut examiner plus en profondeur le réseau et le serveur VBrick DME. Veuillez ouvrir un dossier avec le support de VBrick.

VoD TCS avec VBrick les problèmes les plus courants :

Problèmes de configuration du serveur multimédia :

Message d'erreur : "Échec de la connexion au serveur FTP(S)« .

Motif: Port FTP incorrect.

Solution : Vérifiez que le numéro de 'Port de commande FTP' configuré dans 'Configuration système > Ports' dans l'interface Web VBrick DME est identique.

Message d'erreur : « L'utilisateur 'votreutilisateur' n'a pas pu se connecter au serveur FTP(S)... »

Motif: Nom d'utilisateur et/ou mot de passe erronés.

Solution : Vérifiez que l'utilisateur et/ou le mot de passe de l'administrateur DME sont corrects. Si ces informations d'identification ont été perdues, contactez le support technique de VBrick.

Impossible de télécharger la VoD de TCS vers Rev Server,

Message d'erreur : « UploaderUserDoNotExist UploaderUserDoNotExist = { UserDoNotExist = Impossible de télécharger la vidéo. Assurez-vous que la vidéo est associée à un utilisateur valide... » 

04/20/17 14:21:04, .tcs_ingest/O149271454700-30674761fl.mp4, Starting Rev upload
04/20/17 14:21:05, .tcs_ingest/O149263473800-58284370fl.mp4, UploaderUserDoesNotExist UploaderUserDoesNotExist = { UserDoesNotExist = Unable to upload video. Please ensure that video is associated to a valid user., Uploader = Administrator, accountId = 30dcd82e-ae13-4aae-b0a6-fd8d0ed3b805 }
04/20/17 14:21:05, .tcs_ingest/O149263452400-34534979fl.mp4, UploaderUserDoesNotExist UploaderUserDoesNotExist = { UserDoesNotExist = Unable to upload video. Please ensure that video is associated to a valid user., Uploader = Administrator, accountId = 30dcd82e-ae13-4aae-b0a6-fd8d0ed3b805 }

Motif: L'utilisateur configuré en tant que 'propriétaire d'alias d'enregistrement personnel' dans l'alias d'enregistrement VoD VBrick dans TCS ne correspond pas à un utilisateur qui existe dans le serveur VBrick Rev.

Solution : Créez un utilisateur dans TCS qui correspond à un utilisateur avec des droits 'Media' dans le serveur Rev ou créez un utilisateur dans Rev avec des droits 'Media' qui correspondent à l'utilisateur TCS configuré en tant que 'Propriétaire d'alias d'enregistrement personnel' dans l'alias d'enregistrement pour VBrick VoD.

Comment créer un utilisateur dans l'interface Web de TCS :

Dans Configuration > Groups and users, dans la section 'Add users', notez le nom d'utilisateur dans la fenêtre 'Creator role', souvenez-vous que ce nom d'utilisateur doit correspondre au nom d'utilisateur dans le serveur Rev. Cliquez sur le bouton Ajouter en bas de la page. L'utilisateur sera créé et pourra être sélectionné dans la liste déroulante de la configuration du propriétaire d'alias d'enregistrement personnel.

Comment créer un utilisateur dans VBrick Rev :

Création d'un utilisateur dans l'interface Web du serveur Rev : Accédez à Paramètres > Utilisateurs > Utilisateurs et cliquez sur le bouton Ajouter un utilisateur. Vérifiez que le nom d'utilisateur correspond au nom d'utilisateur dans TCS (il ne respecte pas la casse). Vérifiez également que tous les rôles 'Media' sont attribués à l'utilisateur. Cliquez sur le bouton Créer un utilisateur pour créer l'utilisateur. N'oubliez pas que l'utilisateur ne sera pas actif tant qu'il n'aura pas atteint le lien d'activation après sa création.

Problèmes de lecture de la vidéo sur VBrick Rev :

Message d'erreur : « Impossible de traiter la vidéo » sur l'interface Web du serveur VBrick Rev lors de la tentative de lecture de l'enregistrement VoD TCS.

Solution : Veuillez contacter le support VBrick pour obtenir de plus amples informations sur le dépannage, car il peut s'agir des services Rev hébergés dans le cloud.