View of /trunk/webwork/webworkdocs/installation/readme.upgrade

    1 readme.upgrade file for WeBWorK version 1.8
    2 
    3 **********************************************************************
    4 
    5 1. Read the readme.install file and download the *.tar.gz files.
    6 
    7 2. Courses running under WeBWorK 1.5 or later will run without change under
    8 WeBWorK 1.8.
    9 
   10 3. If you don't want to keep a version of your current WeBWorK system
   11 active, you can remove the system directory (and all its subdirectories)
   12 and start over with the new installation.  We strongly recommend that
   13 you keep a copy of your old system even if you do not make the changes
   14 outlined in step 4 below.
   15 
   16 4. If you want to maintain an active version of your current system, do
   17 the following:
   18 a. Move the system directory to a new directory old_system and move
   19 the system_html directory to a new directory old_system_html:
   20 cd .../webwork/
   21 mv system old_system
   22 mv system_html old_system_html
   23 b. In old_system/lib/webworkConfig.pm edit the items: $mainDirectory,
   24 $htmlWebworkURL, and $cgiWebworkURL.  In these items, replace "system"
   25 by "old_system".
   26 c. In old_system/cgi/webworkInit.pm edit the "use lib" line replacing
   27 "system" by "old_system". Copy this edited webworkInit.pm file to
   28 old_system/cgi/cgi-scripts/webworkInit.pm and
   29 old_system/scripts/webworkInit.pm. This same file maut reside in these
   30 three locations.
   31 d. In you webserver's htdocs and cgi-bin directories (or configuration
   32 files), create new links for $cgiWebworkURL and $htmlWebworkURL (just
   33 copy your current setup replacing "system" by "old_system" in the links
   34 or cgi aliases).
   35 e. To get a course (e.g. mth140a) to use the old_system, edit the course's
   36 index.html file (.../webwork/courses/mth140a/html/index.html) changing the line
   37  <FORM ACTION= "/cgi-bin/webwork/system/login.pl" METHOD="POST">
   38 to
   39  <FORM ACTION= "/cgi-bin/webwork/old_system/login.pl" METHOD="POST">
   40 
   41 You can even have two login forms on this page so that students can use
   42 either system at will.  This may be confusing for the students, but will
   43 not cause any problems for WeBWorK.  All the course data is completely
   44 independent from the WeBWorK system scripts.
   45 
   46 5. To install the new system, follow the instructions in readme.install.
   47 Be care not to over write your .../webwor/courses/ directory if you have
   48 real courses set up there.
   49 
   50 
   51 Mike Gage and Arnie Pizer