Maple TA Hotfix Installation - Windows
======================================

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

Unzip the hotfix package. It doesn't matter where you unzip it, but you 
must retain the subfolder structure.

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.bat
script calls java.exe 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 environment variable or 
modify the install.bat script to provide full path to the java.exe executable.

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


1. Run the install.bat script that you find in the top level of your unzipped
	hotfix. There are two special requirements:
  . You must run the script under an administrator account. Use the runas
    command or login with an administrator account.
  . You must run the script with its directory as the working directory.

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.

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

    install /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.bat 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 simply 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:

    install /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
