Media Flow Controller has the ability to work with Adobe Flash Media Server (FMS) to stream Flash videos over Real Time Messaging Protocol™ (RTMP).FMS RTMP delivery service listens on Transmission Control Protocol (TCP) port 1935; the FMS administration service listens on TCP port 1111. RTMP is a proprietary protocol developed by Adobe Systems for streaming audio, video and data over the Internet, between a Flash player and a server.To install FMS, you must first download the image; you can do this directly from Adobe (the “Development Server” version, available for free, is adequate for this procedure, but it is limited to 10 simultaneous streams). First download the image to a Web or FTP/SCP server to which you have access. Use these CLI commands at the (config) # prompt (must have admin privileges and enter enable and then configure terminal first):The download command downloads the image given in the URL (SCP, HTTP, or FTP) to the directory /nkn/adobe/downloads directory that is visible in the FMS shell. See the “Command Arguments Key” on page 161 for the scp URL format).The install command shows files in the FMS download directory and, when the install image is given, interactively installs FMS.Important! It is critical that a few of the installation questions are answered with the correct values; be sure to use these values as indicated in the following step procedure.
1. Accept the license agreement and enter your FMS server serial number or leave blank and press Enter to install the FMS Development Server. The FMS Development Server is free, but limited to 10 simultaneous streams.You have not entered a serial number. Falling back to the Adobe Flash Media Development Server!
2. Enter the correct directory for the installation, /nkn/adobe/fms.The installer will install Adobe Flash Media Server 3.5 in the following directory. Default [/opt/adobe/fms]: /nkn/adobe/fmsDo you want the installer to overwrite the previous installation with this installation or quit this installer? (y/q) Default [y]: yThe Adobe Flash Media Server communicates on the IANA-assigned port of 1935, which is the port most Flash applications expect, and can also communicate on port 80, both for tunneling Flash over HTTP, and for proxying HTTP to a webserver.Please enter the port to use for the Admin service. You can only specify one admin port. Default [1111]: 1111
6. The administrative user name and password you provide here is required to use the Adobe Flash Media Server Management Console for administration, monitoring, and debugging.
7. When the Adobe Flash Media Server service is started, the service can be run as a user other than "root". The server would change to this user when the server is started and has acquired its ports.Please enter the user that the Adobe Flash Media Server service will run as Default user [nobody]: adminDo you want to start the Adobe Flash Media Server after the installation is done? (y/n) Default [y]: nYou must manually configure two FMS files. If any configuration changes are made to FMS, including installation, the FMS services need to be restarted.
1. Modify the FMS server and adminserver files using vi. To do this, first log in to the FMS shell from the CLI config mode in Media Flow Controller:
2. test-vos # enabletest-vos # configure terminaltest-vos (config) # application fms shell# ls# cd fms# ls
3. Exit the FMS shell by typing exit; the window closes and you must open a new session to Media Flow Controller.
4. In the new Media Flow Controller session, enter config mode and restart FMS:The FMS Admin Console allows you to monitor and manage FMS activity, including the current FMS user sessions, streams, and performance. The Media Flow Controller Web-based Management Console lets you monitor only the delivery of the files configured under VOD (described below).Note! Do not use your Media Flow Controller as a Web server for the FMS Admin Console.To use the FMS Admin Console to monitor FMS activity, you need to copy three files under the FMS installation directory to the doc root of your origin-server; Juniper Networks recommends placing these files in a directory separate from your FMS video files directory.
1.
2. You can locate the three files you need in the fms/webroot directory of the unpacked FMS Development Server tarball:Copy these three files to your doc root (/var/www/html) in a directory you create; for example fmsAdmin.
4. Login with the FMS Admin Console credentials you configured in step 6 of “Installing FMS on Media Flow Controller” on page 100 and the IP address of your Media Flow Controller for Server Address.
5. The advantage to installing the FMS Admin Console before FMS configuration is complete is that, when FMS configuration on Media Flow Controller is complete, you can immediately check the installation via the FMS Admin Console. Otherwise, you must send appropriately defined traffic and verify FMS processing through the Media Flow Controller. You can do this either by looking at the logs and graphs in the Media Flow Controller Web-based Management Console or by using show counters at the CLI to observe FMS traffic.To configure FMS for video on demand (VOD), log in to the FMS shell from the CLI config mode in Media Flow Controller:The above CLI command takes you to the FMS installation directory and from there, all FMS configuration changes can be done. The configuration entails creating a Media Flow Controller FMS directory and namespace(s).When an RTMP request comes to FMS, it scans the configuration file in the application directory /fms/applications to find the requested file. You configure Media Flow Controller namespace to correspond with the configuration of VOD_DIR (described below).Important! The configuration in FMS must match your FMS Media Flow Controller namespace configuration.
1. Locate the Application.xml file in the /fms/applications/vod directory and replace ${VOD_DIR} with /nkn/mnt/fuse/fms in the the configuration for VirtualDirectory. The VirtualDirectory configuration part of Application.xml looks like this (before editing):test-vos (config) # application fms shell# ls# cd fms# ls# cd applications# ls# cd vod# ls
2. Exit the FMS shell by typing exit; the window closes and you must open a new session to Media Flow Controller.Note! The directory configuration is /nkn/mnt/fuse PLUS the URI path /fms from the namespace configuration (below).If the file requested by the client player for application VOD is sample.flv, then the request that comes to Media Flow Controller is /fms/sample.flv. Media Flow Controller matches the incoming request /fms/sample.flv to namespace fms_vod via the configured match uri of /fms.The namespace and match uri must match the application configuration in FMS. For example, if you used /nkn/mnt/fuse/fms/vod above instead of /nkn/mnt/fuse/fms, then your corresponding namespace configuration would have to have a match uri of /fms/vod. Example assumes a configuration of /nkn/mnt/fuse/fms.The video files and associated files such as SWFs, JavaScript, and HTML are stored in an HTTP or NFS origin server and the configured Media Flow Controller namespace points to that origin server.It's also possible to cache only the video file in Media Flow Controller and for all other associated files, the player directly goes to the origin server.test-vos (config) # namespace fms_vodtest-vos (config namespace fms_vod) # domain anytest-vos (config namespace fms_vod) # match uri /fmstest-vos (config namespace fms_vod) # origin-server http fms-origin.test.comtest-vos (config namespace fms_vod) # status activeHave multiple applications such as vod, vod1, and vod2, in FMS and let them map to their corresponding namespaces as given below:vod:vod1:vod2:Have only one application and use the client player to provide different file paths that map to different namespaces.vod:Put your videos in the Apache webroot (var/www/html) in a directory named /fms (or whatever you used for the URI path configuration in the Application.xml file) of the origin server configured for your streaming namespace. Provide access to them on your Website. You can then open a browser and request a video via RTMP and observe FMS on Media Flow Controller either by looking at the logs and graphs in the Media Flow Controller Web-based Management Console or by using show counters at the CLI.If you installed FMS on Media Flow Controller using the free FMS Development Server, and decide to upgrade to the full-function Adobe FMS Server, follow these steps.
1. Download the license using application fms download command. For example:test-vos (config) # application fms download scp://<user>@<hostname>/<path_to_file>/<license_file_name>.licNote! You can install FMS on Media Flow Controller without the full-function FMS Server license, but the functionality is limited to 10 simultaneous streams.Note! You can also obtain a special juniper-mfc-fms license that, when installed, automatically installs the full-function Adobe Flash server. For details, see “Requesting Technical Support” on page 32.
Report an Error |
Media Flow Controller Administrator's Guide and CLI Command Reference |
Copyright © 2010 Juniper Networks, Inc. |