About This Document
================
READ THIS DOCUMENT BEFORE INSTALLING OR USING MAE 2.0! It is a road map to the other MAE documentation and the MAE installation process. It is the only source for some information, including last-minute tips, and cautions relating to the software and the documentation. You may want to keep a printed copy of this document; it is designed to be printed directly by lp or lpr at 66 lines per page.
Supported Workstations And Operating Systems
==================================
This release of MAE is compatible with Sun workstations running Solaris 2.3 and later, and with Hewlett Packard (HP) workstations running HP-UX 9.0x. Ross HyperSPARC processors are also supported. Recommended RAM is 32MB or more; configurations smaller than 16MB are not supported. This version has not been tested with HP series 800 machines.
What's New In MAE 2.0
=================
- FULLY SUPPORTED APPLETALK NETWORKING: You can use the Chooser desk accessory to access other machines running MAE as well as Macintoshes. You can use AppleTalk printers, share files with other users, and run popular AppleTalk applications such as mail, scheduling and database group-ware. See Chapter 7 of the MAE USER'S GUIDE, "Networking with MAE."
- PERFORMANCE ENGINEERING: Sophisticated software techniques substantially improve the performance of most applications under MAE 2.0.
- MACINTOSH SOUND OUTPUT SUPPORT: Most applications that produce sound work with MAE 2.0. See Appendix B of the MAE USER'S GUIDE, "Using Sound."
- AFS AND NFS FILE SYSTEM SUPPORT: Significantly enhanced network file system support; performance is improved for all file system types.
- DYNAMIC RESIZE: Resizing the MAE desktop does not require restarting MAE.
- IMPROVED APPLICATION INSTALLATION: A "Temporary Installer Volume" (TIV) is a virtual Macintosh hard disk on your MAE Desktop. Normally, applications that could not be readily installed in MAE 1.0 install correctly to a TIV. See Chapter 3 of the MAE USER'S GUIDE, "Installing Macintosh Applications."
- MacTCP SUPPORT: MAE 2.0 supports MacTCP applications such as NCSA Telnet.
- EXTENSION MANAGEMENT: The Extensions Manager Control panel turns on and off startup programs, and switches between sets of extensions.
- SIMPLIFIED PROGRAM LAUNCH: The Launcher control panel opens a window that lets you launch frequently-used programs with one click.
- STICKIES: On-screen "yellow stickies" let you add notations to your desktop. They need not even all be yellow. Look for "Stickies" in the Apple Menu.
- WINDOW SHADE CONTROL PANEL: This new control panel allows you to reduce screen clutter by shrinking windows.
- SOFTWARE FPU: Support for SoftwareFPU (a shareware virtual 68881).
- CONTROL PANELS: New look for MAE General Control Panel; Network Control Panel for MAE allows the user to choose a default zone and to pick a network interface if the user has more than one; default RAM in Memory control panel is now 8MB (up from 5MB); the Desktop Patterns control panel provides a larger set of desktop patterns and textures.
- SOFTWARE TOOLS AND UTILITIES: HyperCard Player (apple/Tools); MoviePlayer (apple/Tools); third party utilities: Fetch, SoftwareFPU, and Disinfectant ( apple/tools/Shareware); appleping and atlookup, AppleTalk debugging utilities (apple/bin).
MAE 2.0 Information Resources
========================
This Read Me File
-------------
This document contains vital last-minute notes on this version of MAE and its documentation. Please read the entire document before installing MAE. It is included as README.TXT in the root directory of the CD-ROM. In addition, when MAE 2.0 is installed on your workstation, a copy of this Readme file is made in the file "MAE_ReadMe_2.0" within the "apple" directory.
MAE Documentation
--------------
MAE 2.0 includes three manuals:
- MAE USERS GUIDE ("Macintosh Application Environment User's Guide")
- MAE INSTALLATION MANUAL ("Macintosh Application Environment Setup and Installation Guide")
- MAE SYSTEM ADMINISTRATOR'S MANUAL ("Macintosh Application Environment System Administrator's Guide")
A printed copy of the Installation manual accompanies the product CD-ROM. The other two documents, in Apple DocViewer format, are located in the subdirectory "DOCS" of your "apple" directory, and can be printed once MAE 2.0 is installed.
The MAE Internet Server Site
---------------------
The MAE project maintains up-to-date MAE related information on world-wide-web and ftp servers, as follows:
www site: <
http://www.mae.apple.com/>
ftp site: <
ftp.support.apple.com>.
The following information is available:
* MAE Tech Notes: The most up-to-date list of current issues applicable to MAE 2.0
* Frequently-Asked Questions (FAQ): The questions most often asked by MAE users
MAE email Resources
---------------
Two mailing lists and one email address support MAE users:
* mae-announce is a moderated mailing list that will be used to distribute "official" product announcements and information about MAE from Apple. It is a very low traffic mailer aimed at people who want to keep informed on the product, but don't want to sift through all of the mail that is distributed through an open mailing list.
IMPORTANT: Apple strongly suggests that all MAE users subscribe to mae-announce. This mailing list is the primary means Apple will use to inform the MAE customer base about updates, patch availability and other significant MAE news.
* mae-users is an unmoderated mailing list that allows users to discuss the product in an informal atmosphere. mae-users will let users assist each other and distribute hints and other information about the product.
* mae-bugs is a "one-way" email address to MAE Engineering. Its purpose is to allow users to submit comments, bugs and suggestions about MAE to Apple. Note that mae-bugs is NOT a replacement for your standard support channel. If Apple decides to respond to an mae-bugs submission, it will be done through the general mae-users mailing list.
To request information about how to subscribe to mae-announce or mae-users, or about submitting reports to mae-bugs, please send mail to "mae-info-mail@webster.mae.apple.com".
How To Proceed
===========
Before installing MAE, read the MAE INSTALLATION MANUAL, then the balance of this document. After you have installed MAE, you may find the information on the MAE ftp server, in the FAQ and MAE Tech Notes useful for solving commonly-encountered problems.
Tips, Cautions, And Last-Minute Release Notes
================================
The remainder of this document is functionally organized:
I. Installing The Required Vendor Patches In Your Workstation Software
II. Running The MAE Installer
III. Running MAE For The First Time After Installation
IV. Starting and Exiting MAE
V. Issues Related To AppleTalk and Networking
VI. Issues Related To Sound
VII. Installing and Working With Application Programs
VIII. Floppy Disks and CD-ROM Discs
IX. Other Issues
Items applicable only to Sun workstations are labeled "(Sun only)"; those applicable only to HP workstations are labeled "(HP only)". All other items apply to all workstation types.
I. Installing The Required Vendor Patches In Your Workstation Software
---------------------------------------------------
The following patches for HP_UX and Solaris are the earliest versions that have been tested with MAE; Apple suggests that your system administrator apply the latest patch releases recommended by Sun and HP.
* (HP only): Copies of all HP patches can be obtained from the HP Support WWW server, whose URL is:
<
http://support.mayfield.hp.com/>
The Patch Browse/Search/Download screen itself can be found at this URL:
<
http://support.mayfield.hp.com/slx/html/ptc_hpux.html>
* (Sun only): Copies of Solaris patches are available on the Sun FTP site sunsite.unc.edu. Sun also maintains a WWW site, whose home page is at URL:
SunSolve home page: <
http://sunsolve1.sun.com/>
The URL of the patches pages is:
SunSolve patches: <
http://sunsolve1.sun.com/sunsolve/patches.html>
* (HP only): AppleTalk requires that the HPStreams module be installed in HP-UX. The STREAMS file sets are supplied on the CD in a "tar" file in directory STREAMS. Do not un-tar this file! The /etc/update program understands how to read the tar format. Two STREAMS packages are included: 3STREAMS.TAR and 5STREAMS.TAR. Please install 3STREAMS.TAR on HP-UX 9.03 and 5STREAMS.TAR on HP-UX 9.05.
The following file sets are included:
- STREAMS
- STREAMS-DLPI
- STREAMS-MAN
- TLI-XTI-MAN
Install all four file sets by using the /etc/update command:
/etc/update -rs /cdrom/STREAMS/3STREAMS.TAR '*'
-or-
/etc/update -rs /cdrom/STREAMS/5STREAMS.TAR '*'
WARNING: This command will reboot your workstation!
* (HP only): The recommended patches can be found in a single tar archive named HP_PATCH.TAR on the MAE CD-ROM in the PATCHES directory. Do not un-tar this file! The /etc/update program understands how to read the tar format.
The four patch file sets are listed below. (The versions of these patches may not be the latest available from HP, but have been tested with this release.)
PHKL_4605: This is a kernel "mega-patch" that fixes a number of important performance and reliability bugs, including an NFS memory leak and several bugs that can lead to kernel panics. This patch is relevant for users of HP-UX 9.03-9.05.
PHNE_3939: Kernel networking patch.
PHSS_4341: This patch fixes bugs in HP's audio server. "Issues Related to Sound" details the procedure required to install and enable this patch.
PHSS_4485: An X server patch.
To install any of these file sets, use the /etc/update command. This command requires the absolute path of the tar file and a list of the file sets to be installed. Use the '-r' option flag to tell update to reboot the system after installing the patches.
To install all four patches, use the following command: /etc/update -rs /cdrom/PATCHES/HP_PATCH.TAR '*'
WARNING: This command will reboot your workstation!
* (Sun only): SOLARIS 2.4 SYSTEMS: ask your system administrator to verify that volume manager patch 102077 has been installed. This patch must be in place before you install MAE.
SOLARIS 2.3 SYSTEMS: we recommend you install Kernel Jumbo Patch 101318-59 (Sun has recalled version -60 through -68 of this patch)
These Solaris patches are available on the Sun FTP site sunsite.unc.edu. Sun also maintains a WWW site, whose home page is at URL:
SunSolve home page: <
http://sunsolve1.sun.com/>
The URL of the patches pages is:
SunSolve patches: <
http://sunsolve1.sun.com/sunsolve/patches.html>
II. Running The MAE 2.0 Installer
------------------------
* BACK UP ALL IMPORTANT FILES ON YOUR WORKSTATION. If you are upgrading an existing MAE installation, be sure to back up your MAE files. Beware: some UNIX backup utilities are incompatible with Macintosh file names (which contain spaces and 8-bit special characters, for example). Test yours!
* Read Chapter 1 of the MAE INSTALLATION MANUAL before running the installer.
* The most straightforward way to install MAE is to run the installer while logged onto your workstation as root. If you run as an ordinary user, it will be impossible for the installer to install system-level facilities, such as the Solaris Volume Manager Extensions and the AppleTalk kernel modules. You will also have to be root to install vendor patches on either Sun or HP.
* When you use the MAE 2.0 Installer to remove packages (such as the documentation of Reference Man Pages packages) you will be asked "In which directory do you want to install the <package>?"
This question should read "In which directory is the <package> installed?"
* If you have previously installed any version of MAE, and do not have a system folder, remove the file ~/.mac/hostname/sm.vpram
* IMPORTANT: RE-INSTALLING APPLETALK: If you have previously installed any release of MAE 2.0 (including any Beta release), be sure to use the MAE 2.0 Installer to remove AppleTalk BEFORE INSTALLING THIS RELEASE. Follow this procedure:
Step 1: Shut down any MAE sessions currently running.
Step 2: Log in as root.
ON HP, CONTINUE AS FOLLOWS:
Step 3: Rename the AppleTalk command in your target install directory. Example: mv /u/MAEuser/apple/bin/appletalk /u/MAEuser/apple/bin/appletalk.old
Step 4: Use the Installer to remove the old AppleTalk kernel modules. Invoke the installer with ./INSTALL.SH -r, then, when prompted, verify that you want to remove the AppleTalk component.
Step 5: Use the installer to install the latest MAE in its entirety, including the new AppleTalk kernel modules.
Step 6: REBOOT your workstation.
Step 7: Remove the OLD AppleTalk command created in step 3 above. Example: rm /u/MAEuser/apple/bin/appletalk.old
ON SOLARIS, FROM STEP 2 ABOVE:
Step 3: Use the installer to install the latest MAE in its entirety, including the AppleTalk new kernel modules.
Step 4: Reboot your machine to unload dynamically loaded AppleTalk kernel modules.
On either workstation type, the resulting MAE will come up with AppleTalk when the first session is invoked.
IMPORTANT: If you are running MAE off a (remote) NFS file server, you must still install the AppleTalk kernel modules on the local machine, if you want to use AppleTalk. For example, if you are running the MAE process on workstation A, using a copy of apple/bin/MAE on workstation B, you must have the AppleTalk kernel modules installed on workstation A.
* The installer correctly upgrades your existing MAE 1.0 "apple" directory, if it exists, to version 2.0. The installer also updates the MAE documents and manual pages. Applications you have stored in the apple/Tools directory will not be removed. (However, if you have modified the MAE 1.0 versions of files that are replaced during the MAE 2.0 installation, your modifications will not be preserved during the installation.)
* If you are upgrading an existing MAE installation and will be installing new demo applications, remove the old directories "ClarisWorks", "FileMaker Pro", and "MacProject Pro" from the apple/Demos directory. Files from the old Demos directories that are not part of the new Demo set will otherwise be merged with the new Demo versions.
* MAE apple directories and System Folders cannot be cross-shared between Sun and HP workstations (as Macintosh applications and documents can).
* Installing MAE on an AFS volume may be problematic. MAE cannot be installed on an AFS volume at all unless the installing user is the superuser and has AFS administration privileges. Possible workarounds for residual difficulties: (1) upgrade to the latest release of AFS, which supports 8-bit characters in file names (2) install MAE onto a local or NFS mounted volume and then copy the MAE apple directory onto your AFS volume. (Remember: if you move the "apple" directory, you must use the "-appledir" command line option to start MAE.)
* (Sun only): During installation of MAE 2.0 into an AFS file system, very long AFS path names, or very large AFS volumes, may cause the installer to fail. The installer parses the output from the command "df -k"; the failure condition occurs when the path name or volume size fields run together without an intervening space. Before executing the installer, execute a "df -k" command to verify that these two fields are properly space-separated.
* (HP only) If you are running automounter and install MAE 2.0 into an automounted directory, specify the path in /tmp_mnt rather than /net (for example /tmp_mnt/net/foo/apple instead of /net/foo/apple).
* When running the installer, do not use destination directory names ending in special characters such as +, -, or &.
* Customizing the Install process for mass installation: Some sites have installed MAE on a central NFS or AFS server. Before undertaking support of such an installation, read Chapter 2 of the System Administrator's Guide, "Customizing MAE and Your Workstation."
* Problems with ISO 9660 format CD-ROM discs.
Some CD-ROM drivers (for example IBM, Data General) may translate filenames on ISO 9660 format CD's (such as the MAE CD) to lower case. If this occurs, the MAE Installer will not be able to find the files needed for installation.
To work around this, copy the files from the CD to a local volume and manually change the filenames to upper case before installing MAE. A shell script will be made available via anonymous ftp at some future time to automate the conversion of these file names.
This translation does not occur for Macintosh CDs.
The Tech Info Library article#17159: "
Locating Vendor Information", can help you search for a particular vendor's address and phone number.