[Aimmath-commit] AIM/doc installlin.html,1.1,1.2
Brought to you by:
gustav_delius,
npstrick
Menu
▾
▴
[Aimmath-commit] AIM/doc installlin.html,1.1,1.2
|
From: <gr...@us...> - 2003-08-29 19:05:19
|
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? <p/> - 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. ! <p/> 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 <font ! color='green'>/usr/local/maple</font> (for Unix) or <font ! color='green'>C:\Maple</font> (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 ! <font color='red'>not</font> work with Maple 8, because the <font ! color='green'>codegen</font> 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. ! <br><br> 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 <font ! color='green'>tth</font> in <font ! color='green'>/usr/bin</font>. Under Windows, just call the ! TtH directory <font color='green'>C:\TtH</font>. 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 <font color='green' ! >WEB-INF/bin/blat194.zip</font> 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 ! <font color='green'>/usr/java/jdk1.3.1_01</font> by default. ! You should make a symbolic link to this from ! <font color='green'>/usr/java/jdk</font>. ! <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. ! <br><br> ! Under Linux, the unpacked directory is called ! jakarta-tomcat-4.0. You should put it in <font ! color='green'>/usr/local/</font>, and make a symbolic link to it from <font color='green'>/usr/local/tomcat</font>. ! <br><br> ! Under Windows, you should call the unpacked directory ! <font color='green'>C:\Tomcat</font>. ! <br><br> ! Under the main Tomcat directory (<font ! color='green'>/usr/local/tomcat</font> or <font ! color='green'>C:\Tomcat</font>) you will find a subdirectory called ! <font color='green'>webapps</font>. 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 <font color='green'>aim.tgz</font> or ! <font color='green'>aim.zip</font> from ! <a ! href="http://aim.shef.ac.uk/aimsource">aim.shef.ac.uk/aimsource</a>, ! which you should unpack to get a directory called <font ! color='green'>ROOT</font>. ! <br><br> ! You should rename this directory to ! <font color='green'>/usr/local/tomcat/webapps/ROOT</font> or ! <font color='green'>C:\Tomcat\webapps\ROOT</font>. ! <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 <font ! color='green'>/usr/java/j2sdk1.4.2_01</font> (but it will allow you to ! install it in <font color='green'>/usr/local/java/j2sdk1.4.2_01</font> ! if you prefer). You should make a symbolic link to this from ! <font color='green'>/usr/java/jdk</font> (or <font ! color='green'>/usr/local/java/jdk</font>). ! <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 ! <font color='green'>/usr/local/</font>, and make a symbolic link to it from <font color='green'>/usr/local/tomcat</font>. ! 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 <font color='green'>tth</font> should be in a standard ! path such as <font color='green'>/usr/bin</font> or <font color='green'>/usr/local/bin</font>. 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 "unavailable". 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 "unavailable". 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> |
