MACROMEDIA FLASH MEDIA SERVER 2-MANAGING FLASH MEDIA... User manual

Managing Flash Media Server

Trademarks

1 Step RoboPDF, ActiveEdit, ActiveTest, Authorware, Blue Sky Software, Blue Sky, Breeze, Breezo, Captivate, Central,

ColdFusion, Contribute, Database Explorer, Director, Dreamweaver, Fireworks, Flash, FlashCast, FlashHelp, Flash Lite,

FlashPaper, Flash Video Encoder, Flex, Flex Builder, Fontographer, FreeHand, Generator, HomeSite, JRun, MacRecorder,

Macromedia, MXML, RoboEngine, RoboHelp, RoboInfo, RoboPDF, Roundtrip, Roundtrip HTML, Shockwave, SoundEdit,

Studio MX, UltraDev, and WebHelp are either registered trademarks or trademarks of Macromedia, Inc. and may be registered in

the United States or in other jurisdictions including internationally. Other product names, logos, designs, titles, words, or phrases

mentioned within this publication may be trademarks, service marks, or trade names of Macromedia, Inc. or other entities and

may be registered in certain jurisdictions including internationally.

Third-Party Information

This guide contains links to third-party websites that are not under the control of Macromedia, and Macromedia is not

responsible for the content on any linked site. If you access a third-party website mentioned in this guide, then you do so at your

own risk. Macromedia provides these links only as a convenience, and the inclusion of the link does not imply that Macromedia

endorses or accepts any responsibility for the content on those third-party sites.

Jabber is a registered trademark of the Jabber Software Foundation.

Sorenson™ Spark™ video compression and decompression technology licensed from

Sorenson Media, Inc.

translated, or converted to any electronic or machine-readable form in whole or in part without written approval from

Macromedia, Inc. Notwithstanding the foregoing, the owner or authorized user of a valid copy of the software with which

this manual was provided may print out one copy of this manual from an electronic version of this manual for the sole

purpose of such owner or authorized user learning to use such software, provided that no part of this manual may be

printed out, reproduced, distributed, resold, or transmitted for any other purposes, including, without limitation,

commercial purposes, such as selling copies of this documentation or providing paid-for support services.

Acknowledgments

Project Management: Suzanne Smith

Writing: John Norton, Suzanne Smith

Editing: Geta Carlson, Evelyn Eldridge, Mary Ferguson, Lisa Stanziano, Anne Szabla

Production Management: Adam Barnett

Media Design and Production: Aaron Begley, Paul Benkman, John Francis, Mario Reynoso

First Edition: October 2005

Macromedia, Inc.

600 Townsend St.

San Francisco, CA 94103

Contents

About This Manual. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Intended audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

System requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

About the Flash Media Server documentation . . . . . . . . . . . . . . . . . . . . . 8

Typographical conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9

Additional resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9

Chapter 1: Managing the Server . . . . . . . . . . . . . . . . . . . . . . . . . . . .11

Basic server settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11

Registering client applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Configuring virtual hosts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Deploying server-side scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Starting and stopping the server in Windows . . . . . . . . . . . . . . . . . . . 14

Starting and stopping the server on Linux . . . . . . . . . . . . . . . . . . . . . . 15

Using the management console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Connecting to the management console . . . . . . . . . . . . . . . . . . . . . . . 17

Managing applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Creating a new application instance . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Managing the administrative users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27

Managing the servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Managing servers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Viewing server details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Viewing connection details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Viewing application details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Viewing license files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Viewing the server log file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Logging client connections and other system events . . . . . . . . . . . . . 34

Access log file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Application log file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Diagnostic log file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Configuring logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Viewing server events in the Windows event viewer . . . . . . . . . . . . .57

Configuring the server at runtime . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57

4Contents

Managing Flash Media Server on Linux. . . . . . . . . . . . . . . . . . . . . . . . . . 58

Starting the Flash Media Admin Service in Windows. . . . . . . . . . . . 58

Starting the Flash Media Admin Service on Linux . . . . . . . . . . . . . . 58

Using the fmsmgr utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Chapter 2: Deploying Flash Media Server. . . . . . . . . . . . . . . . . . . 61

Typical configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

Configuration for development and testing. . . . . . . . . . . . . . . . . . . . . 62

Deploying on one computer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Deploying on two computers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Deploying on two computers with authentication

through Flash Media Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Deploying on two computers with authentication

through an application server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

SSL support in Flash Media Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Defining a secure port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Configuring SSL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

Creating multiple certificates for an adaptor . . . . . . . . . . . . . . . . . . . . 65

Configuring independent virtual hosts for SSL application . . . . . . . 66

About configuration levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

About the configuration hierarchy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

Adding adaptors and virtual hosts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

Server administration over HTTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71

Configuring Flash Media Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71

