MACROMEDIA FLASH MEDIA SERVER 2-SERVER MANAGEMENT ACTIONSCRIPT LANGUAGE Reference

Server Management ActionScript

Language Reference

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, 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.

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: Jody Bleyle

Managing Editor: Rosana Francescato

Editing: Geta Carlson

Production Manager: Adam Barnett

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

Special thanks to Erick Vera and the Flash Media Server engineering and QA teams.

First Edition: October 2005

Macromedia, Inc.

601 Townsend St.

San Francisco, CA 94103

3

Contents

Server Management ActionScript Language Reference . . . . . . . . 5

Using the Server Management ActionScript API . . . . . . . . . . . . . . . . . . . 5

Establishing the connection to the server . . . . . . . . . . . . . . . . . . . . . . . . . . 5

A simple application example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Information objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9

Method summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9

addAdmin() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

addApp() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

addVHostAlias() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

approveDebugSession(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

changePswd() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

gc(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

getActiveInstances() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

getAdaptors() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

getAdminContext(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

getAdmins() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

getApps() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

getAppStats() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

getConfig() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

getConfig2() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27

getGroupMembers() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

getGroupStats() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

getGroups() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

getInstanceStats() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

getIOStats() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

getLicenseInfo() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37

getLiveStreams() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

getLiveStreamStats() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

getMsgCacheStats() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

getNetStreams(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

getNetStreamStats() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

getRecordedStreams() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

getRecordedStreamStats() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

getScriptStats() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

4

getServerStats() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

getServices() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

getSharedObjects() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

getSharedObjectStats(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

getUsers() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

getUserStats() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

getVHosts(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

getVHostStats(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

ping() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

reloadApp() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

removeAdmin() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

removeApp(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

removeVHostAlias() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

restartVHost(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

setConfig() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

setConfig2() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

startServer() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

startVHost() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

stopServer() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

stopVHost() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71

unloadApp() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

5

Server Management ActionScript

Language Reference

Macromedia Flash Media Server includes a set of advanced methods, the Server Management

ActionScript application programming interface (API), that lets you extend the management

console or make your own administration and monitoring tools by creating Macromedia

Flash applications.

This document describes the Server Management ActionScript API. For information about

ActionScript, see the ActionScript 2.0 Language Reference. For information about Flash Media

Server, see the Client-Side ActionScript Language Reference for Flash Media Server 2, the

Server-Side ActionScript Language Reference, and Managing Flash Media Server.

Using the Server Management

ActionScript API

To use the Server Management ActionScript API, you need to have Flash and Flash Media

Server installed, and you need to have administrative access to Flash Media Server. You should

be fluent in ActionScript and in creating Flash applications.

Establishing the connection to the server

Flash Media Server communicates on port 1935 (the default port). However, to use the Server

Management ActionScript API, you must connect to Flash Media Server through the

administration server on port 1111.

You establish a connection using the

NetConnection.connect() method, passing in three

parameters: the URI of the host administration server, an administrator user name, and an

administrator password.

NOTE

This document assumes that you have not changed the default port number for the

administration server; if you have, use your valid port number instead of port 1111.

6 Server Management ActionScript Language Reference

When the administration server host to which you want to connect is a virtual host (one of

several services on the same machine), make sure to specify the virtual host’s domain name, or

IP Address, as part of the URI—for example,

rtmp://www.myVhost.com/admin:1111. That

way, when you connect to the host machine, you connect to an instance of the server running

on your specified virtual host.

Only valid administrators, as defined in the Users.xml configuration file, can connect to the

server. You must specify two administrative parameters, the user name and the password for a

valid administrator, to the

NetConnection.connect method.

The following example shows the call that lets the administrator

MHill with password

635xjh27 connect to the server on localhost:

nc = new NetConnection();

nc.connect("rtmp://localhost:1111/admin", "MHill", "635xjh27");

To prevent unauthorized users from accessing the administration server, you should use a

firewall and limit access to the administration server port (port 1111). For more information

about security for Flash Media Server, see the security white papers at www.macromedia.com/

go/flashmediaserver_security_en.

Syntax example

To make a Server Management ActionScript API call, you’ll want to include a callback

handler and any required parameters in your code.

In the following example, the

getAppStats method is called to retrieve the performance data

of a running application; the callback handler

new receiveAppStats captures the result of

the call; and the value

ChatApp is a required parameter that specifies the name of the

application:

nc = new NetConnection();

nc.connect("rtmp://localhost:1111/admin", "MHill", "635xjh27");

// Call getAppStats

nc.call("getAppStats", new receiveAppStats(), "ChatApp");

A simple application example 7

A simple application example

This section contains the code for a simple Flash application that calls the getAppStats

method. You can copy and paste this code into Flash to see how a simple call works.

In Flash, create an application with the following elements:

■ An input field named Application Name with a border

■ A button that calls the doGetAppStats() method (shown in the code sample that

follows)

■ A multiline, dynamic text field called outputBox that has a border

■ A scroll component next to the text field

This simple interface lets you test the Server Management ActionScript API.

Next, in the Actions panel, enter the sample ActionScript code that follows. Be sure to replace

admin_name and admin_pass with your valid administrator name and password.

/** Establishes the connection to Flash Media Server **/

nc = new NetConnection();

nc.connect("rtmp://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")

outputBox.text = "Call failed: " + info.description;

else {

outputBox.text = "Info for "+appName.text+ " returned:" + ¬

newline;

printObj(info, outputBox);

}

nc.call("getAppStats", new onGetAppStats(), appName.text);

}

// This function proceeds through an object, printing all values to the

// destination, including recursively printing objects within objects.

// The tabLevel parameter is used for cosmetic purposes.

function printObj(obj, destination, tabLevel)

NOTE

The continuation character (¬) indicates that the code continues to the next line; this

character should not appear in code.

8 Server Management ActionScript Language Reference

{

if (arguments.length < 2) {

trace("ERROR! you need to supply a text object to output to");

return;

}

if (arguments.length < 3)

tabLevel = 0;

for (var prop in obj) {

for (var i = 0; i < tabLevel; i++) // insert requested # of tab

characters

destination.text += "\t";

destination.text += prop + " = " + obj[prop] + newline;

if (typeof (obj[prop]) == "object") { // recursively call printObj

printObj(obj[prop], destination, tabLevel+1 );

}

// Alerts you if there are errors connecting to the server.nc.onStatus =

function(info) {

if (info.code == "NetConnection.Connect.Success") {

trace("Connected! The call should work")

} else {

// Use nc.isConnected to test condition of server

if (! nc.isConnected)

trace("NO netConnection to server. Call will not work");

}

Method summary 9

Information objects

All Server Management ActionScript API methods return data in an information object with

the following properties:

level, code, timestamp, data, description, and details. All

information objects have

level, code, and timestamp properties. Some methods have the

data property, which contains return data (often in an object or array), and the description

and

details properties, which typically provide information about errors.

In addition to the information objects that are documented in the Client-Side ActionScript

Language Reference for Flash Media Server 2, the NetConnection class has information objects

that are specific to the Server Management ActionScript API. The following table lists the

code and level properties, as well as the meaning of commonly returned information

objects.

Method summary

The Server Management ActionScript API contains the following three types of methods:

■ Queries let you monitor Flash Media Server, its applications, and specific instances of its

applications.

■ Administrative commands let you perform administrative tasks for Flash Media Server,

such as adding administrative users and starting and stopping the server, virtual hosts, and

applications.

■ Configuration commands: the getConfig2() command lets you view server

configuration keys, and the

setConfig2() command lets you set values for the keys.

Code Level Meaning

NetConnection.Call.Success Status

The call is successful.

This information object includes a

data

property, which returns detailed information

in an object or array.

NetConnection.Admin.CommandFailed Error

The method called is nonexistent.*

NetConnection.Call.Failed Error

A general failure has occurred.*

NetConnection.Call.BadValue Error

The value of a parameter is invalid.*

* This information object contains description and detail properties, which are strings that

provide a more specific reason for the failure.

10 Server Management ActionScript Language Reference

Some methods are available only to server administrators, as indicated by an asterisk (*) in the

description of each method; virtual host administrators cannot use these methods. In some

cases, virtual administrators can use a method with restrictions; these restrictions are described

in the dictionary entry for the method.

Queries for monitoring the server

The following table lists the methods you can use to monitor the server.

NOTE

Parameters in square brackets ([]) are optional; all other parameters are required. If you

don’t specify an optional parameter, a default value might be used, depending on the

method. For example, if you don’t specify a virtual host in the

scope parameter, it is

assumed that you want to perform the command on the virtual host to which you

connected when you logged on to Flash Media Server.

Method Description

approveDebugSession() Approves a pending debug session’s request to connect to a

selected application.

getActiveInstances() Returns an array of strings that contains the names of all running

application instances on the connected virtual host.

getAdaptors() Returns an array of adaptor names.

getAdminContext() Returns the administrative context for the administrator

(administrator type, name of adaptor, and name of the virtual

host).

getAdmins() Returns all the administrators on the Flash Media Server.

getApps() Returns an array of strings that contains the names of all the

applications that are installed.

getAppStats() Returns aggregate information of all instances for an application.

getGroupMembers() Returns a list of the group members for a particular group.

getGroupStats() Returns statistics for a particular group connection.

getGroups() Returns a list of the group connections for a particular application

instance.

getInstanceStats() Returns detailed information about a single running instance of

an application.

getIOStats() Returns the I/O information: bytes in, bytes out, and so on.*

getLicenseInfo() Returns license key information.

getLiveStreams() Returns a list of all live streams currently publishing to a particular

application.

Method summary 11

getLiveStreamStats() Returns detailed information about a live stream.

getMsgCacheStats() Returns server TCMessage cache statistics.

getNetStreams() Returns a list of all network streams that are currently connected

to the application.

getNetStreamStats() Returns detailed information about a specific network stream.

getRecordedStreamStats() Returns detailed information about a recorded stream.

getRecordedStreams() Returns an Array containing the name of all the recorded streams

currently playing from a particular instance of an application.

getScriptStats() Gets the performance data for a script running on the specified

instance of an application.

getServerStats() Retrieves the server status and statistics about the operation of

the server, including the length of time the server has been

running and I/O and message cache statistics.*

getServices() Returns an array containing the names of all the services

currently connected to Flash Media Server.

getSharedObjects() Returns a list of all persistent and nonpersistent shared objects

that are currently in use by the specified instance of an

application.

getSharedObjectStats() Returns detailed information about a shared object.

getUsers() Returns a list of all users who are currently connected to the

specified instance of an application.

getUserStats() Returns detailed information about a specified user.

getVHosts() Returns an array of vhosts defined for the specified adaptor.

getVHostStats() Returns statistics for a vhost.

ping() Returns a status string indicating the condition of the server.

* Only server administrators can use this method.

Method Description

12 Server Management ActionScript Language Reference

Commands for managing the server

The following table lists the methods you can use to manage the server.

Commands for configuring the server

The following table lists the methods you can use to configure the server.

Entries in this document are listed alphabetically.

Method Brief description

addAdmin() Adds an administrator to the system.*

* Only server administrators can use this command.

addApp() Adds a new application.

addVHostAlias() Adds an alias to a virtual host.

changePswd() Changes the password for an administrator in the system.

gc() Forces garbage collection of server resources.*

reloadApp() Unloads an instance of an application if it is loaded, and then reloads the

instance.

removeAdmin() Removes an administrator from the system.*

removeApp() Removes an application or an instance of an application.

removeVHostAlias() Removes an alias from a virtual host.

restartVHost() Restarts a virtual host.

startServer() Starts or restarts Flash Media Server.*

startVHost() Starts the specified virtual host if it stops. Enables a new virtual host if

the virtual host directories have been created in the file system.*

stopServer() Shuts down the Flash Media Server.*

stopVHost() Stops a virtual host.

unloadApp() Unloads all instances of an application or one instance of an application.

Disconnects all users.

Method Description

getConfig2() Returns configuration information for the specified configuration key.

setConfig2() Sets a value for a specified configuration key.

addAdmin() 13

addAdmin()

Availability

■ Flash Player 6.

■ Flash Communication Server MX 1.0.

Usage

addAdmin(admin_name, password [,scope])

Parameters

admin_name A string that contains the user name of the administrator being added.

password Password of that administrator. The password is encoded before it is written to

the Server.xml configuration file.

scope Optional; string that specifies whether the administrator is a server administrator or a

virtual host administrator, and for which virtual host. To add a server administrator, specify

server.

To add a virtual host administrator to the virtual host to which you’re connected, omit this

parameter. To add a virtual host administrator to a different virtual host, specify the virtual

host as

adaptor_name/virtual_host_name.

Returns

If the call succeeds, the server sends a reply information object with a level property of

status and a code property of NetConnection.Call.Success. The Server.xml

configuration file is updated with the new administrator.

If the call fails, the server sends a reply information object with a

level property of error

and a

code property of NetConnection.Admin.CommandFailed or a more specific value, if

available. Some objects might also have a

description property that contains a string

describing the cause of the failure.

If the specified administrator already exists in the system, this command fails.

Description

Adds an administrator to the system. You can add a server administrator or a virtual host

administrator, depending on the parameters you specify.

You must be a server administrator to add an administrator to the system.

14 Server Management ActionScript Language Reference

Example

The following three examples show how you can specify parameters in a call to the addAdmin

command:

/* Adds a server administrator named "GLee" with password "boat4907" */

nc.call("addAdmin", new onAddAdmin(), "GLee", "boat4907", "server");

/* Adds a virtual host administrator named "ChrisM" with password "tree2981"

*/

nc.call("addAdmin", new onAddAdmin(), "ChrisM", "tree2981");

/* Adds a virtual host administrator "DHong" with password "wate3235" */

/* for vhost tree.oak.com */

nc.call("addAdmin", new onAddAdmin(), "DHong", "wate3235", "_defaultRoot_/¬

tree.oak.com");

addApp()

Availability

■ Flash Player 6.

■ Flash Communication Server MX 1.0.

Usage

addApp(app_name)

Parameters

app_name A string that contains the name of the application to be added.

Returns

If the call succeeds, the server sends a reply information object with a level property of

status and a code property of NetConnection.Call.Success.

If the call fails, the server sends a reply information object with a level property of error

and a

code property of NetConnection.Call.BadValue or a more specific value, if available.

Some objects might also have a

description property that contains a string describing the

cause of the failure.

Description

Adds a new application to the virtual host by creating the required directory for the new

application in the directory tree. Once the directory for the new application is created, you (or

another administrator with file system access) can put any required server-side scripts in the

directory. The client-side code uses the new application directory in the URI parameter of the

NetConnection.Connect call.

addVHostAlias() 15

Example

The following example shows a call to add the ChatApp application to the connected virtual

host:

nc = new NetConnection();

nc.connect("rtmp://localhost:1111/admin", "JLee", "x52z49ab");

nc.call("addApp", new onAddApp(), "ChatApp");

addVHostAlias()

Availability

■ Flash Player 6.

■ Flash Media Server 2.

Usage

addVHostAlias(VHostName, AliasName, PersistValue)

Parameters

VHostName A string indicating the virtual host to which to add an alias.

AliasName A string indicating the alias name to add to the specified vhost.

PersistValue A Boolean value indicating whether the alias change will be written to the

configuration file to last beyond the vhost's next restart (true), or whether this alias will be lost

on vhost restart (false).

Returns

If the call succeeds, the server sends a reply information object with a level property of

status, and a code property of NetConnection.Call.Success.

Description

Adds an alias to a virtual host. Aliases are alternative names for vhosts that are used as targets

by incoming Flash Media Server connections. When you remove an alias, that name is no

longer available for incoming connections.

Before this API was available, alias names had to be added to the configuration files manually.

See also

removeVHostAlias()

16 Server Management ActionScript Language Reference

approveDebugSession()

Availability

■ Flash Player 6.

■ Flash Media Server 2.

Usage

approveDebugSession(appInst, PIN)

Parameters

appInst A string indicating the application and instance name that has a pending debug

connection to approve.

PIN A number indicating the debug session Personal Identification Number. Each debug

connection issues a debug number when queueing to connect to an application. This same

number is included on this API. When this API is processed, the PIN numbers are matched

and the corresponding connection is allowed to connect. This is a security measure to prevent

unauthorized users from using the debug connection.

Keep in mind that 0 is not a valid

PIN value. To maintain security, PIN numbers should not

be able to be easily guessed. PIN numbers must be non-zero and must be within the range of

+/- (2^31 - 1) that is between positive or negative 2147483648. If there is a pending

connection with a given PIN, and another connection arrives with the same PIN while the

original is still waiting, the second connection with the same PIN will be rejected as a security

measure.

Returns

If the call succeeds, the server sends a reply information object with a level property of

status, a code property of NetConnection.Call.Success.

Description

Approves a pending debug session’s request to connect to a selected application. Once

approved and permitted, the debug session may connect to its application through the

Services.onDebugConnect gateway and act as a regular client.

Connecting to an application with a debug session allows you to view the streams and shared

objects for an application through the management console.

Example

The following is an example of a Debug connection:

nc.connect("rtmp://serverName/appName%3F%5Ffcs%5Fdebugreq%5F%3D1234");

// The original string is _fcs_debugreq_=1234.

changePswd() 17

The following is an example of a Debug approval request:

nc_admin.call("approveDebugSession", null, appName/instName", 1234);

changePswd()

Availability

■ Flash Player 6.

■ Flash Communication Server MX 1.0.

Usage

changePswd(admin_name, password [, scope])

Parameters

admin_name A string that contains the name of the administrator whose password is being

changed.

password A string that contains that administrator’s new password.

scope Optional; a string that specifies whether the administrator is a server administrator or

virtual host administrator, and for which virtual host.

To change the password for the specified administrator on the virtual host to which you’re

connected, omit this parameter. To change the password for the specified administrator on a

different virtual host, specify

adaptor_name/virtual_hostname.

To change a server administrator’s password, specify

server.

Returns

If the call succeeds, the server sends a reply information object with a level property of

status and a code property of NetConnection.Call.Success.

If the call fails, the server sends a reply information object with a

level property of error

and a

code property of NetConnection.Admin.CommandFailed or a more specific value, if

available. Some objects might also have a

description property that contains a string

describing the cause of the failure.

If the specified administrator does not exist, this command fails.

Description

Changes the password for the specified administrator. The password is encoded before it is

written to the Server.xml configuration file.

Virtual host administrators can change only their own password.

18 Server Management ActionScript Language Reference

Example

/* Change password for server administrator named "ASilva" to "cbx5978y" */

nc.call("changePswd", new onChangePswd(), "ASilva", "cbx5978y", "server");

/* Change password for virtual host administrator named "JLee" to "kbat3786"

*/

nc.call("changePswd", new onChangePswd(), "JLee", "kbat3786");

/* Change password for virtual host administrator "JLee" to "kbat3786" on */

/* virtual host "tree.oak.com" */

nc.call("changePswd", new onChangePswd(), "JLee", "kbat3786",

"_defaultRoot_/¬ tree.oak.com");

gc()

Availability

■ Flash Player 6.

■ Flash Communication Server MX 1.0.

Usage

gc()

Parameters

None.

Returns

If the call succeeds, the server sends a reply information object with a level property of

status and a code property of NetConnection.Call.Success.

If the call fails, the server sends a reply information object with a

level property of error

and a

code property of NetConnection.Admin.CommandFailed or a more specific value, if

available. Some objects might also have a

description property that contains a string

describing the cause of the failure.

Description

Forces collection and elimination of all server resources that are no longer used, such as closed

streams, instances of applications, and nonpersistent shared objects. This operation is

performed within about one second of the call.

You must be a server administrator to perform this operation.

getAdaptors() 19

getActiveInstances()

Availability

■ Flash Player 6.

■ Flash Communication Server MX 1.0.

Usage

getActiveInstances([processID])

Parameters

processID A number; the process identifier of a Flash Media Server core process. This

parameter is optional.

Returns

If the call succeeds, the server sends a reply information object with a level property of

status, a code property of NetConnection.Call.Success, and a data property that is an

array of strings containing the names of all running instances of an application on the server

or on a specified process.

If the call fails, the server sends a reply information object with a

level property of error

and a

code property of NetConnection.Call.Failed or a more specific value, if available.

Some objects might also have a

description property that contains a string describing the

cause of the failure.

Description

Returns an array of strings that contains the names of all running application instances on the

entire server (if no

processID parameter is passed), or on the process specified by the

processID parameter.

getAdaptors()

Availability

■ Flash Player 6.

■ Flash Communication Server MX 1.0.

Usage

getAdaptors()

Parameters

None.

20 Server Management ActionScript Language Reference

Returns

If the call succeeds, the server sends a reply information object with a level property of

status, a code property of NetConnection.Call.Success, and a data property that is an

array of strings containing the names of all the adaptors.

Description

Returns an array of adaptors that are defined. You must be a server administrator to perform

this command.

getAdminContext()

Availability

■ Flash Player 6.

■ Flash Communication Server MX 1.0.

Usage

getAdminContext([adminName][, adaptorName][, vhostName])

Parameters

adminName The name of an administrator.

adaptorName An alternate adaptor, other than _defaultRoot_, on which to find

administrators. If not specified,

_defaultRoot_ is used

vhostName An alternate vhost, other than _defaultVHost_, on which to find vhost

administrators. If not specified, server level admin is used.

Returns

If the call succeeds, the server sends a reply information object with a level property of

status, a code property of NetConnection.Call.Success, and a data property that is an

object. The

data object has the following properties:

Property Description

admin_type

String; the type of administrator, either server or vhost.

adaptor

String; name of the adaptor for which the user is an administrator.

vhost

String; name of the virtual host for which the user is an administrator.

connected

String; this property is deprecated and always returns true.

Page is loading ...

MACROMEDIA FLASH MEDIA SERVER 2-SERVER MANAGEMENT ACTIONSCRIPT LANGUAGE Reference

This manual is also suitable for

MACROMEDIA FLASH MEDIA SERVER 2-SERVER MANAGEMENT ACTIONSCRIPT LANGUAGE Reference

Related papers

Other documents