manualshive.com logo in svg

Adobe 65029121 - Flash Media Streaming Server, Configuration And Administration Manual, Page: 250 / 257

Share
Download
Adobe 65029121 - Flash Media Streaming Server Configuration And Administration Manual Download Page 250

246

FLASH

 MEDIA

 SERVER

 4.5

 CONFIGURATION

 AND

 ADMINISTRATION

XML configuration files reference

Last updated 11/28/2012

Path

Specifies the physical location of the proxy cache. By default, the location is 

RootInstall

/cache/. The value must be an 

absolute path. Relative paths are ignored and the server uses the default folder.

See also

Proxy

Container element.

The elements nested in this section configure this virtual host as an edge server that can forward connection requests 
from applications running on one remote server to another server. 

Note: 

Whenever a virtual host is configured as an edge server, it behaves locally as a remote server.

If this virtual host is configured to run in 

remote

 mode and you want to configure the properties of an outgoing SSL 

connection to an upstream server, the SSL connection to upstream servers will use the default configuration specified 
in the 

SSL

 section of the Server.xml file.

Contained elements

Mode

, 

Anonymous

, 

CacheDir

, 

LocalAddress

, 

RouteTable

, 

EdgeAutoDiscovery

, 

SSL

, 

AggregateMessages

, 

RequestTimeout

RequestTimeout

The maximum amount of time, in seconds, the server waits for a response to a request from an upstream server. A 
request can be for metadata, content, and so on. This value -1 specifies an unlimited amount of time (no timeout). The 
default value is 2 seconds.

See also

CacheDir

ResourceLimits

Container element.

The elements in this section specify the maximum resource limits for this virtual host.

Contained elements

MaxConnections

, 

MaxEdgeConnections

, 

MaxAppInstances

, 

MaxStreams

, 

MaxSharedObjects

, 

AppInstanceGC

,

RouteEntry

Instructs the edge server to forward the connection request to one server’s IP address and port number [host:port] to 
a different IP address and port number.

Edge servers are configured with the 

RouteEntry

 element to direct connections to another destination. The 

RouteTable

 element contains the 

RouteEntry

 elements that control where the edge server reroutes requests. 

You can also add the 

protocol

 attribute to an individual 

RouteEntry

 element to specify how the edge server reroutes 

requests. If no protocol is specified, however, Flash Media Server applies the protocol specified in the 

RouteTable

 

element. Implicit proxies hide the routing information from the clients.

Summary of Contents for 65029121 - Flash Media Streaming Server

Page 1: ...ADOBE FLASH MEDIA SERVER 4 5 Configuration and Administration Guide...

Page 2: ...Last updated 11 28 2012 Legal notices Legal notices For legal notices see http help adobe com en_US legalnotices index html...

Page 3: ...ing failover 62 Using a third party web server 74 Configuring Differentiated Services DiffServ 75 Chapter 3 Using the Administration Console Connecting to the Administration Console 80 Inspecting appl...

Page 4: ...iv FLASH MEDIA SERVER 4 5 CONFIGURATION AND ADMINISTRATION Contents Last updated 11 28 2012 Application xml file 138 Logger xml file 185 Server xml file 191 Users xml file 232 Vhost xml file 236...

Page 5: ...sh connections to the server Port number Protocol Transport Description 1935 RTMP E TCP By default Flash Player and AIR clients make RTMP connections to Flash Media Server over port 1935 over TCP To c...

Page 6: ...inbound traffic from unknown hosts on ports 19350 65535 is optional Flash Media Server sends a packet out to a new client to redirect it to a port in the range 19350 65535 This packet attempts to punc...

Page 7: ...number of fmscore processes in use The number of fmscore processes in use depends on how application instances are distributed See Configure how applications are assigned to server processes on page 2...

Page 8: ...ach HostPort element can specify a public address that corresponds to the specified port This is the address that is advertised to clients for the given HostPort To advertise an address specify a valu...

Page 9: ...same server In this case a simple analysis can fail to predict whether a client can make a peer to peer connection Note A firewall can filter and not be a NAT A NAT can act as a firewall and have filt...

Page 10: ...ache to use port 80 and configure Flash Media Server not to use port 80 You do not need to use both techniques Specify the port number in request URLs Connect clients to Apache HTTP Server directly th...

Page 11: ...d verify the installation on each computer Ensure that you deploy all servers on computers that meet the minimum system requirements Note For cross platform compatibility use lowercase names for all f...

Page 12: ...not necessarily to the same application Peer lookups do not work across origin servers However peerIDs are cached on the edge server which reduces the load on the origin When clients are connected to...

Page 13: ...see RouteEntry Configure edge servers To configure the server to run as an edge server edit the Vhost xml configuration file of the virtual host you want to run as an edge server The Vhost xml file de...

Page 14: ...eEntry element how to route connections from the origin to the edge There is one attribute protocol that indicates the protocol of the outgoing connection Set this attribute to either rtmp or rtmps To...

Page 15: ...bucket reaches K N bytes where K is the maximum size of the disk cache the server triggers a rollover A rollover means the server deletes the oldest bucket and creates a new bucket where new content...

Page 16: ...ble in the RouteTable element for more information see the comments about RouteEntry tags in the Vhost xml file installed with Flash Media Server Element Description MaxSize Specifies the maximum allo...

Page 17: ...may have problems with shared objects because of the embedded question mark character in the URL Call the following function to encode or escape the question marks from the URL before passing the URL...

Page 18: ...own root folders For example you could use two virtual hosts to host www test com and www example com on the same server You can assign an IP address or a port number to an adaptor but not to a virtu...

Page 19: ...ctory with the name of the adaptor in the rootinstall conf folder for example rootinstall conf adaptor2 2 In the adaptor2 directory create or paste a copy of the _defaultVHost_ directory and an Adapto...

Page 20: ...with the name of the virtual host in an adaptor folder for example rootinstall conf _defaultRoot_ www example com 2 Copy an Application xml file a Vhost xml file and a Users xml file to the new virtu...

Page 21: ...applications live Each folder contains an Application xml file The values in these files override the values in the vhost level file rootinstall conf _defaultRoot_ _defaultVHost_ Application xml To p...

Page 22: ...ord encrypt true 6cb340fd77d3297cb6d82f57bb085a13d f45cd9513d042355a9a304c1d47ec433c97a8bdc2584424 Password When the server starts it replaces the parameter in the XML configuration files with the val...

Page 23: ...SymbolName element for each symbol you want to create 3 For example this substitution xml file maps the symbol TESTUSERNAME to the value janedoe Root Symbols TESTUSERNAME janedoe TESTUSERNAME Symbols...

Page 24: ...fers to an environment variable and not to a user defined string The syntax for specifying an environment variable as a symbol is ENV_VAR_NAME For example the server maps the following symbol to the C...

Page 25: ...e size Only the amount of RAM available on the computer limits the recorded file cache size Note The system warns that a process is close to the memory limit when the process memory is more than 90 of...

Page 26: ...mount will be used by the OS and other non Flash Media Server processes Amount of RAM available for FMS R RAM size RAM used by the OS and non FMS processes The RAM available for Flash Media Server is...

Page 27: ...setting is disabled the server breaks up aggregate messages into individual messages before delivering them to clients Aggregate messages can be used with live and recorded streams An origin server c...

Page 28: ...s the maximum duration of the aggregate message controlled by the stream timeline For instance if an aggregate message is configured to be 64K long but the MaxAggMsgDuration is set to 3 seconds even i...

Page 29: ...ges in the queue are grouped together as aggregates to improve the efficiency of transmission It is possible to enable queing and disable the generation of aggregate messages but this does not result...

Page 30: ...an Application xml file to the application s folder 2 Locate the StreamManager Audio CombineSamples section of the file and set values the following elements 3 Restart the server Limit connection req...

Page 31: ...event logs To close idle connections enable the feature in the Server xml file Once you enable the feature in the Server xml file you can disable the feature for individual virtual hosts or individua...

Page 32: ...r checks for active client connections The default interval is 60 seconds A client is disconnected the first time the server checks for idle connections if the client has exceeded the MaxIdleTime valu...

Page 33: ...o all the applications running in that virtual host Settings in an Application xml file in an application s folder for example rootinstall applications myApp Application xml apply only to that applica...

Page 34: ...s 3 which means that the default behavior is to distribute application instances to three core processes 3 Enter one of the following values for the Distribute element Value Description adaptor All ap...

Page 35: ...cified by the rollover value because rollover values are calibrated to the real clock time The duration of process 1 is partially determined by the current time when process 1 starts For example as sh...

Page 36: ...streams without running into performance issues The RAW file format records and plays back all streams that Flash Media Server supports including H 264 video data only audio only and so on 1 Open the...

Page 37: ...ml file for the adaptor you want to disable located in rootinstall conf 2 Locate the following XML RTMP RTMPE is the encrypted RTMP protocol covering both RTMPE and RTMPTE This is enabled by default s...

Page 38: ...ia Server 4 webroot SWFFolder prevents you from needing to maintain two copies of each SWF file Note If you re deploying an Adobe AIR application copy the SWF file you compiled into the AIR package to...

Page 39: ...lder or a semicolon delimited list of folders that contain copies of client SWF files These SWF files are used to verify connecting SWF files They are the verifying SWF files The default value is the...

Page 40: ...ng a positive value scans that number of subfolder levels Specifying zero scans the parent folder and no subfolders Specifying a negative value scans all subfolder levels The default value is 1 which...

Page 41: ...ver element or the AdminServer element for the Administration Server Server CrossDomainPath CrossDomainPath 2 Specify the location of the cross domain file in the CrossDomainPathElement for example Cr...

Page 42: ...OpenSSL libraries see TechNote 90293 Secure Sockets Layer SSL is a protocol for enabling secure communications over TCP IP Flash Media Server provides native support for both incoming and outgoing SSL...

Page 43: ...ty CA it must include the intermediate certificate as part of the certificate that the server returns to the client Your certificate file if signed by an intermediate CA should look something like the...

Page 44: ...or Ho4stPortList HostPort name edge1 ctl_channel 19350 ADAPTOR HOSTPORT HostPort HostPortList Adaptor 2 Create new HostPort elements with unique name and ctl_channel attributes and unique port values...

Page 45: ...teFile cert pem SSLCertificateFile SSLCertificateKeyFile private pem SSLCertificateKeyFile SSLPassPhrase SSLPassPhrase SSLCipherSuite ALL ADH LOW EXP MD5 STRENGTH SSLCipherSuite SSLSessionTimeout 5 SS...

Page 46: ...large number SSLSessionCacheGC How often to flush expired sessions from the server side session cache in minutes SSLVerifyCertificate A Boolean value specifying whether to verify the certificate retu...

Page 47: ...efault If you ve changed the default port configure the hardware to forward data on that port Configure RPCs Remote Procedure Calls Flash Media Server provides settings in the Application xml file for...

Page 48: ...tion file To enable virtual directories for server side File objects set the VirtualDirectoryForFile element s enable attribute to true in the Server xml file In the Application xml file add a Virtual...

Page 49: ...on level in the Vhost xml and Application xml files You can also override the logging interval at the vhost and application levels For more information see the comments in the XML files located in the...

Page 50: ...shortage problem on the Internet A system that only runs IPv6 can t communicate with a system that only runs IPv4 By default Flash Media Server runs in IPv4 mode even if the operating system is config...

Page 51: ...y the v6 entries would be displayed On IPv6 enabled Linux if you are using an host name that resolves to IPv4 host name with an RTMPT or RTMPTE connection configure the Adaptor xml appropriately to re...

Page 52: ...ment is application config dept The output is as follows My computer s name is jsmith01 My department is Engineering Note Server side ActionScript trace statements display in the Live Log panel of the...

Page 53: ...er create subfolders to create instances of applications For example the following path is to an instance of an application called my_application rootinstall applications my_application first_instance...

Page 54: ...and no other application files Use the StorageDir tag in the Application xml file to specify a different location to store streams or shared objects You could do this for vod applications For example...

Page 55: ...ns on the virtual host can access video files in the specified location although Adobe recommends that if you want control at the virtual host level you configure the VirtualDirectory tag in Vhost xml...

Page 56: ...mple Separating high and low bandwidth video One way you can use directory mapping is to separate storage of different kinds of resources For example your application could allow users to view either...

Page 57: ...edia Server includes Apache HTTP Server If you install and enable the web server you can deliver client SWF files container HTML pages and media assets from Flash Media Server You can serve content ov...

Page 58: ...x this issue configure MaxHeaderLineLength to 8192 Note By default the Apache HTTP header size limit is 8 KB 8190 bytes plus a carriage return 1 Open rootinstall conf Adaptor xml in a text editor 2 Ed...

Page 59: ...ile in a text editor If you have multiple adaptors open the file for the adaptor you want to configure The default Adaptor xml file is located in the rootinstall conf _defaultRoot_ folder Set the enab...

Page 60: ...Server version 2 2 15 documentation at www apache org The following keywords are reserved words open close send idle fcs fms crossdomain xml fpad Reserved words cannot be used for directory names unde...

Page 61: ...hat would require you to merge configuration files 2 Make sure the currently installed version of Apache is working correctly 1 Check the master log file for errors The master 00 log file should have...

Page 62: ...HTTP server In some cases the Apache server could be at fault for the Flash Media Server not running properly This is sometimes caused by syntax errors in the Apache configuration files Check the mas...

Page 63: ...add any logging directives All access requests are logged through the standard Apache HTTP Server log module All errors are logged in the Apache error_log file in the logs directory The following tab...

Page 64: ...ed file An unknown error occurs when processing a request where 1 is the URI string The module fails where 1 is the error code 2 is error description and 3 is the URI string Error occurs while packagi...

Page 65: ...2 HttpStreamingBootstrapMaxAge 2 HttpStreamingFragMaxAge 1 HttpStreamingDrmmetaMaxAge 3600 Options Indexes FollowSymLinks Location IfModule For live Apple HTTP Live Streaming add the following LoadMod...

Page 66: ...formation about ports see Using a third party web server on page 74 Configure HTTP Streaming failover In a real world clustered HTTP Streaming scenario you want your site to offer robust playback even...

Page 67: ...his failure the last successfully written fragment on Packager 2 was still 700 3 A short amount of time elapses in this case 10 fragment intervals 4 Packager 2 s encoder connection is restored and rem...

Page 68: ...at it caches for less than a fragment interval You can configure the HTTP error code as described in Configure live and on demand HTTP Streaming at the server level httpd conf Code the control plane a...

Page 69: ...the bootstrap has not been updated in specified number of seconds configurable as MaxBootstrapAge The global up element is set to true if all bootstrap up elements are true otherwise it is set to fal...

Page 70: ...vent works for both HDS and HLS streams You send this as an HTTP POST request with no request body Endpoint disable Result Upon receiving this request the control plane module creates a disabled file...

Page 71: ...sc Command executed successfully status desc stream stream name livestream1 status code 1 status code status desc Command executed successfully status desc stream controlplane response Disable a strea...

Page 72: ...le livepkgr _definst_ livestream f4m manifest file stream name livestream2 status code 1 status code status desc Command executed successfully status desc stream controlplane response Enable an event...

Page 73: ...e status desc Command executed successfully status desc stream controlplane response Enable a stream Description Enables a stream works for both HDS and HLS streams You send this as an HTTP POST reque...

Page 74: ...vent as done Description Signals that an event is complete You send this as an HTTP POST request with no body You signal an event as done so that the client is notified when content ends This achieves...

Page 75: ...y status desc stream controlplane response Mark a stream as done Description Signals that a stream complete You send this as an HTTP POST request with the stream name specified in the body You signal...

Page 76: ...tatus desc stream controlplane response Mark an event as in progress Description Signals that an event is still in progress You send this as an HTTP POST request with no body This request undoes a don...

Page 77: ...vestream3 status code 1 status code status desc Command executed successfully status desc stream controlplane response Mark a stream as in progress Description Signals that a stream is still in progre...

Page 78: ...a port set up Flash Media Server as the proxy put your web server on an unused port and change the fms ini HTTPPROXY_HOST setting to point to that port If you want your web server to serve the Flash...

Page 79: ...nger has a name and the other 2 bits are used for ECN Explicit Congestion Notification Edge routers and endpoints can make decisions on a per flow basis They mark the packets within the flow so that i...

Page 80: ...in the AuthMessage log file ECN part of diffserv will not get set for diffserv bits 50 and mask 255 Configure DiffServ in the Server xml file Use the DiffServ and DiffServMask elements in the Server x...

Page 81: ...fy method of the Authorization plug in Get operations Get bits in the following events E_CONNECT E_PLAY and E_STOP The get result on the F_CLIENT_DIFFSERV_MASK field always returns the value 0xFC Logg...

Page 82: ...s for uri s Unable to get DiffServ field Edge A socket is being used for multiple sessions and a session is trying to set the DSCP bits on a socket that already has DSCP bits set by another session De...

Page 83: ...From the NetConnection response packet until the NetStream Play Reset or NetStream Play Start packet whichever is sent first the bits are set to what was set in the E_CONNECT event From this point the...

Page 84: ...Use the Flash Media Server Administration API Reference to build your own administrative applications Connect to the Administration Console There are two types of administrators server administrators...

Page 85: ...ot save your password between sessions To log in to a virtual host that is not on the default adaptor you must specify the name of the adaptor For example when logging in to a virtual host on the adap...

Page 86: ...u and select a time duration Inspecting applications View applications After connecting to a server or virtual host the Administration Console displays a panel that lists the currently running applica...

Page 87: ...Administration Console on page 80 2 Click View Applications 3 Select the application from the list The following information is listed for the application on the different tabs Log messages generated...

Page 88: ...updated whenever the application instance generates a log message If the console refresh feature is paused log messages are still received Live Log panel 1 Follow the steps in Connect to the Administr...

Page 89: ...e client Type A string that describes the type of stream either stored live or NetStream 5 Select a stream to view its properties The values of the properties are as follows Name The actual stream nam...

