AppleShare IP 5.0.2: Read Me

CONTENTS

What's New
Requirements for Running AppleShare IP 5.0.2
Requirements for Running AppleShare Client 3.7.2
Support
Installing AppleShare IP 5.0.2
Known Problems, Incompatibilities and Limitations

What's New

AppleShare IP 5.0.2 provides Mac OS 8.0 support, two new major features and a number of fixes since version 5.0. First, it supports web server plug-ins that are compatible with W*API version 1.1. Please refer to AppleShare IP 5.0.2 Addendum on the AppleShare IP 5.0.2 CD-ROM disc for more information on how to use web server plug-ins. Second, the ability to configure ARA user information was added to the administration software. AppleShare IP 5.0.2 also provides full compatibility with Mac OS 8.0, At Ease 5.0 and ARA 2 and 3 personal server software.

There have been several changes to the AppleShare IP 5.0.2 Mail server which improve its performance, robustness and feedback to the administrator about current mail activity.

• AppleShare IP Mail is now better behaved with regards to DNS. There were some cases in AppleShare IP 5.0 and 5.0.1 where the AppleShare IP Mail Server would ask for information from DNS that could lead to potential stalls in mail delivery performance, which have been identified and fixed in 5.0.2.
• AppleShare IP Mail is now much faster at certain operations. User access to accounts with hundreds or thousands of messages has been improved. Deleting a very large message or many small messages is also faster.
• AppleShare IP Mail now supports more than one outgoing SMTP connection. The AppleShare IP Mail Server uses SMTP to send or forward mail destined for other mail servers on the intranet or Internet. The 5.0 and 5.0.1 AppleShare IP Mail Server only allowed one of these "outgoing" connections. This could lead to delays in the delivery of mail if you frequently had mail that required connections with many different SMTP hosts. The 5.0.2 Mail server now allows many outgoing SMTP connections to be active at once. The standard memory partition in AppleShare IP Mail 5.0.2 allows for 3 outgoing SMTP connections. Increasing the memory partition of the AppleShare IP Mail Server will allow for more outgoing SMTP connections, up to a maximum of 16. You can determine how many outgoing SMTP connections are allowed by checking the ASIP Mail Server log (there will be a message right after the DNS information printed each time the server starts), or by launching AppleShare IP Mail Administration, and selecting the "Show Outgoing SMTP Activity" option from the "Server" menu.
• There is a new window in the AppleShare IP Mail Administration software. This window allows Mail Administrators to view the current status of the outgoing SMTP connections. The window shows the following information:
  • server at idle
  • SMTP host is currently being worked on
  • looking up DNS information
  • attempting to contact a SMTP host
  • transferring messages to a SMTP host
  This new window is available by choosing the "Show Outgoing SMTP Activity" option from the "Server" menu in AppleShare IP Mail Admin 5.0.2.
• If you need to modify your TCP/IP configuration, stop the Mail Server, make changes to the TCP/IP control panel, and restart the Mail Server.

Requirements for Running AppleShare IP 5.0.2

• CPU: Any Apple Power Macintosh computer or Workgroup Server with a PowerPC 601, 604, or 604e microprocessor.
• RAM: 32 MB of memory with virtual memory turned on; 48 MB with virtual memory turned off. More memory may be needed if you are using one or more web server plug-ins.
• System Software: Mac OS 8.0, which includes Open Transport 1.2 and OpenDoc 1.2.1, is strongly recommended. The minimum requirement is Mac OS 7.6 or later with OpenDoc 1.1.2 or later and Open Transport 1.1.2 or later, except for the Workgroup Server 7350 and the Workgroup Server 9650, which require Mac OS 7.6.1 or later.

Requirements for Running AppleShare Client 3.7.2

• System Software: 7.5.3 or later
• Networking Software: Open Transport 1.1.2 or later

Support

Telephone Support

In the United States, if you have questions about AppleShare IP 5.0.2 that are not answered by the AppleShare IP Administrator's Manual or Apple Guide, call the Apple Assistance Center at 1-800-APL-CARE (1-800-275-2273) during telephone support hours (Monday through Friday, 6 am to 6 pm Pacific time). When prompted, enter the support access number provided on the back of your Apple Support Card and follow the instructions.

