|Overview of WeBWorK system setup for WeBWorK 1.8||topic started 10/16/2002; 5:53:27 AM
last post 10/16/2002; 5:53:27 AM
|Arnold K. Pizer - Overview of WeBWorK system setup for WeBWorK 1.8
10/16/2002; 5:53:27 AM (reads: 2412, responses: 0)
Overview of WeBWorK system setup
Where to put the WeBWorK files
The WeBWorK files can be placed almost anywhere but a reasonable location is
How much disk space you need depends on how large your courses are, how much temporary data you keep, whether or not you do any "housekeeping", whether for example you have WeBWorK keep an access_log which can become huge, etc. It is difficult to give general guidelines. The actual system files take up less than 5 MB. The system log files can be many many times that size. A 100 student course might have 25 MB of actual permanent data and 250 MB of temporary data. If you are setting up a system which will have a substantial number of users, we recommend you set up tmp directories for courses under a separate file system (see linux.html). Disk space is very cheap --- it is a lot better to have too much than too little.
How does WeBWorK interact with the webserver?
No WeBWorK files are directly accessible from the web. Rather all access is through two types of methods, one for cgi scripts and one for html files. The WeBWorK cgi directory can be accessed through either of two methods.
The first method of accessing the WeBWorK cgi directory is through a link. One cgi link gives access to all of WeBWorK's cgi scripts. Note that this requires your webserver to be set up to follow symbolic links under the cgi-bin directory. If for some reason you do not want to set up your webserver this way, we suggest you first do so on a temporary basis and get WeBWorK running. Then you can move WeBWorK's cgi directory (
The second (and recommended) method of accessing the WeBWorK cgi directory is through (at least with Apache) a
There is one html link that gives access to the html files used by the WeBWorK system. In addition there is one html link for every course that gives access to the html files used by each individual WeBWorK course (this link is set up when setting up a course). Note that this requires your webserver to be set up to follow symbolic links under the htdocs directory, i.e. the html document root
Directions for configuring apache and setting up these links are given in the linux.html document.
What does the system setup script do?
This script is run only when you initially set up the WeBWorK system.
It modifies all the scripts entering the correct path to perl on your system.
It writes a
It sets the correct permissions and groups for all the files and directories. This is extremely tricky to get correct by hand if you want to have a functioning and secure system.
It modifies the
What does the course setup script do?
This script is run every time a WeBWorK course is set up.
It sets the correct permissions and groups for all the course files and directories. Any missing files or directories are created.
It creates the
It creates a generic but functional