[Aimmath-commit] AIM/doc install.html,1.2.2.3,1.2.2.4

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-serv29373/doc

Modified Files:
      Tag: windows
	install.html 
Log Message:
complete installation instructions for Windows

Index: install.html
===================================================================
RCS file: /cvsroot/aimmath/AIM/doc/install.html,v
retrieving revision 1.2.2.3
retrieving revision 1.2.2.4
diff -C2 -d -r1.2.2.3 -r1.2.2.4
*** install.html	26 Aug 2003 14:58:30 -0000	1.2.2.3
--- install.html	26 Aug 2003 20:37:53 -0000	1.2.2.4
***************
*** 5,12 ****
  </head>
  <body>
! <h1>Installing AiM under Windows</h1>

  These are instructions for installing and configuring AiM. Installation
  has been tested with Windows 2000 and Windows XP.

--- 5,22 ----
  </head>
  <body>
! <h1><a name="install">Installing AiM under Windows</a></h1>

  These are instructions for installing and configuring AiM. Installation
  has been tested with Windows 2000 and Windows XP.
+ <p/>
+ 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>.

***************
*** 35,39 ****

! <h2>Maple</h2>

  You will need Maple version 7, 8, or 9. Simply follow Maple's default installation
--- 45,49 ----

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

  You will need Maple version 7, 8, or 9. Simply follow Maple's default installation
***************
*** 56,60 ****

! <h2>Java</h2>

  You need to have a java runtime environment (JRE) installed on your machine.
--- 66,70 ----

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

  You need to have a java runtime environment (JRE) installed on your machine.
***************
*** 64,68 ****
  install the JRE into the folder <font color='green'>C:/Program Files/Java/j2re1.4.2</font>.

! <h2>Tomcat</h2>

  You will need the Jakarta Tomcat 4 server from <a
--- 74,78 ----
  install the JRE into the folder <font color='green'>C:/Program Files/Java/j2re1.4.2</font>.

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

  You will need the Jakarta Tomcat 4 server from <a
***************
*** 78,82 ****

! <h2>AiM</h2>

  You are now finally ready to install AiM itself by following the following steps.
--- 88,92 ----

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

  You are now finally ready to install AiM itself by following the following steps.
***************
*** 91,98 ****
  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. You might for example want to change a 
! different name if you already have an AiM server installed in the folder 
! <font color='green'>AiM</font> and want
! to run the new installation in parallel.<p/>
  </li>
  <li>Open the Maple worksheet <a href="..\WEB-INF\maple\AutoConf.mws">AutoConf.mws</a>. Just clicking the link
--- 101,115 ----
  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. 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 
! <font color='green'>C:/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.</li>
! </ol>
! <p/>
  </li>
  <li>Open the Maple worksheet <a href="..\WEB-INF\maple\AutoConf.mws">AutoConf.mws</a>. Just clicking the link
***************
*** 121,124 ****
--- 138,142 ----
    subjects and so on.<p/>
  </li>
+ <li>(Optional) You can copy 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'>C:/Tomcat/webapps/ROOT/</font> and your new one is in <font color='green'>C:/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>

***************
*** 130,134 ****
  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://aimmath.sourceforge.net/forum/index.php?id=2">AiM Forum</a>.
  <p/>
  Some other kinds of errors may give you a Java stacktrace in your
--- 148,152 ----
  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
***************
*** 175,180 ****
    server, or change the port that Tomcat is listening and also set 
    <font color='green'>Config['TomcatPort']</font>
!   in <font color='green'>ManualConfig.mpl</font> to specify a
!   different port.
   </li>
   <li>The message <font color='red'>Catalina.stop:
--- 193,198 ----
    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:
***************
*** 184,188 ****
   </li>
  </ul>
- 

--- 202,205 ----