If you are located outside of the United States, refer to the support information that came with your AppleShare IP 5.0.2 software for instructions.

Web Site

If you have an Internet connection, check the Apple Support Information Web site at http://www.apple.com/support and the AppleShare IP Web site at http://www.apple.com/appleshareip/ for tips, solutions to problems, or any patches that may become available after the release of the software.

AppleShare IP Mailing List

To receive information about software updates, you are cordially invited to join the AppleShare IP mailing list. By joining the mailing list, you will also have the opportunity to share your experiences, questions, and comments with others using the software. Apple employees monitor the list, but Apple does not guarantee that all questions directed to this list will be answered. For more information about the mailing list, see the AppleShare IP Web site at http://www.apple.com/appleshareip/.

Installing AppleShare IP 5.0.2

For summary information about installing AppleShare IP 5.0.2, see the Installation & Getting Started file at the root level of your AppleShare IP 5.0.2 CD-ROM disc. For detailed information, see the AppleShare IP 5.0 Administrator's Manual. An electronic copy of the manual is available in the AppleShare Electronic Library folder on the AppleShare IP 5.0.2 CD-ROM disc.

You should read the remainder of this Read Me file before you install AppleShare IP 5.0.2; it contains suggestions about the order in which you install software.

Known Issues, Incompatibilities and Limitations

• If your server stops responding when running the AppleShare IP File and Mail servers on the same system, upgrade your server to Open Transport 1.2.1. The Open Transport 1.2.1 patch is located on your AppleShare IP CD in the folder "Open Transport 1.2.1 Update." This update requires Mac OS 8. The Open Transport 1.2.1 update has been tested and qualified on all 601, 604 and 604e based systems with 32 MB of RAM or larger. It is intended only for use with AppleShare IP 5.0.2 servers and with the U.S. version of Mac OS 8.
  If you encounter this problem with System 7.6 or 7.6.1, you must first update your server to Mac OS 8. If you are using a Workgroup Server, note that the Workgroup Server 7350 and 9650 Internet and Application bundles were developed before Mac OS 8 was released. Some of the third party applications provided with the Workgroup Server are undergoing revisions to fully support the added features of Mac OS 8. Please consult the Apple Web site at http://macos.apple.com/macos/latebreaking/compatibility.html for more information regarding Workgroup Server updates and application compatibility.
