What are the streams in TCS companies

introduction

This document describes the steps to configure and troubleshoot Live Streaming and Video-on-Demand (VoD) Cisco TelePresence Content Server (TCS) with VBrick Distributed Media Engine (DME) Server and VBrick Rev Server. The VBrick integration with TCS was added from version 6.2.1.

Supported by Christian Ruiz and Cesar Coria, Cisco TAC Engineers.

requirements

conditions

  • Cisco TCS 6.2.1 and higher
  • VBrick DME
  • VBrick Rev (required for VoD integration)

Attention: Cisco TCS 7.2 and higher is required for the VoD configuration of FTP over SSL (FTPS).

Components used

The information in this document is based on the following software and hardware versions:

1. TCS 7.2
2. VBrick DME 3.15.0 Rhel7
3. VBrick Rev 7.14 (for VoD integration)

The information in this document was produced by the devices in a specific laboratory environment. All devices used here started with deleted (standard) configurations. With your network up and running, make sure you understand the potential implications of a command.

Background information

There are two types of integration that can be configured:

1. Live streaming (webcast) and

2. VoD

Live streaming integration with VBrick DME enables users to replay live streaming TCS conferences from various devices within the network. When VBrick Rev is used in conjunction with VBrick DME, this extends this capability to display from outside the network for any authorized VBrick Rev user.

VoD integration with VBrick DME and VBrick Rev allows authorized VBrick Rev users to view all submitted recordings made by TCS from various devices inside and outside the network.

Configure

Network diagram

Configurations

1. Integration of live streaming (webcast)

1a Add VBrick's live server configuration.

In the TCS web interface, go to Management> Recording Setup> Media Server Configurations and click the "+ Add VBrick Live Server Configuration" link:

Fill in the fields for the media server configuration:

SurnameName to identify the media server
Server addressIP or FQDN Vbrick DME
RTSP portRTSP port number configured in Vbrick for multi-protocol servers. The default is 5544.
User nameUsername configured in Vbrick for Stream Input Authentication. The default username is Send.
passwordStream Input Authentication Password configured in Vbrick. The default password is "Submit".
Password confirmationconfirm password
Name of the static streamThe name by which you identify the stream on the network. If this is not the case, TCS appends a random name for the stream when it is created. Although the web interface suggests this is optional, it is highly recommended that you configure it. If Vbrick Rev is used with VBrick DME, configuration of this field is mandatory.


If the connection with VBrick DME is successful, you will receive the following confirmation message: "RTSP test successful on server 'Your DME IP address or hostname'. The server is a VBrick server.":

1b add template for VBrick live streaming:

In the TCS web interface, go to Management> Recording Setup> Templates and click the '+ Add template' link:

Fill in and select the VBrick Live template configuration fields:

SurnameName to identify the Vbrick Live Template.
Choose how you'd like to capture recordings made with this template and edit the following options:Enable only the option 'Viewable in the Content Server Web Interface'.
Output to be displayed in the content server web interface> Output to be displayed in the content server web interfaceSelect one of your options based on your recording and streaming needs.
Output in the web interface of the Content Server> On DemandFormats: Select the "MPEG-4 for Flash" format (required because Vbrick only works with this format) Optionally, to select additional format types, as long as the "MPEG-4 for Flash" format is also selected. Size: Select one of your options based on your recording and streaming needs.
Output to be displayed in the web interface of the Content server> Configuration settings for on-demand media serversMPEG-4 for Flash will be selected automatically and Windows Media and MPEG-4 for QuickTime will be disabled if you select the MPEG-4 for Flash format above. The "Optimize for Motion" check box is optional.
Output to be displayed in the web interface of the content server> Live streamEnable live stream. Format: MPEG-4 for Flash Confirm Selected. Size: Select one of your options. Re-transcode real-time movies: Optional. Media server configuration: Confirm that your media server configuration is selected for Vbrick Live.

Click the "Save" button to save the configuration.

1c Adding Recording Aliases for VBrick Live Streaming:

Fill in and select the alias configuration fields for VBrick Live Recording:

Recording aliasName ": Name to identify the Vbrick Recording alias. 'Owner of the personal recording alias': Select the user who has the authorization to edit these recordings.
Dial propertiesAccording to the dial plan in your video network. Enter the H.323 and / or SIP dialing information.
Recording settingsIn the template, select the Vbrick Live template created in 1b. All other settings in this section can be kept by default or adjusted to your needs.
Standard recording informationCan be left blank or customized to suit your needs.
Standard recording permissionsLeave the default settings unchanged or adjust them as needed.

Click the "Save" button to save the configuration.

If you just configure live streaming (webcast) integration, you're done. You can skip the following steps to the "Verify" section to begin testing this integration. If you are also configuring VoD (Video on Demand), follow the next steps.

2. VBrick VoD (Video on Demand) integration.

2a) Add VBrick VoD server configuration

In the TCS web interface, go to Management> Recording Setup> Media Server Configurations and click on the link '+ Add VBrick VoD server configuration':

There are two options for configuring the VoD media server: You can configure the connection via FTP or FTPS (Secure FTP with SSL).

