MACROMEDIA FLASH MEDIA SERVER 2-SERVER-SIDE ACTIONSCRIPT LANGUAGE Manuale Utente Pagina 1

Managing Flash Media Server

10 About This Manual

100 Configuration FilesSee alsoACCP, Admin, ECCP, Edge, HTTP, RTMP (Protocol) containersCoreGCThis tag specifies how often to check for and remove idl

XML configuration files 101DenyThis tag specifies which automatic proxy discovery messages Flash Media Server does not respond to.DescriptionThis tag

102 Configuration FilesContained tagsMinIOThreads, MaxIOThreads, SocketOverflowBuckets, SocketTableSizeSee alsoACCP, Admin, Core, ECCP, HTTP, RTMP (Pr

XML configuration files 103Enable (AutoDiscovery)Server.xml uses four tags named Enable: the Enable tag in the AutoDiscovery container and the Enable

104 Configuration FilesSee alsoFreeRatioFreeRatioLocated in the LargeMemPool, MessageCache, SegmentsPool, and SmallMemPool containers.DescriptionThis

XML configuration files 105GlobalRatioLocated in the LargeMemPool, MessageCache, SegmentsPool, and SmallMemPool containers.DescriptionThis tag specifi

106 Configuration FilesSyntax<HostPort>[<ip>][:<port>]</HostPort>HTTPContainer tag.DescriptionThe tags nested within the HTTP

XML configuration files 107DescriptionThe tags nested within the LargeMemPool container configure the large memory pool, which caches large chunks of

108 Configuration FilesMaskA three-digit octal value used by the Linux umask (user permissions mask) command to set a file creation mask. The user mus

XML configuration files 109DescriptionThis tag defines the maximum size of the cache in megabytes. The default is 100 MB.See alsoMaxCacheUnitsMaxCache

111CHAPTER 1Managing the ServerAs a Flash Media Server administrator, you’ll need to perform several administrative tasks after the server is installe

110 Configuration FilesMaxIOThreadsLocated in the ACCP, Admin, Core, ECCP, Edge, HTTP, and RTMP (Connector) containers.DescriptionThis tag specifies t

XML configuration files 111MaxUnitSizeLocated in the LargeMemPool, MessageCache, SegmentsPool, and SmallMemPool containers.DescriptionThis tag specifi

112 Configuration FilesDescriptionThis tag specifies the minimum number of threads in the pool for I/O operations. The default is 1 times the number o

XML configuration files 113MyZoneThis tag specifies the zone that the edge or proxy server belongs to when it broadcasts a FPAD message. The message i

114 Configuration FilesExamples<Allow>foo.macromedia.com,10.41.1.55</Allow><Deny>all</Deny><Order>Deny,Allow</Order&g

XML configuration files 115Contained tagsACCP, ECCP, RTMP (Protocol) containersProxyInfoThis tag specifies the host (or IP) and port to return to the

116 Configuration FilesRTMP (Connector)Flash Media Server uses two container tags named RTMP: one nested within the Connector container, and the other

XML configuration files 117See alsoRTMP (Connector) in Connector container.ScopeThis tag determines whether to write a separate log file for each virt

118 Configuration FilesContained tagsAdminServer, AutoDiscovery, Logging, Mask, Process, ResourceLimits, and SSL containers ServerDomainThis tag speci

XML configuration files 119SocketGCDescriptionThis tag specifies in seconds how often Flash Media Server checks for and removes inactive sockets.The d

12 Managing the ServerYou can configure Flash Media Server 2 as an origin or edge server, configure adaptors and virtual hosts and change the location

120 Configuration FilesThe following is a quick-start to enable SSL connections with Flash Media Server. Specify the location of the certificate in t

XML configuration files 121To import these certificates, run FMSmaster > Console > Initialize [directory]. This action imports all current certi

122 Configuration FilesThe cipher list consists of one or more cipher strings separated by colons. Commas or spaces are also acceptable separators but

XML configuration files 123These cipher strings instruct Flash Media Server to accept only RSA key exchange, and refuse export or null encryption. The

124 Configuration FilesHere is the complete list of components that Flash Media Server can evaluate:Key Exchange Algorithm DescriptionkRSA Key exchang

XML configuration files 125SSLClientCtxContainer tag.DescriptionThe tags in this section configure Flash Media Server to perform as an SSL client for

126 Configuration FilesDescriptionEntropy is a measure of randomness. The more entropy, the more random are the numbers that the PRNG will generate. T

XML configuration files 127See alsoSSLVerifyDepthSSLVerifyDepthThis tag specifies the maximum depth in the certificate chain from which Flash Media Se

128 Configuration FilesSee alsoClusterMonitorIntervalUIDThis tag contains the server process user ID. DescriptionIf no UID or group ID (GID) is specif

XML configuration files 129Users.xml fileUsers.xml is the configuration file for the Flash Media Admin Service users and is located at the root level

Basic server settings 13To edit the <AppsDir> tag in the Vhost.xml file:1. Locate the Vhost.xml file for the virtual host you are working with.

130 Configuration FilesDescription of Users.xml tagsThe following alphabetical list of Users.xml tags contains additional information, including cross

XML configuration files 131DescriptionThis tag lists the Flash Media Admin Service commands that the administrator can access using HTTP. You can auth

132 Configuration FilesDescriptionThis Deny tag lists the Flash Media Admin Service commands that an administrator cannot use via HTTP. You can deny a

XML configuration files 133HTTPCommandsContainer tag.DescriptionThis section contains the settings for those Flash Media Admin Service commands that c

134 Configuration FilesThe default sequence Allow, Deny means that administrative access is allowed unless the user is specified in the Allow list of

XML configuration files 135UserListContainer tag. DescriptionThe UserList tag defines the access permissions for administrators that use the Flash Med

136 Configuration Files<Events>connect;disconnect;play;pause;unpause;stop</Events><Fields>x-category;x-event;date;time;x-pid;c-ip;cs

XML configuration files 137Description of Logger.xml tagsThe following alphabetical list of Logger.xml tags contains additional information, including

138 Configuration FilesContained tagsDelimiter, EscapeFields, Events, Fields, FileName, LogServer, QuoteFields, Rotation, TimeApplicationContainer tag

XML configuration files 139Contained tagsDirectory, Rotation. TimeDirectoryThis tag specifies the directory where the log files are located.Descriptio

14 Managing the ServerDeploying server-side scripts In developing applications for Flash Media Server, you may decide to use server-side scripts to im

140 Configuration FilesDescriptionThe following table lists the events recorded in the Access log file. Events are logged in a semicolon-separated lis

XML configuration files 141See alsoFields400 Bad request; client connected to server using an unknown protocol.401 Connection rejected by the applicat

142 Configuration FilesFieldsThis tag specifies which fields for an event are logged in the Access log file.DescriptionFields are associated with the

XML configuration files 143The following table is a complete list of fields associated with events in the Access log file. Not every field is associat

144 Configuration Filessc-bytes application This field shows the number of bytes transferred from the server to the client. This information can be us

XML configuration files 145See alsoEventsFileNameThis tag specifies the name of the Access log file.DescriptionThe Access log file name includes a dat

146 Configuration FilesLoggerRoot tag.DescriptionThe Logger tag is a container for all the other tags in Logger.xml.LogServerContainer tag.Description

XML configuration files 147RotationContainer tag.DescriptionThe tags in this section configure the rotation of the log files.Located in Access, Applic

148 Configuration FilesTimeThe Time field in a log file can be logged either in UTC (GMT) or local time. DescriptionThe setting for the Time tag can b

XML configuration files 149<SetCookie></SetCookie><Redirect enable=”false” maxbuf=”16384”></Redirect><NeedClose></Nee

Basic server settings 154. In the Services list, scroll down and select Flash Media Server.5. Click the Stop button at the top of the control panel. T

150 Configuration FilesIdleAckIntervalSpecifies the maximum time the server may wait before it returns an ack (acknowledgement code) for a client idle

XML configuration files 151Description of Adaptor.xml tagsThe following alphabetical list of Adaptor.xml tags contains additional information, includi

152 Configuration FilesDenyThis tag identifies the hosts whose clients’ attempts to connect to the server(s) will be rejected.DescriptionThe Deny tag

XML configuration files 153SyntaxThe connection string for the HostPort tag has the following syntax:<HostPort><ip>:<port>,<port&

154 Configuration FilesSee alsoHostPortListHostPortListThis tag contains a list of HostPort tags associated with this adaptor.Example<HostPort secu

XML configuration files 155Accept-Encoding: gzip, deflate..User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1)..Host: localhost:1935..

