RMS II
RMS Client Application

(rev. 30-Jul-04)

RMS Client

Introduction

The RMS Client application allows you to access a RMS Server installation remotely either through a dial-up modem, or through the Internet (depending upon how the RMS Server was configured). You can see the sound and scan data files that the RMS Server has created and retrieve those files either directly, or via an automated download process. You can also download the Server's current Script or Log files, and may upload a new Script file. New scripts are immediately installed and take effect as soon as you disconnect from the Server. And finally, you can transfer arbitrary files to and from the Server via the Transfer folder.

For connections to an RMS Server X, only TCP (full-time internet) connections are allowed. RMS Server X automatically listens for Client connections only if the connection is set to "full-time". An RMS Server X configured for "dial-up" cannot connect with a Client. In contrast, RMS Server 9 allows connections to a Client configured for either "full-time" or "dial up" internet.

System Requirements

CPU:           Any 680x0 or PowerPC Macintosh, PowerBook, or clone
Memory Usage:  3MB
Disk Usage:    1MB + however much space is needed to store retrieved data files
Network:       28.8+ Modem for client dial-out (external, internal, or PCMCIA);
               Full-time Internet connection with Open Transport 1.1.1 or later, or
                 part-time Internet connection via Modem and OT/PPP 1.0 or later;
               EtherTalk/LocalTalk connection optional, depending upon supported Client connection
OS:            System 7.5 or later, including System 8 or 9

Hardware Setup

  1. Connect hardware for communications with RMS Server application:
    • OPTION A. Set up for dial-out connection to Server 9.
      This is a typical "old style" communication installation. In this situation, the Client will use a modem to dial-out and establish a connection to the Server.
      Connect the modem:
      • If using a standard Mac with external modem, connect the modem to the Mac's Modem (typical) or Printer port, and then connect the phone cable to the modem.
      • If using a standard Mac with internal modem, connect the phone cable to the modem.
      • If using a PowerBook with an internal modem, connect the phone cable to the internal modem.
      • If using a PowerBook with a PCMCIA modem, connect the phone cable to the PCMCIA card.
      • No other options for connecting the modem are supported.
    • OPTION B. Set up for full-time Internet connection to Server 9 or Server X.
      This is the typical setup where the Client will maintain a full-time connection to the Internet (most likely via an Ethernet connection) and will use standard TCP/IP protocols to connect to, and communicate with, the Server.
      Connect to the Internet:
      • If using a standard Mac, connect to the Internet via the Mac's Ethernet port or via a LocalTalk connection (requires the use of an Internet gateway).
      • If using a PowerBook with a built-in Ethernet connection, connect to the Internet via the Ethernet port.
      • If using a PowerBook with a PCMCIA card that supports Ethernet communications, connect to the Internet via the card's Ethernet port.
      • No other options for connecting to the Internet are supported.
    • OPTION C. Set up for local network connection (e.g. LocalTalk) to Server 9.
      This option is primarily to facilitate demonstrations and testing of the RMS II system and is not intended as an option for installing RMS II in the field.
      Connect to local AppleTalk network:
      • If using a standard Mac, connect to the local network using either a LocalTalk connector connected to the Printer port, or an Ethernet connector connected to the Ethernet port.
      • If using a PowerBook with no built-in Ethernet connection, connect to the local network using a LocalTalk connector connected to the PowerBook's external serial port, the "Printer/Modem Port".
      • If using a PowerBook with a built-in Ethernet connection, connect to the local AppleTalk via the Ethernet port.
      • If using a PowerBook with a PCMCIA card that supports Ethernet communications, connect to the local AppleTalk network via the card's Ethernet port.
      • No other options for connecting to the Internet are supported.

Software Components

Software Installation

Perform the following steps to install the RMS II software necessary to run the Client Mac.

  1. Copy the file "RMS Client" to a folder on the Mac's hard disk. For example, you might name the folder "RMS II Client".
  2. Copy the following Communications Toolbox Tools to the Extensions folder within the Client Mac's OS 9 System Folder:
    • Apple Modem Tool (for connecting to Server 9)
    • TCP Tool (for connecting to Server 9 or Server X)
    • AppleTalk ADSP Tool (for connecting to Server 9)
    • Mark/Space ZModem Tool (for connecting to Server 9)
  3. Install StuffIt v5.5 on the Client Mac. Note: StuffIt is not provided on the standard RMS II installation disks.
  4. Install the RealAudio Player software using RealAudio's standard installer. Note: RealAudio Player is not provided on the standard RMS II installation disks.
  5. If you intend to utilize a full-time Internet connection to the Server, then you must install Apple's Open Transport software using its standard installer (for older Mac OS versions only; newer versions come with Open Transport pre-installed). Note: Open Transport software is not provided on the standard RMS II installation disks.

