Maple TA Hotfix Installation - Linux or Solaris
===============================================

Applying the hotfix
===================
Unzip the hotfix package and run the install.sh script with administrator
privileges.

For example, if the package is MapleTA-Hotfix-400-001.tar.gz, you may log in,
copy the package to your home directory, and from your home directory:
1. tar -xzf MapleTA-Hotfix-400-001.tar.gz
2. cd MapleTA-Hotfix-400-001
3. sudo ./install.sh
4. You should see informational messages about files being backed up and
copied, followed by the message "Maple TA hotfix processing completed". If you
see this message, the hotfix has been installed successfully.

Please note the two special requirements:
  . You must run the script under an administrator account. The "best
    practices" approach is to use sudo or su.
  . You must run the script with its directory as the working directory.

The hotfix detailed install log
===============================
The hotfix install script logs what it did, in the 'install.log' file in
the 'log' subfolder of the hotfix folder.

The hotfix history log
======================
The hotfix install script logs a single line in the 'hotfixes.log' file in
the 'hotfixlog' subfolder of your Maple T.A. installation folder. This is
the best place to look if you want to determine whether or not your system
has a particular hotfix installed, or when a particular hotfix was installed.

If the installer can't find your Tomcat folder
==============================================
In this case the installer will display a clear message to that effect. You
must edit the hotfix.def file in the top level of your unzipped hotfix, to
specify the Tomcat folder. Comments in that file indicate how to do it.

Reverting a hotfix
==================
If you feel you need to "undo" the hotfix, simply run the install again
with the "--revert" command-line parameter. That is
    sudo ./install.sh --revert
The installer will revert the hotfix using a backup that it took during the
original install.

Running the install a second or subsequent time
===============================================
This might happen if, for example, you applied, reverted, then wanted to apply
again. If you simple run the install a second time you will see the message
  "Hotfix installation requires backing up the targets but the backup folder
  is not empty. Empty the backup folder or suppress backup with --force."
Follow those instructions. Usually you will want to suppress the backup like
this:
    sudo ./install.sh --force
However, there may be scenarios where you want to clear the backup folder and
allow the installer to take the backup again.


Maplesoft
April 2008
