Release notes for WeBWorK 2.4.1

This article has been retained as a historical document. It is not up-to-date and the formatting may be lacking. Use the information herein with caution.

See more recent notes in Category:Release_Notes

                                     WeBWorK                                    
                         Online Homework Delivery System                        
                                  Version 2.4.1                                 

                    Copyright 2000-2007, The WeBWorK Project                    
                              All rights reserved.                              

Details
-------

Release date: 25-August-2007
CVS tag: rel-2-4-1
CVS branch: rel-2-4-dev

Changes since 2.4.0
-------------------

* Fixed a "Duplicate entry" error that occurred when WeBWorK attempted to assign
  a set to a user to whom it was already assigned, for example with the "Assign
  Set to All Users" button. (Bug #1293)

* Fixed a problem that occurred when viewing the set details for a set that had
  not been assigned to any users.

* Added the ability to unarchive .tar.gz and .tar files to the File Manager.

* Worked around an IE bug in the File Manager where pressing return submits a
  form but does not set the submit button's value properly in some
  circumstances.

* Fixed a problem where the "over time: closed." status message would appear in
  incorrect circumstances in the problem set list.

* Improved handling of textbook chapters and sections in the NPL-update script.

* Improved handling in the NPL-update script for problems which are tagged to a
  chapter, but not to a particular section in the chapter.

* Show the numbers for textbook chapters and sections in the Library Browser.

* Improve speed of browsing the National Problem Library in the Library Browser.

* Ignore .svn directories when browsing file-based problem libraries in the
  Library browser.

* Extended the set definition file format to support commas in the source_file,
  value, and max_attempts fields. Literal commas and backslashes are backslash-
  escaped.

Installation & Upgrade
----------------------

Comprehensive installation and upgrade instructions are located at:
http://webwork.maa.org/wiki/Installation_Manual_for_2.4

Read the sections below for specific information about upgrading from various
versions of WeBWorK.

Upgrading from 2.4.0
--------------------

Before beginning, back up your WeBWorK database and course directories.

To update WeBWorK to exactly 2.4.1, use the following commands:

cd /opt/webwork/webwork2
cvs -q up -dP -rrel-2-4-1

To update WeBWorK to the "tip" of the 2.4.x branch, which is mostly stable and
includes bug fixes and new features before they are officially released, use the
following commands:

cd /opt/webwork/webwork2
cvs -q up -dP -rrel-2-4-dev

If you are using the National Problem Library, re-run bin/NPL-update to update
the database format to the latest version.

No database changes occurred between 2.4.0 and 2.4.1, so running bin/wwdb_upgrade
is not necessary. No configuration file changes occurred between 

Upgrading from 2.3.x
--------------------

Before beginning, back up your WeBWorK database and course directories.

To update WeBWorK to exactly 2.4.1, use the following commands:

cd /opt/webwork/webwork2
cvs -q up -dP -rrel-2-4-1

To update WeBWorK to the "tip" of the 2.4.x branch, which is mostly stable and
includes bug fixes and new features before they are officially released, use the
following commands:

cd /opt/webwork/webwork2
cvs -q up -dP -rrel-2-4-dev

Merge changes from global.conf.dist, database.conf.dist, and
webwork.apache-config (if you are using Apache 1) or webwork.apache2-config (if
you are using Apache 2) into your configuration files.

Run bin/wwdb_upgrade -v to upgrade your database. If you receive errors about
modelCourse it is OK to go on -- modelCourse is not a real course.

If you are using the National Problem Library, the loadDB2 script in the
database_problems directory has been replaced with a new bin/NPL-update script
in the main webwork2 distribution. The problem library metadata is now stored
within the main webwork database. Run bin/NPL-update to load the problem
metadata into the its new location. It is safe to remove the separate
ProblemLibrary database.

Upgrading from 2.2.x
--------------------

Make sure you are using the sql_single database layout for all the courses you
wish to continue to use. After you upgrade, courses using other database
layouts will be inaccessible. Move non-sql_single courses out of your courses
directory.

The standard directory layout of WeBWorK has changed since 2.2.x. We now suggest
that you place the webwork2 directory, as well as the pg, courses, and
libraries, directories in /opt/webwork rather than in /opt.

To update WeBWorK to exactly 2.4.1, use the following commands:

cd /opt/webwork/webwork2
cvs -q up -dP -rrel-2-4-1

To update WeBWorK to the "tip" of the 2.4.x branch, which is mostly stable and
includes bug fixes and new features before they are officially released, use the
following commands:

cd /opt/webwork/webwork2
cvs -q up -dP -rrel-2-4-dev

Merge changes from global.conf.dist, database.conf.dist, and
webwork.apache-config into your configuration files.

Run bin/wwdb_check -v to verify that your database is up-to-date for version
2.3.0 (the first version that included automated database upgrades). Then run
bin/wwdb_upgrade -v to upgrade to bring your database up-to-date for version
2.4.1.

Getting help
------------

The best place to get support is in the WeBWorK discussion forums located at:
http://webwork.maa.org/moodle/course/view.php?id=2

To report bugs:
http://bugs.webwork.rochester.edu/

Lots of WeBWorK documentation:
http://webwork.maa.org/wiki/

-- Main.SamHathaway - 26 Aug 2007