Using the admin commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Symbolic text substitutions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Making a substitution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Predefined symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

Mapping environment variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

Defining symbols outside the substitution.xml file . . . . . . . . . . . . . . . 81

Building the symbol map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

Configurable application object properties for server-side scripting . 82

Chapter 3: Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . . . . .85

XML configuration files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

Server.xml file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

Summary of Server.xml tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

Description of Server.xml tags. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

Users.xml file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

Summary of Users.xml tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

Description of Users.xml tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129

Logger.xml file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

Summary of Logger.xml tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

Description of Logger.xml tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

Contents 5

Adaptor.xml file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147

Summary of Adaptor. xml tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .148

Description of Adaptor.xml tags. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .150

Vhost.xml file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .162

Summary of Vhost.xml tags. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164

Description of Vhost.xml tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167

Application.xml file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .183

Summary of Application.xml tags. . . . . . . . . . . . . . . . . . . . . . . . . . . . .186

Description of Application.xml tags . . . . . . . . . . . . . . . . . . . . . . . . . . .190

Chapter 4: Flash Media Server Security . . . . . . . . . . . . . . . . . . . 215

Managing server security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .215

About authentication and authorization . . . . . . . . . . . . . . . . . . . . . . . . .218

JavaScript security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .219

Secure script loading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220

Protecting objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .221

Permissions levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222

Choosing passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224

Access DLL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224

Configuring Access DLL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225

Sample Adaptor.cpp file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228

Developing secure applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229

Using SSL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229

Using other secure development practices . . . . . . . . . . . . . . . . . . . 230

About privacy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .231

Deploying secure applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .231

About firewalls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .231

Log file precautions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233

6Contents

About 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 applications created in Macromedia

Flash 8. Developers create these applications using ActionScript, a scripting language based on

the same standard used by the JavaScript language.

Flash Media Server communicates with Macromedia Flash Player using the Real-Time

Messaging Protocol (RTMP), an unencrypted TCP/IP protocol designed for high-speed

transmission of audio, video, and data messages. You can also administer the server over

HTTP. You can use the same server administration application programming interface (API)

over HTTP as you would over RTMP. By passing command strings and arguments to the

URL of your Flash Media Server, you can interact with the server to retrieve information or

modify the server configuration. This API is described in detail in the Server Management

ActionScript Language Reference, included with Flash Media Server.

This manual describes how to configure and manage Flash Media Server to support media

applications deployed on a variety of network configurations. The rest of this chapter provides

system requirements, describes the Flash Media Server documentation, and lists additional

resources.

Flash Media Server enables applications to communicate with other servers. This manual does

not discuss web server and application server management or server operating system setup.

Intended audience

This manual is aimed at system administrators who will configure and manage Flash Media

Server to support media applications. You should already be familiar with basic network

infrastructure and security. You should also have some familiarity with client-server

application models, XML, and JavaScript.

8AboutThisManual

System requirements

Flash Media Server can be deployed on the following systems:

■Microsoft Windows 2000 Server or Windows 2003 Server - Standard Edition running on

a Pentium III 1-GHz processor or faster (Dual Pentium 4 or faster recommended).

Windows XP is acceptable for developing and testing applications.

■Linux Red Hat Enterprise Version 3.0 and Linux Red Hat Enterprise Version 4.0 running

on a Pentium III 1-GHz processor or faster (Dual Pentium 4 or faster recommended).

Your deployment system for Flash Media Server applications also requires the following:

■Minimum of 512 MB of available RAM.

■50 MB of available disk space.

■CD-ROM drive for installation.

Depending on your applications, your requirements might be greater than outlined here.

If you install Flash Media Server on a Linux computer, you’ll need Flash 8 installed on a

separate Windows or Macintosh computer to develop your Flash applications. You’ll also need

Macromedia Flash Player for Windows or Macintosh and a web browser to run the sample

applications.

About the Flash Media Server

documentation

All Flash Media Server documents are available in PDF format (viewable and printable with

AdobeAcrobatReaderatwww.adobe.com/products/acrobat/)and asFlash help. The PDFs

are available on the product CD or can be downloaded from the Macromedia website. To

view the help, open the Welcome page (in Windows, Start > Programs > Macromedia > Flash

Media Server > Welcome) or in Flash 8, select Help > Using Flash and then select a Flash

Media Server topic from the Table of Contents.

Tutorials on how to build simple applications that demonstrate important individual concepts

are included with the server. You can access these tutorials on Windows by selecting Start >

Programs > Macromedia > Flash Media Server > Welcome. Click on Welcome and then

Sample Applications. A link to the tutorials appears on the page that is displayed.

Additional resources 9

Typographical conventions

The following typographical conventions are used in this book:

■Code font indicates ActionScript statements, XML tag and attribute names, and literal

text used in examples.

