RMS II
Reference E: OS X Installation Notes

(rev. 5-May-08)


This page describes OS X installation details for various components of RMS.


Librarian / Web Player CGI / WebMonitor CGI

 

Using Apache OS X

This description corresponds to Milestone 11.7 (9-May-06) and later. It is intended for OS X (10.4.x) and later.

  1. Disable Web*
    1. Quit all Web* applications
    2. Delete the "webstar" user (Hint: System Preferences > Accounts; select and click "-")
    3. Check to make sure Web* is removed from Startup Items (Hint: System Preferences > Accounts > Login Items tab)
  2. Migrate data from Web* installation to Apache installation
    1. copy over data in the Web* 'Default Site' folder to /Library/WebServer/Documents/
      1. "RMSData" folder
      2. "Depository" folder
      3. "Bands" text file
    2. Set permissions of "RMSData" folder and "Depository" folder in /Library/WebServer/Documents/ to "Read/Write"
      1. Select folder; Get Info; in Ownership & Permissions set Access to "Read & Write" for "Owner", "Group" and "Others"
      2. Click "Apply to enclosed items..."
  3. Turn on Apache OS X
    1. Open System Preferences > Sharing.
    2. Under Services, check "Personal Web Sharing" on. Click Start button.
  4. Set up "acgi dispatcher"
    1. Download the most recent version of acgi dispatcher from http://www.sentman.com/acgi/ (currently version 2.5)
    2. Drag the application "acgi dispatcher" icon from the installation onto your hard drive anywhere you want (e.g. Applications folder)
    3. Double click the application to launch it. Accept the default installation options.
    4. Using the right arrow in the bottom of the "acgi dispatcher" UI window, select "Accept Connections"
    5. Quit the "acgi dispatcher" application.
    6. Add "acgi dispatcher" to your start up items (Hint: System Preferences > Accounts > Login Items tab)
    7. Reboot your Mac and make sure that "acgi dispatcher" launches automatically.
  5. Install Librarian / Player / Web Monitor
    1. Download the following components from the RMS FTP _RMS_Apps folder (latest versions as of 8-May-06 are):
      • Librarian_X_050412_2.3.5.sit
      • PlayerCGI_X_050712_2.7.sit
      • PlayerCompact_X_050712_2.7.sit
      • Player_HTML_050712_2.7.sit
      • WebMonCGI_X_050207_2.3.1.sit
      • WebMon_HTML_050207_2.3.1.sit
    2. Expand each of these sit files and place their contents into the /Library/WebServer/Documents/ folder as follows (creating sub folders as needed):
      1. /Library/WebServer/Documents/milestone_1.2.htm (or your substitute)
      2. /Library/WebServer/Documents/RMS Librarian X
      3. /Library/WebServer/Documents/RMSPlayer/cgi-bin/PlayerCGI.acgi
      4. /Library/WebServer/Documents/RMSPlayer/cgi-bin/RMS PlayerCompactor X
      5. /Library/WebServer/Documents/RMSPlayer/html
      6. /Library/WebServer/Documents/RMSWebMonitor/cgi-bin/WebMonitorCGI.acgi
      7. /Library/WebServer/Documents/RMSWebMonitor/html
    3. In the Documents folder, run the RMS Librarian and configure its preference settings in the usual manner. At a minimum, make sure you set the Librarian's Incoming folder and RMS Data folder settings.
    4. In the Documents/RMSPlayer/cgi-bin folder, run the PlayerCGI.acgi application and configure its preference settings in the usual manner. Make sure you set the Player's Librarian location and RMS Data folder settings. Quit the Player CGI when finished configuring it.
    5. In the Documents/RMSWebMonitor/cgi-bin folder, run the WebMonitorCGI.acgi application and configure its preference settings in the usual manner. Make sure you set the WebMonitor's Librarian location and RMS Data folder settings. Quit the WebMonitor CGI when finished configuring it.
  6. Set up EIMS in the usual manner (see below). Make sure you point to the depository folder in /Library/WebServer/Documents/ instead of in the Web* folder.
  7. Since the Librarian has moved, you need to remove it from the startup items, and then re-add it (Hint: System Preferences > Accounts > Login Items tab)
  8. Now everything should be configured properly, so the last step is to run the EIMS Server X and the RMS Librarian applications.

Using WebStar OS X

