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

Before applying the hotfix
==========================

Unzip the hotfix package.

For example, if the package is MapleTA-Hotfix-700-001.tar.gz, you may log in,
copy the package to your home directory, and from your home directory:

1. tar -xzf MapleTA-Hotfix-700-001.tar.gz
2. cd MapleTA-Hotfix-700-001

Each hotfix has a hotfix.def file in the root directory of the hotfix. 
This file contains description of the fix, installation instructions
for the fix and a list of the files supposed to be updated by the installer.

In the hotfix.def file you can also specify the location of your Tomcat directory 
(in TomcatInstallPath parameter) and your Maple T.A. web context name if you use custom 
name for Maple T.A. web application (MapleTAContextName parameter). Please see the
file for instructions on how to do that.

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

IMPORTANT: Please consult hotfix.def file for the installation instructions BEFORE you 
proceed with the installation.

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

Applying the hotfix
===================

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

IMPORTANT: The hotfix installer is a Java-based program and therefore the install.sh
script calls java executable to launch the installer. If your <Java>/bin directory is
not in the $PATH list, the script will not be able to start the installer. To fix the 
problem you can either add your <Java>/bin directory to the $PATH variable or modify the
install.sh script to provide full path to the java executable.

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

Run the install.sh script with administrator privileges:

1. sudo ./install.sh
2. You should see informational messages about files being backed up (if you do not use 
	the "force" option) 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.

NOTE: the revert option is available only if the install.sh script was NOT run with
"force" option.

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, 2011