[Aimmath-commit] AIM/doc installosx.html,1.6,1.7
Brought to you by:
gustav_delius,
npstrick
Menu
▾
▴
[Aimmath-commit] AIM/doc installosx.html,1.6,1.7
|
From: Jon B. <bre...@us...> - 2004-05-21 14:12:37
|
Update of /cvsroot/aimmath/AIM/doc In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv28978/doc Modified Files: installosx.html Log Message: Second attempt at committing Index: installosx.html =================================================================== RCS file: /cvsroot/aimmath/AIM/doc/installosx.html,v retrieving revision 1.6 retrieving revision 1.7 diff -C2 -d -r1.6 -r1.7 *** installosx.html 29 Sep 2003 21:13:19 -0000 1.6 --- installosx.html 21 May 2004 14:12:28 -0000 1.7 *************** *** 19,22 **** --- 19,23 ---- --> <li><a href="#aim">Install AiM itself</a></li> + <li><a href="#connect">Connecting Apache and Tomcat</a></li> </ol> It is likely that you already have some of the above software installed *************** *** 43,48 **** 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 ! href='http://www.gnu.org/licenses/gpl.html'>General Public ! License</a>, as distributed by the <a href='http://www.fsf.org'>Free Software Foundation</a>; either version 2 of the license or (at your option) any later version. --- 44,49 ---- 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 ! href="http://www.gnu.org/licenses/gpl.html">General Public ! License</a>, as distributed by the <a href="http://www.fsf.org">Free Software Foundation</a>; either version 2 of the license or (at your option) any later version. *************** *** 55,75 **** <h2><a name="usr">Get acquainted with Terminal</a></h2> ! The AiM installation will require you to use the Terminal application for some of the installation steps. Terminal can be found in <font color="green">/Applications/Utilities</font>. It is recommended that you place Terminal in your Dock for easier access. There are a few commands that will be of use during the installation. These include <code>cd</code> (change directory), <code>mkdir</code> (make directory), <code>ln -s</code> (make a symbolic link), and <code>sudo</code> (temporarily assume <code>root</code> privileges).<p/> ! Many of the files associated with AiM are placed in subdirectories of the <font color='green'>/usr</font> directory. Under OS X <font color='green'>/usr</font> is hidden. The simplest way to browse and work with <font color='green'>/usr</font> is to create a symbolic link to the directory in your home directory. To do this start the Terminal application and enter, on one line, <font color='green'>ln -s /usr usr</font>. Now open your home directory. You should see a folder called <font color='green'>usr</font>. You can browse through the new folder as you normally would, but must use Terminal to create or move any files into the <font color='green'>/usr</font> directory or any of its subdirectories. <h2><a name="maple">Maple</a></h2> ! You will need Maple version 9. Simply follow Maple's default installation procedure, which typically installs software associated ! with Maple in a directory such as <font color='green'>/Applications/Maple 9</font> ! so that the executables lie in <font color='green'>/Applications/Maple\ 9.app/Contents/MacOS/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> in the Terminal application. For example <blockquote> <code>ln -s /Applications/Maple\ 9.app/Contents/MacOS/bin/maple /usr/local/bin/maple</code> </blockquote> ! will create a symbolic link in <code>/usr/local/bin</code> to the maple binary file. <p/> If you want to use AiM for actual teaching (rather than just checking --- 56,80 ---- <h2><a name="usr">Get acquainted with Terminal</a></h2> ! The AiM installation will require you to use the Terminal application for some of the installation steps. Terminal can be found in <font color="green"><code>/Applications/Utilities</code></font>. It is recommended that you place Terminal in your Dock for easier access. There are a few commands that will be of use during the installation. These include <code>cd</code> (change directory), <code>mkdir</code> (make directory), <code>ln -s</code> (make a symbolic link), and <code>sudo</code> (temporarily assume <code>root</code> privileges).<p/> ! Many of the files associated with AiM are placed in subdirectories of the <font color="green"><code>/usr</code></font> directory. Under OS X <font color="green"><code>/usr</code></font> is hidden. The simplest way to browse and work with <font color="green"><code>/usr</code></font> is to create a symbolic link to the directory in your home directory. To do this start the Terminal application and enter, on one line, <font color="green"><code>ln -s /usr usr</code></font>. Now open your home directory. You should see a folder called <font color="green"><code>usr</code></font>. You can browse through the new folder as you normally would, but must use Terminal to create or move any files into the <font color="green"><code>/usr</code></font> directory or any of its subdirectories. <h2><a name="maple">Maple</a></h2> ! You will need Maple version 9 or higher. Simply follow Maple's default installation procedure, which typically installs software associated ! with Maple in a directory such as <font color="green"><code>/Applications/Maple 9</code></font> ! so that the executables lie in <font color="green"><code>/Applications/Maple\ 9.app/Contents/MacOS/bin</code></font>. ! A nice way to make maple available in a standard path is by creating ! symbolic links into <font color="green"><code>/usr/local/bin</code></font> via the command <code>ln -s</code> in the Terminal application. For example <blockquote> <code>ln -s /Applications/Maple\ 9.app/Contents/MacOS/bin/maple /usr/local/bin/maple</code> </blockquote> ! will create a symbolic link in <font color="green"><code>/usr/local/bin</code></font> to the maple binary file. One could make the OS X installation mimic a UNIX or Linux install by entering ! <blockquote> ! <code>ln -s /Applications/Maple\ 9.app/Contents/MacOS /usr/local/maple</code> ! </blockquote> ! and then add <font color="green"><code>/usr/local/maple/bin</code></font> to the PATH variable. See <a href="http://www.peachpit.com/articles/article.asp?p=31442&seqNum=4">Configuring Your OS X Unix Environment</a> for information about changing the PATH variable. <p/> If you want to use AiM for actual teaching (rather than just checking *************** *** 78,105 **** then this is not an issue. If you do not have such a license, or are unsure of the type of license that your campus has, then you should ! 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 generally supportive. Our main contact there has been <a href='dmc...@ma...'>Darren McIntyre</a> (but you should ! email <a href='mailto:in...@ma...'>in...@ma...</a> in the first instance). <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> or from <a ! href="http://serverlogistics.com/tomcat.php">ServerLogistics</a>. Download ! <a href="http://aimmath.sourceforge.net/jakarta-tomcat-4.1.27.tar.gz"> ! jakarta tomcat 4.1.27</a> (7.1 MB) from jakarta.apache.org or <a href="http://serverlogistics.com/software/packages/jaguar/CompleteTomcat-4.1.24.dmg.gz"> ! jakarta tomcat 4.1.24</a> (7.8 MB) from ServerLogistics. If you downloaded jakarta-tomcat-4.1.27 to the Desktop, you should unpack it and move the resulting folder to ! <font color='green'>/usr/local/</font>, and make a symbolic link to ! it from <font color='green'>/usr/local/tomcat</font>. You can move the folder using the command ! <blockquote> ! <code>sudo mv ~/Desktop/jakarta-tomcat-4.1.27 /usr/local</code> ! </blockquote> ! in the Terminal and enter your password when prompted. If you downloaded from ServerLogistics, follow their installation instructions. 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 --- 83,104 ---- then this is not an issue. If you do not have such a license, or are unsure of the type of license that your campus has, then you should ! 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 generally supportive. Our main contact there has been <a href='dmc...@ma...'>Darren McIntyre</a> (but you should ! email <a href="mailto:in...@ma...">in...@ma...</a> in the first instance). <h2><a name="tomcat">Tomcat</a></h2> ! You will need the Jakarta Tomcat server from <a href="http://jakarta.apache.org">jakarta.apache.org</a> or from <a ! href="http://serverlogistics.com/tomcat.php">ServerLogistics</a>. I would recommend downloading ! <a href="http://apache.oregonstate.edu/jakarta/tomcat-5/v5.0.24/bin/jakarta-tomcat-5.0.24.tar.gz"> ! jakarta-tomcat-5.0.24</a> (9.8 MB) from jakarta.apache.org or <a href="http://serverlogistics.com/software/packages/jaguar/CompleteTomcat-4.1.24.dmg.gz"> ! jakarta tomcat 4.1.24</a> (7.8 MB) from ServerLogistics. If you downloaded jakarta-tomcat-5.0.24 to the Desktop, then follow the directions found at <a href="http://www.developer.com/tech/article.php/981431">http://www.developer.com/tech/article.php/981431</a> for installing Tomcat 4. You only need to alter the name of the file to match the one you downloaded. If you downloaded from ServerLogistics, follow their installation instructions. One thing to note about the ServerLogistics' installation is that it puts Tomcat in <font color="green"><code>/Library/Tomcat</code></font> and you should modify any references to <font color="green"><code>/usr/local/tomcat</code></font> below to <font color="green"><code>/Library/Tomcat</code></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 *************** *** 107,117 **** At this point you need to set the JAVA_HOME environment variable. To do this open Terminal and enter <blockquote> ! <code>pico .tcshrc</code> </blockquote> then enter <blockquote> ! <code>setenv JAVA_HOME /Library/Java/Home</code> </blockquote> ! and finally press CTRL-O to save the .tcshrc file and CTRL-X to quit the pico editor. You can start up the Tomcat server and test some example applications, if you like, but generally it's problem-free. <!-- --- 106,118 ---- At this point you need to set the JAVA_HOME environment variable. To do this open Terminal and enter <blockquote> ! <code>pico .tcshrc</code> for the tcsh shell or<br> ! <code>pico .bashrc</code> for the bash shell </blockquote> then enter <blockquote> ! <code>setenv JAVA_HOME /Library/Java/Home</code> for tcsh or<br> ! <code>export JAVA_HOME="/Library/Java/Home"</code> for bash. </blockquote> ! and finally press CTRL-O to save the .tcshrc file and CTRL-X to quit the pico editor. You can now start up the Tomcat server using the commands found in the installation instructions you followed and test some example applications, but generally everything should work as expected. <!-- *************** *** 119,136 **** <h2><a name="tth">TtH</a></h2> ! If you don't already have <font color='green'>tth</font> (the command that runs the TeX-to-HTML converter TtH from <a href="http://hutchinson.belmont.ma.us/tth/">hutchinson.belmont.ma.us/tth/</a>) ! installed or if your already installed version of <font color='green'>tth</font> is version 3.30 or better, you may skip this section. <p/> ! During the running of <font color='green'>AutoConf.mpl</font> (see the next section), the TtH used by AiM is set to the first one found by searching the ! standard paths <font color='green'>/usr/local/bin</font>, ! <font color='green'>/usr/bin</font> and <font color='green'>/bin</font>, and if it is not found among these paths it is set to the copy of ! <font color='green'>tth</font> that comes with the AiM distribution. ! If <font color='green'>AutoConf.mpl</font> finds a version ! of <font color='green'>tth</font> on your system that is older than 3.30 you should set AiM to use its own copy, by setting <blockquote> --- 120,137 ---- <h2><a name="tth">TtH</a></h2> ! If you don't already have <font color="green">tth</font> (the command that runs the TeX-to-HTML converter TtH from <a href="http://hutchinson.belmont.ma.us/tth/">hutchinson.belmont.ma.us/tth/</a>) ! installed or if your already installed version of <font color="green">tth</font> is version 3.30 or better, you may skip this section. <p/> ! During the running of <font color="green">AutoConf.mpl</font> (see the next section), the TtH used by AiM is set to the first one found by searching the ! standard paths <font color="green">/usr/local/bin</font>, ! <font color="green">/usr/bin</font> and <font color="green">/bin</font>, and if it is not found among these paths it is set to the copy of ! <font color="green">tth</font> that comes with the AiM distribution. ! If <font color="green">AutoConf.mpl</font> finds a version ! of <font color="green">tth</font> on your system that is older than 3.30 you should set AiM to use its own copy, by setting <blockquote> *************** *** 139,144 **** </blockquote> (modified appropriately for whatever your AiM webapps directory is) in ! <font color='green'>ManualConfig.mpl</font> and rerunning <font ! color='green'>AutoConf.mpl</font>. <p/> Note that versions of TtH older that 3.30 may translate some ``unbalanced'' --- 140,145 ---- </blockquote> (modified appropriately for whatever your AiM webapps directory is) in ! <font color="green">ManualConfig.mpl</font> and rerunning <font ! color="green">AutoConf.mpl</font>. <p/> Note that versions of TtH older that 3.30 may translate some ``unbalanced'' *************** *** 165,182 **** <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. You should get a folder called <font color="green">aim Folder</font>. Rename the <font color="green">aim Folder</font> to <font color="green">AiM</font>. Now move the <font color="green">AiM</font> folder into the ! <font color='green'>/usr/local/tomcat/webapps/</font> directory by entering <blockquote> <code>sudo mv ~/Desktop/AiM /usr/local/tomcat/webapps</code> </blockquote> ! in Terminal (assuming you unzipped on the Desktop). If you unzipped in a different location, then type <code>sudo mv </code> and then drag your <font color="green">AiM</font> folder onto the Terminal window. The path to your <font color="green">AiM</font> folder will be auto completed and you can finish the command by entering space and the rest of the command above. ! You do not have to rename the aim Folder to AiM. 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/> --- 166,183 ---- <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. You should get a folder called <font color="green"><code>aim Folder</code></font>. Rename the <font color="green"><code>aim Folder</code></font> to <font color="green"><code>AiM</code></font>. Now move the <font color="green"><code>AiM</code></font> folder into the ! <font color="green"><code>/usr/local/tomcat/webapps/</code></font> directory by entering <blockquote> <code>sudo mv ~/Desktop/AiM /usr/local/tomcat/webapps</code> </blockquote> ! in Terminal (assuming you unzipped on the Desktop). If you unzipped in a different location, then type <code>sudo mv </code> and then drag your <font color="green"><code>AiM</code></font> folder onto the Terminal window. The path to your <font color="green">AiM</font> folder will be auto completed and you can finish the command by entering space and the rest of the command above. ! You do not have to rename the <font color="green"><code>aim Folder</code></font> to <font color="green"><code>AiM</code></font>. You can choose any name (not containing spaces) for this subdirectory. If you choose ! <font color="green">ROOT</font> 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"><code>AiM</code></font>. If you chose something different, simply replace ! <font color="green"><code>AiM</code></font> by your choice in all filenames and URLs below. <p/> *************** *** 197,201 **** </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 --- 198,202 ---- </em></dt> <dd>In this case, you should unzip the new AiM into the ! <font color="green"><code>/usr/local/tomcat/webapps/ROOT/</code></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 *************** *** 205,209 **** </li> <li>Change to the maple 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>.) You can do this by entering <blockquote> --- 206,210 ---- </li> <li>Change to the maple directory of your new AiM installation. (If you installed ! AiM in the default location then the directory will be <font color="green"><code>/usr/local/tomcat/webapps/AiM/WEB-INF/maple/</code></font>.) You can do this by entering <blockquote> *************** *** 212,216 **** in Terminal. <!-- ! 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. --- 213,217 ---- in Terminal. <!-- ! 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. *************** *** 218,222 **** --> Now start Maple, and read in the file ! <font color='green'>AutoConf.mpl</font> by entering <blockquote> <code>sudo maple</code> --- 219,223 ---- --> Now start Maple, and read in the file ! <font color="green">AutoConf.mpl</font> by entering <blockquote> <code>sudo maple</code> *************** *** 228,246 **** find out all the necessary configuration information automatically. If it complains of any problems, you may wish to set ! <font color='green'>waffle := true</font> and run it again to get a more verbose report. The output is saved in the file ! <font color='green'>autoconf.log</font> as well as being printed on the terminal. <p/> <a name = "reconfig"> ! Usually <font color='green'>AutoConf.mpl</font></a> will find everything it needs, but if not, you will need to have a file <font ! color='green'>ManualConfig.mpl</font> that contains the parameters whose default values you wish to override and rerun <font ! color='green'>AutoConf.mpl</font>. To create such a file start ! by copying <font color='green'>ManualConfig.dist</font> to <font ! color='green'>ManualConfig.mpl</font> and then edit it following the instructions included in the file. You should then run <font ! color='green'>AutoConf.mpl</font> again. You can iterate this procedure as often as is needed until you get an installation without error messages. Particular settings you may want to check are the following: --- 229,247 ---- find out all the necessary configuration information automatically. If it complains of any problems, you may wish to set ! <font color="green">waffle := true</font> and run it again to get a more verbose report. The output is saved in the file ! <font color="green">autoconf.log</font> as well as being printed on the terminal. <p/> <a name = "reconfig"> ! Usually <font color="green">AutoConf.mpl</font></a> will find everything it needs, but if not, you will need to have a file <font ! color="green">ManualConfig.mpl</font> that contains the parameters whose default values you wish to override and rerun <font ! color="green">AutoConf.mpl</font>. To create such a file start ! by copying <font color="green">ManualConfig.dist</font> to <font ! color="green">ManualConfig.mpl</font> and then edit it following the instructions included in the file. You should then run <font ! color="green">AutoConf.mpl</font> again. You can iterate this procedure as often as is needed until you get an installation without error messages. Particular settings you may want to check are the following: *************** *** 264,279 **** Config['TomcatPort'] := 80: </blockquote> ! in <font color='green'>ManualConfig.mpl</font>. If you neglected to do this the first time around you may have to manually edit ! the files <font color='green'>admin.html</font> and ! <font color='green'>index.html</font> in ! the <font color='green'>WEB-INF</font> directory and ! <font color='green'>DefaultZone.mpl</font> ! in the <font color='green'>WEB-INF/root</font> directory, to remove the string <tt>:8080</tt>. Incidentally, the port used by Tomcat is set in the <tt><Connector/></tt> tag (that is in turn embedded in <tt><Server ...><Service ...> ... </Service></Server></tt>) in the file ! <font color='green'>/usr/local/tomcat/conf/server.xml</font>.</dd> <dt><em>Is the time set correctly?</em> <dd>There is currently a problem with time zones; if automatic --- 265,280 ---- Config['TomcatPort'] := 80: </blockquote> ! in <font color="green">ManualConfig.mpl</font>. If you neglected to do this the first time around you may have to manually edit ! the files <font color="green">admin.html</font> and ! <font color="green">index.html</font> in ! the <font color="green"><code>WEB-INF</code></font> directory and ! <font color="green">DefaultZone.mpl</font> ! in the <font color="green"><code>WEB-INF/root</code></font> directory, to remove the string <tt>:8080</tt>. Incidentally, the port used by Tomcat is set in the <tt><Connector/></tt> tag (that is in turn embedded in <tt><Server ...><Service ...> ... </Service></Server></tt>) in the file ! <font color="green"><code>/usr/local/tomcat/conf/server.xml</code></font>.</dd> <dt><em>Is the time set correctly?</em> <dd>There is currently a problem with time zones; if automatic *************** *** 284,305 **** GMT = GMT + 0 hours. If you are in the southern hemisphere or your locale doesn't have daylight saving, you may want ! to hard-set the time in <font color='green'>ManualConfig.mpl</font> (see the end of the file).</dd> </dl> <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> and 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> --- 285,306 ---- GMT = GMT + 0 hours. If you are in the southern hemisphere or your locale doesn't have daylight saving, you may want ! to hard-set the time in <font color="green">ManualConfig.mpl</font> (see the end of the file).</dd> </dl> <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> and 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> *************** *** 319,327 **** </li> <li>Point your Web browser at the URL of the AiM server. This will be something ! like <font color='green'><a href="http://localhost:8080/AiM/admin.html">http://localhost:8080/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 --- 320,328 ---- </li> <li>Point your Web browser at the URL of the AiM server. This will be something ! like <font color="green"><a href="http://localhost:8080/AiM/admin.html">http://localhost:8080/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"><code>/usr/local/tomcat/webapps/</code></font> ! if you chose to unzip AiM in a directory other than <font color="green"><code>AiM/</code></font>, or omit ! <font color="green"><code>AiM/</code></font> completely if you chose to put it in <font color="green"><code>ROOT/</code></font>. You may also need to alter localhost to match the name of your server,e. g., www.myserver.edu:8080. 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 *************** *** 332,347 **** 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> --- 333,438 ---- 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="connect">Connecting Apache and Tomcat</a></h2> + <h3><font color="red">Warning!! This should only be attempted by users who are very comfortable with the Terminal and working with system configuration files.</font></h3> + <ol> + <li>Shutdown Tomcat and Apache. + <ul> + <li>You can shutdown Apache by turning off Web sharing in System Preferences.</li> + <li> Tomcat can be shutdown by running + <blockquote> + <code>sudo /usr/local/tomcat/bin/shutdown.sh</code> + </blockquote> + in the Terminal.</li> + </ul></li><p/> + <li>Install JK 1.2 module for Apache + <ul> + <li>Download the binary release of the module from <a href="http://apache.mirrors.redwire.net/jakarta/tomcat-connectors/jk/binaries/macosx/jakarta-tomcat-connectors-jk-1.2.5-macosx-apache-1.3.28.tar.gz">http://apache.mirrors.redwire.net/jakarta/tomcat-connectors/jk/binaries/macosx/jakarta-tomcat-connectors-jk-1.2.5-macosx-apache-1.3.28.tar.gz</a> and unzip the file. Move the <font color="green">mod_jk.so</font> file found in the unzipped archive to the Apache module directory and give it the correct file properties by entering the following series of commands in the Terminal + <blockquote> + <code>sudo cp ~/Desktop/jakarta-tomcat-connectors-jk-1.2.5-macosx-apache-1.3.28/mod_jk.so /usr/libexec/httpd/mod_jk.so</code><br><br> + <code>sudo chown root:wheel /usr/libexec/httpd/mod_jk.so</code><br><br> + <code>sudo chmod 755 /usr/libexec/httpd/mod_jk.so</code> + </blockquote></li> + </ul></li> + <li>Edit the Apache configuration file + <ul> + <li>Back up the configuration file by entering in Terminal + <blockquote> + <code>sudo cp /etc/httpd/httpd.conf /etc/httpd/httpd.conf.mybak</code> + </blockquote></li> + <li>Add the following lines to the <font color="green">httpd.conf</font> file by first opening the file in the Terminal with + <blockquote> + <code> sudo pico /etc/httpd/httpd.conf</code> + </blockquote></li> + <dl> + <dt>In the LoadModule section before the hfs_apple_module add + <blockquote> + <code>LoadModule jk_module libexec/httpd/mod_jk.so</code> + </blockquote></dt> + <dt>In the AddModule section before the mod_hfs_apple.c add + <blockquote> + <code>AddModule mod_jk.c</code> + </blockquote></dt> + <dt>Before Section 3 on Virtual Hosts add + <blockquote> + <code>###Connecting to AiM</code><br> + <code><IfModule mod_jk.c></code><br> + <code>JkWorkerFile /usr/local/tomcat/conf/workers.properties</code><br> + <code>JkLogFile /usr/local/tomcat/logs/mod_jk.log</code><br> + <code>JkLogLevel debug</code><br> + <code>Alias /AiM /usr/local/tomcat/webapps/AiM</code><br> + <code>JkMount /AiM/* aimWorker</code><br> + <code><Location "/AiM/WEB-INF/"></code><br> + <code>AllowOverride None</code><br> + <code>deny from all</code><br> + <code></Location></code><br> + <code></IfModule></code><br> + </blockquote></dt> + <dt> Now do CTRL-O RETURN CTRL-X to save and close the file.</dt> + </dl> + </ul></li> + <li>Create the <font color="green">workers.properties</font> file by typing the following in the Terminal + <blockquote> + <code>sudo pico /usr/local/tomcat/conf/workers.properties</code><br> + <code>#Set up for AiM</code><br> + <code>workers.tomcat_home=/usr/local/tomcat</code><br> + <code>workers.java_home=/System/Library/Frameworks/JavaVM.framework/Versions/1.4.2/Home</code><br> + <code>ps=\</code><br> + <code>worker.list=aimWorker</code><br> + <code>worker.aimWorker.port=8009</code><br> + <code>worker.aimWorker.host=localhost</code><br> + <code>worker.aimWorker.type=ajp13</code><br> + </blockquote>and do CTRL-O RETURN CTRL-X to save and close the file.</li><p/> + <li>Edit the <font color="green">jk2.properties</font> file + <ul> + <li>Back up the file by entering + <blockquote> + <code>sudo cp /usr/local/tomcat/conf/jk2.properties /usr/local/tomcat/conf/jk2.properties.mybak</code> + </blockquote> + in the Terminal</li> + <li>Open the file with + <blockquote> + <code>sudo pico /usr/local/tomcat/conf/jk2.properties</code> + </blockquote> + and remove the # symbol from the beginning of the shm.file line. Do CTRL-O RETURN CTRL-X to save and close the file. + </ul> + </li><p/> + <li>Return to step 2 of the <a href="#aim">AiM installation</a> and set the port for AiM to 80 in <font color="green">ManualConfiig.mpl</font> and follow the rest of the AiM installation instructions. + </li><p/> + <li>Test the set up by starting Apache and Tomcat and entering <code>http://myservername/AiM/</code> into your browser. You should see the student login page. + </li> + </ol> <h2><a name="trouble">Troubleshooting</a></h2> *************** *** 377,381 **** 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 backward from the end for the string "unavailable". Just above this, you should find a --- 468,472 ---- 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 backward from the end for the string "unavailable". Just above this, you should find a *************** *** 395,400 **** 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 re-execute that worksheet. </li> --- 486,491 ---- 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 re-execute that worksheet. </li> *************** *** 406,410 **** </ul> <hr/> ! Last modified by Jon Breitenbucher on 15/09/03 </body> --- 497,501 ---- </ul> <hr/> ! Last modified by Jon Breitenbucher on 21/05/04 </body> |