Page 90: ...s only one data point to start with figures appear after the panel is open for 15 seconds Connection Time The date and time the client connected Messages In and Messages Out The number of messages sen...

Page 91: ...erty to AMF0 1 Follow the steps in Connect to the Administration Console on page 80 2 Click View Applications 3 Click Shared Objects 4 Select an application from the list 5 To display information abou...

Page 92: ...d The average number of messages video frames audio packets and command messages sent per second Bytes Per Second The average number of bytes sent per second for this application instance The Administ...

Page 93: ...l host administrator to access the Manage Users tab 1 Log in to the Administration Console as a server administrator 2 Select the Manage Users tab 3 Click New User 4 Enter the user name and password a...

Page 94: ...t from any domain UserList User name SERVER ADMIN_USERNAME Password encrypt false SERVER ADMIN_PASSWORD Password Allow Allow Deny Deny Order Allow Deny Order User User name vHostAdmin Password encrypt...

Page 95: ...e information about using the Administration API see Working with the Administration API on page 116 Managing the server Monitoring server performance You can review the performance of individual serv...

Page 96: ...server Ping the server to verify that it is running Restart the server or a virtual host Run garbage collection to clear unused server resources such as streams and application instances from memory A...

Page 97: ...cations running on the selected server or virtual host 1 Follow the steps in Connect to the Administration Console on page 80 2 Click Manage Servers 3 Click Applications 4 Select a server from the lis...

Page 98: ...icense 4 Enter the serial key number in the text boxes at the bottom of the Administration Console 5 Click Add Serial Key 6 Restart the server Note Serial numbers that are added manually that is added...

Page 99: ...whether the server logs events The Logging section also contains a Scope tag that determines whether the server writes separate log files for each virtual host or one file for the entire server The lo...

Page 100: ...d similar resource information You can use the status codes associated with specific events to troubleshoot event failures You can also use this information to determine which applications are used mo...

Page 101: ...ient pauses a stream but the server still sends data to the client so the player has enough data to play when the client unpauses This type of pause is called a smart pause Smart pause requires Flash...

Page 102: ...ream segment has loaded action application An action has occurred codec stream A codec has changed Authconnect authorization Client connects to server This event occurs if an Authorization plug in is...

Page 103: ...tion of the s uri field cs uri query The query portion of the s uri field c referrer URI of the referrer c user agent User agent c client id Client ID cs bytes This field shows the number of bytes tra...

Page 104: ...m bytes is not necessarily the same as the value of the QoS ByteCount property x service name Name of the service providing the connection only applicable to certain connection types x sc qos bytes Nu...

Page 105: ...ect publish unpublish play record record stop stop status_OK 200 Successful play stop status_transition 210 A transition between streams has occurred connect status_unavailable 302 Application current...

Page 106: ...e the last client disconnected disconnect gc_idle_client 432 Flash Media Server autoclose feature automatically closed the connection disconnect swf_hash_fail 433 SWF verification failure disconnect s...

Page 107: ...ation 00 log Fields in application logs disconnect js_exception 602 An unknown exception is thrown from the JS engine disconnect js_chunkstream_error 603 Bad application data disconnect js_debug_forbi...

Page 108: ...e is a two digit number representing the version of the log For a list of messages that appear in the diagnostic log files see Diagnostic logs on page 104 Fields in diagnostic logs Status categories i...

Page 109: ...N AND ADMINISTRATION Monitoring and Managing Log Files Last updated 11 28 2012 262 SMTP 263 Adaptor 264 JavaScript 265 TCApplication 266 TCConnector 267 Admin 268 SharedObject 269 Configuration 270 Vi...

Page 110: ...tart All Programs Adobe Adobe Flash Media Server 4 Stop Adobe Flash Media Administration Server 4 Choose Start All Programs Adobe Adobe Flash Media Server 4 Stop Adobe Flash Media Server 4 Start stop...

Page 111: ...lowing steps are accurate if you are working directly on the server To view the events from another Windows machine use Event Viewer to open a remote connection to the server 1 From the Windows Start...

Page 112: ...You cannot give the play and publish commands at the same time Example play foo 10 5 publish name duration record append Publishes files to the server This command must be used along with pubfile The...

Page 113: ...run query Allows you to input your own string for special purposes such as authentication Example rtmp host app inst foo abcd timeout sec Specifies a timeout value in seconds If the program does not...

Page 114: ...nt in the file Checking other video files Flash Media Server supports playback and recording of H 264 encoded video and HE AAC encoded audio within an MPEG 4 based container format A subset of the MPE...

Page 115: ...messages are as follows d duration Specifies the margin of error in seconds that FLVCheck reports The default is 2 seconds When validating metadata the absolute difference between metadata_duration a...

Page 116: ...runcated box The reported length of a box is longer than the remaining length of the file The file may have been truncated or the reported box length may be invalid 19 MP4 Duplicate box 20 MP4 Invalid...

Page 117: ...unsupported sample type Flash Media Server ignores will not play back tracks that are encoded with unsupported codecs 108 MP4 Invalid video codec This warning indicates that a track has an invalid vid...

Page 118: ...ce fmsmgr clearautostart Sets the Flash Media Administration service to start manually fmsmgr list Lists all the services installed including Administration services with additional information about...

Page 119: ...4 encoded string Use this option to encrypt credential passwords This option assumes that the string to scramble is already Base64 encoded The tool doesn t decode the string randCode number of bytes G...

Page 120: ...logged in to the _defaultRoot_ adaptor When logging in to a virtual host not on the default adaptor virtual host administrators must specify the name of the adaptor For example when logging in over RT...

Page 121: ...timestamp result Constructing an HTTP request string Many Administration APIs expect one or more parameters in addition to auser and apswd Parameters passed in an HTTP request must adhere to the follo...

Page 122: ...pass it the Administration API method a response object if needed and any parameters if needed ncAdmin call getAppStats new onGetAppStats vod The getAppStats method returns performance data for an app...

Page 123: ...localhost 1111 admin admin_name admin_pass Makes the API call for example getAppStats function doGetAppStats function onGetAppStats this onResult function info if info code NetConnection Call Success...