156 Configuration FilesIdleAckIntervalThis tag specifies the maximum time the server may wait before it sends back an ack (acknowledgement code) for a

XML configuration files 157MaxFailuresThis tag specifies the maximum number of failures an edge server may incur before it restarts. DescriptionDefau

158 Configuration FilesMimeTypeThis tag specifies the default MIME (Multipurpose Internet Mail Extensions) type header sent on tunnel responses.Descri

XML configuration files 159The alternative sequence Deny,Allow indicates that access to a server is allowed unless specified in the Deny tag and not s

16 Managing the ServerUsing the management consoleThe management console for the Flash Media Server 2 release has been redesigned to ease the workflow

160 Configuration FilesThis example instructs Flash Media Server to redirect unknown requests to the specified redirect host. <Host port="443&

XML configuration files 161The following is a quick-start to allowing SSL-enabled connections to Flash Media Server. Go to the SSL section of the Ada

162 Configuration FilesSee alsoSSLPassPhraseSSLCipherSuiteThis tag specifies the suite of encryption ciphers that Flash Media Server uses to secure in

XML configuration files 163SSLServerCtxContainer tag.DescriptionThe tags in this section control the SSL configuration for this adaptor.Contained tags

164 Configuration FilesVhost.xml fileThe Vhost.xml configuration file defines an individual virtual host in Flash Media Server. Each virtual host dire

