[Aimmath-commit] AIM/doc installlin.html,1.1,1.2

SourceForge Headquarters 1320 Columbia Street Suite 310 San Diego, CA 92101 +1 (858) 422-6466

Update of /cvsroot/aimmath/AIM/doc
In directory sc8-pr-cvs1:/tmp/cvs-serv12767

Modified Files:
	installlin.html 
Log Message:
Update for AiM 3.0: Linux instructions for installing AiM.   - GG

Index: installlin.html
===================================================================
RCS file: /cvsroot/aimmath/AIM/doc/installlin.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** installlin.html	27 Aug 2003 07:50:20 -0000	1.1
--- installlin.html	29 Aug 2003 19:05:14 -0000	1.2
***************
*** 2,51 ****
  <!--  @(#)$Id$ -->
  <head>
!  <title>Installing AIM under Linux</title>
  </head>
! <body bgcolor='white'>
! <h1>Installing AIM under Linux</h1>

! These are still the old instructions for AiM 2.1. They should be adapted or rewritten. Any volunteers?

- These are instructions for installing and configuring AiM.  They
- assume that you do not want your web server to do anything except run
- AiM - it is perfectly possible for AiM to coexist with other things,
- but it is a little more complicated to configure.  They also assume
- that you will be using the Jakarta Tomcat 4 server. 
- 
- <p/>  The
- system has also been installed under Mac OSX; support for this is not
- yet properly integrated in the distribution, but the key point is to
- replace the file <font color='green'>OS0_Linux.mpl</font> by 
- <font color='green'>OS0_OSX.mpl</font>.
- 
- <br><br>
- 
- If you already have AiM installed and you want to upgrade the Maple
- part of the system, see the <a href="#upgrade">upgrade</a> section.
- 
- <br><br> These notes tell you in detail where to put various files and
- directories.  All of these locations can be changed if you are willing
- to edit some configuration files.  In particular, in Windows you can
- put Maple and TtH under <font color='green'>Program
- Files</font> if you like; earlier releases of AiM had problems
- with spaces in directory names, but I think these are now cured.
- 
- <br><br>
- <font color='red'>
- Under Unix, many of the installation steps require that you should be
- logged on as root. You will also need to be root to start the server.
- </font>

  <h2>License terms</h2>

! AiM relies on various external components, such as Maple, Java, the
! Tomcat web server, TtH for LaTeX-to-HTML conversion and so on.  There
! are some comments below about the license terms for these components,
! but of course you should consult their suppliers for definitive
! answers. 
! 
  The Maple and Java source code for AiM itself is free software; you
  can redistribute it and/or modify it under the terms of the GNU <a
--- 2,44 ----
  <!--  @(#)$Id$ -->
  <head>
!  <title>Installing AiM under Windows</title>
  </head>
! <body>
! <h1><a name="install">Installing AiM under Windows</a></h1>

! These are instructions for installing and configuring AiM,
! for Linux (and other variants of UNIX, though it has not been
! fully tested under other variants of UNIX, and there still appear
! to be some problems under Mac OSX).
  <p/>
+ The installation consists of 5 steps:
+ <ol>
+ <li><a href="#maple">Install Maple</a></li>
+ <li><a href="#jre">Install the Java runtime environment</a></li>
+ <li><a href="#tomcat">Install the Tomcat web server</a></li>
+ <li><a href="#tth">Install TtH (TeX-to-HTML)</a></li>
+ <li><a href="#aim">Install AiM itself</a></li>
+ </ol>
+ It is likely that you already have some of the above software installed
+ in which case you should be able to skip those steps, so long as, the
+ installed version is current enough and is in a standard path so that
+ it can be found when you come to do the auto-configuration step of AiM.
+ If you already have a working installation of AiM then jump 
+ directly to <a href="#aim">AiM installation step</a> to see how to
+ install your new AiM in place of or in parallel with your old installation.

  <h2>License terms</h2>

! AiM relies on various external components, such as 
! <a href="http://www.maplesoft.com">Maple</a>, 
! <a href="http://java.sun.com">Java</a>, 
! the <a href="http://jakarta.apache.org/tomcat/">Tomcat</a> web server, 
! <a href="http://hutchinson.belmont.ma.us/tth/">TtH</a> for 
! LaTeX-to-HTML conversion, and
! the <a href="http://www.servlets.com/cos/index.html">com.oreilly.servlet</a> 
! support classes.
! The license terms for these components can be found on their webpages.
! 
 The Maple and Java source code for AiM itself is free software; you
 can redistribute it and/or modify it under the terms of the GNU <a
***************
*** 60,78 ****
 GNU General Public License for more details.

! <h2>Prerequisites</h2>
! 
! <h3>Maple</h3>
! 
! You will need to install maple in /usr/local/maple (for Unix) or C:\Maple (for Windows). I have only checked the
! current version of AiM with Maple 7, but I believe it will work with
! Maple 6 and probably also with Maple 5. I understand that it will
! not work with Maple 8, because the codegen package has been deprecated and
! replaced by a completely different mechanism. This will probably be
! an improvement, once I have installed Maple 8 and understood it.
!

  If you want to use AiM for actual teaching (rather than just checking
  it out) you will need a Maple license that allows you to make the
--- 53,66 ----
  GNU General Public License for more details.

! <h2><a name="maple">Maple</a></h2>

+ You will need Maple version 7, 8 or 9. Simply follow Maple's default
+ installation procedure, which typically installs software associated
+ with Maple in a directory such as <font color='green'>/usr/local/maple9</font>
+ so that the executables lie in <font color='green'>/usr/local/maple9/bin</font>.
+ A nice way to make these available in a standard path is by creating
+ symbolic links into <font color='green'>/usr/local/bin</font> via
+ the command <code>ln -s</code>.
+ <p/>
  If you want to use AiM for actual teaching (rather than just checking
  it out) you will need a Maple license that allows you to make the
***************
*** 82,86 ****
  contact <a href='mailto:in...@ma...'>Waterloo Maple</a>
  directly to ensure that you are complying with your license terms.  If
! you have any complex discussions about licensing issues then I (<a
  href='mailto:N.P...@sh...'>Neil Strickland</a>)
  would appreciate a copy.  Waterloo Maple are aware of AiM and are
--- 70,74 ----
  contact <a href='mailto:in...@ma...'>Waterloo Maple</a>
  directly to ensure that you are complying with your license terms.  If
! you have any complex discussions about licensing issues then (<a
  href='mailto:N.P...@sh...'>Neil Strickland</a>)
  would appreciate a copy.  Waterloo Maple are aware of AiM and are
***************
*** 90,191 ****
  the first instance).

! <h3>TtH</h3>
! 
! You will need to download the TeX-to-HTML converter TtH from <a
! href="http://hutchinson.belmont.ma.us/tth/">hutchinson.belmont.ma.us/tth/</a>.
! Under Linux, put the executable file tth in /usr/bin. Under Windows, just call the
! TtH directory C:\TtH. TtH uses symbol
! fonts, which should display properly under Internet Explorer or
! Netscape on Windows platforms. A little browser configuration is
! needed for the fonts to work under Netscape on Unix platforms; see 
! <a href="http://hutchinson.belmont.ma.us/tth/manual"
! >the TtH manual</a>. If you know that your users will have recent
! browsers with Unicode support then another option is to make TtH use
! the -u flag; see the mailing list for discussion of how to do this and
! whether it is a good idea.
! 
! <h3>BLAT</h3>
! 
! If you are running AiM under Windows, you will need to install BLAT
! for AiM to be able to send automatically generated emails. It is
! included in the AiM distribution as WEB-INF/bin/blat194.zip under the main aim directory; the
! original source was <a
! href='http://www.interlog.com/~tcharron/blat.html'
! >http://www.interlog.com/~tcharron/blat.html</a>.
! 
! <h3>Java</h3>
! 
! You will need to download the JDK (Java development kit) from <a
! href="http://java.sun.com">java.sun.com</a>. The package is
! about 25MB, so it takes a while to download. I have been using
! version 1.3.1, which works fine. Under Linux, it unpacks itself in
! /usr/java/jdk1.3.1_01 by default.
! You should make a symbolic link to this from 
! /usr/java/jdk.

! <h3>Tomcat</h3>

! You will need to download the Jakarta Tomcat 4 server from <a
! href="http://jakarta.apache.org">jakarta.apache.org</a>.

! There is an RPM (= Red Hat Package Manager) version, but when I last
! tried it, this was configured in an inconvenient way. These notes
! assume that instead, you have downloaded and unpacked the tar or zip
! file for the binary distribution. 
! 
! Under Linux, the unpacked directory is called
! jakarta-tomcat-4.0. You should put it in /usr/local/, and make a symbolic link to
 it from /usr/local/tomcat.
! 
! Under Windows, you should call the unpacked directory 
! C:\Tomcat.
! 
! Under the main Tomcat directory (/usr/local/tomcat or C:\Tomcat) you will find a subdirectory called
! webapps. I recommend that you 
! <ul>
! <li>Start up the server, check that the example applications are
! working properly, then shut it down.
! </li>
! <li>Rename the directory webapps as hidewebapps. This will mean that
! the examples no longer work, but also that they will no longer
! clutter the log files with messages that can impede
! troubleshooting. 
! </li>
! <li>Create a new webapps directory.
! </li>
! </ul> 
! 
! <h3>AiM</h3>

! You should download aim.tgz or
! aim.zip from
! <a
! href="http://aim.shef.ac.uk/aimsource">aim.shef.ac.uk/aimsource</a>,
! which you should unpack to get a directory called ROOT. 
!

! You should rename this directory to
! /usr/local/tomcat/webapps/ROOT or 
! C:\Tomcat\webapps\ROOT.

! <h2>Configuration</h2>

! <ul>
!  <li>
!   Change directory to
!   <font
!   color='green'>/usr/local/tomcat/webapps/ROOT/WEB-INF/maple</font>
!   or <font color='green'>C:\Tomcat\webapps\ROOT\WEB-INF\maple</font>.
    If you already have a <font color='green'>Config.mpl</font> 
    file, you should make a copy of it.  Backup files called Config.bak
    are generated automatically, so you should use some other name.
!   <br><br>
    Now start Maple, and read in the file
    <font color='green'>AutoConf.mpl</font>.  This will try to
--- 78,181 ----
  the first instance).