Page 124: ...n username and password to the request parameters When you run the example enter an application name in the TextInput control and click the Get App Stats button Default applications include live and v...

Page 125: ...800 width 359 s Application This application was written for Flex 4 If the call is successful the getAppStats method returns a result similar to the following result level status level code NetConnect...

Page 126: ...ttempts 0 swf_verification_attempts swf_verification_exceptions 0 swf_verification_exceptions swf_verification_failures 0 swf_verification_failures swf_verification_unsupported_rejects 0 swf_verificat...

Page 127: ...nadmin The password is stored in the Users xml file as a salted hash To reset the password see Delete administrator accounts and reset passwords on page 90 Adaptor xml file changes The default value o...

Page 128: ...trator Console password Password e206a5e1b52dcb4eaf024ca6adbe321b86cf0079bb747b78134ddaf8375e10aff905da0b28e84c5a Password Vhost xml file changes No changes Adaptor xml file The Adaptor xml file is th...

Page 129: ...ges are defined in HostPort elements in the HostPortList container Each edge can have different HTTPTunnel configurations Attribute name A name identifying an edge Use the name specified in the HostPo...

Page 130: ...0 443 This value instructs the adaptor to bind to any IP address on ports 1935 80 and 443 where 443 is designated as a secure port that will only receive RTMPS connections When assigning port numbers...

Page 131: ...stPort See also HostPortList HostPortList Container element The elements in this container list HostPort elements associated with this adaptor Example HostPortList HostPort name edge1 ctl_channel 1935...

Page 132: ...server responds to a special HTTP identification request before making a RTMPT connection true or not false This feature is enabled by default even if the HTTPIdent2 tag or the enabled attribute is mi...

Page 133: ...value of HTTPPROXY HOST in the fms ini file or replace the variable in the Adaptor xml file The following is from the default Adaptor xml file HttpProxy enable true maxbuf 16384 Host port 80 HTTPPROXY...

Page 134: ...osts to the server to indicate that Flash Player has no data to send The default settings for the IdleAckInterval and IdlePostInterval elements provide medium latency and are set to 512 512 millisecon...

Page 135: ...ximum number of requests Flash Player will allow to be pipelined The value must be greater than or equal to 1 The default value is 5 Example MaxPipelinedRequests 6 MaxPipelinedRequests MaxSize Specifi...

Page 136: ...n the cluster The ID must contain URL safe characters alphanumerical A Z a z and 0 9 and the special characters _ See also HTTPTunnel Order Specifies the sequence in which the server evaluates the All...

Page 137: ...equest on a newly accepted connection At any other time the request is considered an error and the connection is closed The maxbuf attribute determines how big the IO buffers are Flow control automati...

Page 138: ...ookies are currently supported only on Flash Player 9 0 28 or later in Windows only Example SetCookie false SetCookie See also NodeID SSL Container element The elements in this section configure the i...

Page 139: ...ute path to the key file is not specified it is assumed to be relative to the adaptor directory Example SSLCertificateKeyFile type PEM SSLCertificateKeyFile The type attribute specifies the type of en...

Page 140: ...eout SSLServerCtx Container element The elements in this section control the incoming SSL configuration for this adaptor Contained elements SSLCertificateFile SSLCertificateKeyFile SSLPassPhrase SSLCi...

Page 141: ...uccessfully verifiable This should not be used in a production deployment but can be useful for testing debugging purposes The default value is none The log attribute specifies whether or not to log w...

Page 142: ...on xml file is located in the application directory and specifies a different value than the default for an element that cannot be overridden it is ignored and the default is used If the default Appli...

Page 143: ...ngine AggregateMessages Client Specifies whether or not to send aggregate messages to clients When the enabled attribute is set to true the server will deliver aggregate messages to clients that suppo...

Page 144: ...ement configures the server to allow HTTP tunnelling connections into this application By default Flash Player communicates with the server using the RTMP protocol over port 1935 If that fails it will...

Page 145: ...his section specify the settings for audio streams on the server Contained elements CombineSamples SendSilence AutoCloseIdleClients Container element Contains elements that determine whether or not to...

Page 146: ...applications have access When this element is enabled all clients can access the audio data in streams in the specified folders To enable access to all audio data streamed by the server specify in th...

Page 147: ...s nested in this section to be overridden too Contained elements ClientToServer BandwidthCap ServerToClient BandwidthCap BandwidthDetection Container element This element contains settings for how the...

Page 148: ...0 5 BufferRatio See also Server Cache Container element contains elements that configure the cache setting for SWF verification MaxRate The maximum rate in Kbps at which the server sends data to the c...

Page 149: ...ial characters such as All parameters are surrounded by The server substitutes the actual names for everything specified within the By default the prefix is set to IP You can include the IP address in...

Page 150: ...lowing are available as checkpoint events connect continue play continue and publish continue Logging checkpoint events to the Access log is enabled in the Vhost xml file by default You can disable lo...

Page 151: ...that no customer abuses the bandwidth limit For example a customer can set any bandwidth limit for their applications but cannot exceed the caps set by the ISP Example ClientToServer 1250000 ClientTo...

Page 152: ...s in the Event xml ContentProtection section can override the ContentProtection section in the Application xml file HDS This section controls the behavior of HTTP live recording Recording ContentProte...

Page 153: ...lank which allows all protocols to connect to the server Distribute Specifies how to distribute application instances to processes The default value is insts meaning each application instance runs in...

Page 154: ...seconds to wait before it notifies the client when the audio has stopped in the middle of a live or recorded audio stream The default wait time is 3 seconds The minimum wait time is 1 second There is...

Page 155: ...and generated in Flash Player 9 Update 3 or later The default value is true The server does not insert keyframes and all seeks begin at the nearest existing keyframe Example EnhancedSeek true Enhance...

Page 156: ...imeout This element defines the maximum amount of time that a client can use to provide its final verification to the server See also SWFVerification FirstHashTimeout This element defines the maximum...