XML configuration files 165<GlobalRatio>0.4</GlobalRatio><MaxAge>1000000</MaxAge><UpdateInterval>1024</UpdateInterval

166 Configuration FilesSummary of Vhost.xml tagsThe following list alphabetically displays the tags in the Vhost.xml configuration file. Vhost.xml tag

XML configuration files 167MaxStreamsSpecifies the maximum number of streams that can be created.MaxUnitSizeSpecifies the size threshold for messages

168 Configuration FilesDescription of Vhost.xml tagsThe following alphabetical list of Vhost.xml tags contains additional information, including cross

XML configuration files 169If more than one virtual host on the same adaptor has been defined with the same alias, then the first match that is found

Using the management console 17 View application logs. View logs of server connections and other server events. View streams and inspect shared obj

170 Configuration FilesAnonymousThis tag configures the virtual host as an anonymous proxy (also called an implicit or transparent proxy) or as an exp

XML configuration files 171AppInstanceGCThis tag specifies how often to check for and remove unused resources for application instances, such as Share

172 Configuration FilesThe default location is the cache folder in the server installation directory. Syntax<CacheDir enabled="false">

XML configuration files 173FreeRatioLocated in LargeMemPool, MessageCache, SegmentsPool, and SmallMemPool containers.This tag specifies the percentage

174 Configuration FilesLocalAddressThis tag binds a proxy's outgoing connection to a specific local IP address. DescriptionThe LocalAddress tag l

XML configuration files 175MaxCacheUnitsLocated in LargeMemPool, MessageCache, SegmentsPool, and SmallMemPool containers.This tag specifies the maximu

176 Configuration FilesMessageCacheContainer tag.DescriptionThis section contains the tags that control how the message cache holds onto messages used

XML configuration files 177ProxyContainer tag.DescriptionThe tags nested in this section configure this virtual host as a proxy server that can forwar