■Italic indicates placeholder elements in code or paths. For example, /settings/myPrinter/

means that you should specify your own location for myPrinter.

■Directory paths are written with backslashes (\) for servers running on Microsoft

Windows systems. If you are running Flash Media Server on a UNIX system, replace the

backslashes with forward slashes (/).

Additional resources

The Flash Media Server documentation was written before the code in the product was

complete. Therefore, there may be discrepancies between the final implementation of the

product’s features and how they are documented in this manual. For a list of known

discrepancies, see thedocumentation update (www.macromedia.com/go/

flashmediaserver_documentation_update_en)intheFlash Support Center

(www.macromedia.com/go/flashmediaserver_support_en).

The Flash Support Center is updated regularly with the latest information on Flash and Flash

Media Server, as well as advice from expert users, advanced topics, examples, tips, and other

updates.

10 About This Manual

This manual suits for next models

Table of contents

Other MACROMEDIA Software manuals

MACROMEDIA

MACROMEDIA COLFUSION MX 7-GETTING STARTED BUILDING COLDFUSION... User manual

MACROMEDIA

MACROMEDIA DREAMWEAVER 8 User manual

MACROMEDIA

MACROMEDIA CONTRIBUTE 3 - USING AND ADMINISTERING... Mounting instructions

MACROMEDIA

MACROMEDIA FLEX - DEVELOPING COMPONENTS AND THEMES User manual

MACROMEDIA

MACROMEDIA 38000382 - Macromedia JRun - Mac User manual

MACROMEDIA

MACROMEDIA DIRECTOR MX 2004-GETTING STARTED WITH... User manual

MACROMEDIA

MACROMEDIA FLASH 8-GETTING STARTED WITH FLASH User manual

MACROMEDIA

MACROMEDIA FLEX-FLEX BUILDER Operation instructions

MACROMEDIA

MACROMEDIA FLASH MX PROFESSIONAL 2004 - FLASH LITE 1.1... Instruction Manual

MACROMEDIA

MACROMEDIA FLEX-CREATING ADVANCED COMPONENTS User manual

MACROMEDIA

MACROMEDIA FLASH 8-LEARNING ACTIONSCRIPT 2.0 IN FLASH User manual

MACROMEDIA

MACROMEDIA DIRECTOR MX 2004-USING DIRECTOR Mounting instructions

MACROMEDIA

MACROMEDIA COLDFUSION MX 61-GETTING STARTED BUILDING COLDFUSION... User manual

MACROMEDIA

MACROMEDIA BREEZE Quick reference guide

MACROMEDIA

MACROMEDIA FIREWORKS 2-USING FIREWORKS Mounting instructions

MACROMEDIA

MACROMEDIA FLASH 8-INTRODUCTION TO FLASH LITE 2.X... Reference manual

MACROMEDIA

MACROMEDIA DREAMWEAVER 8-DREAMWEAVER API Service manual

MACROMEDIA

MACROMEDIA FLASH MX 2004-ACTIONSCRIPT LANGUAGE Service manual

MACROMEDIA

MACROMEDIA DIRECTOR MX 2004-USING DIRECTOR Mounting instructions

MACROMEDIA

MACROMEDIA FLASH 8-DEVELOPING FLASH LITE 2.X User manual

MACROMEDIA

MACROMEDIA COLDFUSION 4.5-CFML LANGUAGE Service manual

MACROMEDIA

MACROMEDIA COLDFUSION MX 7.0.2-USING COLDFUSION MX WITH FLEX... Mounting instructions

MACROMEDIA

MACROMEDIA COLDFUSION 5 - INSTALING AND CONFIGURING... User manual

MACROMEDIA

MACROMEDIA STUDIO 8-EXPLORING STUDIO 8 User manual

Popular Software manuals by other brands

COMPRO

COMPRO COMPROFM manual

Muratec

Muratec OFFICEBRIDGE ONLINE user guide

Oracle

Oracle Contact Center Anywhere 8.1 installation guide

Adobe

Adobe 65007312 - Photoshop Lightroom Programmer's guide

Avaya

Avaya NULL One-X for RIM Blackberry user guide

HP ProLiant BL420c user guide

PS Audio

PS Audio PowerPlay Programming manual

Brady

Brady LOCKOUT PRO 3.0 Administrator's guide

Avaya

Avaya Interaction Center user guide

Texas Instruments

Texas Instruments TI-83 Plus Silver Edition Guide book

Novell

Novell GROUPWISE 8 - INTERNET AGENT manual

Oracle

Oracle Application 9i Configuration guide

Acer

Acer RDM user guide

Canon

Canon Vixia HF21 instruction manual

Canon

Canon ZR950 instruction manual

Samsung

Samsung Auto Backup user manual

Polycom

Polycom Vortex EF2201 Application note

Brocade Communications Systems

Brocade Communications Systems Brocade 8/12c user manual