View of /trunk/NationalProblemLibrary/Instructions

    1 How to Install the WeBWorK Problem Library Version 2
    2 --- -- ------- --- ------- ------- ------- ------- -
    3 
    4 Installing the problem library can be done in 4 steps.
    5 
    6 1. Download and unpack files
    7 
    8 The files are located in the Rochester cvs (including this one).
    9 Get the files and remember where you put them.  We will refer to
   10 it below as that directory from step 1.
   11 
   12 2. Tell WeBWorK where on your disk you put the problem library
   13 
   14 In the file $WEBWORK_ROOT/conf/global.conf, set the following
   15 values.  The first one is where you put the problem library files
   16 in step 1.
   17 
   18 $problemLibrary{root}        = "/opt/ProblemLibrary";
   19 $problemLibrary{version} = "2";
   20 $problemLibrary{userSQL}     = "webworkWrite";
   21 $problemLibrary{passwordSQL} = "xxx";
   22 
   23 The last line is the password you use for webworkWrite for mysql.
   24 
   25 3. Set up database
   26 
   27 In mysql, create a database called ProblemLibrary and give read access
   28 to someone like webworkRead.  For example, you could use the following
   29 (using your own value for rootPassword which is the password for root
   30 to access mysql):
   31 
   32     mysql -u root -p=rootPassword
   33 
   34     mysql> CREATE DATABASE ProblemLibrary;
   35 
   36     mysql> GRANT SELECT on ProblemLibrary.* to webworkWrite@localhost;
   37 
   38 4. Run the installation script
   39 
   40 Make sure you are in the directory created in step 1.  The directory
   41 should at a minimum contain the files loadDB2 and create_tables2.sql.
   42 Then run
   43 
   44   ./loadDB2 rootPassword
   45 
   46 Again, rootPassword is not the system root password, but the password
   47 for user root in mysql.  If you don't supply it, you will be prompted for
   48 it.
   49 
   50 5. Adjust existing courses.
   51 
   52 If you have courses which had been accessing version 1 of the problem
   53 library, your courses will have a symbolic link in their templates
   54 directories called Library.  Delete this link (rm Library).  WeBWorK
   55 will make the correct new link for you the next time you need it.
   56 
   57 Test and enjoy.
   58 
   59 Upgrading
   60 ---------
   61 
   62 If at some time in the future you get your hands on more problems,
   63 upgrading is simpler.  Optionally remove the previous copy of the
   64 library, unpack the new copy in the same place, and run loadDB.pl.
   65 
   66 Send questions, problems, and other feedback to jj (at) asu.edu.
   67 
   68 Credit
   69 ------
   70 
   71 This problem library was compiled in large part by support from the
   72 National Science Foundation.
   73