Table Of Contents
Integration Note for
Configuring Cisco MXE 3500 Release 3.2 with Cisco Show and Share Release 5.2.1 or Later
Revised May 27, 2011
This document describes how to integrate the Cisco Media Experience Engine 3500 Release 3.2 with Cisco Show and Share Release 5.2.1 or later releases to automatically transcode videos to a common format.
See these sections:
About Cisco MXE 3500 Integration with Cisco Show and Share
When Cisco MXE 3500 integration is enabled in Cisco Show and Share, videos uploaded to Cisco Show and Share are delivered to the Cisco MXE 3500 for transcoding. When the transcoding is complete, the transcoded videos are returned to Cisco Show and Share. Videos are transcoded to this format:
•Format: Flash video 8 (.flv)
•Bitrate: 400 bps
•Frame rate: 30 fps
•Maximum height: 268 pixels
•Maximum width: 480 (for 16x9 ratio), 360 (for 4:3 ratio)
Transcoded videos are editable in the Cisco Show and Share video editor.
After you complete the Cisco MXE 3500 and Cisco Show and Share integration, the end user workflow to upload and transcode a video is as follows:
1. User uploads a video to the Cisco Show and Share video portal.
2. Cisco Show and Share submits the video by using FTP to the Cisco MXE 3500 for transcoding.
3. Cisco Show and Share uses the MXE API to submit and poll the status of the job it submitted. When the Cisco MXE 3500 completes transcoding the video, Cisco Show and Share uses FTP to copy the transcoded video to the Cisco Show and Share video portal.
4. The user publishes the transcoded video.
Guidelines and Limitations
The following guidelines and limitations apply to Cisco MXE 3500 integration with Cisco Show and Share:
•You can only configure one Cisco MXE 3500 or Cisco MXE 3500 cluster in Cisco Show and Share.
•There is no co-location requirement for Cisco Show and Share and Cisco MXE 3500 hardware. The appliances can be deployed anywhere in the network provided that they can communicate by using FTP (TCP port 21) and HTTP (TCP port 80). Cisco Show and Share uses FTP to submit user videos to Cisco MXE 3500 and retrieve transcoded versions, and uses HTTP to submit transcoding job requests. If network loading or bandwidth are a concern with large video files, Cisco Show and Share and the Cisco MXE 3500 should be co-located.
•The Cisco MXE 3500 licenses, Standalone and Resource Manager, both work for this integration. Other than the functional differences between the two licenses, there are no specific configuration limitations.
When using the Standalone license, the Cisco MXE 3500 will continue to perform network transcoding jobs in addition to those submitted from Cisco Show and Share. When using the Resource Manager license, you can integrate the Cisco MXE 3500 with Cisco Show and Share by using one of these scenarios:
–Add Cisco Show and Share-specific profiles to the Cisco MXE 3500 system default profiles.
–Create separate profiles and use these in place of the system default profiles.
•Cisco MXE 3500 does not include the workflow profiles: encoder, output, preprocessor, for integration with Cisco Show and Share. You must download and install the profiles from Cisco.com.
•When integrating Cisco Show and Share with a Cisco MXE 3500 cluster (resource nodes managed by a resource manager), observe these guidelines:
–Verify that the resource nodes (RNs) have full control access to the c:\dms shared folder on the resource manager (RM).
–When configuring the host setting, we recommend using the IP address for the RM. Verify that the RNs can reach the RM IP address.
Configure the Cisco MXE 3500
Note If you are using a Cisco MXE 3500 cluster, perform all configuration steps on the unit acting as the Resource Manager.
Cisco MXE 3500 Windows Configuration
Step 1 On a local Windows computer, choose Start > All Programs > Accessories > Communications > Remote Desktop Connection.
The Remote Desktop Connection dialog box appears.
Step 2 Enter the IP address or network name of the Cisco MXE 3500 in the computer field. Click Connect.
The Cisco MXE 3500 desktop connection opens. A dialog box prompts you for login credentials.
Step 3 Enter the Cisco MXE 3500 Remote Desktop Username and Password. The defaults are admin and change_it.
Note The password is case sensitive.
Step 4 Create the media input and output directories for Cisco DMS:
Step 5 Right-click the dms folder and choose Sharing and Security.
Step 6 Select Share this folder. Verify that the folder name (dms) appears in the Share name.
Step 7 Click Permissions. Assign Full Control to Everyone. Click OK.
Step 8 Right-click the C:\Program Files\Cisco\Media Experience Engine\profiles folder and choose Sharing and Security.
Step 9 Select Share this folder. Change the folder name in the Share name field to dmsProfileSpace.
Note The share name needs to be dmsProfileSpace because it has been hard coded in Cisco Show and Share for this integration.
Step 10 Click Permissions and then click Add.
Step 11 Type Everyone in the Enter the object names to select field, click Check Names, and then click OK.
Step 12 Click OK to close the Permissions dialog box and then click OK to close the folder Properties dialog box.
Note No changes are needed on the Cisco MXE 3500 in terms of the profile directory. Keep the default settings that came with Cisco MXE 3500.
Cisco MXE 3500 Linux Configuration
Step 1 Use SSH to access the Linux VM.
Step 2 Log into Linux as admin. The default password is change_it. The configuration menu appears.ssh admin@<linux_ip>Password: change_it
Step 3 Select System Command Prompt. The command line interface appears.
Step 4 Become root.su -
Step 5 Locate and run the Cisco Show and Share integration setup script:[root@10 ~]# cd /opt/cisco/mxe/scripts/sns/[root@10 sns]# ./install.shStarting SNS integration setup...Shutting down smbd services: [ OK ]Shutting down nmbd services: [ OK ]Starting smbd services: [ OK ]Starting nmbd services: [ OK ]Saving firewall rules to /etc/sysconfig/iptables: [ OK ]Flushing firewall rules: [ OK ]Setting chains to policy ACCEPT: filter nat [ OK ]Unloading iptables modules: [ OK ]Applying iptables firewall rules: [ OK ]Starting vsftpd for vsftpd: [ OK ]SNS integration setup complete.
Step 6 Create the dmsftp user and assign its home directory as the dms mount directory.[root@10 sns]# useradd -d /mnt/dms dmsftp
Step 7 Create a password for the new user:[root@10 sns]# passwd dmsftpChanging password for user dmsftp.New password:Retype new password:passwd: all authentication tokens updated successfully.
Write down the new username and password. You will need the username and password when configuring Cisco MXE 3500 in the Cisco DMM.
Install the Cisco DMS profiles
The DMS profiles contain settings used by the Cisco MXE 3500 to transcode videos submitted from Cisco Show and Share.
Step 1 Download the dmsProfileSpace.zip file from Cisco.com software center to a local machine:
Step 2 Use FTP to copy the dmsProfileSpace.zip file to the shared c:\dms folder on the Cisco MXE 3500:
•ftp <Cisco MXE 3500 IP address>
•Use the FTP user (dmsftp) and password created above
Step 3 Log in to the Cisco MXE 3500 Windows desktop using Remote Desktop.
Step 4 Go to the c:\dms folder. Extract dmsProfileSpace.zip file to C:\.
Step 5 After you extract the file, you should have a dmsProfileSpace directory in the C:\ drive that contains the following directories and files:
Step 6 Copy the DMS_SNS_4X3_FLV.flash8.awp and DMS_SNS_16X9_FLV.flash8.awp files under the C:\dmsProfileSpace\flash8 folder to:
C:\Program Files\Cisco\Media Experience Engine\profiles\flash8 folder.
Step 7 Copy the DMS_SNS_Output.out.awp file under the C:\dmsProfileSpace\out folder to:
C:\Program Files\Cisco\Media Experience Engine\profiles\out folder.
Step 8 Copy the DMS_SNS_PP.pp.awp file under the C:\dmsProfileSpace\pp folder to:
C:\Program Files\Cisco\Media Experience Engine\profiles\pp folder.
Configure the Cisco MXE 3500 Host Settings
Make sure that the Cisco MXE 3500 IP address, rather than localhost, appears in the host configuration.
Step 1 Log into the Cisco MXE 3500 web UI (http://mxe_server/mxeui) by using an admin account. You can use the Cisco MXE 3500 IP address or fully qualified domain name in the URL. The default admin account password is admin.
Step 2 Choose Administration > Host.
Step 3 Verify that the Cisco MXE 3500 IP address appears in the host column.
Step 4 If localhost appears as the hostname for your Cisco MXE 3500, do the following:
a. Click the hostname to select the row.
b. Choose Host Options > Edit.
c. Type the IP address in the Host Name field.
d. Change the temporary directory path by using the IP address: \\<MXE3500 IP address>\temp.
e. Click Save and then click Apply Configuration.
Configure Cisco MXE 3500 API Authentication
For Cisco MXE 3500 3500 Release 3.2, you must disable API basic authentication to integrate with Cisco Show and Share.
Step 1 Log into the Cisco MXE 3500 web UI (http://mxe_server/mxeui) by using an admin account.
Step 2 From the Toolbox, click Administration > API Admin.
Step 3 In the Configure Authentication Mode section, click Edit.
Step 4 Choose Unauthenticated Mode. This option specifies that the MXE REST API does not require any authentication. No API components are blocked, giving users unrestricted access to all and any API components.
Step 5 Click Save.
Note•Cisco MXE 3500 uses the mode that you configure upon save, though this mode is not reflected in the UI.
•The Cisco MXE 3500 web UI and APIs will not be accessible for 1-2 minutes while the authentication mode change is applied.
Register the Cisco MXE 3500 in the Cisco DMM
Note Cisco Show and Share cannot use the Cisco MXE 3500 until the Cisco MXE 3500 has been registered in the Cisco DMM.
Step 1 Log into Cisco DMM (http://dmm_server_name:8080) as superuser.
Step 2 Click Administration.
Step 3 Choose Settings > External Servers > MXE. The Media Experience Engine settings page appears.
Step 4 Select Enabled in the Use of MXE field. Enter the Cisco MXE 3500 fully qualified domain name or IP address in the MXE FQDN field, for example mxe.cisco.com.
Step 5 Enter the FTP credentials that you configured on the Cisco MXE 3500:
The username of the FTP account that you created in the "Cisco MXE 3500 Linux Configuration" procedure. For example, dmsftp.
The password for the FTP account that you created the "Cisco MXE 3500 Linux Configuration" procedure.
Step 6 Click Save. Cisco DMM verifies the connection to the Cisco MXE 3500. If it cannot contact the Cisco MXE 3500, an error message appears.
Step 7 If you receive an error, verify your settings. If you configured the FTP password incorrectly, complete the following steps to reset the password on the Cisco MXE 3500 and then return to Step 1 to register the Cisco MXE 3500 again.
a. Use SSH to access Linux.
b. Log into Linux as admin. The default password is change_it. The configuration menu appears.ssh admin@<linux_ip>Password: change_it
c. Select System Command Prompt. The command line interface appears.
d. Become root.su -
e. Enter the following commands:cdpam_tally --user dmsftp --reset
Configure Cisco Show and Share to Use the Cisco MXE 3500 for Transcoding Videos
Step 1 Log into Cisco Show and Share with admin or superuser privileges.
Step 2 Chose Administration from the global navigation.
Step 3 Choose Setup > Media Experience Engine. The Media Experience Engine Settings page displays.
Step 4 Select Enable Media Experience Engine.
Step 5 Select one of the following choices:
•Do not transcode Windows Media video content. Prevents Windows media files (.wmv, .wma, .asx, and .asf) from being transcoded. They will be handled natively by Cisco Show and Share. Users will not be able to use the built-in video editor with these file types. This option is enabled by default.
•Allow Windows media content to be transcoded. Allows Windows media files to be transcoded by the Cisco MXE. Users that are uploading Windows media files are given the option to skip transcoding and have the files processed natively by Cisco Show and Share. They would want to skip transcoding if their media contained embedded closed captioning. When Windows media video content is transcoded, any embedded Closed Captioning is lost.
Verify the Integration
Cisco Show and Share now automatically submits transcoding jobs to the Cisco MXE 3500. Follow this procedure to verify the integration.
Step 1 Upload a video to Cisco Show and Share, and save it as a draft.
Step 2 Log in to the Cisco MXE 3500 user interface.
Step 3 Choose Monitoring > Job Status. A job will be running without a Job Profile Name.
Step 4 Select the job.
Step 5 The Tasks tab displays the job details. When the Cleanup task is complete, the Cisco MXE 3500 has completed the transcoding and deleted the submitted video from the C:\dms\input folder.
Step 6 On Cisco Show and Share, the status of the uploaded video will change from "Processing - Draft" to "Draft". You can now publish the transcoded video in the Cisco Show and Share video portal.
Cisco Show and Share:
Cisco Media Experience Engine 3500: