Adobe Flash Media Server Plugin

Adobe Flash Media Server Plugin

This plugin allows monitoring of metrics exposed by Adobe's Flash Media Server / Flash Interactive Server, versions 3+.

It has been tested with Flash Media Server 3.5, but should work with the 3.0.x and (probably) 4.x servers as well.

Support

This plug-in is not supported by VMWare / Hyperic.

You can report problems with the plug-in through the author's website.

Configure Flash Media/Interactive Server for Monitoring:

In order to monitor your Flash Media Server, you will need to provide an administrative username and password, and ensure that certain HTTP-Admin-API commands are permitted by your FMS server's configuration.

If you have multiple adaptors configured on a system to be monitored, it is recommended that you specify your Flash Server admin credentials in your agent.properties file for the monitored host(s) before installing this plug-in. This will permit the auto-discovery process to correctly identify all of the adaptors configured on your server, in particular if you have removed or disabled the default adaptor.

You may specify these credentials by adding the following lines to your hyperic-install-path/agent-4.5/conf/agent.properties file:fms3.user=admin
fms3.password=your-password-here
fms3.ip=127.0.0.1
fms3.port=1111
You will, or course, need to replace your-password-here with your real Flash Admin password; if your administrative user is not named "admin", or if you have disabled the administration server from listening on 127.0.0.1:1111, you will need to alter the other parameters accordingly.

In addition, you must enable certain administrative HTTP commands. Adobe's server ships with all administrative commands but the "ping" command disabled; you will need to edit your FMS configuration as follows:

1. Open your flash-media-server-install-path/conf/Users.xml. In the <AdminServer> tag, in the nested <HTTPCommands> tag, alter the <Allow> tag to include (at minimum) the following:
   ping,getServerStats,getVHosts,getAdaptors,getVHostStats,getLicenseInfo
   • Note that Adobe advises against enabling all HTTP administrative API commands (eg. <Allow>all</Allow>)
2. Open your flash-media-server-install-path/conf/fms.ini. Near the bottom of the file, ensure that USERS.HTTPCOMMAND_ALLOW is set to true.
   • Also note that this file can also be used to verify or alter your admin server's host/IP, as well as the admin username and password
3. Finally, re-start your Flash Administration Server -- in Windows installs, this will appear as seperate service in the services control panel (Start -> Control Panel -> Administrative Tools -> Services).

You may verify your work by visiting http://127.0.0.1:1111/admin/getLicenseInfo?auser=admin&apswd=your-admin-password-here from your Flash Server machine.

Installing the Monitoring Plug-in

On your Hyperic server:Move a copy of the adobe-fms3-plugin.jar file into the hq-engine/hq-server/webapps/ROOT\WEB-INF/hq-plugins/ folder, in the server's installation directory. The Hyperic server should automatically load the new plug-in.
On Hyperic agents:Save a copy of the adobe-fms3-plugin.jar file into the bundles/agent-4.5/pdk/plugins/ folder, then restart the client to load the new plug-in. You only need to do this for clients you will use to monitor FMS instances.
Note: The plug-in must be installed on both the agent and server to function correctly!

Hyperic should detect your FMS server(s) during the next scheduled auto-inventory. If you don't want to wait, you can force an auto-inventory on the relevant platforms, or set upthe servers manually (please refer to the Hyperic documentation).