! <h2><a name="jre">Java</a></h2>

! If you don't have a java runtime environment already, you can install it 
! by downloading and running the 
! <a href="http://aimmath.sourceforge.net/j2re-1_4_2_01-linux-i586.bin">installer 
! for JRE 1.4.2</a> (14MB) or you can install the full developer's kit 
! by downloading and running the
! <a href="http://aimmath.sourceforge.net/j2sdk-1_4_2_01-linux-i586.bin">installer
! for SDK 1.4.2</a> (35MB) both from 
! <a href="http://java.sun.com">java.sun.com</a> (the latter of these gives
! you <code>javac</code> and others, which you will need if you intend to
! compile java code). By default, it will unpack in /usr/java/j2sdk1.4.2_01 (but it will allow you to
! install it in /usr/local/java/j2sdk1.4.2_01
! if you prefer). You should make a symbolic link to this from
! /usr/java/jdk (or /usr/local/java/jdk).

! <h2><a name="tomcat">Tomcat</a></h2>

! You will need the Jakarta Tomcat 4 server from <a
! href="http://jakarta.apache.org">jakarta.apache.org</a>. Download 
! <a href="http://aimmath.sourceforge.net/jakarta-tomcat-4.1.27.tar.gz">
! jakarta tomcat 4.1.27</a> (7.1 MB). You should unpack it in
! /usr/local/, and make a symbolic link to
 it from /usr/local/tomcat.
