[Aimmath-commit] AIM/doc installwin.html,1.5,1.6

SourceForge Headquarters 225 Broadway Suite 1600 San Diego, CA 92101 +1 (858) 422-6466

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

Modified Files:
	installwin.html 
Log Message:
Cosmetic changes to windows autoconfiguration

Index: installwin.html
===================================================================
RCS file: /cvsroot/aimmath/AIM/doc/installwin.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -C2 -d -r1.5 -r1.6
*** installwin.html	27 Aug 2003 10:11:43 -0000	1.5
--- installwin.html	6 Sep 2003 20:00:39 -0000	1.6
***************
*** 12,23 ****
  The installation consists of 4 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="#aim">Install AiM itself</a></li>
  </ol>
! It is likely that you already have both Maple and a Java runtime environment on your computer, in which case you can skip those steps. 
! If you already have a working of installation of AiM then you will also already have a Tomcat server installed and you can jump directly to <a href="#aim">step 4</a>.
! 

  <h2>License terms</h2>
--- 12,25 ----
  The installation consists of 4 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="#aim">Install AiM itself</a></li>
  </ol>
! It is likely that you already have both Maple and a Java runtime
! environment on your computer, in which case you can skip those steps.
! If you already have a working of installation of AiM then you will
! also already have a Tomcat server installed and you can jump directly
! to <a href="#aim">step 4</a>.

  <h2>License terms</h2>
***************
*** 26,34 ****
  <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, 
! the <a href="http://www.servlets.com/cos/index.html">com.oreilly.servlet</a> support classes,
! and the <a href="http://www.interlog.com/~tcharron/blat.html">blat</a> mailer.
! 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
--- 28,44 ----
  <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, 
! the 
! <a href="http://www.servlets.com/cos/index.html">com.oreilly.servlet</a> 
! support classes,
! and the 
! <a href="http://www.interlog.com/~tcharron/blat.html">blat</a> 
! mailer.
! You should check the license terms for these components on their 
! webpages, but they are unlikely to cause trouble for academic users,
! apart from the issues described below for Maple.
  <p/>
  The Maple and Java source code for AiM itself is free software; you
***************
*** 44,52 ****
  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. 
  <p>
  If you want to use AiM for actual teaching (rather than just checking
--- 54,61 ----
  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.
 
 If you want to use AiM for actual teaching (rather than just checking
***************
*** 65,141 ****
 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-windows-i586.exe">installer for JRE 1.4.2</a> (14MB) from <a
! href="http://java.sun.com">java.sun.com</a>. Just follow the default installation procedure. It will
! install the JRE into the folder C:/Program Files/Java/j2re1.4.2_01/bin. Restart your computer to complete the installation.

  <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 and run 
! the automatic installer for 
 <a href="http://aimmath.sourceforge.net/tomcat-4.1.27.exe">
! tomcat 4.1.27</a> (8.73 MB). When the installer offers you to change the default installation
! location, I recommend you choose C:\Tomcat because it will be easier to find than
! the default location deep inside the C:\Program Files folder. Towards the end
! of the installation you will also be asked for the port number, you can simply
! leave it at the default 8080. Finally you will be asked to choose a password for admin account on the
! Tomcat manager.
!

  <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 complete) 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 
! C:\Tomcat\webapps\
! 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. Below we will assume that
! you chose the name "AiM". 
! If you chose something different, simply replace "AiM" by 
! your choice in all filenames and URLs below. 
! 
! If you already have a working AiM installation then you have to make an important choice. Do you want to
 <ol>
! <li>keep the old installation
! and install AiM 3.0 in a different subdirectory of the webapps directory. 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 <a href="#copy">step 5</a> below.</li>
! <li>update by overwriting your old installation with AiM 3.0. In this case you should unzip the new AiM into the 
! C:/Tomcat/webapps/ROOT/ 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.</li>
! </ol>
! 
! </li>
! <li>Open the maple subfolder of your new AiM installation. (If you installed AiM in the default location then the folder is <a href="file://c:\Tomcat\webapps\AiM\WEB-INF\maple" target="new">c:\Tomcat\webapps\AiM\WEB-INF\maple</a>. Just clicking the link
! should open the folder in an Explorer window.) In the folder you will find a Maple worksheet AutoConfWin.mws. Open it in Maple (for example by double-clicking on it). In this worksheet you can first make changes to the default configuration, as explained there.
! Then execute the worksheet. The worksheet will
! find out most of the necessary configuration information automatically.
! If it complains of any problems, you may wish to set 
! waffle := true and run it again
! to get a more verbose report. Using this information you can then review the
! settings at the top of the worksheet and make the
! necessary changes before executing AutoConfWin.mws again. You can iterate
! this procedure as often as you like until you get an installation without
! error messages.
! </li>
! <li>The installation is complete. Now start your Tomcat server. The Tomcat installation will have installed a shortcut
! "Start Tomcat" for this purpose in the Start menu.
! </li>
! <li>
! Point your webbrowser at the
! URL of the AiM server. This will be something like <a href="http://localhost:8080/AiM/admin.html">http://localhost:8080/AiM/admin.html</a>,
! where you may have to replace AiM by the name of the subdirectory of the 
! Tomcat/Webapps/
! directory into which you unzipped AiM.
! 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>(Optional) You can copy data from an old AiM installation to your new installation. All the data is contained in the directory root inside the WEB-INF subdirectory of your old AiM installation. You can copy the entire contents into the corresponding root 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 C:/Tomcat/webapps/ROOT/ and your new one is in C:/Tomcat/webapps/AiM/ then you want to replace every occurrence of ROOT by AiM in all the files.</li>
 </ol>

--- 74,195 ----
  the first instance).

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