Page 157: ...for configurations for HTTP Dynamic Streaming Contained Elements Recording HDS on page 172 ContentProtection on page 148 HiCPU This element instructs the server to start combining samples when CPU uti...

Page 158: ...control the polling frequency on a per client basis Selecting too small a delay value for the above parameters will increase the polling frequency and reduce network performance and efficiency Selecti...

Page 159: ...al for an idle post ranges from 0 to 4064 milliseconds If the IdlePostInterval element is set to a value that lies outside of this range the default value of 512 milliseconds is used Note At times the...

Page 160: ...ability Container element The elements nested within this container configure the JavaScript engine Inside the JSEngine element you can define properties for the server side Application object Definin...

Page 161: ...example a 15 second video with a file size of 76 KB is increased only to 89 KB when the KeyFrameInterval element is set to 5000 which is an increase of 13 KB or 17 The same video has a size of 109 KB...

Page 162: ...e loaded at start up Example LoadOnStartup false LoadOnStartup See also Process MaxAppIdleTime JSEngine StreamManager LockTimeout Specifies the timeout value before automatically unlocking a shared ob...

Page 163: ...AccumulatedIFrames MaxAppIdleTime Specifies the maximum time an application instance can remain idle with no clients connected before it is unloaded from the server s memory An application instance is...

Page 164: ...MaxDuration Specifies the maximum duration in seconds of a recorded file The value 0 disables recording The value 1 means there is no maximum duration The default value is 1 Set this parameter when y...

Page 165: ...leObject XMLSocket NetConnection ScriptEngine MaxFailures The value of this element determines the maximum number of core process failures that can occur before a core process is disabled Once the cor...

Page 166: ...ages for screen sharing packets Example MaxMessageSizeLosslessVideo 0 MaxMessageSizeLosslessVideo See also OutChunkSize AccumulatedIFrames Access UserAgent MaxPendingDebugConnections Specifies the max...

Page 167: ...alue of 1 sends the data at whatever rate is necessary to measure bandwidth without throttling Example MaxRate 1 MaxRate See also DataSize MinBufferTime Live MaxSamples Specifies how many sound sample...

Page 168: ...their applications but cannot exceed the MaxSizeCap set by the ISP Note The F_STREAM_RECORD_MAXSIZE field in the Authorization plug in can override this value See also MaxSize Recording MaxDuration Ma...

Page 169: ...execution is terminated Setting a maximum time to execute a script prevents infinite looping in scripts The default value is 0 and no checks are performed to detect runaway scripts This setting may be...

Page 170: ...MaxWait See also MaxRate DataSize MimeType Specifies the default MIME Multi purpose Internet Mail Extensions type header sent on tunnel responses The server generally uses the MIME type specified by t...

Page 171: ...uffer setting there are enough messages to begin playback quickly Setting this value to less than 64 may cause content with a low FPS to delay before starting The default value is 64 See also Server M...

Page 172: ...ver 4 NotifyAudioStop Container element The Duration element nested within this container determines whether or not the server is notified when an audio transmission ending on a stream is encountered...

Page 173: ...able to take over the ownership of a live stream when the stream is already published by another client The default value is false If set to true add application logic to avoid stream name collision...

Page 174: ...ritization is set to false which is the correct setting to avoid possible latency when server side NetStream objects are used to publish messages to remote servers Messages are sent out through one ch...

Page 175: ...is tag is applicable when using the Authorization plug in When a client requests to play a stream an E_FILENAME_TRANSFORM event occurs in the Authorization plug in You can map the stream differently f...

Page 176: ...me Recorded Recording HDS Container for configurations for HTTP Dynamic Streaming Contained Elements ContentProtection on page 148 Recording StreamManager Container element The elements nested within...

Page 177: ...eDir DuplicateDir LockTimeout AutoCommit MaxProperties MaxPropertySize Reuse This element configures whether or not the server explicitly closes the HTTP connection after each transfer The default is...

Page 178: ...a significant amount of memory you must increase the engine size If you create a new script object that will cause the runtime size of the application instance to exceed the value of this element an...

Page 179: ...e corresponds to the tag s name and the property value corresponds to the tag s contents Example The following XML fragment defines the properties user_name and dept_name with the values jdoe and engi...

Page 180: ...element Example ScriptLibPath APP JS_SCRIPTLIBPATH ScriptLibPath See also RuntimeSize MaxGCSkipCount MaxTimeOut JSEngine and ScriptEngine FileObject XMLSocket NetConnection ScriptEngine Security Cont...

Page 181: ...fies whether to prioritize outgoing messages for server to server connections Contained elements BufferRatio Prioritization ServerToClient Bandwidth Specifies the bandwidth in bytes per second that th...

Page 182: ...BandwidthCap SharedObject Lets you list methods allowed for SharedObject RPCs Any method not explicitly listed here is blocked If a client subscribes to a remote SharedObject and tries to call remote...

Page 183: ...nly if the files for shared objects or recorded streams must be stored in a location other than the application directory Example StorageDir C myapp sharedobjects StorageDir StorageDir C myapp streams...

Page 184: ...t is the application s folder appended with SWFs Use a semicolon to separate multiple directories SWF files located under an instance named folder can only connect to that specific instance Example Fo...

Page 185: ...4 ThrottleDisplayInterval See also ThrottleBoundaryRequest ThrottleLoads ThrottleLoads Controls the maximum number of concurrent segment loads per recorded stream When streaming through a proxy server...

Page 186: ...dAuth true UnrestrictedAuth See also Allow Max UpdateInterval Specifies the maximum time in minutes to wait for the server to scan the SWF folders for updates when there is a miss in the cache The def...

Page 187: ...l video data streamed by the server specify in the tag The folder path is restricted to the application s streams folder or folders so do not use absolute paths in the list of folders While you can al...

Page 188: ...information see comments in the Application xml file and Mapping virtual directories to physical directories on page 51 See also FileObject WindowsPerAck Controls how many messages can be sent before...

Page 189: ...other than English the name is written in that language even if the server is running on an English language operating system The Logging section in the Server xml file enables or disables the log fi...

Page 190: ...s nested within this container configure the core log settings Contained elements LogServer Delimiter Specifies whether or not to use a single quotation mark as a delimiter to separate the fields in t...