! If you have a 4.0 series installation of Tomcat, it is a good idea
! to replace it with the current version (there were some location
! changes of some directories which may cause some problems if you don't
! do this). You can start up the Tomcat server and test some example
! applications, if you like, but generally it's problem-free.

! <h2><a name="tth">TtH</a></h2>

! You will need to download the TeX-to-HTML converter TtH from <a
! href="http://hutchinson.belmont.ma.us/tth/">hutchinson.belmont.ma.us/tth/</a>.
! The executable file tth should be in a standard
! path such as /usr/bin or /usr/local/bin. TtH, by default, uses symbol fonts, which should display 
! properly under Internet Explorer or Netscape 4 (and earlier) on Windows 
! platforms. Recent versions of Netscape and Mozilla no longer support
! symbol fonts, but do display Unicode fonts (which, alas, Internet Explorer
! does not fully support). If you know that your users will have recent
! browsers with Unicode support then another option is to make TtH use
! the -u flag; see the mailing list for discussion of how to do this and
! whether it is a good idea. We hope to soon to have the facility to
! detect the browser so that AiM serves pages with symbol fonts or Unicode
! fonts as appropriate for the browser.

! <h2><a name="aim">AiM</a></h2>

! You are now finally ready to install AiM itself by following the following
! steps.
! <ol>
!  <li>Download the latest file release (with a name starting with 
!   <font color='green'>complete</font>) from 
!   <a href="http://sourceforge.net/projects/aimmath/">SourceForge</a> 
!   or directly <a href="http://aimmath.sourceforge.net/aim.zip">from here</a>
!   and unzip it into a subdirectory of the 
!   <font color='green'>/usr/local/tomcat/webapps/</font> directory. Do not 
!   unzip it into the webapps directory itself but into a subdirectory that
!   you create. You can choose any name for this subdirectory. If you choose
!   ROOT then the directory will not appear in the URL of the server pages
!   for the AiM quizzes. Any other choice will appear in the URL. (It is
!   possible to have multiple AiM installations, and this simple rule ensures
!   the URLs of these parallel installations are distinguished.) Below we will
!   assume that you chose the name <font color='green'>AiM</font>.  
!   If you chose something different, simply replace 
!   <font color='green'>AiM</font> by your choice in all filenames and URLs
!   below.
!   <p/>
!   If you already have a working AiM installation then you have to make an 
!   important choice:
!   <p/>
!   <em>Do you want to ...</em>
!   <blockquote>
!   <dl>
!    <dt><em>keep the old installation and install AiM 3.0 in a different 
!     subdirectory of the webapps directory?</em></dt>
!    <dd>You will then have two completely independent installations. 
!     The new AiM server will not know about the students and quizzes 
!     on the old installation unless you copy the data over as explained
!     in the <a href="#copy">optional copying step</a> below.
!     </dd>
!    <dt><em>... or update by overwriting your old installation with AiM 3.0?
!     </em></dt>
!    <dd>In this case, you should unzip the new AiM into the 
!     <font color='green'>/usr/local/tomcat/webapps/ROOT/</font> directory (or
!     to wherever you chose to install the old AiM). The old subjects, quizzes
!     and student data will then still be available in the updated AiM 
!     installation.</dd>
!   </dl>
!   </blockquote>
!   </li>
!  <li>Change to the directory of your new AiM installation. (If you installed
!   AiM in the default location then the directory will be
!   <font color='green'>/usr/local/tomcat/webapps/AiM/WEB-INF/maple/</font>.)
    If you already have a <font color='green'>Config.mpl</font> 
    file, you should make a copy of it.  Backup files called Config.bak
    are generated automatically, so you should use some other name.