• You can run AppleShare IP under light and moderate load with virtual memory turned on. However, on Mac OS 7.6.x, you may encounter issues running AppleShare IP under very heavy load with virtual memory turned on. Under very heavy load with virtual memory turned on, the AppleShare IP Web & File Server may stop responding with a system error 112. If this occurs, restart your computer and take steps to reduce the load by avoiding the use of other programs, quitting AppleShare IP administrative programs when they are not in use, and lowering the number of concurrent users. If taking these steps does not prevent this situation, install additional memory and turn off virtual memory. This issue has been fixed in Mac OS 8.0.
• Mail Databases created with version 5.0 of the Mail Server are not compatible with those used by versions 5.0.1 and 5.0.2. There are two methods available for preserving e-mail that is contained in a 5.0 Mail Database.
  1. Before upgrading to 5.0.2, have all clients download their messages from the Mail Server. When that is complete, shut down the Mail Server so that you can simply throw away the AppleShare IP Mail 5.0 Database. The 5.0.2 server will create a New Database upon startup.
  2. There is a tool available on the AppleShare IP Web site (http://www.apple.com/appleshareip/) which can convert ASIP Mail 5.0 databases to the file format compatible with 5.0.1 & 5.0.2. This tool is called the AppleShare IP Mail Tool. The tool also allows scavenging of unusable AppleShare IP Mail Databases, compression of AppleShare IP Mail Databases, and reassignment of disabled mail account/mailboxes (see section in this Read Me about disabled accounts).

Installation and AppleShare IP Easy Setup

• If you are installing onto a computer running Mac OS 7.6, the AppleShare IP Installer installs the 7.6 Device Mgr Server Update version 1.0 on all computers and version 1.0.5 of the built-in Ethernet driver on PCI-based computers.
• On computers that run AppleShare IP, disable the sections of the Energy Saver control panel that handle hard disks. (They are enabled by default when you install system software.) If you do not disable energy saving for disks, several seconds will elapse before an AppleShare IP server can respond to a user's request as the disk drive
  s spin up. To disable energy saving for hard disks, in the Energy Saver control panel, make sure that the "Shut down instead of sleeping" box is not checked and that the slider is set to "Never." Click the Show Details button in the Energy Saver control panel and make sure that the "Separate timing for hard disk sleep" check box is not checked. Choose Server Settings from the Preferences menu, make sure that the "Never put hard disk to sleep" box is checked in the dialog box that appears, and click OK.
• When installing software on computers that run AppleShare IP, you may see a dialog box with the following message: "Installation cannot take place on the active disk while other applications are running. Please quit the AppleShare IP Registry and try again." If you see this dialog box, dismiss it and try the installation again. If the dialog box continues to appear, quit all applications and select "Mac OS 7.6 base" or "Mac OS 8.0 base" from the Selected Set pop-up menu in the Extensions Manager control panel. Restart your computer and try the installation again. Then use the Extensions Manager control panel to turn extensions on and restart once more.
• If you want to use the Vicom Internet Gateway software (available on the AppleShare IP Companion CD-ROM disc that came with your original AppleShare IP 5.0), you should install it on a computer other than a computer that runs AppleShare IP 5.0.2. If you run the Vicom Internet Gateway software on a computer that also runs one or more of the AppleShare IP 5.0.2 servers, performance of the AppleShare IP servers may be affected, PPP connections may experience timeouts, and proxy services may perform poorly.
• If you are running MacOS 7.6 on your server, the Web & File Server may crash if the Apple Menu Options control panel is enabled. To prevent the crash, the Installer removes the Apple Menu Options control panel if you are running MacOS 7.6. The Apple Menu Options control panel that comes with MacOS 8.0 fixes the problem.
• The Web & File Server may crash if the File Sharing Control Strip is enabled. To prevent the crash, the Installer removes the File Sharing Control Strip when it installs AppleShare IP 5.0.2.
• The AppleShare IP Administrator's Manual's instructions for running AppleShare IP Easy Setup incorrectly tells you to enter the new serial number that came with your AppleShare IP 5.0.2 software if you are upgrading from a version of AppleShare 4. If you are upgrading from a version of AppleShare 4, AppleShare IP Easy Setup automatically displays your current serial number for you. To proceed, click the right arrow button.

Web & File Admin

• On computers that do not have a lot of memory (48 MB or less), the Web & File Admin program may display a dialog box stating that it is out of memory. When you dismiss the dialog box, the Web & File Admin program quits. To prevent the Web & File Admin program from running out of memory again, you may want to quit other administration programs that you aren't using, turn on virtual memory, or install OpenDoc 1.2 or later. OpenDoc 1.2 corrects problems that may occur during low memory conditions.
• The MacAfee VirusScannerPPC application is not compatible with the AppleShare IP Web & File Admin program. If you have issues with running VirusScannerPPC, stop using it.

Web & File Server

• For the latest information on web server plug-in compatiblities, please refer to AppleShare IP web site at http://www.apple.com/appleshareip/.
• If a computer that is running the Web & File Server stops responding, check your hard disks by running Disk First Aid before you start the Web & File Server again. Disk First Aid is located in the Utilities folder on your Mac OS CD-ROM disc.
• If you need to modify your TCP/IP configuration, stop the Web & File Server, make changes to the TCP/IP control panel, and restart the Web & File Server.
• If you installed a prerelease version of AppleShare IP 5.0 and have trouble starting the Web & File Server from the Web & File Admin program, remove your Users & Groups Data File from the Preferences folder. If you want to save your user information, use the Export option from the Web & File Admin program's File Menu before deleting the file. After you have rebooted, you can use the Import option to add the users back. Passwords cannot be exported and must be reentered. You will also have to reassign any access privileges that you've set. This information only applies to prerelease versions of AppleShare IP 5.0. Versions of AppleShare 4 upgrade correctly.
• The AppleShare IP 5.0 Web & File Server uses a new set of access privileges based on combinations of the original access privileges (See Files, See Folders, and Make Changes). The new privileges are Read Only, Read & Write, Write Only, and None. When a user connects to an AppleShare IP volume and chooses Sharing from the Finder's File menu, the dialog box that appears displays the original AppleShare access privileges. If the user changes the folder's privileges to a combination of privileges that is invalid on the AppleShare IP file server, the file server automatically applies the most secure access privilege that approximates the change. If the user closes the dialog box and chooses Sharing again for that folder, the check boxes that are checked may be different than the check boxes that user checked earlier.
• The Adobe Acrobat Installer cannot be used while the Web & File Server is running. Be sure to install Adobe Acrobat before you start the Web & File Server.
• The requirements for creating drop boxes on a computer that is running the AppleShare IP Web & File Server are slightly different than for previous versions of AppleShare. On computers that are running the Web & File Server, make a disk or a folder a share point and assign Read Only or Read & Write access. Inside the disk or folder that has been made a share point, create the folders that are to be drop boxes and assign the Write Only privilege to the Everyone category for each folder.
• FTP client applications that do not enable "store unique" functionality cannot transfer files to an AppleShare IP drop box (that is, a folder whose access privileges are set to Write Only). When these FTP client applications are used to transfer files to a drop box, an Access Denied error occurs (error code 550). Many Mac OS FTP applications do not enable "store unique," but most UNIX FTP applications do.
• Upgrade to Fetch 3.0.2 or later if you are using version 3.0.1 or earlier of Dartmouth College's Fetch application. Fetch 3.0.2 includes changes that automatically send the appropriate FTP commands for downloading files that are in MacBinary format. (With Fetch 3.0.1 or earlier, you must use Fetch's Send FTP Command(s) command to send the MacBinary Enable command to the FTP Server and click the Binary radio button to download files correctly that are not in BinHex format.)
• Be careful when using FTP client applications to transfer files to the Web & File Server; under certain circumstances, a file may be unintentionally overwritten. Say, for example, that there is a file named X that you want to transfer in MacBinary or BinHex format. Most FTP client applications automatically append an extension of .bin (or .hqx for BinHex format) to the file, thereby implying that the file will be named X.bin (or X.hqx) when the transfer is complete. However, after the FTP client application transfers the file to the Web & File Server, the server decodes the file and removes the extension. If there is a file named X in the folder to which the file is transferred, it will be overwritten. To prevent this behavior, rename the file before you transfer it. For example, name the file X1 and then transfer it.
• When using a UNIX FTP client application to retrieve a file from the AppleShare IP FTP server, you may see the error message "Data connection reset by client." If you encounter this error, you can sometimes work around it by closing the FTP session and establishing a new session. If possible, you can also try a different FTP client program.
• Some Web browsers automatically look for and display a file named Default.html or a file named Index.html as the point of entry (home page) to your Web site, regardless of the file that is selected as the default home page in the Web & File Admin program's Web & File Server Settings window. You can avoid having visitors inadvertently see the wrong home page by removing files named Default.html and Index.html from the folder that is set as the Web Folder (whether at root level or in a nested folder) unless the file is selected as the default home page. If you decide to change the name of the file that is selected as your default home page, be sure to update any links that reference it.
• AppleShare IP 5.0.2 is not compatible with ARA Multiport Server software. You should not run them on the same computer.
• To retain CD ROM or locked volume privileges set under Macintosh File Sharing or a previous version of AppleShare, you must copy their access privileges files from the File Server folder to the Access Privileges folder inside the AppleShare IP Preferences. Both the File Server folder and the AppleShare IP Preferences folder are located inside the Preferences folder in the System Folder.

