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

    1 readme.first file for WeBWorK version 1.8
    2 
    3 
    4 First you should connect to our server (http://webwork.math.rochester.edu) and
    5 play around (as a practice user) in some actual or past WeBWorK courses. Most
    6 courses allow you to login as 'practice1' with password 'practice1'.
    7 
    8 There is also a lot on line documentation which you can peruse.
    9 
   10 Assuming you like what you see (or have already done this), read on.
   11 
   12 The basic requirements for setting up WeBWorK is a unix system running the
   13 apache webserver, perl, and LaTeX. Probably your system already has all these
   14 installed. In addition for the readable display of mathematical expressions you
   15 will need tth, latex2html, and dvipng. You can make do with a subset of these,
   16 but we recommend you install all of them.  You will need a system administrator
   17 to do some of the set up and it would be a good idea for him or her to be
   18 involved from the beginning.  Our system admin is Hoss Firooznia
   19 (hfir@math.rochester.edu) and he would certainly be willing to answer questions.
   20 Similarly,  Mike Gage (gage@math.rochester.edu) or Arnie Pizer
   21 (apizer@math.rochester.edu) are willing to help.
   22 
   23 Here is some information on installing WeBWorK. If you have any questions or
   24 problems, please email us.
   25 
   26 
   27 Have fun,
   28 
   29 Mike Gage and Arnie Pizer
   30 ******************************************************************
   31 
   32 
   33 1. Download the following files using a web browser (ftp access is not allowed).
   34 Connect to http://webhost.math.rochester.edu/webworkdocs/ and then click on
   35 Download WeBWorK and follow the instructions. You will have to register to
   36 download files. If you have difficulty registering, contact Gage
   37 (gage@math.rochester.edu) or Pizer (gage@math.rochester.edu).
   38 
   39 webwork_VERSION_SUBVERSION-MONTH-DAY-YEAR.tar.gz
   40 templates_VERSION_SUBVERSION-MONTH-DAY-YEAR.tar.gz
   41 
   42 and also:
   43 
   44 readme.first
   45 readme.install
   46 readme.upgrade
   47 overview.html
   48 linux.html (really instructions for setting up WeBWorK on any unix system)
   49 linux-redhat-8.0.html (instructions for setting up RedHat 8.0 as a WeBWorK server)
   50 
   51 These six files are contained in webwork_X.X_XX-MONTH-XX-XXXX.tar.gz but you
   52 should look at
   53 overview.html and
   54 readme.install
   55 for information on where to install the files.
   56 
   57 
   58 2. If you are setting WeBWorK up for the first time, read the readme.install
   59 file. If you have already installed a previous version of WeBWorK, read both the
   60 readme.install and readme.upgrade files.  Even if you are not using RedHat, we
   61 recommend that you read linux-redhat-8.0.html as this contained useful
   62 information.
   63 
   64 
   65 3. Version 1.8 of WeBWorK contains several enhancements and bug fixes.  Many
   66 enhancements are internal and will not be apparent to students. The most
   67 apparent change is the addition of a new display mode ("typeset2") which uses
   68 dvipng to create png images of equations.  The output is identical to the output
   69 from LaTeX2HTML ("typeset") but it is almost as fast as tth.  Thus precreation
   70 is not required. We would like to express our sincere thanks to John Jones for
   71 providing the code the added the typeset2 mode.
   72 
   73 Courses running under WeBWorK 1.5 or later should run without change under
   74 WeBWorK 1.8.
   75 
   76 
   77 4. The templates_X.X_XX-MONTH-XX-XXXX.tar.gz file contains a library
   78 approximately 2500 WeBWorK problems covering pre-calculus, first year calculus,
   79 vector calculus, differential equations, probability, and statistics.  Note that
   80 some problems form older distributions have been renamed and/or moved to other
   81 locations in the library.  The current version of all problems (and WeBWorK
   82 system files if you want to live on the bleeding edge) can be obtained by
   83 connecting to http://webhost.math.rochester.edu/webworkdocs/ , clicking on
   84 "Software Download" and then on "Experimental CVS for WeBWorK."  The Rochester
   85 problem library is under the CVS Root Rochester and the system files are under
   86 System.  In addition at this site you can find problem libraries from Cal State
   87 Long Beach (CSLB), Detroit County Day School (DCDS), Dartmouth, Indiana, Ohio
   88 State, and Stony Brook.  If you have written WeBWorK problems and are are
   89 willing to share them, please contact us and we will add your problems to the
   90 repository.
   91 
   92 
   93 
   94 5. WeBWorK License
   95 
   96 Copyright (c) 1995-2002 University of Rochester
   97 All Rights Reserved
   98 
   99 
  100 Permission to use, copy, modify, and distribute this software and its
  101 documentation for educational, research and non-profit purposes,
  102 without fee, and without a written agreement is hereby granted,
  103 provided that the above copyright notice, this paragraph and the
  104 following three paragraphs appear in all copies.
  105 
  106 Permission to incorporate this software into commercial products may
  107 be obtained by contacting the University of Rochester's Office of
  108 Research and Project Administration
  109 (<URL: http://www.rochester.edu/ORPA/tto/index.html>).
  110 
  111 This software program and documentation are copyrighted by the
  112 University of Rochester. The software program and documentation are
  113 supplied "as is", without any accompanying services from the
  114 University. The University does not warrant that the operation of the
  115 program will be uninterrupted or error-free. The end-user understands
  116 that the program was developed for research purposes and is advised
  117 not to rely exclusively on the program for any reason.
  118 
  119 IN NO EVENT SHALL THE UNIVERSITY OF ROCHESTER BE LIABLE TO ANY PARTY
  120 FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES,
  121 INCLUDING LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE AND
  122 ITS DOCUMENTATION, EVEN IF THE UNIVERSITY OF ROCHESTER HAS BEEN
  123 ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. THE UNIVERSITY OF ROCHESTER
  124 SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
  125 THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  126 PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS ON AN "AS IS" BASIS, AND
  127 THE UNIVERSITY OF ROCHESTER HAS NO OBLIGATIONS TO PROVIDE MAINTENANCE,
  128 SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
  129 
  130 
  131