RMS II
RMS Web Player

(rev. 14-Jun-07)


RMS Web Player


Introduction

The RMS Web Player consists of two CGI applications, one helper application, and some associated template HTML files. Once it is installed on a web server Macintosh, the RMS Web Player lets web browser clients make queries on sound, band scan, and web monitoring log data files. The queries allow the web browser user to be able to select just those data files that meet a certain criteria -- for example, select just those sound files that have a certain frequency, broadcaster and language, within the past 3 days.

In all, the RMS Web Player lets web browser users:

The sound, scan, and web monitoring data files must reside on the same Macintosh as the Web Player (i.e. usually the RMS Librarian and RMS Web Player will reside on the same Mac).

System Requirements

CPU:           Any PowerPC Macintosh or PowerBook
Memory Usage:  16MB
Disk Usage:    1MB + however much space is needed to cache query files
Network:       Internet connection
OS:            OS X 10.4 or later

Software Components

Software Installation

  1. For complete OS X installation instuctions, see Reference_E: OS X Installation Notes.

Software Setup 

  1. Set the PlayerCGI.acgi Preferences:
    • Launch the Player CGI application by double-clicking its icon in the Finder. It is located in the "cgi-bin" folder which is inside the "RMSPlayer" folder.
    • Choose Preferences from the File menu to open the Preferences dialog.
    • In the Preference's Data Files section, set where the "RMS Data" folder resides. This folder is the one into which the RMS Librarian places all the incoming Sound, Scan, Script and Log files. Click Set, then navigate to and select the "RMS Data" folder. The CGI will search this folder for data files when performing a query. Note that the RMS Librarian, Player CGI, and WebMonitor CGI MUST all reference the same "RMS Data" folder for query requests to work properly. For details on how the RMS Librarian uses the "RMS Data" folder, refer to the RMS Librarian documentation.
    • In the Preference's Librarian Location section, set the location of the RMS Librarian application. Click Set, then navigate to and select the Librarian application. The Player CGI needs to know where the Librarian is located so that it can access the "RMS Librarian Census" file, and the "Bands" file.
    • The Cache and Log file preference settings can be adjusted as needed for your installation.

      Important Note: The "RMS Data" folder must reside inside the same folder that directly contains the "RMSPlayer" folder (it can be nested inside folders in that folder). Here's an example of a typical setup:

      WebStar "root" folder
         milestone_1.2.htm
         "RMSPlayer" folder
            "html" folder
            "cgi-bin" folder
         "RMS Data" folder
            (this folder contains nested folders which contain data files)
  2. Set the WebMonitorCGI.acgi Preferences:
    • Launch the WebMonitor CGI application by double-clicking its icon in the Finder. It is located in the "cgi-bin" folder which is inside the "RMSWebMonitor" folder.
    • Choose Preferences from the File menu to open the Preferences dialog.
    • In the Preference's Data Files section, set where the "RMS Data" folder resides. This folder is the one into which the RMS Librarian places all the incoming Sound, Scan, Script, Log, and Web Monitoring Log files. Click Set, then navigate to and select the "RMS Data" folder. The CGI will search this folder for data files when performing a query. Note that the RMS Librarian, Player CGI, and WebMonitor CGI MUST all reference the same "RMS Data" folder for query requests to work properly. For details on how the RMS Librarian uses the "RMS Data" folder, refer to the RMS Librarian documentation.
    • In the Preference's Librarian Location section, set the location of the RMS Librarian application. Click Set, then navigate to and select the Librarian application. The WebMonitor CGI needs to know where the Librarian is located so that it can access the "RMS Librarian Census" file.
    • In the Preference's Web Server Name section, type the name of the web server on which the CGI is running (e.g. "america.ibb.his.com" if this is the Americas server in DC). The WebMonitor CGI needs to know its web server name so that it can post requests to itself.
    • The Cache and Log file preference settings can be adjusted as needed for your installation.

      Important Note: The "RMS Data" folder must reside inside the same folder that directly contains the "RMSPlayer" and "RMSWebMonitor" folders (it can be nested inside folders in that folder). Here's an example of a typical setup:

      WebStar "root" folder
         milestone_x.x.htm
         "RMSPlayer" folder
            "html" folder
            "cgi-bin" folder
         "RMSWebMonitor" folder
            "html" folder
            "cgi-bin" folder
         "RMS Data" folder
            (this folder contains nested folders which contain data files)

Notes