AIM installation procedure for Windows and Maple 7

The following installation procedure has been tested on Windows 98 and NT. If you have problems installing, please email us and we'll try to help.

1. You will need a Windows computer that has an IP address. You can find the IP address of your computer by executing winipcfg command. You will also need Maple. Make sure that Maple version 7 or 8 is installed on your computer.
2. Download Tomcat from here (we use jakarta-tomcat-4.0.5). Install it under c:\tomcat. Note: before installing tomcat you might also have to download a Java Development Kit and install it for example under c:\j2sdk (we use Java 2 SDK, version 1.4.0).
3. Add the locations of java.exe and cmaple.exe to your PATH variable:
   • If using Windows NT: click right mouse button on "this computer" and select "properties" then "system variables" and edit PATH variable there.
   • If using Windows 98/2000/...:  edit autoexec.bat file and modify the PATH variable there.
   Your PATH should now contain something like
   PATH = "c:\j2sdk\bin"; "c:\program files\maple 7\bin.wnt"; %PATH%
   If you intend to make your hands dirty and for some reason recompile the file Alice.java, make sure that java will find the file servlet.jar: in our case this file resides in the tomcat directory, so we add the following line to our autoexec.bat :
   set CLASSPATH = . ; c:\tomcat\common\lib\servlet.jar
   (modifying PATH will make the commands java and cmaple available).
4. Test Tomcat (point your browser at http://your_address:8080/index.html ).
   
5. Stop Tomcat and rename the directory tomcat\webapps to original_webapps: you won't need it anymore.
6. Download aim.zip from here. Unzip it. IMPORTANT: you must unzip it into c:\. After you have done that, two directories will be created: c:\aim and c:\tomcat\webapps.
7. Modify your URL in the file tomcat\webapps\Root\index.html and, if necessary, copy the contents of c:\tomcat\webapps to wherever your tomcat is installed.
8. • If you decide to relocate the c:\aim directory, edit the contents of the file c:\tomcat\webapps\aim\web-inf\classes\Aliceserver.java (replace c:\aim) and recompile it (javac Aliceserver.java)
   • If your Maple library is not located in c:/progra~1/maple7~1/lib, then edit the contents of the file c:\tomcat\webapps\aim\web-inf\classes\Maple.java (replace "cmaple -q -b \"c:/progra~1/maple7~1/lib\" ") and recompile it (javac Maple.java)
9. Restart your computer so that PATH changes take effect.
10. Edit the file c:\aim\settings.src and modify the timezone according to instructions given there. NOTE: You must do this before going to the next step.
11. Launch a dos window and type in the following commands:

C:\>cd \aim

C:\aim>cmaple
> read(`aim.src`);
> quit

This will generate the file aim.m in the aim directory.

• NOTE: if you get 'bad command or file name' after typing 'cmaple' then you probably set your PATH incorrectly.
• NOTE: If you get an error after "read(`aim.src`)" then try adding libname := "c:/aim", libname: at the end of maple.ini file found inside Lib subdirectory of Maple directory.
  
12. Start Tomcat and point your browser at http://your_address:8080/aim/ .
    If everything works properly, you will see a wellcome window like the one you get when you try http://caroll.UGent.be:8080/aim.
    You can Minimize but NOT CLOSE the java window that results.
13. IMPORTANT: You need to change passwords for "Algebra", "Calculus", "Sample" and Theoretical mechanics courses. Their default passwords are "arbegla", "suluclac", "elpmas" and "scina" respectively. To change a password for Calculus, click on teacher's page, choose "Other options", enter the current password, and click on "Calculus". You will then be able to change the password. Do the same for the others. IMPORTANT: it is essential that you change these passwords to prevent a potential security hole.

To add more courses to AIM server:

1. Create directory "MyAlgebra" under c:\aim
2. Go to directory c:\tomcat\webpages\aim and edit the file index.html. Copy and paste existing button (say "Algebra"), and change "Algebra" to "MyAlgebra". Make the same change in teacher_page.html
3. VERY IMPORTANT: Go to "teacher's page", click on "Other options" then on "MyAlgebra" and change the password. (by default there is no password hence a security hole).
4. We maintain a web page with a list of all known AIM courses/websites. Once you have tested your course material, please email us your AIM web site address so that other people can use your work. Conversly, if you see any courses you like on that page, email the corresponding authors and they may be willing to share their work.