178 Configuration FilesDescriptionProxies or edge servers are configured with the RouteEntry tag to direct connections to another destination. The Rou

XML configuration files 179RouteTableContainer tag.DescriptionThe RouteEntry tags nested under the RouteTable tag specify the routing information for

18 Managing the Server2. Enter the name and address of the server or virtual host you want to connect to. You can enter localhost, which will refer t

180 Configuration FilesSegmentsPoolContainer tag.DescriptionThe tags nested within this container configure how the segments pool caches segments of F

XML configuration files 181 If the SSL tags in the Vhost.xml file override the SSL tags in the Server.xml file, Flash Media Server uses the SSL tags

182 Configuration FilesSyntaxvirtualDirectory;actualDirectoryThe Streams tag allows you to specify a virtual directory for stored stream resources use

XML configuration files 183Example<VirtualDirectory><Streams key="A">foo;c:\streams\on2</Streams><Streams key="B&q

184 Configuration FilesSyntax<VirtualDirectory><Streams>key-value;virtual path;directory</Streams></VirtualDirectory>You speci

XML configuration files 185VirtualKeysThis tag sets the virtual key mappings for the different versions of Flash Player connecting to Flash Media Serv

186 Configuration FilesEach virtual host can contain multiple Application.xml files. The Application.xml file in the virtual host directory configures

XML configuration files 187<StreamManager><StorageDir></StorageDir><DuplicateDir></DuplicateDir><CachePrefix></

188 Configuration Files<Bits></Bits></UserAgent></Client><HTTP><HTTP1_0></HTTP1_0><Verbose></Verbos

XML configuration files 189BandwidthContainer tag; contains tags to configure the bandwidth settings for server-client communications.BandwidthCapCont

Managing applications 19Setting the refresh rateThe management console provides live performance data on the server. You can use the Refresh Rate pop-

190 Configuration FilesHTTP1_0Allows or disallows use of the HTTP 1.0 protocol.HTTPTunnelContainer tag; contains tags to configure HTTP tunneling.Idle

XML configuration files 191MimeTypeSpecifies the default MIME-type header sent on tunnel responses.NotifyAudioStopSpecifies whether Flash Media Server

192 Configuration FilesDescription of Application.xml tagsThe following alphabetical list of Application.xml tags contains additional information, inc

XML configuration files 193AllowHTTPTunnelThe tag configures Flash Media Server to allow HTTP tunneling connections into this application. Descriptio

194 Configuration FilesAutoCommitShared Objects are automatically committed when they have been changed.DescriptionSetting this tag to false disables

XML configuration files 195See alsoBandwidthBitsThis tag contains the settings for Flash Player on the Windows and Macintosh platforms.Examples<Bit

196 Configuration FilesBy default, the prefix is set to ?IP?You can include the IP address in the prefix to avoid file collision. For example, the pro

XML configuration files 197ClientContainer tag.DescriptionThe tags nested within this container configure the client. DescriptionBy default, the Clien

198 Configuration FilesCombineSamplesContainer tag.DescriptionFlash Media Server conserves system resources by combining sound samples. This strategy

XML configuration files 199DuplicateDir (StreamsManager)This is one of two tags named DuplicateDir in the Application.xml file.Located in StreamManage

TrademarksAfterburner, AppletAce, Attain, Attain Enterprise Learning System, Attain Essentials, Attain Objects for Dreamweaver, Authorware, Authorware

20 Managing the Server A user debugging another application now desires to see the contents of a shared object that they have implemented in their ap

200 Configuration FilesFileObjectContainer tag.DescriptionThe VirtualDirectory tag nested within this container configures the JSEngine file object se

XML configuration files 201Example<Host>myserver:8080</Host>To specify the port number in this string, add :[port] to the end of the host

202 Configuration FilesThe Application.xml configuration file offers three representative settings for these parameters. These settings recommend that

XML configuration files 203The interval for an idle post ranges from 0 to 4064 milliseconds. If the IdlePostInterval tag is set to a value that lies o

