Download the appropriate file for your workstation. It is important to download the patch that is associated with the version of hp-ux ('maepatch2.0.2.hp.tar' for hp-ux v9.0.x and 'maepatch2.0.2.hp10.tar' for hp-ux v10.01) Note: the tar files are compressed internally and did not require further compression using `compress' or a similar utility.
NOTE: As of April 1996, HP-UP 10.1 is not supported with MAE 2.0.2..
Extracting the Patch Files From the Downloaded File
---------------------------------------------------
Place the tar file anywhere. Extract it by running the following command:
On HP-UX 9.x Workstations:
% tar xovf maepatch2.0.2.hp.tar
On HP-UX 10.01 Workstations:
% tar xovf maepatch2.0.2.hp10.tar
The extracted files will be placed in a new directory named "maepatch2.0.2.hp" or "maepatch2.0.2.hp10" depending on your system type. Once the extraction is complete, you can delete the downloaded file maepatch2.0.2.*.tar.
Preparing For Patch Installation
--------------------------------
Before you run the patch installer, make backup copies of two directories: your system folder (normally in your home directory, in the directory "System Folder"), and the directory ".mac" within your home directory. In the event that patch installation results in an inoperable copy of MAE, you will be able to reconstruct your original MAE environment, from these saved copies, by removing the damaged apple directory, reinstalling MAE 2.0, and restoring your saved copies of the System Folder and .mac.
Important Information For AppleTalk Users
-----------------------------------------
If you have more than one copy of MAE on any workstation, you must update all copies of MAE with this patch at the same time. The AppleTalk driver in MAE 2.0.2 is not compatible with older versions of MAE (2.0 or 2.0.1). This applies to multiple copies of MAE on the same workstation only.
Important Information For HP-UX Version 10.01 Users
---------------------------------------------------
The MAE binaries for HP-UX v9.x and v10.01 are not interchangeable. If you are installing this patch to allow MAE to run on an HP-UX 10.01 system, you should be aware that the updated binaries will no longer function on a 9.x system. If you have multiple workstations sharing the same binary directory (appledir), you may wish to reinstall MAE from the CD-ROM onto a 9.x system. The patch can then be safely applied to both systems, creating updated executables for each environment.
Below are instructions for installing MAE 2.0.2 for use with HP-UX 10.01:
- For a new installation of MAE for HP-UX 10.01, first install MAE v2.0 as
distributed on the CD-ROM but do not install AppleTalk (you can do this
by performing a custom installation (as detailed in the `MAE User's
Guide')). After you have installed MAE 2.0 from the CD-ROM, you can
apply the MAE 2.0.2 patch by executing ./PATCH.SH as distributed with
the patch. Note that the STREAMS package is not required for HP-UX
10.01.
- HP-UX 10.01 was not supported in versions 2.0 and 2.0.1. As a result,
upgrade instructions are not included here.
- If you are upgrading from MAE v1.0, first rename any existing MAE v1.0
(or MAE v1.0a) System Folders. Next, install MAE v2.0 as distributed on
the CD-ROM but do not install AppleTalk (you can do this by performing a
custom installation as detailed in the `MAE User's Guide'). This will
create a new System Folder to which you can manually drag/copy any
resources (Extensions, Fonts, Preferences, etc.) from your old MAE
v1.0 System Folder. You can now safely apply the MAE 2.0.2 patch by
executing ./PATCH.SH as distributed with the patch.
- To remove MAE except for the AppleTalk components, use the Remove
feature of the installer supplied with the MAE v2.0 CD-ROM and/or the
2.0.2 patch distribution. Note that the 2.0.1 patch does not have any
removal capabilities and that the 2.0.2 patch will ONLY remove
previously-installed 2.0.2 components. Then remove the AppleTalk
components utilizing the Remove feature of MAE 2.0.2.
The device files for HP-UX 10.01 have also changed. As a result, the `macdisks.HPUX' file will require modifications to function with your existing devices. This is true even if you had previously made these changes for an HP-UX 9.x system. Note that using the `default' convention will not work for HP-UX 10.01; you need to explicitly specify the path to the device. Examples are provided in the updated file installed by the patch (when installing for HP-UX 10.01).
Important: Run Under the Appropriate Login Account
--------------------------------------------------
The account used to install the patch must have read/write privileges to all files in your apple directory; you can best accomplish this by running the patch installer under the same account originally used to install MAE 2.0. This patch includes new version of AppleTalk kernel modules as well as new version of various files from your apple directory. In order to install the patched version of the AppleTalk kernel modules, you must run the patch installer as root (superuser).
Applying the Patch
------------------
After you are appropriately logged in, cd into the newly created "maepatch2.0.2.hp" or "maepatch2.0.2.hp10" directory. Apply the patch by running the "PATCH.SH" program as follows:
On HP-UX 9.x Workstations:
% cd maepatch2.0.2.hp
% ./PATCH.SH
On HP-UX 10.01 Workstations:
% cd maepatch2.0.2.hp10
% ./PATCH.SH
PATCH.SH will lead you through the installation process. You will have a choice of `Easy' or `Custom' installation as well as `Remove'. Easy installation patches both your Apple directory and the AppleTalk kernel modules; Custom installation gives you the opportunity to patch only one or the other. If your copy of MAE is on a central server, serving many workstations, you will have to patch JUST the copy of MAE on the server, and JUST the AppleTalk kernel modules, on the workstations.
Remove will delete the MAE components from your system (but not any System Folders located in a $HOME directory). See the FAQ for more information on removal of MAE.
Reinstalling Custom Resources
-----------------------------
The patch will replace several files in your System Folder. If you have installed any custom sounds or applications that have modified resources within the file `System' in the System Folder, you will be able to use your backed-up copy of System to help you reinstall the custom resources, after patch installation is complete. If you are not sure if any application has done this, refer to that application's documentation.
Article Change History:
13 May 1996 - Added HP-UX 10.1 note.