Subversion Repositories wimsdev

         Distribution version WIMS_VERSION of WIMS
          (WWW Interactive Multipurpose Server)


Please be aware that WIMS is a sophisticated software, not a simple set of
web pages. You have to compile and install it if you want to run it locally
on your computer.

WIMS is copyrighted under the GNU General Public License (GPL). See the file
COPYING for licensing conditions.
        
This software is reported to work on several Linux distributions, including
Red Hat, Debian, and LinuxPPC. It is also reported to work on Mac OS-X and
should work on any modern Unix-like system after minimal porting efforts.

Otherwise, you may compile the system on your machine. Here are the steps:

0. Install third party support softwares:
 -- LaTeX distribution
 -- Pari 2.3 or up (http://pari.math.u-bordeaux.fr/).
 -- Maxima 5.20 or up (http://sourceforge.net/projects/maxima/).
 -- Make sure that the server is able to send mail.
 
1. Create a user, say `wims', with home directory, say, /var/wims ($HOME).

2. Login as wims, and copy the tar file wims-WIMS_VERSION.tgz into $HOME.
   This tarball now contains the base system. It does not contains "pedagogical modules".

3. Decompress and untar the .tgz file.

4. Compile the server as user wims : type './compile'.

Then execute the script ./bin/setwrapexec as root. It is important 
for security reasons.

5. Get and install optional support software. Omitting some of them will simply
 prevent your server from running some of the exercises / activities.

 -- GNU Octave 3.O or up (http://www.octave.org/).          ( 20% importance)
 -- Yacas 1.0.52 or up (http://yacas.sourceforge.net/).     ( 10% importance)
 -- GAP 4 or up (http://www-gap.dcs.st-and.ac.uk/~gap).     ( 10% importance) 
 -- Povray (http://www.povray.org/).                        (  5% importance)
 -- Graphviz (http://www.graphviz.org/).                    (  5% importance)
 -- Macaulay (1.1 or up)                                    (~ 0% importance)

6. You may run WIMS single-user by executing the script $HOME/localwims
   if you would prefer something else. In this case, you must run first the 
   script ./bin/setwimsd as root. It is important for security reasons.
   
   The default browser used is mozilla, call 'localwims another_browser'
   if you would prefer something else.  
   You should see your favorite browser pop up and display the WIMS home page,
   including a link allowing you to do online site maintenance. Click on it
   and follow instructions there to configure and check your installation.
   
   In particular, modules must be selected and installed from that online
   maintenance page.

7. If you want to use Apache httpd with WIMS, run $HOME/bin/apache-config 
   as root. In this case, wims can be accessed from the address

        http://localhost/wims/         or
        http://localhost/wims/wims.cgi

8. Get and install all or some help and teaching modules (from the WIMS home
page, follow the link maintenance, then module management). A good idea is to
install at least modules from categories "teacher" and "student" ("all" is
recommended) in zone "help" : they contain the FAQ pages and several help
documents.

Good luck, and enjoy!

If you run into difficulties: have a look at WIMSEDU forum (http://wimsedu.info/).

Home site of wims: http://wims.unice.fr/
Source : http://sourcesup.cru.fr/frs/?group_id=379