Software Setup

Perform the following steps to configure the various RMS II software components on the Client Mac.

  1. Configure Open Transport software (may be optional).
    • If you installed the Open Transport software in the installation step, you must configure the software now. Please refer to the Open Transport documentation for how to properly configure the TCP/IP connection for your particular server.
  2. Create and edit the Client connection document. In order for the RMS Client to know how to communicate to the RMS Server, it reads a Client connection document. Client connection documents are created by the RMS Client and encapsulate all of the information needed to communicate with a specific RMS Server. Users of the RMS Client can create any number of Client connection documents, typically one for each Server site the user wants to contact. To create a Client connection document, open the RMS Client application and perform the following steps:
    • Invoke the New command from the File menu to create a new Client connection document.
    • Configure the Server communication settings. Click the Setup button to specify the communication settings the Client should use when connecting to the specific Server site that corresponds to this Client connection document. In the dialog which appears, a popup menu listing the available Communications Tools is provided. Consult the following to determine which tool to use for your type of Server connection:
      • For Client dial-out connections to Server 9, select Apple Modem Tool
      • For Client full-time Internet connections to Server 9 or Server X, select TCP Tool
      • For Client local AppleTalk network connections to Server 9, select AppleTalk ADSP Tool
      • Configuring Apple Modem Tool Connections to Server 9:
        • Select the Apple Modem Tool from the popup menu.
        • Select the following communication settings:
          • Baud rate: fastest the modem will support (use 38.4K for 28.8 and 33.6 modems)
          • Parity: None
          • Stop Bits: 1
          • Data Bits: 8
          • Handshaking: DTR & CTS
        • Select the port your modem is connected to from the list at the lower right.
        • Enter the phone number in the edit box provided. Be sure to include any special characters needed in the number such a '9' for an outside line, or a '1' before the area code.
        • Under Modem Options, select the name of your modem. If your modem doesn't appear in the list, you can contact the modem manufacturer to see if a Apple Modem Tool compatible script exists for your modem, and if so, get a copy from them. You can also create a custom modem definition by invoking the Custom command from the menu. This is considered an expert feature and not to be used under normal conditions.
        • Once a modem is selected from the list, choose the best error correction options available for the modem.
        • Click OK in the dialog.
      • Configuring TCP Tool Connections to Server 9 or Server X:
        • Select the TCP Tool from the popup menu.
        • For host name, enter the domain name of the Server machine (e.g. ibb.beijing.com) or the Server's IP address (e.g. 206.89.53.2). Make sure you're connected to the Internet before configuring the TCP Tool, because it will attempt to determine and/or verify the IP address when you dismiss the dialog.
        • For IP Port, enter the port number 20000. This is the port on which RMS Client and RMS Server communicate. For RMS Server 9, you must also enter 20000 for the port in the Client section (TCP Tool area) of the RMS Server Config document. For RMS Server X, the port 20000 is pre-configured (i.e. hard coded).
        • Click OK in the dialog.
      • Configuring AppleTalk ADSP Tool Connections to Server 9:
        Note: This option is primarily to facilitate demonstrations and testing of the RMS II system and is not intended as an option for installing RMS II in the field.
        • Select the AppleTalk ADSP Tool from the popup menu.
        • Enter "RMS II" in the Connection Type edit box. Make sure the Server machine is available on the network and it's configured for a connection type of "RMS II".
        • After a few moments, the name of the Server machine should appear in the list box at the lower right. Once it appears, select it. You may need to change AppleTalk zones if the Server machine is in a zone different than the one containing the Client machine.
        • Click OK in the dialog.
    • Save changes to the configuration document by invoking Save As from the File menu. You can name the document anything you choose; for example, "Connect to Vienna RMS".
    • If you wish, you can now connect to the Server by clicking the Connect button.
  3. Restart the Client Mac. The RMS Client is now configured for operation.

Notes