Release notes for WeBWorK 2.11
WeBWorK
Online Homework Delivery System
Version 2.11
Copyright 2000-2016, The WeBWorK Project
All rights reserved.
Details
-------
Release date: January, 2016
Github repository: https://github.com/openwebwork
Modules: webwork2 pg
Contents
Cautions
| Warning : | A number of new modules have been added since version 2.10, as well as significant database upgrades. There are also changes to the configuration files which will need to be integrated into your existing configurations. The process for upgrading to 2.11 is described below.: |
Upgrade Instructions
1) Go to /opt/webwork/webwork2, /opt/webwork/pg and run
git pull origin master
on each directory (assuming that origin is your remote name for the openwebwork repo).
2) There were a number of new perl modules added for 2.10. Run check_modules.pl and look for missing modules. They may include
3) There were a couple of new LaTeX packages added for 2.10. Change to a writeable directory outside the webwork2 directory (like ~) Run pdflatex /opt/webwork/webwork2/bin/check_latex.tex and look for missing packages. Added packages include
4) Check localOverrides.conf.dist and look for changes to add to the existing localOverrides.conf. They may include
5) Check site-conf.dist and look for changes to add to the existing site.conf. They may include paths for the following external programs
6) Run the upgrade_admin_db.pl command from webwork2/bin to upgrade your admin course database.
| Warning : | You will not be able to access the admin course until you perform this step. |
7) restart the webserver. (with apachectl graceful or similar command.)
8) Log into the admin course and upgrade the databases for all of your courses.
9) Download the latest version of the OPL using
cd /opt/webwork/libraries/webwork-open-problem-librarygit pull originOPL-update
Primary Changes
Smaller Changes
Installer
The ww_install installer has been updated to support version 2.10. It has been tested on Ubuntu 14.04, Debian 7, CentOs 7, and Fedora 20. Note: ww_install also installs the components necessary to switch your installation to the develop branch without installing new software. (It has trouble installing the Template perl package on CentOS 7. This doesn't prevent you from using release 2.10.)
Supported Distributions and Features
The following are the distributions and features that are officially still supported. You still can use WeBWorK on whatever you like, of course. In particular if you install WeBWorK on a very recent version of Ubuntu or Fedora and have problems let us know.
- Ubuntu LTS 14.04
- Debian 7
- CentOs 7
- Fedora 20
Note: There is currently a bug which prevents installation on Fedora 21. There is no package which provides the pnmtops program and this causes the installation to fail.
What could possibly go wrong?
- You can get a warning when trying to log into the admin course: You will need to run
upgrade_admin_db.pl. You will also need to upgrade all of your other course. - The library browser may stop responding. When you select a subject the chapter list may not populate. You should look in your apache error log to see what errors pop up. There are a couple of different things that can cause older systems to fail when upgraded. Chief among these seems to be having outdated or incompatible SOAP modules.
- You can't get the update notifier to work: You need to update both the localOverrides.conf and the site.conf configuration files with the latest additions to get the update notifier to work.
- You can't get hardcopies to work: You will need to install the latest LaTeX packages, including path.sty. This can be a challenge on CentOS 7 because there is no native package that provides it. You can manually download and install the Fedora version and it will work.
- Remember to update the OPL and run OPL-update.
