Setting up a Development Server

These instructions was written for Apache 1.3. To use with Apache 2.x, use wwapache2ctl rather than wwapachectl and use the config files ending in .apache2-config rather than those ending in .apache-config.

Follow the instructions at CVS Commit Access to check out the webwork2 and pg modules from the system repository into your home directory. The checkout command will look like this:

cvs -d :ext:yourname@cvs.webwork.rochester.edu:/webwork/cvs/system checkout pg webwork2

In webwork2/bin, copy wwapachectl.dist to wwapachectl. Edit that file:

• Set HTTPD to the location of Apache on your system. This could be /usr/bin/apache, /usr/bin/httpd, /usr/local/bin/httpd, /usr/local/sbin/httpd etc.
• Set WEBWORKROOT to the location of your working copy of webwork2, e.g. /home/yourname/webwork2.
• If you will be sharing courses with other developers on the same system, uncomment the line umask 2.

In webwork2/conf, copy each *.dist file, removing the .dist extension.

Edit devel-site.apache-config so that the configuration therein matches that of your system's Apache configuration. You can usually find your system's Apache configuration somewhere like /etc/apache/httpd.conf or /usr/local/apache/conf/httpd.conf.

Edit devel.apache-config, and modify the Include lines to point to your copies of devel-site.apache-config and webwork.apache-config.

Edit webwork.apache-config, setting the $webwork_dir variable to the same location of your working copy of webwork2. This should be the same as the value you used for the WEBWORKROOT variable in wwapachectl.

Edit global.conf as described in Installation_Manual_for_WeBWorK_2.4#Configuring_WeBWorK. Set $pg_root to the location of your working copy of pg, e.g. /home/yourname/pg.

To start your system, change to your webwork2 directory and type:

bin/wwapachectl start