Page 191: ...ields QuoteFields edge Container element The elements nested within this container configure the edge log settings Contained elements LogServer EscapeFields Formatting element This element controls wh...

Page 192: ...on page 98 Not every field is associated with each event in the log file See also Events FileIO Container element The elements in this section configure the settings for the File plug in log file sett...

Page 193: ...rt xxx xxx xxx xxx 1234 HostPort See also ServerID DisplayFieldsHeader Logger Root element The Logger element is a container for all the other elements in Logger xml LogServer Container element The el...

Page 194: ...named application 02 log and so on when it is time to rotate the log files This occurs until the maximum history setting is reached The log file with the highest version number keeps the oldest log hi...

Page 195: ...rt DisplayFieldsHeader Time The Timefield in a log file can be logged either in UTC GMT or local time Valid values are utc gmt or local The setting for the Time element can be used to override the ser...

Page 196: ...handling services for Flash Media Gateway This FMSCore process comes to life on start up and allows Flash Media Gateway to register its services to Flash Media Server Enable this registry core only w...

Page 197: ...Server from any domain or IP address This potential security risk can be managed by the Allow element Permissible administrator connections are detailed as a comma delimited list of host names domain...

Page 198: ...time specified in MaxAppIdleTime in Application xml AudioAutoBufferReadSize The server caches F4V MP4 video audio and other data in memory Caching data allows the server to make fewer disk reads and t...

Page 199: ...ual hosts in the Vhost xml files or for individual applications in Application xml The values defined in the Server xml configuration file apply to all clients connected to the server unless the value...

Page 200: ...Timeout element and HTTP ConnectionTimeout element specify how long to wait before timing out an outgoing connection in milliseconds The default is 1 which uses the OS timeout to block outgoing connec...

Page 201: ...erflowBuckets CoreExitDelay Specifies how much wait time in seconds an idle core is given to exit on its own before it is removed from the server The default wait time is 20 seconds Example CoreExitDe...

Page 202: ...which allows clients from all domains to access the server This element is nested within both the Server element and the AdminServer element Use it for both edge and administration server requests Ex...

Page 203: ...There is little use for this unless you have set up a DSCP domain Also some values may lead to errors depending on your platform and your router configuration For example to set priority class 4 you m...

Page 204: ...ol the IPC interprocess communication message queue used by edge and core processes to communicate with each other Contained elements HeapSize MaxQueueSize Enable Server xml uses Enable elements in th...

Page 205: ...n the FLVCache container Specifies in seconds how often the server reloads the video segment in the cache when there is a file change The default value is 120 seconds The minimum value is 1 second The...

Page 206: ...ed Use this setting to configure the cache for optimal memory use If you are receiving cache full events in the core log file or want to increase the chance that streams will find the information need...

Page 207: ...alQueue container control the IPC message queue used by all processes to communicate with each other Contained elements HeapSize MaxQueueSize GlobalRatio Located in the MessageCache SmallMemPool Large...

Page 208: ...Flash Media Administration Server which in turn connects to Flash Media Server Example HostPort ip port HostPort See also AdminServer HTTP Container element The elements nested within the HTTP contain...

Page 209: ...an NT service If a value for Service is present n Service is appended to both commands Linux ignores this section of the command Contained elements Directory Program Options Service IdleTime Located...

Page 210: ...e Administration Console can be deleted using the Administration Console Example LicenseInfo SERVER LICENSEINFO LicenseInfo LicenseInfoEx Contains license keys added using the Administration Console L...

Page 211: ...file in that language even if the server is running on an English language operating system Contained elements Time RecordsNumber RetryNumber RetrySleep Access Diagnostic Application AuthEvent AuthMe...

Page 212: ...y positive integer The default value is 65536 Example MaxAggMsgSize 65536 MaxAggMsgSize See also Raw MaxAudioSampleDescriptions Located in the Recording container Each change in codec for a content ty...

Page 213: ...ner accepts You can set a fractional maximum connection rate such as 12 5 A value of 0 or 1 disables the feature This is a global setting for all socket listeners If the element is set to 10 connectio...

Page 214: ...ues If more gaps or appends occur than the value specified in the MaxELSTEntries tag recording ends However setting this value too high takes up unnecessary space in each recorded file The default val...

Page 215: ...MaxInitDelay 5 MaxInitDelay See also SWFVerification MaxIOThreads Located in the RTMP Connector Edge Core Admin ECCP and ACCP containers Specifies the maximum number of threads that can be created for...

Page 216: ...the value of MaxNumberofRequests Once MaxNumberofRequests is reached subsequent requests are rejected By default Flash Media Server does not count the number of requests made to the File plug in or re...

Page 217: ...The default value is 100 handles Example MaxSize 100 MaxSize MaxSize RecBuffer Located in the RecBuffer container Specifies the maximum size to which the buffer can grow before messages are committed...

Page 218: ...trict the URL lengths of incoming requests To restrict the length of outbound NetConnection URLs from SSAS use the MaxUrlLength element in the Application xml file Example MaxUrlLength 65536 MaxUrlLen...

Page 219: ...Specifies the minimum accepted version of SWF verification feature that the server allows The default value of 0 accepts current and all future versions Example MinGoodVersion 0 MinGoodVersion MinIOT...

Page 220: ...ersion 6 IPv6 This is an empty tag The operating system network stack should be configured to support IPv6 if desired Flash Media Server automatically detects the operating system configuration this e...

Page 221: ...inimum size is 1024 bytes The default value is 1024 bytes Playback Container element The Playback elements configure how the server plays back MP4 F4V MOV and other MP4 file types Contained elements V...

Page 222: ...the executable file for the web server The default value is bin httpd Protocol Container element Flash Media Server receives connections through various protocols The elements in this container confi...

Page 223: ...this time you cannot edit these files with third party tools or convert the files to FLV format or MP4 format Availability Flash Media Server 4 Contained elements MaxAggMsgSize raw See also Streams R...

Page 224: ...registry core to activate a single FMSCore instance dedicated to handling services for Flash Media Gateway This FMSCore process comes to life on start up and allows Flash Media Gateway to register it...