FTP configuration.

  • To configure FTP, complete the media server configuration fields as follows:
SurnameName to identify the Vblock VoD media server
Server addressIP or FQDN Vbrick DME
File transfer protocolSelect FTP
Command sportField disabled when FTP is selected
User nameAdmin user for Vbrick DME server. The default value is "admin".
passwordPassword for the admin user in the Vbrick DME server. The default value is "admin".
Password confirmationConfirm the password that was set in the previous field.

Before saving the configuration, you can use the "Test FTP" button to confirm that you have reached the server and that the administrator credentials are correct if you get a green check mark with the message: 'FTP test successful to server YourDMEServer: 21 ', then you can save the media server configuration:

FTPS configuration:

  • To configure the configuration to use FTPS (Secure FTP with SSL), complete the media server configuration fields as described below. Please note that this option is only available in TCS7.2 and higher:
SurnameName to identify the Vblock VoD media server
Server addressIP or FQDN Vbrick DME
File transfer protocolSelect FTPS
Command sportThis must match the "FTP Command Port" configured in the Vbrick DME web interface: System configuration> Ports.
User nameAdmin user for Vbrick DME server. The default value is "admin".
passwordPassword for the admin user in the Vbrick DME server. The default value is "admin".
Password confirmation

Confirm the password that was set in the previous field.

Before saving the configuration, you can use the "Test FTPS" button to check that you have reached the server and that the administrator credentials are correct if you get a green checkmark with the message: 'FTPS test successful to server YourDMEServer: YourCommandPortNumber' , save the media server configuration:

Note: FTPS must be activated for FTPS to work on the VBrick DME server. The command port is configured differently than the standard 21 and the SSL certificate needs to be uploaded.

Enable FTPS in VBrick DME using the web interface under System Configuration> Security:

Specify a different FTPS port that works under System Configuration> Ports:

Upload an SSL certificate to the VBrick server under System Configuration> SSL Certificates. For detailed information on uploading and signing your certificate, see the VBrick documentation: VBrick Admin Guide.

2b) Add template for use with VBrick VoD:

In the TCS web interface, go to Management> Recording Setup> Templates and click the '+ Add template' link:

Fill in and select the VBrick Live template configuration fields:

SurnameName to identify the Vblock VoD template.
Choose how you'd like to capture recordings made with this template and edit the following options:Just enable the Distributed to Media Experience Engine 3500, VBrick, Show and Share, Podcast Producer, or iTunes U option.
Expenditures for distribution to Media Experience Engine 3500, Show and Share, VBrick, Podcast Producer or iTunes UFor the outputs, choose one of you based on your recording and streaming needs, then select the Vbrick check box, select the 'Media Server Configuration' that was created for Vbrick VoD in the previous step. Select a size for streaming.

Click the "Save" button to save the configuration.

2c) Adding recording aliases for VBrick VoD:

Fill in and select the fields for the VBrick VoD Recording Alias ​​configuration:

Recording aliasName ": Name to identify the Vbrick VoD Recording Alias. 'Owner of the personal recording alias': The user selected here must exactly match a user that is available in the VBrick Rev server.
Dial propertiesAccording to the dial plan in your video network. Enter the H.323 and / or SIP dialing information.
Recording settingsIn the template, select the Vblock VoD template that was created in 2b. All other settings in this section can be kept by default or adjusted to your needs.
Standard recording informationCan be left blank or customized to suit your needs.
Standard recording permissionsLeave the default settings unchanged or adjust them as needed.

Note: If the user selected as the owner of the personal recording alias does not exactly match a user who is assigned all of the 'Media' assigned roles that exist in the VBrick Rev Server, the VoD integration will not work. This user is the uploader of the video made to rev and must be recognized by him.

For detailed information on the following topics, see the "Troubleshooting" section of this document: Create a user in TCS that corresponds to an existing user in Rev and / or how to create a user in Rev that is exactly the same as the one we selected in TCS User matches.

Click the "Save" button to save the configuration.

When all of these settings have been configured, proceed to the "Verifying" section of this document.

Check

This section verifies that your configuration is working properly.

VBrick Live Streaming:To make sure the program is working properly, check the following:

When connecting a call to the Live Streaming Recording SIP or H.323 alias in TCS, the recording should appear in the TCS web interface under the View Recordings tab:

In the VBrick DME server web interface, go to Monitor and Logs> Multi-Protocol Connections. If the streaming is successful from TCS to DME, you should see all the details of the stream there:

Use a streamer player like VLC Player to intercept the stream and properly test the audio and video transmission. To do this, use the RTP or RTP links seen in VBrick Web Interface Monitor and Logs> Multi-Protocol Connections.

If any of these steps do not display the correct behavior, see the "Troubleshooting" section of this document for the causes and what you can do to resolve them.

VBrick VoD: To make sure the program is working properly, check the following:

When the recording is complete, go to the TCS web interface, go to the Management tab and check that the recording has finished transcoding. Only after the recording has been fully transcoded is it uploaded to the VBrick Rev server:

When the transcode job is completed in TCS, go to the VBrick DME server web interface and go to Monitor and Logs> Upload Log. If the upload goes smoothly, you will see messages confirming that the video capture and upload completed successfully to the Rev server:

You can then go to the VBrick Rev server web interface to verify that your video has been uploaded and is playing correctly. Remember, the video will be shown as inactive until it is enabled for playback.

If any of these steps do not show the correct behavior, see the Troubleshooting section of this document to see what causes and what you can do to correct them.

Troubleshooting

Packet captures from TCS and DME will help you with most communication problems.

TCS: Use Wireshark or similar in the Windows server on which TCS is installed to get packet captures.

DME: Use the web interface in Diagnostics> Trace Capture and press the Start capture button. Press the 'Stop Capture' button to stop the trace. Press the "Download" trace file to download the packet capture.

Check the correct configuration of the Ports

VBrick DME ports and FTP (S) used for streaming can be checked and configured in the DME server web interface under System configuration> Ports:

Live streaming from TCS to VBrick - the most common problems:

Problems with the media server configuration:

Error message: "The connection to the server could not be established".

Cause: Wrong RTSP port.

Solution: Check whether the 'Multi-Protocol Server RTSP port' configured under System Configuration> Ports in the VBrick DME web interface is identical.

Error message: 'The authentication failed for the RTSP advertisement to the server.'

Cause: wrong username and / or password.

Solution: In User Configuration, enable Stream Input Authentication User Name. Authentication is the same in the VBrick DME web interface.

Streaming from TCS does not show up in DME Web Interface Logs> Multi-Protocol Connections:

Cause: Communication problems between TCS and DME.

Solution:

In TCS: Check that the recording is showing as active on the Recordings tab (red circle indicates recording is showing) Check that all TCS services are running properly.

In DME: In the web interface, check that the RTSP and RTMP services read True.

If the previous steps are correct, there is a communication problem between the TCS and DME and it could be a network problem or a failure in one of the servers. Take the packet capture from TCS and DME to isolate the problem and filter it for the appropriate IP addresses. Checking the communication. the TCS packet capture shows that TCS is sending packets to DME and the DME packet capture shows that no packets are being received by TCS. In this example, you want to check whether a network connection is being blocked or prevented, or whether there is a major fault with the DME server. If you are not very familiar with packet capture, open a TAC ticket and have both packet captures ready so a technician can help you identify the communication problem between the TCS and DME.

Live streaming cannot be intercepted by a streaming player:

Make sure the rtsp link is displayed in the VBrick web interface under Monitor and Logs> Multi-Protocol Connections and not just in the rtmp. If the video does not appear, follow the steps outlined in Can the Streaming from TCS in the DME web interface Logs> Multi-Protocol Connections.

If the VBrick DME web interface under Monitoring and Logs> Multi-Protocol Connections shows details and links for the TCS live streaming, the network and the VBrick DME server need to be investigated more closely. Open a ticket with the assistance of VBrick.

TCS-VoD with VBrick common problems:

Problems with the media server configuration:

Error message: "The connection to the FTP (S) server could not be established".

Cause: Wrong FTP (S) port.

Solution: Verify that the FTP command port number is the same under System Configuration> Ports in the VBrick DME web interface.

Error message: "The user 'your user' could not log into the FTP (S) server ..."

Cause: Incorrect username and / or incorrect password.

Solution: Check that your DME administrator user and / or password are correct. If these credentials are lost, contact VBrick support.

VoD cannot be uploaded from TCS to Rev-Server.

Error message: "UploaderUserDoesNotExist UploaderUserDoesNotExist = {UserDoesNotExist = Uploader for video not possible. Make sure that the video transmission is linked to a valid user .."

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 = {UserDoesNotExist 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, UploaderUserDoesNotExistoes UploaderExist = {UserDoesNotExist = Unable to upload video. Please ensure that video is associated to a valid user., Uploader = Administrator, accountId = 30dcd82e-ae13-4aae-b0a6-fd8d0ed3b805}

Cause: The user that was configured as 'Personal Recording Alias ​​Ownership' in the VBrick VoD Recording Alias ​​in TCS does not match a user that exists in the VBrick Rev server.

Solution: Create a user in TCS that corresponds to 'Media' rights on the Rev server, or create a user in Rev with 'Media' rights that corresponds to the TCS user who is known as' Personal Recording Alias Ownership 'has been configured in the recording alias for VBrick VoD.

How to create a user in the TCS web interface:

Go to Configuration> Groups and Users, in the Add User section, note the username in the Creator Role window. Remember that this username must match the username in the Rev server. Click the "Add" button at the bottom of the page. The user is created and can be selected from the drop-down list in the configuration of the owner of the personal recording alias.

Creating a User in VBrick Rev:

To create a user in the Rev server web interface: Go to Settings> Users> Users and click the '+ Add User' button. Check that the username matches the username in TCS (it is not case-sensitive). Also check that all 'Media' roles are assigned to the user. Click the Create User button to create the user. Remember, the user will not be active until they hit the activation link after creating it.

Problems playing the video on VBrick Rev:

Error message: When playing the TCS VoD recording, the VBrick Rev Server web interface cannot process video recording.

Solution: Contact VBrick support for further troubleshooting as this may be related to the Rev services hosted in the cloud.