! You probably have a Java Runtime Environment already installed under
! C:/Program Files/JavaSoft/JRE or somewhere
! similar. If not, you can install it by downloading and running the 
! <a href="http://aimmath.sourceforge.net/j2re-1_4_2_01-windows-i586.exe">
! installer for JRE 1.4.2</a> (14MB) from 
! <a href="http://java.sun.com">java.sun.com</a>. Just follow the
! default installation procedure. It will install the JRE into the
! folder C:/Program
! Files/Java/j2re1.4.2_01/bin. Restart your computer to complete
! the installation.

  <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 and run the automatic installer for
 <a href="http://aimmath.sourceforge.net/tomcat-4.1.27.exe">
! tomcat 4.1.27</a> (8.73 MB). When the installer offers you to change
! the default installation location, I recommend you choose 
! C:\Tomcat because it will be easier to find
! than the default location deep inside the 
! C:\Program Files folder. Towards the end of
! the installation you will also be asked for the port number, you can
! simply leave it at the default 8080.
! Finally you will be asked to choose a password for admin account on
! the Tomcat manager.

  <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
! complete) 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 
! C:\Tomcat\webapps\ 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. Below we will
! assume that you chose the name "AiM". If
! you chose something different, simply replace
! "AiM" by your choice in all filenames and
! URLs below. If you already have a working AiM installation
! then you have to make an important choice. Do you want to
! <ol>
! <li>keep the old installation and install AiM 3.0 in a different
! subdirectory of the webapps directory. 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 <a href="#copy">step 5</a> below.
! </li>
! <li>update by overwriting your old installation with AiM 3.0. In this
! case you should unzip the new AiM into the C:/Tomcat/webapps/ROOT/ 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.
! </li>
! </ol>
! 
! </li>
! <li>
! Open the maple subfolder of your new AiM installation. (If you
! installed AiM in the default location then the folder is <a
! href="file://c:\Tomcat\webapps\AiM\WEB-INF\maple"
! target="new">c:\Tomcat\webapps\AiM\WEB-INF\maple</a>. Just clicking
! the link should open the folder in an Explorer window.) In the
! folder you will find a Maple worksheet AutoConfWin.mws. Open it in Maple (for example
! by double-clicking on it). In this worksheet you can first make
! changes to the default configuration, as explained there. Then
! execute the worksheet. The worksheet will find out most of the
! necessary configuration information automatically. If it complains
! of any problems, you may wish to set waffle :=
! true and run it again to get a more verbose report. Using
! this information you can then review the settings at the top of the
! worksheet and make the necessary changes before executing
! AutoConfWin.mws again. You can iterate this procedure as often as
! you like until you get an installation without error messages.
! </li>
! <li>
! The installation is complete. Now start your Tomcat server. The
! Tomcat installation will have installed a shortcut "Start Tomcat" for
! this purpose in the Start menu.
! </li>
! <li>
! Point your webbrowser at the URL of the AiM server. This will be
! something like <a
! href="http://localhost:8080/AiM/admin.html">http://your.host.name:8080/AiM/admin.html</a>,
! where you may have to replace AiM by the
! name of the subdirectory of the Tomcat/Webapps/ directory into which you
! unzipped AiM. 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. Students will be 
! able to log in at <a
! href="http://localhost:8080/AiM/">http://your.host.name:8080/AiM/</a> 
! (without the admin.html).
! </li>
! <li>
! (Optional) You can copy data from an old AiM installation to your
! new installation. All the data is contained in the directory root inside the WEB-INF subdirectory of your old AiM
! installation. You can copy the entire contents into the
! corresponding root 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 C:/Tomcat/webapps/ROOT/
! and your new one is in C:/Tomcat/webapps/AiM/ then you want to replace
! every occurrence of ROOT by AiM in all the files.
! </li>
 </ol>

***************
*** 146,151 ****
  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
--- 200,206 ----
  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 
! from the <a href="mailto:aim...@li...">AiM
! developers</a>.
  <p/>
  Some other kinds of errors may give you a Java stacktrace in your
***************
*** 202,208 ****
  </ul>

- 
  <hr>
! Last modified by Gustav Delius on 27/08/03

  </body>
--- 257,262 ----
  </ul>

  <hr>
! Last modified by Neil Strickland on 06/09/03

  </body>