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-301-001.tar.gz, you may log in, copy the package to your home directory, and from your home directory: 1. tar -xzf MapleTA-Hotfix-301-001.tar.gz 2. cd MapleTA-Hotfix-301-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 log ============== The hotfix install script logs what it did, in the install.log file in the 'log' subfolder of the hotfix folder. 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 December 2007