
            RELEASE NOTES FOR MACINTOSH APPLICATION ENVIRONMENT 2.0

                               28 February 1995



================================================================================
                              ABOUT THIS DOCUMENT
================================================================================

   READ THIS DOCUMENT BEFORE INSTALLING OR USING MAE 2.0!  It is a roadmap 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 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
      groupware. 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 README 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 URL: 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 E-MAIL 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 allow
         users to 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 filesets 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 filesets are included:

      STREAMS
      STREAMS-DLPI
      STREAMS-MAN
      TLI-XTI-MAN

   Install all four filesets 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 filesets 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 filesets, use the /etc/update command.  This command
   requires the absolute path of the tar file and a list of the filesets 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:

      1. Shut down any MAE sessions currently running.

      2. Log in as root.


   On HP, continue as follows:

      3. Rename the appletalk command in your target install directory. 
         Example: mv /u/MAEuser/apple/bin/appletalk
         /u/MAEuser/apple/bin/appletalk.old

      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.

      5. Use the installer to install the latest MAE in its entirety, including
         the new AppleTalk kernel modules.

      6. REBOOT your workstation.

      7. Remove the OLD appletalk command created in step 3 above.  
         Example: rm /u/MAEuser/apple/bin/appletalk.old




   On Solaris:

      3. Use the installer to install the latest MAE in its entirety, including
         the AppleTalk new kernel modules.

      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 (locally.  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 pathnames, 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 pathname 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 (e.g.
   /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 CDROM discs.

   Some CDROM drivers (e.g. 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.



III.  RUNNING MAE FOR THE FIRST TIME AFTER INSTALLATION
=======================================================

** Before you can run MAE successfully, you must run the LICENSE BINDER
   utility, "license_binder".  When you run the license binder, it will ask you
   to input a serial number.  Your MAE 2.0 serial number is printed in two
   places: on the inside of the CD-ROM package, and on the plastic CD-ROM
   sleeve.

** The first time you launch MAE, it creates several files in your home
   directory:

      "System Folder"
      ".mac"
          These two directories are required to run MAE.
      "docs"
      "demos"
      "Tools"
      "lib"
      "man1"
          These are Macintosh aliases to the corresponding files inside the
          apple directory.  Which aliases are created depends on which packages
          are installed; for example, if no demo packages were installed, there
          will not be a "demos" alias. These aliases are there for convenience
          to the MAE user, and may be removed at any time. To control which
          aliases are created, you can modify the AliasList file found in
          apple/lib and described in the MAE System Administrator's Guide.

** When MAE 2.0 is launched for the first time in a new installation, and
   encounters a System Folder from MAE 1.0 or from a beta version of MAE 2.0,
   it automatically converts the System Folder to the format correct for MAE
   2.0.  If you have installed a previous version of MAE 2.0, MAE will not
   create backup versions of the files it replaces in this process.  (Upgrading
   from MAE 1.0, the updater will back up your original files.) In the unlikely
   event that you have trouble running MAE after the System Folder update
   occurs, however, follow this procedure:

   1. Quit MAE.
   2. Rename your System Folder; for example, 'mv System\ Folder
      old.system.folder
   3. Relaunch MAE to create a new System Folder.
   4. If you need Extensions or other files from the renamed System Folder,
      copy them to the new System Folder one at a time, restarting MAE after
      each new file is added to verify correct operation.


IV.  STARTING AND EXITING MAE
=============================

** Do NOT delete or move any of the MAE files or folders located in the
   "apple" directory.

** Shift-Control-E forces MAE to quit

   If you cannot quit MAE by using the Shut Down command in the Special menu
   (on the MAE desktop) or by using the capabilities provided by your X window
   manager, force MAE to terminate by pressing Shift-Control-E.

** If the Message "Can't open X display" Appears on Startup

   If you are running MAE on the same workstation that you are running the X
   Server, set the DISPLAY environment variable to be "local:0" before running
   MAE. If you are running MAE on a machine other than the X Server, set the
   DISPLAY environment variable to the string "X_server_hostname:0"  where
   X_server_hostname is the network hostname of the X server.

   If MAE still will not open the display, run the program "xhost" on the X
   Server machine to ensure that you have access to the server; see the man
   page for xhost.  If MAE is running on a workstation named WORKSTATION and
   the X-Server is on a machine named TERMINAL, then on TERMINAL run the
   command "xhost +WORKSTATION".  This allows MAE on WORKSTATION to open a
   display on TERMINAL.

** If a message appears on startup similar to "Unable to locate <directory>;
   please use the -appledir option to give the path to the apple directory."

   When you start MAE, it expects the directory containing the MAE files to be
   in a directory specified at installation (by default, the directory is named
   "apple").  You can also specify the location of the "apple" directory to MAE
   by using the -appledir command option when you start MAE (see Chapter 2 of
   the MAE USER'S GUIDE).  Alternatively, you can specify an alternate location
   of the "apple" directory in your X Resources file.  To edit your X Resources
   file, open your .Xdefaults file and edit the line that begins with
   "Apple.appleDirectory." Replace the name of the directory that appears in
   the line with the name of the directory that contains the MAE files. For
   example, if the MAE files are located in /usr/local/apple, the line would
   look like this:

   Mae.appleDirectory: /usr/local/apple




V.  ISSUES RELATED TO APPLETALK AND NETWORKING
==============================================

** MAE is not compatible with third-party AppleTalk stacks. If you run on a
   machine with one of these stacks, you cannot use AppleTalk with MAE.  If you
   want to run AppleTalk on MAE, you must first remove any third-party stacks.

** (HP only): MAE AppleTalk requires streams. To determine whether streams
   is installed on your system, run the command 'strvf' (normally in /usr/bin).
   To see which version of streams is installed, inspect the file
   /system/STREAMS-DLPI/index and look for the version in the 'fv:' field.

** (Sun only): If you have a single network interface configured, and this
   interface is not le0, you will see the following message if you open the
   Network Control panel:

      The AppleTalk connection is unknown.  Please select a different AppleTalk
      connection, or built-in LocalTalk will be the AppleTalk connection
      when you restart.

   This message is incorrect. Click 'OK'; the Network Control panel lets you
   switch between zones normally.  AppleTalk and EtherTalk are unaffected, and
   will be normal after restart.

** By default, when you enable FileShare, anyone connecting as "owner" can
   see the entire "/" directory and its descendants.  To allow access to only
   explicitly shared items, open the "Users & Groups" control panel, and turn
   off the option "Allow user to see entire disk" for the File Share owner.

** If multiple users invoke MAE and FileShare on the same workstation, some
   coordination is required in exporting filesystems with FileShare.  If two
   users independently export a single directory or volume under two different
   names, then a second workstation, unable to recognize that the two exported
   names refer to the same volume, can mount them both independently, referring
   to them by different names.  This has potentially serious consequences,
   including loss of files.

   Sites that use multiple instances of MAE on a single workstation should
   provide guidelines for exporting filesystems via FileShare.  These
   guidelines should follow one of two models:

   a. Run a single FileShare on the workstation, and set up Users&Groups
      to allow clients appropriate access to the File system.

   b. Allow each user to run a FileShare server, but to export only parts of
      the file system they "own" in the UNIX sense.  Default sharing of the
      root volume should be disabled.

** When using some MacTCP applications, erroneous login information may
   cause all subsequent connection attempts to fail.  Work around this problem
   by restarting the application (it is not necessary to restart MAE).

** MacTCP and multiple network interface cards: MacTCP uses the first
   configured network interface card and ignores any others.

** Wrong zone: if the Chooser displays no network-visible entities (NVEs) 
   (printers, servers, etc), the Chooser indicates that you are in an invalid
   zone, restart MAE.

** AppleTalk installation/initialization errors

   If you see problems with AppleTalk initialization (e.g., "Lap Init: ..."), do
   the following in order to determine the source of the problem:

   1. Check the system console messages.

   2. Verify that the AppleTalk kernel modules are installed correctly.  See
      "Installing AppleTalk for MAE" in Chapter 5 of the MAE SYSTEM
      ADMINISTRATOR'S GUIDE.

   3. Be sure you have write permission to the /tmp directory. 

   4. Look for error messages in the window from which you launched MAE.  If
      AppleTalk is unable to open a file, an error message will appear here.

   5. Open the Network Control Panel; verify that you are running AppleTalk
      on the correct network interface.

   6. The MAE installer may have informed you that a log file was written. 
      Please consult this file.

   7. For more information, see "Troubleshooting" and "UNIX AppleTalk
      commands" in Chapter 5 of the MAE SYSTEM ADMINISTRATOR'S GUIDE.

** This release includes three UNIX-style commands for troubleshooting
   network problems. These commands are located in the apple/bin directory:

   1. appletalk
   2. appleping
   3. atlookup

   man pages for all three are included in the product release.



VI.  ISSUES RELATED TO SOUND
============================

** (HP only): MAE 2.0 will not support sound on HP-UX 9.01. 

** (HP only): MAE 2.0 will not support sound on HP-UX workstations that are
   not connected to a network.  If your HP workstation is not attached to a
   network, include the -nosound option on the mae command line.

** MAE sound quality depends on the quality of the source sound, the
   processor speed, and the settings of the Sound control panel.

** MAE 2.0 does not support sound input.

** (HP only): Sound on HP workstations may include brief audio hesitations. 
   This effect is most pronounced with higher sampling rates and slower
   machines.

** (Sun only): When changing sound rate on Sparc5's by using the Sound Out
   subpanel in the Sound control panel, there may be a slight delay during
   which your cursor stops moving. This is normal.

** (Sun only): The exernal mute and volume controls on the Sparc speaker box
   have no effect under MAE; sound is controlled only from the Sound Control
   panel.

** If multiple instances of MAE are run on the same workstation, only the
   first to be executed will play sounds normally.  The other copies of MAE
   play no sounds until the first MAE terminates -- then they play all queued
   sounds at once.  To avoid this, add the -nosound option to the MAE command
   line whenever another copy of MAE is already executing on the same
   workstation.  This disables sound completely for all but the first copy of
   MAE to be executed.

** (HP only): UNIX applications that attempt to play sounds while MAE is
   running will have those sounds queued. These queued sounds will be played
   after the (first) MAE session quits.

   This occurs because MAE takes exclusive control of the audio server in
   order to achieve acceptable sound performance. If you do not want this
   situation to occur and do not require sound support from MAE, start up MAE
   with the "-nosound" command line option.

** (HP only): If you don't get sound out of your machine even though it is
   sound capable, check the following:

   1. Make sure the AUDIO environment variable is set to your local machine.
      i.e., AUDIO=hostname:0

   2. Install HP Patch "PHSS_4341" and reboot. This patch is necessary for
      correct sound operation.  

   3. Make sure the LLBD (local location broker daemon) is running. As root,
      edit the /etc/netncsrc file and make sure the line START_LLBD=1 is there,
      and reboot.

   4. Make sure the audio server is running (ps -e | grep -i aserver). There
      should be two Aserver processes running.  Use the command
      "/usr/audio/bin/Aserver" to start the audio server if necessary.

   5. Make sure you have access to the Aserver. "/usr/audio/bin/asecure -C"
      creates an audio access file. Then "/usr/audio/bin/asecure -d" disables
      security (or read the man page and enable for the users to whom you wish
      to grant access).

   6. To get audio out of the output jacks (rather than the internal
      speaker)  set the environment variable SPEAKER="external".

   7. If you're still having problems, try to get HP's audio tools to work
      following their documentation. When HP's audio tools work, MAE sound
      should work.


** (Sun only): Sound problems related to running MAE as a user different
   from the one who is logged in at the console:

   Change the permissions of the /dev/audio and /dev/audioctl audio devices.
   To change the permissions of /dev/audio, execute the command "ls -l
   /dev/audio" and follow the symbolic links to the actual device (expect three
   or four levels of indirection).  Change the permissions on the audio device
   for read/write access.




VII.  INSTALLING AND WORKING WITH APPLICATION PROGRAMS
======================================================

** Using Temporary Installer Volumes (TIVs) to ease application installation:
   Installation of some applications can be complicated by space and
   permissions constraints on the UNIX root volume.  The resulting problems are
   likely to produce error messages such as
          "Not enough free space on <directory>"
          "Cannot create directory <directory>"
   MAE 2.0 provides a workaround: a TIV, which is a virtual hard disk on the MAE
   desktop. By creating, and installing to, a TIV, you can sidestep problems
   associated with the root volume.

   Detailed instructions for creating and using TIVs are in Chapter 3 of the
   MAE USER'S GUIDE.

** Installation of certain software packages can be done only by using a TIV
   that contains a copy of your System folder.  Attempts to install on a TIV
   without a System Folder result in various error messages, depending on the
   installer.  See Chapter 3 of the MAE USER'S GUIDE.

** TIV size: We recommend a TIV size greater than 10 Megabytes.

** If you get a message such as "ClarisDraw requires a hard disk" when
   installing a Claris application

   Some Claris applications require that the destination volume have more than
   10 MB free space, even though the application does not require that much
   space.  To work around the problem, install to a TIV whose size is greater
   than 10 Megabytes.

** Resizing MAE while an application is running

   Some applications may not correctly handle an MAE resize while the
   application is running.  

** Colors Are Not Displayed Accurately in Certain Applications

   In certain applications that use color extensively (for example, Adobe
   Photoshop), colors used in the document may not be displayed correctly.  To
   fix this problem, open the MAE General control panel; click the button "use
   standard Mac colors" under "Color flash reduction" and restart MAE.

** Use only printer drivers that are shipped with MAE

   Some Macintosh applications (e.g., Aldus PageMaker 5.0) install their own
   printer drivers (and related files) when installed.  The only printer
   drivers that have been tested for compatability with MAE are shipped with
   the product: LprWriter and LaserWriter 8.  Other printer drivers have not
   been tested with MAE and may not work.

   For instructions for setting up and using the LprWriter and LaserWriter
   drivers, see Chapter 4 of the MAE USER'S GUIDE, "Printing in MAE."

** PPD files for non-Apple printers

   Apple supports only PPD files for Apple printers. It is a printer vendor's
   responsibility to make PPD files for its printers available.  If the PPD for
   your non-Apple printer isn't shipped with MAE, contact the printer vendor or
   use the ftp archive at ftp.adobe.com.  See Chapter 4 of the User's Guide for
   more information.

** Problems with Microsoft Office

   The specialized Microsoft Office Control panel "Microsoft Office Manager" is
   not compatible with MAE.  If you install Microsoft Office, remove this
   control panel from the System Folder before you restart MAE.

** Use the Option Key When Printing PageMaker 5.0 Documents with LprWriter

   There is an incompatibility between the LprWriter driver and PageMaker. If
   you are printing using the LprWriter driver, you must hold down the Option
   key while you choose Print from the File menu in PageMaker. There is no
   incompatibility with the LaserWriter8 driver.



VIII.  FLOPPY DISKS AND CD-ROM DISCS
====================================

** (Sun only): Volume manager patch

   Solaris 2.4 users: Before using floppy or CD-ROM with MAE on Sun, you must
   install the Solaris Volume Manager Patch.

** Problems mounting CD-ROM discs and floppy disks

   Read "Mounting CD-ROM Discs and Floppy Disks" in Chapter 6 of the User's
   Guide. If your problem is not covered, read on (this material assumes that
   you know the concepts covered in the User's Gude).

   You need to know the exact pathname of the device file that references the
   CD-ROM or floppy (ask your system administrator).  On HP, the command
      ioscan -f
   lists the available devices on your workstation. On Solaris, you should be
   able to determine the pathname(s) by looking in the /etc/vold.conf file for
   the lines that start with "use floppy" or "use cdrom".

   The driver for the device in question may not be configured in your kernel.
   Ask your administrator for help if this is the case.

   Once you know the pathname of the device file, try to access the floppy
   drive from UNIX. Once you have determined that the floppy drive works, enter
   full pathname for the floppy in the macdisks.OS file (where OS is 'hpux' or
   'solaris').

   Example SCSI entry for a CDROM drive: 
      scsi6:removable:ro:<PUT PATHNAME HERE>

   Example line for a floppy drive: 
      floppy0:rw:<PUT PATHNAME HERE>

   Common pathnames for devices :
   On HP, CDROM drives are often at SCSI address 2. The following example line
   should work if your CDROM drive is at SCSI address 2:
   scsi2:removable:ro:/dev/dsk/c201d2s0

   On HP, Floppy drives are often one of the following:
      floppy0:rw:/dev/rfloppy/c201d0s0
      floppy0:rw:/dev/rfloppy/c20Ad1s0

   In some cases, you may need to restart MAE before the modifications to the
   macdisks.OS file will be taken into account, especially if you specify
   "default" for one of the devices.

** Do not eject a diskette and physically remove it from the drive until MAE
   is finished with it (that is, until MAE shuts down, requests another disk
   with a dialog, or deletes the floppy disk icon from the desktop). 
   Disregarding this caution risks physical diskette damage.

** (HP only): If you manually eject a floppy without dismounting it first
   (dismount it by dragging its icon to the trash, or selecting Put Away from
   the File menu), and then insert another floppy, the second floppy may be
   corrupted.



IX.  OTHER ISSUES
=================

** Find File and UNIX file systems

   The "Find File" facility included with MAE 2.0 is optimized for searching
   Macintosh HFS volumes and is not well suited to large UNIX filesystems. 
   Avoid using this facility to search UNIX volumes as it will traverse the
   entire volume and any mounted filesystems within it. This behavior is
   especially noticeable when "Find File" is invoked by a remote client to
   search a UNIX volume exported from MAE via File Sharing.  Using "Find File"
   on HFS volumes (such as TIV files or remote HFS volumes) should present no
   difficulties.

** File System anomalies

   If MAE fails to show items in a UNIX directory (possibly even after the
   window is closed and re-opened), use the touch command to update the time on
   some item in the directory.  (This anomaly is the result of a difference in
   basic assumptions between UNIX and the Macintosh: Using UNIX, it is possible
   to replace an entire directory, with entirely new contents, without updating
   its modification date or time.)

** Using -memory Option When Starting MAE

   When you start MAE with the -memory command option, memory size is set to
   the specified value.  (See "Adjusting the Memory Size of MAE" in the MAE
   USER'S GUIDE, Chapter 10.)  If MAE is restarted, this stipulation will
   remain in effect unless it has been subsequently changed by using the
   Memory Control panel.

** OPTION and SHIFT keys after MAE restart

   After an MAE restart (not a startup), MAE may appear not to respond fully to
   the Option and Shift keys.  A simple workaround technique is effective:
   click anywhere OUTSIDE THE MAE WINDOW on your X screen, then click inside
   the MAE window.  Thereafter the problem disappears.

** Scrapbook conversion: The Scrapbook file format of MAE 2.0 is not
   compatible with that of MAE 1.0.  If you update from MAE 1.0, your
   Scrapbook file will be unusable.  To work around this, copy the new
   Scrapbook file from apple/sys into your System Folder, replacing the
   one there.  To recover the contents of your MAE 1.0 Scrapbook:

   .. run MAE 1.0, using your old MAE 1.0 appledir and System Folder;
      the old system folder is saved in "MAE 1.0 System Files", within
      your MAE 2.0 System Folder.

   .. Paste the Scrapbook contents into an application document and
      save it.

   .. Terminate MAE 1.0, run MAE 2.0, open the application, and paste
      the contents into the Scrapbook.

** MEMORY CONTROL PANEL: Allocating the maximum memory allowed in the Memory
   control panel may result in an MAE crash with "mmap failed" or other error
   messages.

** ALIASES: installing this release invalidates Macintosh aliases from the
   previous installation.  Discard these aliases and re-create them.

** WARNING: Some versions of AFS support only 7 bit characters in filenames,
   while MAE supports 8 bit characters. This may cause problems in some
   situations: BEWARE!

** MAE does not support changing the date and time settings in the General
   Controls and Date & Time control panels.

** SCSI device compatibility problems

   Workstations that support MAE 2.0 typically use the SCSI 2 interface
   Standard.  Depending on how your workstation is configured, you may have
   problems using a SCSI or single-ended SCSI2 peripheral.  Before attempting
   to connect an Apple or other third-party peripheral to your HP or Sun
   workstation, see your system administrator or the documentation that came
   with your workstation for information.

** (HP only): Problems Using CD-ROM Discs on HP 712 Workstations

   If you try to mount a CD-ROM disc on certain HP 712 workstations attached to
   some CD-ROM drives, MAE may display an alert message, asking if you want to
   initialize the disk.  Click Cancel in the alert box.  For information about
   possible solutions to this situation, see your HP dealer or contact
   technical support at Hewlett-Packard.

** If MAE "hangs" when an NFS server goes down:

   MAE 2.0 no longer hangs on NFS mounts when an NFS server goes down, unless
   the server was mounted "hard/nointr." Hard/nointr mounts cannot be
   interrupted while hard/intr are interruptible.  To prevent NFS-related
   hangups, verify that all NFS mounts on your workstation are interruptible.

** If you need to refer to the wide-area part of a distributed AFS
   filesystem:

   MAE does not permit the Finder or applications to see the wide-area part of
   the distributed AFS filesystem.  To access a file contained in the wide-area
   part of an AFS system, use a UNIX shell to copy the file to a directory
   within the local cell, such as your home directory.

** If resizing the MAE window when CloseView is active causes MAE problems:

   This is a known problem in the current version.  Avoid resizing the MAE
   window when CloseView is active.

** (Sun only): If you are using OpenLook

   If you are having trouble importing X data into the MAE environment (for
   example, text in an xterm window), make sure that you do not click on any
   olwm title bar after you have selected the X data.  If you do so, the X
   Windows selection may become lost, and MAE will not be able to import it.
   To work around this problem, position the MAE window so the "Import from X"
   button (on the MAE toolbar) is visible, select the X data, then before
   clicking on any olwm titlebar, select the "Import from X" button.

** Displaying MAE on a Macintosh using MacX.

   MAE may hang when its display appears on a Macintosh via MacX, when MAE is
   also mounting a fileshared volume from the same Macintosh.


** AfterDark 3.0

   The files "Screen Posters" and "Bad Dog" in AfterDark version 3.0 are
   incompatible with MAE 2.0.  After installing After Dark, remove these two
   files from your System Folder before restarting MAE.

** Shareware/freeware issues

   MAE 2.0 includes three shareware/freeware programs, in the directory
   apple/Tools/Shareware.  Observe these points when using these shareware
   programs:

   ** Third party software posted to this CD may be protected by federal
      copyright laws which prohibit copying unless authorized by the copyright
      owner.  Before using any posted software, refer to the start up screen of
      the software, to the accompanying software license, or to the individual
      an/or company posting the software to determine if copying is authorized.
      Posted software is the sole responsibility of the individual and/or
      company posting it.  Apple Computer, Inc. does not endorse, warrant,
      guarantee, or make any representations, express or implied, with respect
      to software posted to this CD, its quality, performance, merchantability,
      or fitness for a particular purpose.  In no event will Apple be liable
      for direct, indirect, special, incidental, or consequential damages
      resulting from the use of posted software.

   ** Somre software in this folder is shareware; if you use a shareware
      utility, please honor its shareware fee.

   ** FETCH: Using Fetch to "get" and "put" non-text Macintosh files from or
      to UNIX filesystems requires special care to insure the files are
      transferred in a usable state by MAE (i.e. preserving their AppleSingle
      format).

      When "get"ing a non-text Macintosh file, always select "binary" transfer
      mode. When "put"ing a non-text Macintosh file, always select
      "AppleSingle" as the file format when prompted by the dialog. Macintosh
      and UNIX text files should always be transferred by selecting "text"
      (ASCII)  transfer mode.

      For complete instructions about using Fetch, read the online "Fetch
      Help".

   ** SOFTWAREFPU - Floating Point Unit Extension

      This extension simulates the FPU coprocessor chip found in some
      Macintoshes and integrated into certain 68K CPU's. It is only useful for
      (the very few) Macintosh applications that require this FPU.

      Complete instructions about using SoftwareFPU are included with the
      utility.

   ** DISINFECTANT - Virus Utility

      MAE is susceptible to the same viruses that plague the Macintosh.
      However, there is no need to scan your entire UNIX filesystem for
      Macintosh viruses. When scanning with Disinfectant, hold down the Option
      key and press the "Scan" button, this will display a dialog that will
      allow you to limit the scope of the search.

      For complete instructions about using Disinfectant, please read the
      online "Disinfectant Help".
