Apple Remote Access 3.0 Read Me

Introduction
This document contains the late-breaking information about Apple Remote Access 3.0.


Contents
What's new in Apple Remote Access 3.0 - general
System Requirements
Open Transport Requirements
Apple Software Update Sites
Before You Install Apple Remote Access 3.0
Known Incompatibilities and Limitations
AppleShare IP Compatibility
Using an Express Modem or GeoPort Telecom Adapter
Miscellaneous Information About ARA 3.0
Troubleshooting Support
Notes for ARA 3.0 Server System Administration
Modem Support
Modem Script Generator
Additional (Unsupported) Modem Scripts
Modem Cable Requirements
Using an ISDN Terminal Adapter
How to Remove or Disable Apple Remote Access 3.0


What's new in Apple Remote Access 3.0 - general
ARA 3.0 is a major upgrade from the previous version, ARA 2.1. ARA 3.0 represents a complete rewrite, and offers a merging of capabilities previously requiring two software packages: ARA and OT/PPP and also includes features not in either of these packages.

New for ARA users:

• ARA 3.0 is rewritten "from the ground up" using native Open Transport interfaces, and runs native on PowerPC based personal computers.
• ARA now supports the open PPP standard, and can be configured to connect to multiprotocol PPP servers using both AppleTalk (ATCP) and TCP/IP (IPCP) concurrently, or can be configured to connect to PPP servers at Internet Service Providers (ISP's). ARA can now call your office or the Internet.
• ARA 3.0 offers Open Transport-style control panels, now fitting in with modern Mac OS human interface design and is now consistent with the rest of Open Transport.
• Automatic detection of server protocol support (ARAP or PPP).
• ARA 3.0 is scriptable.
• ARA 3.0 includes AppleGuide Help.
• A Control Strip Module is included.
• The Remote Access control panel includes send and receive indicators of network traffic.
• Open Transport 1.1.1 or later is required.

New for OT/PPP users:

• ARA 3.0 Client includes a control strip module.
• The Remote Access control panel replaces the PPP control panel.
• The Remote Access control panel includes a triangle control to reduce the window size.
• AppleTalk PPP (ATCP) support is now included.

System Requirements
Apple Remote Access 3.0 is designed to work on Mac OS-compatible computers with a Motorola 68030- or 68040-family microprocessor, or a PowerPC 601, 603e, 604, or 604e microprocessor.

The recommended system software version for Apple Remote Access 3.0 is 7.5.3 or later, updated with Open Transport 1.1.1. or later networking software. System Software versions 7.1, 7.1.1, and 7.1.2 releases are also compatible with Apple Remote Access 3.0 updated with Open Transport 1.1.1 or later.

Note: Apple Remote Access 3.0 cannot be used with system software versions 7.5, 7.5.1, or 7.5.2. Before installing Apple Remote Access 3.0 on one of these systems, install System 7.5, Update 2.0.

Apple Remote Access 3.0 requires a minimum of 8 megabytes (MB) of RAM however 16 megabytes is recommended.


Open Transport Requirements
Open Transport version 1.1.1 or later is required in order to install Apple Remote Access 3.0. Your Apple Remote Access 3.0 CD comes with Open Transport 1.1 and the 1.1.2 Update installers. Apple recommends installing or upgrading to this version if you are using system 7.x. If you have Mac OS 8.0 software already installed on your computer you will not need to update or upgrade your Open Transport network software.

Steps required to install Open Transport depending on what system software you have:

System 7.1.x

1. Install Open Transport 1.1.
2. Install Open Transport version 1.1.1 or later. Open Transport 1.1 and 1.1.2 has been provided with this product.

System 7.5, 7.5.1, or 7.5.2

1. Install System 7.5, Update 2.0. (Available free online at Apple Software Update sites. See the following section for information on how to find these sites.)
2. Choose Open Transport (if it is not already chosen) in the Network Software Selector which is located in the Apple Extras Folder. Once you choose Open Transport, restart your computer.
3. Install Open Transport version 1.1.1 or later. Open Transport 1.1 and 1.1.2 has been provided with this product.

Mac OS 7.5.3 or 7.5.5

1. Choose Open Transport (if it is not already chosen) in the Network Software Selector which is located in the Apple Extras Folder. Once you choose Open Transport, restart your computer.
2. Install Open Transport version 1.1.1 or later. The Open Transport 1.1.2 Update has also been provided with this product.

Mac OS 7.5.3: if you have performed a custom installation without installing Open Transport

1. Use the Mac OS 7.5.3 or System 7.5, Update 2.0 installer to custom-install Open Transport 1.1.
2. Choose Open Transport (if it is not already chosen) in the Network Software Selector which is located in the Apple Extras Folder. Once you choose Open Transport, restart your computer.
3. Install Open Transport version 1.1.1 or later. The Open Transport 1.1.2 Update has also been provided with this product.

Mac OS 7.5.5: if you have updated a system on which Open Transport was not installed due to a custom installation.

1. Reinstall system software using the system software disks that came with your computer.
2. Based on the version of the system software that came with your computer, use one of the procedures above to install Open Transport version 1.1.1 or later.

Mac OS 7.6 includes Open Transport version 1.1.1 networking software.

Mac OS 8.0 includes Open Transport version 1.2 networking software.


Apple Software Update Sites
Information about updating Apple software is available online on the World Wide Web and other online servers. On the Web, go to the Apple Software Updates Web site at http://www.apple.com/swupdates .

Reading article 14724: "Where To Find Apple Software Updates", you can find Apple Software Updates locations for Internet, America Online, and other online services.


Before You Install Apple Remote Access 3.0

• Save any special modem scripts from your system folder (extensions folder) prior to installing ARA 3.0.
• Please note that any previously installed Open Transport/PPP and ARA 2.x system software component will be replaced by ARA 3.0. ARA 2.x connection documents can be converted through the "import" button in the "Configuration" window of the Remote Access Control panel. Select "Configuration" from the file menu of the Remote Access Control Panel to display the "Configuration" window.
• Although your existing Open Transport/PPP configurations will be automatically converted to conform to the ARA 3.0 configuration format, you can save your existing configurations using the "export" button in the "Configuration" window. Select "Configuration" from the file menu of the PPP Control Panel to display the "Configuration" window. Using the export and import features also allows you to move configurations from one system to another.
• If you are using the ARA 2.1 Personal Server on a system that is also configured to receive Faxes using 3rd party FAX software, you may need updated FAX software before installing the ARA 3.0 Personal Server. Verify with your FAX software vendor that their package is compatible with ARA 3.0 before updating.
• Open Transport/PPP users need to be aware that ARA 3.0 subsumes Open Transport/PPP functionality.

Known Incompatibilities and Limitations

• The ARAP Client is not notified if new network services appear on the Server side. Specifically if the Client connects via ARAP to a network on which there is no router, when a router is started on the ARA Server network, the Client is neither notified that the new network connectivity is available nor can the Client access the new services available across the router. To see these new network services the user must disconnect the current ARA connection and reconnect.
• Some Client connections set to the "Automatic" protocol in the Remote Access Control Panel may get the ARAP protocol even when the PPP protocol is available. The activity log will display what protocol is being used. If PPP protocol is desired, explicitly select that protocol under the protocol option instead.
• AutoRemounter does not work with ARA. Volumes mounted via ARA 3.0 prior to Sleep mode will not be automatically remounted.
• ARAP or PPP connections will be disconnected if the machine goes into Sleep mode. The user will receive a "terminating ARAP or PPP connection" dialog upon wakening.
• If you restart a PowerBook which is set up as an ARA 3.0 Server and is using a PC Card modem, the ARA server may not enable the auto-answer mode with some PC Card modems.
• Sometimes when the PowerBook 3400 with the built-in 33.6K Modem/Ethernet card as an ARA Personal Server a Client will not be able to access AppleShare servers or machines running Personal File Sharing. The attempt to mount the server will succeed, but when the server icon is opened the connection may time out and drop the remote access connection.
• The control strip may not accurately display the amount of time connected as shown in the connection document.
• In some cases the status information in the Remote Access Control Panel is not updated correctly even if a connection is made successfully. This may happen if you make one connection where the TCP/IP Control Panel is set to use MacIP, disconnect, change to a TCP/IP Configuration that uses PPP, and then connect again. If you have the Control Strip installed, the ARA Control Strip Module can be used to verify your PPP connection was successful using the following procedure:
  
  1. Select Status Display in the ARA Control Strip pop-up menu.
  2. Choose the Time connected radio button.
  3. Press the OK button to dismiss the dialog box.
  
  The time connected status display will increment if a successful connection has been made. The status will display 0:00:00 if there is no active connection.
  The combination of a PPP call, following a MacIP call can also cause the PPP connection to fail if the "Connect automatically when starting TCP/IP applications" Protocol Option is selected. If you restart your computer between changing configurations, or after a failed connection the next connection will be successful.
• Launching a non-X.25 ARAP file server alias is successful if the X.25 check box option is set. If you have installed the X.25 option for ARA 3.0 and have created a volume alias over an ARA connection using the X.25 option, but then find that you cannot reconnect to the volume later when using the alias, check to see if the X.25 option box is still checked in the ARA Options dialog. When the alias is created, the X.25 information is not stored into the alias. As a result, if the X.25 option box is unchecked, then ARA will use it's current setting and fail to connect via X.25 when the alias is used to establish the connection.

AppleShare IP Compatibility
ARA Personal Server 3.0 and AppleShare IP 5.0 are not fully functional together. AppleShare IP 5.0 does not provide User fields for ARA CallBack or Enable Dial-In. If you install ARA Personal Server 3.0 and AppleShare IP 5.0 on the same computer - please note the following.

Installation Order - ARA Personal Server has to be installed first. If not, current User information will not be imported into AppleShare IP 5.0's User list. Your ARA server will not work if installed after AppleShare IP 5.0.

ARA User Information - the information isn't modifiable within AppleShare IP 5.0 Manager's User Window.

An unsupported solution to this scenario is available. The AppleShare IP 5.0 website has posted an OpenDoc Editor called UserARA that allows ARA User fields to be modified within AppleShare IP's User Window. It can be found on the Internet at http://www.apple.com/appleshareip/.

The ARAUser OpenDoc Editor provides within AppleShare IP Manager a User Remote Access menu to modify ARA CallBack and Enable ARA Dial-In. The ARA options can be found in the AppleShare IP Manager's Users & Groups List after opening a User window and switching the Pop-Up Menu to Remote Access.


Using an Express Modem or GeoPort Telecom Adapter

• If you are using Express Modem software with either an Express Modem or a GeoPort Telecom Adapter, you must turn on 32-bit addressing in the Memory control panel.
• If an ARA 3.0 Client launches an Apple installer on a remote server volume and the installer needs to quit any running applications, the connection will be dropped. Apple recommends dragging the application net install folder to the hard drive before starting an installation.
• If an ARA Server using a GeoPort modem is shut down (using the Shut Down item in the Special menu) while a Client is connected, the Client may not receive a disconnect notification. The Client will eventually timeout. Apple recommends manually disconnecting Clients before shutting down the ARA Server.
• If an ARA client using a GeoPort modem is shut down while there are open applications, the applications may display alerts to the fact that the connection has disappeared. Apple recommends manually quitting such application before shutting down the Macintosh. You can place an alias of the "Disconnect Remote Access" Apple Menu Item into the System's Shutdown Items folder. If you do this, do not cancel the disconnection.
• A client machine with an Express Modem or GeoPort software and System 7.x may stop responding when aliases are used to make a remote connections. This is resolved by upgrading to Mac OS 8, or not using the alias feature in this configuration.
  Note: This does not apply to the internal 33.6K modem on the PowerBook 3400; alias connections from the 3400 work as expected.

Miscellaneous Information About ARA 3.0

• If the user installs ARA 3.0 Personal Server software on a system that had ARA 2.1 Client software, the ARA 2.1 application is not removed. Launching ARA 2.1 will result in a failed connection. To prevent this problem remove the ARA 2.1 application.
• Users are recommended not to install Open Transport/PPP over ARA 3.0. ARA 3.0 subsumes Open Transport/PPP functionality. Open Transport/PPP is installed by default when loading Mac OS 7.6 or later. If Open Transport/PPP was installed over ARA 3.0, reinstall ARA 3.0.
• When using PPP, the user must set the TCP/IP Control Panel to Connect via: PPP before connecting to an IP service. Attempting to set the TCP/IP Control Panel to Connect via: PPP after the connection will fail forcing a reconnection to any IP service.
• Prior to Mac OS 8.0, the Mac OS Guide makes references to the PPP Control Panel. The PPP Control Panel was replaced by the Remote Access Control Panel with ARA 3.0. For assistance, open the Remote Access Control Panel and use the Remote Access Guide.
• On a Client only ARA System, if the Users&Groups Control Panel is opened, each "User" has an option to enable dial-in even though the server functionality is not present.
• When using a Terminal Window upon opening a PPP connection, the Terminal Window will be closed if the user chooses the "Cancel" option. The terminal window can be brought up only once during a PPP session.
• ARA 3.0 works with 2.x aliases but ARA 3.0 aliases cannot be used with earlier versions of ARA.
• When traveling outside of the U.S., the user may need to manually edit the area code in the Remote Access setting to remove the leading "0" in the as DialAssist does not strip the "0".
• When updating to ARA 3.0, retain your Open Transport/PPP configurations by using the export and import procedures. See your ARA 3.0 User Manual for more detail.
• If you are using a Global Village PowerPort Platinum Pro PC card modem and you get an error message stating the port is busy, please check the Global Village web site at (http://www.globalvillage.com/) for information and updates.
• The Verbose Logging checkbox does not provide additional server information.
• There is no maximum size to the Remote Access Log. If disk space is at a premium, periodically back up the log file and clear the log. The Log file is located in the Remote Access folder in the Preferences folder.

Troubleshooting Tips

• If your connection protocol is set to "Automatic" and the connection attempts repeatedly fails, set the connection protocol to either PPP or ARAP. Some servers are not compatible with Automatic connections.
• When connecting to some 3rd-Party PPP servers with AppleTalk, the ARA 3.0 software may erroneously indicate that the connection is still pending when it has actually connected. One symptom is that the ARA Control Panel will indicate that ARA is "starting network protocols" and not change. If VM is On, the problem may disappear when turning VM Off.
• When using Timbuktu 3.0.2 you should not click rapidly between different zones with some 3rd party remote access servers. The number of responses can overload the server and prevent display of devices in the selected zone until the remote access server is less busy. When dialing into an Ascend server it can sometimes take a long time ( 5-10 minutes) for all devices to be displayed. Apple, Ascend and Farallon are working to prevent this from happening through an update to one or more products.
• When using the ARA Client from a network without zones or a single Macintosh, if the AppleTalk Control Panel is set to Ethernet, Timbuktu 3.0.2 may not display a list of zones after the connection to the remote network is made. The workaround is is to set the AppleTalk Control Panel to Remote Only.

Notes for ARA 3.0 Server System Administration

ARA Server Security Considerations

• ARA 3.0 provides the same security features present in ARA 2.x products. In order to provide the same level of security for TCP/IP clients the ARA Server must be configured in the following manner:
  • AppleTalk must be active.
  • TCP/IP must be set to use the same port as AppleTalk or
  • TCP/IP must be set to use MacIP (in the Connect Via pop up)
• PAP Authentication works with ARA only when Guest access is allowed, otherwise CHAP Authentication is used. Some older PPP clients (e.g. MacPPP 2.0.1) do not work with CHAP, so either the PPP client software must be updated to a version that does work with CHAP or Guest access must be allowed. Reminder: Guest access does not require a password, therefore anyone can connect to the server.

Using manually configured IP addresses for Client connections

• Enabling the "Allow client to use own IP Address" PPP Server Setup option with Open Transport 1.2 or earlier is not recommended if two or more ARA Personal Servers are installed on the same network. This option is configured in the Answering dialog of the Remote Access Control Panel.
• On the server, Open Transport continues to defend the client's IP address until the server is restarted, even after the client has disconnected. This prevents other servers from allowing a client to use the same manually configured IP address for later connections to the network. When the client using a manually configured IP address connects to the 2nd server, both the original server and the server accepting the call report a duplicate IP Address errror dialog which need to be manually dismissed. The dialog reports each server's IP address as being in conflict, not the address of the manually configured client. The 2nd server's Log will indicate the actual conflicting IP address. If this occurs both server machines should be restarted. This will clear Open Transport's ARP Table. A future version of Open Transport will remove this limitation.

Changing Server Settings While Clients are Connected

• In general, changing settings on the ARA Server while clients are connected is not recommended. In many cases, the client is not notified of the change in the network. Examples are:
  
  - Server: Switching Network Ports - Client will be disconnected
  - Server: Turning off AppleTalk - Client will be disconnected
  - Server: Going into Sleep Mode - Client will be disconnected
  - Router: Adding a router to the Server Network - Client needs to reconnect to get updated network information
  
  Note: In most of the above cases the Client will be immediately disconnected and no warning will be issued.
  
  Important: If changes need to be made, disconnect the Client.
  
• The ARA Personal Server periodically checks to see if the attached modem is working correctly if answering is enabled. It will make an entry in the Log each time it checks, if it can not communicate with the modem. The status area of the Remote Access Control Panel will still display Call answering enabled even if the modem is off or not connected. Apple recommends you not turn off the modem attached to a computer with Answer Calls enabled to prevent confusion about server status, and to avoid repetitive Log entries.

Modem Support
Scripts that work with many popular modems are provided on the Apple Remote Access installation disk(s). This is the list of scripts provided with ARA 3.0:

3Com Impact Analog 14.4
3Com Impact ISDN 56K
3Com Impact ISDN 56K MLPPP
3Com Impact ISDN 64K
3Com Impact ISDN 64K MLPPP
Apple Personal Modem
AT&T Dataport 288
AT&T KeepInTouch
Best Data Smart One 28.8/33.6
Dayna CommuniCard 28800
Farallon Netopia 56K
Farallon Netopia 56K MLPPP
Farallon Netopia 64K
Farallon Netopia 64K MLPPP
Farallon ISDN PC Card ARA 56K
Farallon ISDN PC Card ARA 64K
Farallon ISDN PC Card PPP 56K
Farallon ISDN PC Card PPP 64K
Farallon LAN/Modem PC Card
GeoPort/Express Modem
GeoPort/Express Modem CNG
Global Village Gold/Silver/Merc
Global Village Platinum/Gold II
Global Village x2
Global Village 28.8-k56
Hayes Accura 288
Hayes Optima 288
Hayes Accura 56K
Megahertz CruiseCard 14.4
Megahertz CruiseCard 28.8
Metricom Ricochet Wireless
Microcom DeskPorte Fast/288
Microcom QX/4232bis
Motorola BitSURFR 56K
Motorola BitSURFR 56K MLPPP
Motorola BitSURFR 64K
Motorola BitSURFR 64K MLPPP
Motorola ModemSURFR 28.8
Motorola Power/Lifestyle 28.8
Null Modem 115200
Null Modem 19200
Null Modem 57600
Null Modem 9600
Practical Peripherals V.34
Supra 144
Supra 288/336
Supra 336v+/336e/56e
TDK DF2814
Telebit QBlazer
US Robotics Universal
Zoom V-Series

Apple now installs all modem scripts in the Modem Scripts folder (in the Extensions folder) instead of directly in the Extensions folder. Future Apple products will handle modem scripts the same way. Apple Remote Access 3.0 does not recognize modem scripts stored outside the Modem Scripts folder.

Auto-routing of modem scripts has been disabled by the installer. Once Apple Remote Access 3.0 is installed, a modem script will not be routed to the Extensions folder if it is dragged into an active System folder.

The Easy Install mode of the installer copies all of the Apple Remote Access 3.0 modem scripts to your disk. You can choose Custom Install to limit the installation to only the scripts you choose.

Note: You can delete any unneeded scripts from the Modem Scripts folder, which is located inside the Extensions Folder.

Note: You must use the Custom Install option in order to install X.25 functionality.


Modem Script Generator
The Apple Modem Script Generator has been provided in a separate folder on the CD or on the Internet for users who prefer to generate their own modem scripts.


Additional (Unsupported) Modem Scripts
User and some vendor contributed scripts are available online or in the ARA Extras Folder on the ARA 3.0 CD. New modems are regularly introduced and Apple is willing to help publish scripts contributed by users to aid in making Apple Remote Access work easily with as many modems as possible.

Important: Scripts provided in the Unsupported folder are not tested or supported by Apple, Inc., so you should contact the script's author or vendor rather than Apple if you run into difficulty using a script downloaded from the unsupported folder. These contributed modem scripts are provided on an as-is basis as a convenience to Apple customers. They are not warranted to be complete or free from errors, although Apple may choose to review and fully test some user-contributed scripts and include them in future versions of Apple software. If you want to provide Apple with feedback about particular user-contributed scripts, send electronic mail to the following address: msg@apple.com

To find these scripts, go to any Apple Software Updates location and use the following path:
/English-North_American/Macintosh/Misc/User_Contributed_CCLs/


Modem Cable Requirements
Most modems require a cable that supports the data terminal ready (DTR) signal. In addition, certain modems require a cable that is compatible with CTS/RTS hardware flow control. To work with DTR, the cable must connect pin 20 on the DB-25 connector to pin 1 on the Mini DIN-8. To work with CTS/RTS, the cable must connect pin 5 on the DB-25 connector to pin 2 on the Mini DIN-8 and pin 4 on the DB-25 connector to pin 1 on the Mini DIN-8. Contact your modem vendor or Apple-authorized dealer to obtain the necessary cable.


Using an ISDN Terminal Adapter
Apple Remote Access 3.0 supports serial connection speeds of 115,200 and 230,400 bps. By doing so, Apple enables Macintosh users to make ARA and PPP connections over ISDN lines at 64 kbps or even 112 kbps if the ISDN terminal adapters at both ends are compatible with channel bonding and proper modem scripts are used.

Note: The "Connected at" line of the Remote Access control panel status box may not accurately reflect the connection speed of ISDN connections. A slower speed may be indicated because ISDN terminal adapter hardware does not report the establishment of second channel connections to the CCL script engine. This will usually happen if you use the Multilink PPP (MLPPP) version of an ISDN script.

Connection speeds of 115,200 and 230,400 bps are not supported by the serial ports on most older Macintosh computers. Here is a partial list of Macintosh models that do have fast serial port support:

• Macintosh Centris 660av, Macintosh Quadra 660av and Macintosh Quadra 840av models
• Macintosh Performa 6100CD series
• Power Macintosh 6100, 7100, 7200, 7300, 7500, 7600, 8100, 8500, 8600, 9500 and 9600 models
• Workgroup Server 6150, 7250, 8150, 8550, and 9150 models

To set the built-in serial ports at 115,200 or 230,400 bps, a new serial driver called SerialDMA must be installed to replace the standard Macintosh serial device driver. SerialDMA 2.0.2 is provided by Apple. It is highly recommended that the file Serial (Built-in) be installed in the Extensions folder as well on Macintosh models with PCI slots to support these high speeds (38,400 bps and above). System 7.5.3 or later includes the latest version of SerialDMA and the file Serial (Built-in).

Note: In general, ISDN terminal adapters have more configuration options than conventional modems. At this time it is not possible for Apple to support all combinations of these options for all the ISDN terminal adapters that are available. We have attempted to write scripts that work with the most common ISDN configurations. You may have to get a revised script from your Internet service provider or network administrator if your server uses different options. You can also modify a script yourself using the Modem Script Generator or by editing the script text directly. You can find the Modem Script Generator in the Unsupported folder mentioned earlier in this document.


How to Remove or Disable Apple Remote Access 3.0

To remove Apple Remote Access 3.0 software by using the Custom Remove option in the Installer:

1. Open the Installer application included with Apple Remote Access 3.0. The Welcome to the Apple Installer screen appears.
2. Click the Continue button. The Apple Remote Access 3.0 Installation screen appears
3. Choose Custom Remove from the pop-up menu in the upper-left corner.
4. In the list that appears, select the items you would like to remove by clicking the box next to each item so that an "X" appears in it. To completely remove Apple Remote Access 3.0, you should select all the item listed.
5. Click the Remove button. If a window appears asking you whether to quit any open applications, click Continue. A window will appear telling you to restart your computer.
6. Click the Restart button.

To disable Apple Remote Access 3.0 without using the Installer:

Note: Although the Remote Access and Modem control panels appear in the Extensions Manager, there is no component in the Extensions Manager that lets you disable Apple Remote Access 3.0. To disable Apple Remote Access 3.0 without using the Installer, you must follow the instructions given here.

1. Move the OpenTpt Remote Access and OpenTpt Modem shared libraries from the Extensions folder in the active System Folder.
2. Move the Remote Access Command file from the Scripting Additions folder in the Extensions folder.
3. Move the Remote Access and Modem control panels from the Control Panels folder in the active System Folder.
4. Restart your computer.

It is not necessary to move the Modem Scripts folder from the Extensions folder.