AppleShare Client 3.7.2 Software

• AppleShare Client 3.7.2 Software is appropriate for computers running system software version 7.5.3 or later. See the AppleShare Client 3.7 Read Me for the versions of AppleShare Client software that are recommended for system software versions prior to system software version 7.5.3.
• If you have issues using the AppleShare Client 3.7.2 software to connect to an AppleShare IP file server over TCP/IP, use MacTCP Ping (available from Apple Computer) to make sure that you can ping the computer that is running the AppleShare IP file server software. If you can't ping successfully, there is a connectivity issue. Check cabling and the configuration of the TCP/IP control panel.
• The AppleShare Client 3.7.2 software is not compatible with versions of RunShare prior to version 3.0, and it may cause the system to stop responding. Be sure to upgrade to RunShare version 3.0 or later before you install AppleShare Client Software 3.7.2.
• If a user makes an alias to an AppleShare IP volume and uses TCP to connect to that volume, both TCP/IP and AppleTalk must be active on the user's computer. Due to a limitation in the Alias Manager, AppleTalk must be active to resolve the alias.
• Microsoft Office Manager (Office 4.2.1) causes the AppleShare Client 3.7.2 software to crash when you try to connect to an AppleShare file server. To correct this problem, install Office Manager Updater, available from Microsoft.
• If you are running system software version 7.5.3 on a PowerPC-based computer and set up automounting of an AppleShare volume over TCP, the automount process may use AppleTalk instead of TCP. This problem is fixed in system software version 7.5.5 and later.
• When you install Open Transport 1.1.2 on a PowerBook 3400, immediately install the Mac OS 7.6.1 Update for PowerBook 3400. The update fixes a situation that could cause the system to stop responding when you switch between Infrared and LocalTalk.
• The NetWare User Authentication Module is incompatible with the AppleShare Client 3.7.2 software. Contact Novell for an update.
• Some old HyperCard XCMDs that mount AppleShare volumes are incompatible with the AppleShare Client 3.7.2 software.
• Utilities that mount disk images from AppleShare file servers may be incompatible with the AppleShare Client 3.7.2 software. If you have issues, contact the vendor for a new version.
• Versions of Santorini Server Manager earlier than 4.0 are not fully functional when used with the AppleShare Client 3.7.2 software. Be sure to install Santorini Server Manager 4.0 from the AppleShare IP Companion CD-ROM disc.
• Server management applications that mount AppleShare volumes may be incompatible with the AppleShare Client 3.7.2 software. Contact the vendor for an update.