This description corresponds to Milestone 2.7 (12-July-05) and later. It is intended for OS X (10.3.x) and later.

  1. Make sure you're logged into a Mac OS X user that has admin privileges.
  2. Download the WebStar v5.3 software from http://www.4d.com/products/downloads_4dws.html.
  3. Get the EIMS(3.2.3) software from http://www.eudora.co.nz.
  4. Place the "EIMS Server X 3.2.3" folder into the Applications folder. Place the "EIMS Admin X" application into the "EIMS Server X 3.2.3" folder.
  5. Create a new Mac OS X user named "webstar", with the password "webstar" (System Preferences -> Accounts). Leave the administer and log in for windows options unchecked.
  6. Install the WebStar software by running the "4d WebStar V" installer (use Easy Install option). The software gets installed into the /Applications/4DWebSTAR folder.
  7. Run the WebStarLauncher application that's in the /Applications/4DWebSTAR folder. When your run WebStarLauncher, it slo launches the WebStar Admin Client app. When the Client app prompts you, log on using the webstar/webstar username/password.
  8. When you log on to the Admin Client, select the "DefaultSite" settings group. In the Admin window, select the Licenses panel within the "Admin Server" section. Enter your server license code by clicking the New button, then click on the gray line in the "Sever Licenses" list and type the code in the "Server Licenses" list. Click the Save button.
  9. Also in the Admin folder, confiure the following settings:

    In the Web Server section:

    1. Web Connections panel
      1. Enter 240 in the Timeout(seconds) field to increase the timeout for processing long requests
      2. Click the Save button
    2. Suffix Mappings panel
      1. Click the New button
      2. In the Suffix edit box, type 'ra'
      3. In the MIME Type edit box, type 'application/x-pn-realaudio'
      4. Click the Save button
      5. Click the New button
      6. In the Suffix edit box, type 'MP4'
      7. In the MIME Type edit box, type 'audio/mp4'
      8. In the Type edit box, type 'mpg4'
      9. In the Creator edit box, type 'TVOD'
      10. Click the Save button
      11. Repeat to create another mapping with Suffix 'mp4' instead of 'MP4'

    In the Web Host section:

    1. CGI Settings panel
      1. Make sure all of the checkboxes at the top of the panel are checked.
      2. Click the Save button

    In the Mail Box Server section:

    1. Connections panel
      • Click on the port number for the POP protocol line and change the number from 110 to 1110.
      • Click on the port number for the IMAP protocol line and change the number from 143 to 1143.
      • Click the Save button

    In the SMTP Server section:

    1. Connections panel
      • Click on the "listening" port number 25 and change it to 1025.
      • Click on the "listening" port number 2500 and change it to 12500.
      • Click the Save button

      The reason for changing these port settings is so that EIMS and WebStar will not both be listening on the same IP port for incoming mail.

    Also, when finished with these settings, be sure to review the other WebStar server settings to make sure they're appropriate for your installation.

  10. Quit the WebStar Admin Client and WebStar Launcher applications so that the license code can kick in. Then restart the WebStar Launcher app.
  11. To test the WebServer installation, run a browser on the same Mac and go to the url http://localhost/. You should then see the default WebStar server page.
  12. The WebSever/DefaultSite folder will contain the RMS web site's files. Open the DefaultSite folder and remove all of the files and folders it contains.
  13. Download the following components from the RMS FTP _RMS_Apps folder (latest versions as of 12-July-05 are):
    • Librarian_X_050412_2.3.5.sit
    • PlayerCGI_X_050712_2.7.sit
    • PlayerCompact_X_050712_2.7.sit
    • WebMonCGI_X_050207_2.3.1.sit
    • WebMon_HTML_050207_2.3.1.sit

    Expand each of these sit files and place their contents into the DefaultSite folder.

  14. Download the following component from the RMS FTP _RMS_Misc folder:
    • StuffitEngineForOSX [ Note: this is no longer needed for RMS Server v 2.3 and later, but is still used by WebMontior 2.3.1 ]

    Expand the sit file the folder contains (StuffItEngine_6.5.1.sit) and place the StuffIt Engine™ file in the /Library/Application Support folder.

  15. The next step is to configure the permissions for running EIMS. Perform the following steps:
    1. Run the Terminal program that's located in the Applications/Utilities folder.
    2. Type the following command: cd "/Applications/EIMS Server X 3.2.3"<cr>
    3. Type the following command: chmod 6550 "EIMS Server X"<cr>
    4. Type the following command: sudo chown root "EIMS Server X"<cr> (Note: you'll need to enter your Admin password to perform this command)
  16. Run the EIMS Server X application. Once it starts, run the EIMS Admin X application and configure the EIMS settings in the usual manner. For example, create a new user with Login Enabled, Account Enabled, Don't Leave Mail on Server enabled, set Mail Action to "Save as Files", and enter the full path of the Librarian Incoming folder (e.g. MyMac:Applications:4DWebSTAR:WebServer:DefaultSite:Incoming). Quit the Admin program when finished configuring it.
  17. The next step is to configure the permissions for running the RMS software with the Web server. Perform the following steps:
    1. Run the Terminal program that's located in the Applications/Utilities folder.
    2. Type the following command: cd /Applications/4DWebSTAR/WebServer<cr>
    3. Type the following command: sudo chmod -R 770 DefaultSite<cr> (Note: you'll need to enter your Admin password to perform this command)
  18. In the DefaultSite folder, run the RMS Librarian and configure its preference settings in the usual manner. At a minimum, make sure you set the Librarian's Incoming folder and RMS Data folder settings.
  19. In the DefaultSite/RMSPlayer/cgi-bin folder, run the PlayerCGI.acgi application and configure its preference settings in the usual manner. Make sure you set the Player's Librarian location and RMS Data folder settings. Quit the Player CGI when finished configuring it.
  20. Copy the RMS PlayerCompactor into the same folder as the PlayerCGI.acgi (i.e. DefaultSite/RMSPlayer/cgi-bin).
  21. In the DefaultSite/RMSWebMonitor/cgi-bin folder, run the WebMonitorCGI.acgi application and configure its preference settings in the usual manner. Make sure you set the WebMonitor's Librarian location and RMS Data folder settings. Quit the WebMonitor CGI when finished configuring it.
  22. Now everything should be configured properly, so the last step is to run the EIMS Server X, the 4DWebSTAR Launcher and the RMS Librarian applications.

 

RMS Server

For detailed installation instructions, see RMS_Server_Setup_Doc_1.5.pdf.

IMPORTANT NOTE: RMS Server v3.6 and later running on OS 10.4+ will generate .tgz files to send to the Librarian. So if you are installing Server 3.6+ on OS 10.4+ you must make sure that the receiving Librarian is also v3.6 or later. If you are running RMS Server on OS 10.3.x or earlier, then RMS Server will continue to generate .sit files to send to the Librarian. RMS Server v3.8 and later requires OS 10.4+ and will only generate .tgz files; Stuffit is no longer supported.