!   <p/>
    Now start Maple, and read in the file
    <font color='green'>AutoConf.mpl</font>.  This will try to
***************
*** 196,200 ****
    <font color='green'>autoconf.log</font> as well as being
    printed on the terminal.
!   <br><br>
    Under Linux, <font color='green'>AutoConf.mpl</font> will probably
    find everything it needs.  There is currently a problem with time
--- 186,190 ----
    <font color='green'>autoconf.log</font> as well as being
    printed on the terminal.
!   <p/>
    Under Linux, <font color='green'>AutoConf.mpl</font> will probably
    find everything it needs.  There is currently a problem with time
***************
*** 203,210 ****
    correct it to the corresponding zone without a shift.  For example,
    BST = British Summer Time = GMT + 1 hour should be changed to GMT =
!   GMT + 0 hours.  Under Windows, <font
!   color='green'>Autoconf.mpl</font> will need more help.  (If you know
!   how to find out the time zone or the host name under Windows, please
!   let me know.)  To provide help, you should copy the file <font
    color='green'>ManualConfig.dist</font> to <font
    color='green'>ManualConfig.mpl</font> and then edit it following the
--- 193,197 ----
    correct it to the corresponding zone without a shift.  For example,
    BST = British Summer Time = GMT + 1 hour should be changed to GMT =