204 Configuration FilesKeyFrameIntervalThis tag defines how often to generate and save keyframes in an FLV file. DescriptionSetting this tag to a high

XML configuration files 205DescriptionHaving an application instance loaded at server startup saves time when the first client connects to that applic

206 Configuration FilesMaxCoresThe value for this tag determines how many core processes can exist for an application. DescriptionBy default, the Max

XML configuration files 207DescriptionThis tag defines the maximum time for a transfer to be completed. The default time is 60 seconds.Operations such

208 Configuration FilesNotifyAudioStopContainer tag.DescriptionThe Duration tag nested within this container determines whether or not Flash Media Ser

XML configuration files 209ProxyContainer tag.DescriptionThe tags nested within this container configure the HTTP Proxy settings.Contained tagsHost, P

Managing applications 21Creating a new application instanceIn the View Applications section of the management console, you can create a new applicatio

210 Configuration FilesResyncDepthThis tag instructs Flash Media Server to resynchronize a shared object file.DescriptionThe shared object is resynchr

XML configuration files 211DescriptionThe default size is 1024 kilobytes, which is the equivalent of 1 megabyte. The lower and upper limits on the siz

212 Configuration FilesSendSilenceContainer tag.DescriptionThe Interval tag nested within this container configures the settings for sending silent me

XML configuration files 213SharedObjManagerContainer tag.DescriptionThe tags nested within this container configure the Shared Object Manager setting

214 Configuration FilesSet this tag only when the files for recorded streams must be stored in a location other than the application directory. See al

XML configuration files 215UnrestrictedAuthThis tag determines whether or not to allow sending the username/password combination with each HTTP redire

216 Configuration FilesSyntax<VirtualDirectory><virtual dir>;<actual dir></VirtualDirectory> WriteBuffSizeThis tag specifies i

2174CHAPTER 4Flash Media Server SecurityMacromedia Flash Media Server 2 will typically be used in a network environment where many users will have acc

218 Flash Media Server SecurityEdit the security tags in the configuration files Utilize the limits that can be set in the server’s configuration fil

Managing server security 219The MaxAppInstances tag nested in the ResourceLimits container lets you limit the number of application instances that can

22 Managing the ServerViewing the Live [Application] log fileEach application creates an associated log file. The Live [Application] log pane displays

220 Flash Media Server SecurityAbout authentication and authorization To authenticate (validate) administrators, Flash Media Server employs several la

JavaScript security 221By default, only the management console performs user authorization. When developing your own media applications, you can decid

222 Flash Media Server SecuritySecure script loadingThe Flash Media Server script security model enables one to limit the exposure to potentially mali

JavaScript security 223// available globally as idGen.global.idGen = protectObject( idgen );// Make idGen non-enumerable, read-only and permanentsetAt

224 Flash Media Server SecurityPermissions levelsFlash Media Server does not use explicit levels of privileges, but provides a way for the application

JavaScript security 225Asynchronous system callsIn Flash Media Server, application developers can implement asynchronous system calls, where the calle

226 Flash Media Server SecurityChoosing passwordsWhen choosing passwords, remember to make them as secure as possible. The following guidelines can he

Access DLL 227Access DLL is the libconnect.dll file (this module is named the libconnect.so file in Linux installations) stored within the modules/acc

228 Flash Media Server SecurityAccess DLL APIsAccess DLL provides the following AccessAdaptor APIs:Access DLL provides the following AccessContext API

Access DLL 229Modifying Access DLLThe Access DLL module contains the Sample.dsp file. You can change or configure this file to conform to your site-sp

Managing applications 23Viewing active clientsThis pane lists all client connections including debugging connections to the selected application. The

230 Flash Media Server SecuritySample Adaptor.cpp fileHere is an excerpt from the Adaptor.cpp file that you can modify to fit your local authenticatio

Developing secure applications 231}default:// We really shouldn't get here!fprintf( stderr, "SampleAdaptor: Unknown access event!\n" );