Page 225: ...iner element This container holds the elements that configure RTMP Real Time Messaging Protocol for communication between Flash Remoting and Flash Media Server The following reference table lists the...

Page 226: ...ty Description Container element The elements in this section configure server security Contained elements LogInLimits MaxUrlLength VirtualDirectoryForFile Availability Flash Media Server 4 SegmentsPo...

Page 227: ...an NT service Services Container element The elements in this section control the IPC message queue used by the edge and core processes to communicate with each other Contained elements HeapSize MaxQu...

Page 228: ...em default values You should explicitly set this value only if you have a very high bandwidth connection that requires a large socket buffer Setting a high value significantly increases the amount of...

Page 229: ...sort ciphers by strength from highest to lowest level of encryption Important Contact Adobe Support before changing the default settings The cipher list consists of one or more cipher strings separat...

Page 230: ...is sequencing allows clients to negotiate for the strongest cipher that both they and the server can accept SSLCipherSuite ALL HIGH MEDIUM LOW EXP NULL SSLCipherSuite This string instructs the server...

Page 231: ...thing less than 8 bytes and the default is 16 Entropy is a measure of randomness The more entropy the more random numbers from the PRNG will be Encryption methods Description eNULL No encoding DES DES...

Page 232: ...accept If a self signed root certificate cannot be found within this depth certificate verification fails The default value is 9 Example SSLVerifyDepth 9 SSLVerifyDepth StreamAdaptors Specifies which...

Page 233: ...ined by the flv sub element is matched by Flash Media Server internally to determine which library to use to process the stream Example flv lib libflv f4f lib libf4f mp3 lib libmp3 mp4 lib libmp4 raw...

Page 234: ...ault is CRLF carriage return and line feed Example TerminatingCharacters CRLF TerminatingCharacters ThreadPoolGC Located in the ResourceLimits container Specifies in minutes how often Flash Media Serv...

Page 235: ...es the maximum time in minutes to wait for the server to scan the SWF folders for updates when there is a miss in the cache The default value is 5 minutes UserDefined Container element Define elements...

Page 236: ...o identify Flash Media Server administrators and set their access permissions Edit this file to set permissions for Administration API calls to Flash Media Administration Server To see the element str...

Page 237: ...uses two elements named Deny the Deny element in the User container and the Deny element in the HTTPCommands container This Deny element lists the Flash Media Administration Server commands that an a...

Page 238: ...ed over HTTP in a comma delimited list When finished restart the server Contained elements Enable Allow HTTPCommands Deny HTTPCommands Order HTTPCommands Order HTTPCommands Flash Media Server uses two...

Page 239: ...le Password e206a5e1b52dcb4eaf024ca6adbe321b86cf0079bb747b78134ddaf8375e10aff905da0b28e84c5a Password See also Allow User Deny User Order User PasswordPolicy You can use PasswordPolicy element to enab...

Page 240: ...virtual host must be mapped to a DNS domain name server entry or another name resolution such as a WINS address or a hosts file that specifies an IP address on the server computer Each adaptor must c...

Page 241: ...t you wish to connect by simply specifying abc then specify the alias abc Keep in mind that abc must still map to the same IP address as abc adobe com If more than one virtual host on the same adaptor...

Page 242: ...umber of an anonymous server is hidden from the client The anonymous proxy does not change or modify the routing information in the incoming URI before connecting the client s to the origin server The...

Page 243: ...Server 4 applications In Linux the default location is opt adobe fms applications Note If you use this tag to map to a network drive see Mapping directories to network drives on page 50 for additiona...

Page 244: ...ll clients connected to the server unless the values are defined in the Vhost xml file The Vhost xml values override the Server xml values Example AutoCloseIdleClients enable false MaxIdleTime 600 Max...

Page 245: ...configure edge autodiscovery An edge server may connect to another server that is part of a cluster In this case the edge server tries to determine which server in the cluster it should connect to may...

Page 246: ...nformation see the Client virtualKey and Stream setVirtualPath entries in the Server Side ActionScript Language Reference For more information see the Configuring content storage section of the Config...

Page 247: ...arate instance of the application on the server The default number is 15 000 application instances A Flash SWF file defines which application instance it is connecting to by the parameters it includes...

Page 248: ...element in the Server xml file Example MaxIdleTime 3600 MaxIdleTime See also AutoCloseIdleClients MaxSharedObjects Specifies the maximum number of shared objects that can be created The default number...

Page 249: ...tion of the disk content will be deleted at any one time but also that files will need to be moved to new buckets more often which results in more disk activity and lower performance You can define th...

Page 250: ...essages RequestTimeout RequestTimeout The maximum amount of time in seconds the server waits for a response to a request from an upstream server A request can be for metadata content and so on This va...

Page 251: ...any host on any port to the same host on port 80 RouteEntry 80 RouteEntry The example instructs the server to route a host port combination to null Its effect is to reject all connections destined for...

Page 252: ...er uses the default values for SSL in the Server xml file to configure the connection If the SSL elements in an edge s Vhost xml file are not present Flash Media Server uses the default values specifi...

Page 253: ...d SSLv3 represents all SSL v3 algorithms Lists of cipher suites can be combined in a single cipher string using the character as a logical and operation For example SHA1 DES represents all cipher suit...

Page 254: ...v2 ciphers come after SSLv3 ciphers SSLCipherSuite ALL SSLv2 SSLCipherSuite The following is the complete list of components that the server can evaluate Key exchange algorithm Description kRSA Key ex...

Page 255: ...You can specify multiple virtual directory mappings for streams by adding additional Streams elements one for each virtual directory mapping For more information see the Configuring content storage s...

Page 256: ...irectories see Mapping virtual directories to physical directories on page 51 You can use the VirtualDirectory element in conjunction with the VirtualKeys element to serve content based on Flash Playe...

Page 257: ...ained elements Key WaitTime Specifies length to wait in milliseconds for edge autodiscovery The number must be long enough to establish a TCP connection perform a UDP broadcast collect the UDP respons...

Reviews:

No comments