!   GMT + 0 hours. To provide help, you should copy the file <font
    color='green'>ManualConfig.dist</font> to <font
    color='green'>ManualConfig.mpl</font> and then edit it following the
***************
*** 212,267 ****
    color='green'>AutoConf.mpl</font> again.  This will run various
    consistency checks as well as generating other configuration files.
! 
!  </li>
!  <li>When you have successfully run AutoConf.mpl, you should make a
!   copy of the file
!   <font color='green'>/usr/local/tomcat/conf/server.xml</font> (or 
!   <font color='green'>C:\Tomcat\conf\server.xml</font>) and
!   then run the file <font color='green'>Servlet.mpl</font>.
!   This
    <ul>
!    <li>Writes configuration information for Tomcat to the file 
!     <font color='green'>/usr/local/tomcat/conf/server.xml</font>
!    </li>
!    <li>Writes AiM-specific configuration information to the file
      <font color='green'>WEB-INF/web.xml</font> under the
      main AiM directory.
     </li>
!    <li>Writes the scripts
      <font color='green'>WEB-INF/startaim.sh</font> and
!     <font color='green'>WEB-INF/stopaim.sh</font> (or
!     <font color='green'>WEB-INF/startaim.bat</font> and
!     <font color='green'>WEB-INF/stopaim.bat</font>) used
!     to stop and start the server.
!    </li>
!    <li>Copies the com.oreilly.servlet helper classes from 
!     <font color='green'>WEB-INF/cos/...</font> to
!     <font color='green'>/usr/local/tomcat/classes/...</font>.
!     (The source code, object code, and documentation in the
!     com.oreilly.servlet package is copyright and owned by Jason
!     Hunter, but he allows non-commercial redistribution subject to a
!     <a href='coslicense.html'>license</a>.)
     </li>
    </ul>
   </li>
!  <li>Now restart Maple and read in Make.mpl.  This will recompile all
!   the Maple source files, which may take a minute or two.
!  </li>
!  <li>
!   Run the script <font
!   color='green'>/usr/local/tomcat/webapps/ROOT/WEB-INF/startaim.sh</font>
!   or <font
!   color='green'>C:\Tomcat\webapps\ROOT\WEB-INF\startaim.bat</font>
!   to start the server.  You will probably need superuser privileges
!   for this.
   </li>
!  <li>
!   Visit the URL <a
!   href="http://localhost/admin.html">http://localhost/admin.html</a>
!   and click on 'Zone login' to log on as the administrator (with empty
!   password).  After logging in, you can set a password, create new
!   subjects and so on.
   </li>
! </ul>

  <h2><a name="trouble">Troubleshooting</a></h2>
--- 199,249 ----
    color='green'>AutoConf.mpl</font> again.  This will run various
    consistency checks as well as generating other configuration files.
!   You can iterate this procedure as often as you like until you get
!   an installation without error messages.
!   <p/>
!   By the way, by running <font color='green'>AutoConf.mpl</font>,
!   the file <font color='green'>Servlet.mpl</font> is read which
!   configures Tomcat, writing
    <ul>
!    <li>configuration information for Tomcat to the file 
!     <font color='green'>/usr/local/tomcat/conf/server.xml</font>;</li>
!    <li>AiM-specific configuration information to the file
      <font color='green'>WEB-INF/web.xml</font> under the
      main AiM directory.
     </li>