232 Flash Media Server SecurityConfigure the adaptor to listen on a secure port. If you need a secure connection, configure the adaptor for the appli

About privacy 233Send sensitive data via HTTPS If you need to send sensitive data such as credit card information, you can use HTTPS to communicate s

234 Flash Media Server SecurityIf the Flash Media Server and an application server are both behind a firewall, they can communicate with each other an

235IndexAAccess DLL 226–231APIs 228–229configuring 227examining the connection request 227modifying 229sample Adaptor.cpp file 230access logs 3

236 IndexApplication.xml tagsAccess 192Allow 192AllowHTTPTunnel 193Application 193Audio 193AutoCommit 194Bandwidth 194BandwidthCap 194Bits 19

Index 237configuration files 85–216Adaptor.xml 148–163Application.xml 185–216Logger.xml 135–148protecting 219security tags 217–219Server.xml 86

238 Indexviewing application log file 22viewing connection data 31viewing license files 33viewing performance statistics of an application 26viewi

Index 239FreeMemRatio 103FreeRatio 104GID 104GlobalQueue 104GlobalRatio 105HeapSize 105HostPort 105HTTP 106IPCQueues 106LargeMemPool 106Loca

24 Managing the ServerViewing active shared objectsThis pane lists the active shared objects for an application. The management console displays their

240 IndexUsers.xml tagsAdminServer 130Allow (HTTPCommands) 130Allow (User) 131Deny (HTTPCommands) 131Deny (User) 132Enable 132HTTPCommands 133O

Managing applications 25Viewing active streamsThis pane lists all the active streams in the selected application. The management console displays thei

26 Managing the ServerViewing application performanceThis pane displays the live information for this application. Application and server administrato

Managing the administrative users 27Managing the administrative usersIn this section of the management console you control Flash Media Server users wi

28 Managing the ServerManaging the serversThe Server pane occupies the left side of the Manage Server section of the management console. This pane lis

Managing the servers 29Clicking one of the buttons lets the administrator perform one of the following administrative actions on a selected server: A

3ContentsAbout This Manual. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Intended audience . . . . . . . . . . . . .

30 Managing the ServerClicking the buttons lets the administrator perform the following actions: Review the performance statistics for the computer w

Managing the servers 31Viewing connection detailsThis pane lists all client connections to the selected server. The management console displays the fo

32 Managing the ServerViewing application detailsThis pane displays detailed information for all the applications running on the selected server or vi

Managing the servers 33Viewing license filesThis pane displays detailed information for all license files authorizing you to run Flash Media Server on

34 Managing the ServerViewing the server log fileThis panel displays the trace messages being recorded in the server log file. The log messages repor

Logging client connections and other system events 35Access log fileFlash Media Server 2 maintains an access log that includes statistics about client

36 Managing the ServerThe following table lists the fields in the access logs.pause application Client pauses playing a stream.unpause application Cli

Logging client connections and other system events 37x-appinst application Application instance names.c-ip application Client IP address.c-proto appli

38 Managing the ServerThe following events display a status code.x-sname-query application Query portion of stream URI specified in play or publish.x-

Logging client connections and other system events 39Application log fileThe application log records information about activities in application insta

4ContentsChapter 2: Deploying Flash Media Server. . . . . . . . . . . . . . . . . . . 61Typical configurations . . . . . . . . . . . . . . . . . .