Mail Server

• If you need to modify your TCP/IP configuration, stop the Mail Server, make changes to the TCP/IP control panel, and restart the Mail Server.
• The Mail Admin folder inside the AppleShare IP 5.0 folder on your startup disk contains an application called the PowerShare Exporter. You can use PowerShare Exporter to export users from PowerShare and import them into an AppleShare IP Users & Groups Data File.
• The Mail Server should not be running when you back up the Mail Server's mail database. AppleShare IP 5.0 comes with a Retrospect script for stopping the Mail Server, backing up the mail database, and restarting the Mail Server automatically. For information on this script, see the Read Me file for the Retrospect Event Handler script in the Mail Backup Samples folder at the root level of the AppleShare IP 5.0 CD-ROM disc.
• The AppleShare IP Mail Server uses a special "fingerprint" to ensure that a user's account in the mail database matches the correct user in the Users & Groups Data File. The fingerprint is a unique number that is stored in the user's record in the Users & Groups Data File and in the user's account/mailbox in the mail database.

The Mail Server checks for fingerprint mismatches each time it starts up. When it finds a user in the mail database whose fingerprint does not match the fingerprint of any user in the Users & Groups Data File, the Mail Server enters a summary message in the Mail Server log and a detailed message in the Mail Server error log, and disables the user's mail account/mailbox. To retrieve mail from a disabled mail account, use the AppleShare IP Mail Tool (available from the AppleShare IP Web site at http://www.apple.com/appleshareip/) to assign the mail account to a valid user in the Users & Groups Data File.

You can prevent mismatch problems by taking these precautions:

• Treat the Users & Groups Data File and the mail database as a set. Always back up and restore them together. If you were to restore the Users & Groups Data File without also restoring the mail database, Mail Server would disable the mail accounts of users who are in the mail database but who are not in the restored Users & Groups Data File. If you must restore the Users & Groups Data File, make sure that all current users have retrieved their mail first (if possible). Then restore the Users & Groups Data File and the mail database from the same backup. Alternatively, you can restore the Users & Groups Data File, start the Mail Server, note the mail accounts that are disabled, and use the AppleShare IP Mail Tool to assign the disabled accounts to valid users.
• If you move the mail database to another computer, move the Users & Groups Data File, too. If you were to move the mail database to another computer without moving the Users & Groups Data File, the Mail Server would disable most (if not all) mail accounts and create new, empty mail accounts for the users in the Users & Groups Data File for whom mail is enabled. (Note, however, that if you move the Users & Groups Data File to another computer that is running the Web & File Server, any access privileges that have been assigned on that computer will be lost because the access privileges no longer match the Users & Group Data File.)
• When you delete users for whom mail is enabled, make sure the AppleShare IP Mail Server is running. If the Mail Server is not running when you delete users for whom mail is enabled, the next time the Mail Server starts up, it will report that the deleted users' mail accounts do not have a matching entry and it will disable their mail accounts.

Note: It is always safe to throw away a mail database that is empty (as indicated by a zero in the "Number of Messages" field in the Mail Server Activity window). When you restart the Mail Server, it will create a mail account for each user in the Users & Groups Data File for which the Enable Mail radio button is selected.

Print Admin

• To see updates in the Print Admin program's Log window, you need to close and open the window again.
• If you create a queue and attach printers to it when the Print Server is busy, a communication issue may occur between the Print Admin program and the Print Server and an alert box may appear. Dismiss the alert box. In a few minutes the queue will appear in the Print Server Activity window with a status message indicating that no printers are attached to the queue. You need to attach the printers again.

Print Server

• The Print Server is not compatible with QuickDraw GX client applications. If you are setting up the Print Server in an environment that requires printing by QuickDraw GX client applications, be sure to enable the "Visible in Chooser" setting for at least one printer that is attached to a Print Server queue or be sure there is at least one printer that is not attached to a Print Server queue. That way, users who require QuickDraw GX support can use the printer directly.
• The Print Server cannot prevent printers that use the LaserWriter IIg version 2010.113 printer description file (PPD) from being visible in the Chooser even when the "Visible in Chooser" setting is not selected. To change the PPD file that the LaserWriter IIg uses, open the Chooser, click a printer icon, select the printer whose PPD file you want to change, and click Setup. In the dialog box that appears, click the Select PPD button and select a different PPD file (such as LaserWriter IIg v2010.130) from the list of PPD files. Click Select and then click OK.
• Do not choose a Print Server queue as the printer for a computer that is running the Print Server. The printing software will crash if you try to print on queue from a computer that is running the Print Server. If necessary, make a printer visible in the Chooser so that you can print on it directly.

Documentation

• The AppleShare IP Administrator's Manual shows that the "Enable users to save password for automatic log on" attribute in the Password Settings window is enabled by default. This is incorrect. By default, the "Enable users to save password for automatic log on" attribute is disabled.
• The AppleShare IP Administrator's Manual does not document the backup copy of the Users & Groups Data File that is made automatically the first time you start the AppleShare IP 5.0 Web & File Server. The backup is named Users & Groups Data File Backup, and it is located in the Preferences folder inside the System Folder on your startup disk. The purpose of the backup is to preserve a copy of your Users & Groups Data File in case you later decide to run Macintosh File Sharing or an earlier version of AppleShare. If you decide to run Macintosh File Sharing or a earlier version of AppleShare, you must first remove the AppleShare IP 5.0 software. Then remove the Users & Groups Data File, rename the Users & Groups Data File Backup to Users & Groups Data File, and restart your computer. These steps restore your Users & Groups Data File to its original state before you installed AppleShare IP 5.0.2.
• The AppleShare IP Administrator's Manual incorrectly implies that you can enter more than one serial number in the Web & File Server Settings window. You can only enter one serial number.
• The AppleShare IP Administrator's Manual incorrectly tells you to enter the new serial number that came with your AppleShare IP 5.0 software if you are upgrading from a version of AppleShare 3 or 4. If you are upgrading from a version of AppleShare 4, AppleShare IP Easy Setup automatically displays your current serial number for you.
• The AppleShare IP Administrator's Manual refers to the AppleShare IP 5.0 Library folder. The correct name for that folder is the AppleShare Electronic Library.