!    <li>and the scripts
      <font color='green'>WEB-INF/startaim.sh</font> and
!     <font color='green'>WEB-INF/stopaim.sh</font>
!     to stop and start the Tomcat server.
     </li>
    </ul>
   </li>
!  <li>The installation is complete. Now start your Tomcat server, by
!   executing <font color='green'>WEB-INF/startaim.sh</font> in the
!   main AiM directory.
   </li>
!  <li>Point your webbrowser at the URL of the AiM server. This will be something
!  like <font color='green'><a href="http://localhost/AiM/admin.html">http://localhost/AiM/admin.html</a></font>, 
!  where you will need to replace <font color='green'>AiM</font> by the name of
!  the subdirectory of <font color='green'>/usr/local/tomcat/webapps/</font>
!  if you chose to unzip AiM in a directory other than AiM/, or omit 
!  <font color='green'>AiM/</font> completely if you chose to put it in ROOT/.
!  You should click on 'Zone login' to log on as the administrator (with empty
!  password).  After logging in, you can set a password, create new
!  subjects and so on.
   </li>
!  <li><a name="copy">(Optional) You can copy</a> data from an old AiM 
!  installation to your new installation. All the data is contained in the
!  directory 
!  <font color='green'>root</font> inside the <font color='green'>WEB-INF</font>
!  subdirectory of your old AiM installation. You can copy the entire contents
!  into the corresponding <font color='green'>root</font> directory of your new 
!  installation. However you also need to make a global search and replace in all
!  files in that directory. If your old installation for example was in 
!  <font color='green'>/usr/local/tomcat/webapps/ROOT/</font> and your new one
!  is in <font color='green'>/usr/local/tomcat/webapps/AiM/</font> then you want
!  to replace every occurrence of <font color='green'>ROOT</font> by 
!  <font color='green'>AiM</font> in all the files.</li>
! </ol>

  <h2><a name="trouble">Troubleshooting</a></h2>
***************
*** 271,276 ****
  minimal tex file.  If any of these things fail, it will display an
  error report when you try to log in as the administrator; this will
! hopefully be self-explanatory.
! <br><br>
  Some other kinds of errors may give you a Java stacktrace in your
  browser, looking something like this:
--- 253,259 ----
  minimal tex file.  If any of these things fail, it will display an
  error report when you try to log in as the administrator; this will
! hopefully be self-explanatory. If necessary, you can ask for help in the
! <a href="http://maths-physics.org.uk/aiminfo/mod/forum/view.php?id=14">AiM Forum</a>.
! <p/>
  Some other kinds of errors may give you a Java stacktrace in your
  browser, looking something like this:
***************
*** 280,284 ****
    for servlet Alice threw exception
  javax.servlet.ServletException: Unexpected output while initializing
!   new Aim process:
  Error, unable to read `AliceServer.mpl`

--- 263,267 ----
    for servlet Alice threw exception
  javax.servlet.ServletException: Unexpected output while initializing
!   new AiM process:
  Error, unable to read `AliceServer.mpl`

***************
*** 291,306 ****
  Note that this includes the line number in the source file Alice.java
  where the error occurred.  The top of the stacktrace is often
! reasonably comprehensible.  If necessary, you can send the whole thing
! to the AiM developers.
! <br><br>
  With other kinds of problems you may see a message like 
  <font color='red'>Servlet Alice is unavailable</font> in your browser.  
! This means that Tomcat started successfully but Alice did not.  You
! should look at the log file  
  <font color='green'>/usr/local/tomcat/logs/log.YYYY-MM-DD.txt</font>, 
  and search backwards from the end for the string
  &quot;unavailable&quot;. Just above this, you should find a
  stacktrace, and the top of the stacktrace may be informative.
! <br><br>
  If you see nothing at all in the browser, then Tomcat itself failed to
  start.  Some possible reasons:
--- 274,288 ----
  Note that this includes the line number in the source file Alice.java
  where the error occurred.  The top of the stacktrace is often