40 Managing the ServerDiagnostic log fileThe diagnostic log records alternative information (alternative to the information logged by the operating sy

Logging client connections and other system events 41The following table lists the fields in the diagnostic logs.The following table lists the status

42 Managing the ServerThe following table lists the status message IDs in the diagnostic logs. Flash Media Server 2 uses the symbols %1$S, %2$S and %3

Logging client connections and other system events 431018 The call method failed, invalid parameters: call(methodName[, resultObj, p1, pn]). 1019 Drop

44 Managing the Server1046 Reserved property (%1$S). 1047 Admin request received from an invalid admin server. 1048 Administrator login failed for use

Logging client connections and other system events 451074 Stopped recording %1$S.1075 Stream %1$S has been idling for %2$S second(s). 1076 Playing and

46 Managing the Server1104 Invalid method name (%1$S). 1105 (%2$S, %3$S): Invalid application name (%1$S). 1106 Connection succeeded. 1107 Connection

Logging client connections and other system events 471131 (%2$S, %3$S): Resource limit violation. Unable to load new application: %1$S. 1132 (%2$S, %3

48 Managing the Server1157 (%2$S, %3$S/%1$S): Current server bandwidth usage exceeds license limit set. Rejecting connection. 1158 (%2$S, %3$S/%1$S):

Logging client connections and other system events 491184 Invalid cryptographic accelerator: %1$S. 1185 Failed to initialize cryptographic accelerator

Contents 5Description of Vhost.xml tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .168Application.xml file. . . . . . . . . . . .

50 Managing the Server1207 Shared object %1$S has changed and is not being saved as auto commit is set to false. Current version %2$S, Last saved vers

Logging client connections and other system events 511235 Core (%1$S) connection to admin failed. 1236 Core (%1$S) received close command from admin.

52 Managing the ServerConfiguring loggingFlash Media Server logging is configured through the Server.xml and Logger.xml configuration files. Server.xm

Logging client connections and other system events 53For a more complete listing of all tags, see “Logger.xml file” on page 135.Logger.xml file exampl

54 Managing the Server<!-- 2. connect session --><!-- 3. disconnect session --><!-- 4. publis

Logging client connections and other system events 55<!-- 25. x-spos Stream position --> <!-- 26. cs-str

56 Managing the Server<QuoteFields>disable</QuoteFields> <!-- This is an optional flag to control if the fields need to be --> <!

Logging client connections and other system events 57 <!-- If type="duration", rotation occurs when the duration of the log -->

58 Managing the ServerManaging Flash Media Server on LinuxOn all supported Linux platforms, Flash Media Server 2 is installed as a service and include

Managing Flash Media Server on Linux 59The following table describes the commands for the fmsmgr utility.Command Descriptionfmsmgr server adminserver

6Contents

60 Managing the ServerFor other administrative tasks, such as adding users or checking the status of applications, you use the management console. For

612CHAPTER 2Deploying Flash Media ServerThis chapter describes the various strategies for deploying Macromedia Flash Media Server 2, including the use

62 Deploying Flash Media ServerConfiguration for development and testingWhile developing and testing your applications, you may choose to install a we

SSL support in Flash Media Server 63Deploying on two computers with authentication through Flash Media ServerSome scenarios may require authentication

64 Deploying Flash Media ServerThis XML tag specifies that Flash Media Server will listen on any interface on ports 1935, 80, and 443, where 443 is de

SSL support in Flash Media Server 65Creating multiple certificates for an adaptorYou can configure Flash Media Server to return multiple certificates

66 Deploying Flash Media ServerConfiguring independent virtual hosts for SSL applicationYou can configure the different virtual hosts in Flash Media S

About configuration levels 67The default directory structure installed with the server looks like this:The directory structure includes three subdirec

68 Deploying Flash Media ServerIf there is a second adaptor, it has its own subdirectory at the same level as the _defaultRoot_ subdirectory. The _d

About configuration levels 69Each adaptor directory must contain a _defaultVHost_ directory.Adding adaptors and virtual hostsTo add an adaptor to the

7About This Manual Macromedia Flash Media Server 2 enables one-to-one, one-to-many, many-to-one, and many-to-many communication in real time between a

70 Deploying Flash Media ServerTo create a new virtual host, create a new virtual host directory inside the /conf/adaptor_name directory in the Flash

About configuration levels 71The conf directory illustrated here contains two adaptor subdirectories: the _defaultRoot_ subdirectory and the Adaptor2

72 Deploying Flash Media ServerFor example, the following URL passes a ping command to the server:http://myFlashMediaServer:1111/admin/ping?auser=some

About configuration levels 73The following is the XML result:<?xml version="1.0" encoding="utf-8" ?><result><level&

74 Deploying Flash Media ServerUsing the admin commandsMany server administration commands expect one or more parameters. These are passed to the func

About configuration levels 75When you use the server management API over HTTP, the arguments for each command must be named. This is different from Ac

76 Deploying Flash Media ServerdisconnectUsers appInst, clientsn/a /admin/disconnectUsers?appInst="simpsons/game1"&clients=["137941

About configuration levels 77getNetStreams appInst n/a /admin/getNetStreams?appInst="foo"getNetStreamStats appInst, streamidsn/a /admin/getI

78 Deploying Flash Media ServerreloadApp appInst n/a /admin/reloadApp?appInst="foo"removeAdmin userName scope /admin/removeAdmin?userName=&q

Symbolic text substitutions 79Symbolic text substitutionsFlash Media Server supports the use of symbolic text substitutions in all tags in the server’

8About This ManualSystem requirementsFlash Media Server can be deployed on the following systems: Microsoft Windows 2000 Server or Windows 2003 Serve

80 Deploying Flash Media ServerOnce you have defined such a mapping, you can use the symbol in one of the XML configuration files. To use a symbol in

Symbolic text substitutions 81Mapping environment variablesYou can also specify symbols that resolve to environment variables. To refer to an environm

82 Deploying Flash Media ServerBuilding the symbol mapYou may use a symbol anywhere, such as in the substitution.xml file, or any of the external conf

Configurable application object properties for server-side scripting 83For example, given the previous XML fragment, the following trace() statements

84 Deploying Flash Media Server

853CHAPTER 3Configuration FilesThis chapter describes the XML files that define the Flash Media Server configuration. It presents their file structure

86 Configuration FilesServer.xml fileThe Server.xml file is located at the root level of the conf directory and contains the tags and information used

XML configuration files 87</Process></AdminServer><ResourceLimits><CPUMonitor>1</CPUMonitor><ThreadPoolGC>20</T

88 Configuration Files<SocketOverflowBuckets>-1</SocketOverflowBuckets><CoreTimeout>30</CoreTimeout></ECCP><ACCP>&

XML configuration files 89<MaxAge>1000000</MaxAge><UpdateInterval>1024</UpdateInterval><FreeMemRatio>0.5</FreeMemRati

Additional resources 9Typographical conventionsThe following typographical conventions are used in this book: Code font indicates ActionScript statem

90 Configuration FilesAdminContainer tag; contains the tags that configure the RTMP protocols for the FMSAdmin.exe process.AdminServerContainer tag; c

XML configuration files 91DenySpecifies which automatic proxy discovery messages not to respond to. DiagnosticContainer tag; contains tag to enable th

92 Configuration FilesLargeMemPoolContainer tag; contains tags to configure the large memory pool.LocalHostSpecifies the Flash Media Server IP loopbac

XML configuration files 93MyZoneSpecifies the zone that the edge server belongs to when it broadcasts FPAD messages. NumCRThreadsSpecifies the number

94 Configuration FilesSocketOverflowBuckets Specifies the number of overflow buckets if all slots in socket table are in use.SocketTableSizeSpecifies

XML configuration files 95Description of Server.xml tagsThe following alphabetical list of Server.xml tags contains additional information, including

96 Configuration FilesContained tagsMinIOThreads, MaxIOThreads, SocketOverflowBuckets, SocketTableSizeSee alsoACCP, Core, ECCP, Edge, HTTP, RTMP (Prot

XML configuration files 97DescriptionThis tag is a comma-delimited list of zones that the sole origin server or the edge servers in a cluster will ser

98 Configuration FilesDescriptionThe tags nested within the AutoDiscovery container set up and configure a single, or a cluster of, edge or proxy serv

XML configuration files 99DHCP is a protocol for assigning dynamic IP addresses to devices on a network. DHCP supports a mix of static and dynamic IP