! reasonably comprehensible.  
! <p/>
  With other kinds of problems you may see a message like 
  <font color='red'>Servlet Alice is unavailable</font> in your browser.  
! This means that Tomcat started successfully but Alice did not. You
! should look at the most recent Tomcat log file
  <font color='green'>/usr/local/tomcat/logs/log.YYYY-MM-DD.txt</font>, 
  and search backwards from the end for the string
  &quot;unavailable&quot;. Just above this, you should find a
  stacktrace, and the top of the stacktrace may be informative.
! <p/>
  If you see nothing at all in the browser, then Tomcat itself failed to
  start.  Some possible reasons:
***************
*** 308,328 ****
   <li>Tomcat had not shut down properly when you tried to restart it.
    I have found it safest to shut down twice (which gives an error
!   message on the second attempt) before restarting.  This problem may
!   leave a message in the log file 
!  <font color='green'>/usr/local/tomcat/logs/catalina.out</font>
!   saying <font color='red'>java.net.BindException: Address already in
!   use</font>.
   </li>
   <li>There may be another web server (such as Apache or IIS) already
!   listening on port 80.  This will again give a message saying 
    <font color='red'>java.net.BindException: Address already in
    use</font> in the log file.  You should either shut down the other
!   server, or set <font color='green'>Config['TomcatPort']</font>
!   in <font color='green'>ManualConfig.mpl</font> to specify a
!   different port.
!  </li>
!  <li>You may be trying to connect to port 80 without superuser
!   privileges; the error message will say 
!   <font color='red'>java.net.BindException: Permission denied</font>.
   </li>
   <li>The message <font color='red'>Catalina.stop:
--- 290,304 ----
   <li>Tomcat had not shut down properly when you tried to restart it.
    I have found it safest to shut down twice (which gives an error
!   message on the second attempt) before restarting.
   </li>
   <li>There may be another web server (such as Apache or IIS) already
!   listening on port 8080 or whichever port you chose for Tomcat.  
!   This will give a message saying 
    <font color='red'>java.net.BindException: Address already in
    use</font> in the log file.  You should either shut down the other
!   server, or change the port that Tomcat is listening and also set 
!   <font color='green'>Config['TomcatPort']</font>
!   in <font color='green'>AutoConfig.mws</font> to specify a
!   different port and reexecute that worksheet.
   </li>
   <li>The message <font color='red'>Catalina.stop:
***************
*** 332,364 ****
   </li>
  </ul>
! 
! <h2><a name="upgrade">Upgrading</a></h2>
! 
! In version 2.0.0, the file Config.mpl is automatically generated,
! using parameters supplied by the user in ManualConfig.mpl if
! necessary.  Thus, if you are upgrading from a version prior to 2.0.0,
! you should first rename your Config.mpl file to Config.old (or
! whatever you like, but not Config.bak, as that will be overwritten.)
! 
! <br><br>
! 
! Apart from that, you can upgrade using the installation procedure
! described above, but omitting the installation of Java, TtH and so on.
! 
! <br><br>
! 
! Changes in AiM are often restricted to the Maple part of the system,
! and in this case a simpler procedure is available.  (Note, however,
! that this does <b>not</b> apply to the changes in Version 2.0.0).  To
! bring your installation up to date, download the file maple.tgz or
! maple.zip from <a
! href="http://aim.shef.ac.uk/aimsource">aim.shef.ac.uk/aimsource</a>,
! and unpack it in <font
! color='green'>/usr/local/tomcat/webapps/ROOT/WEB-INF</font> (or <font
! color='green'>C:\Tomcat\webapps\ROOT\WEB-INF</font>).  Then change to
! the maple subdirectory, start maple, and read in the file <font
! color='green'>Make.mpl</font>.  Finally, change back to the <font
! color='green'>WEB-INF</font> directory, and run the shutdown and
! startup scripts to restart the system.  

  </body>
--- 308,313 ----
   </li>
  </ul>
! <hr/>
! Last modified by Greg Gamble on 30/08/03

  </body>