Sakai Logo
   Home Release 2.2.1
 

Deprecated Code

WARNING: the release artifacts included on this page are no longer current and have been superseded by newer versions of Sakai which include functionality enhancements as well as bug fixes and security patches. You can download the latest Sakai release by visiting http://source.sakaiproject.org/release.

Sakai 2.2.1 Release
(August 15, 2006)

2.2.1 is a maintenance release, meaning that its purpose is to distribute a further set of fixes to issues that were present in 2.2.0, while deliberately avoiding any new features which may introduce novel bugs. In short, 2.2.1 is currently the latest and best release of the 2.2 codebase, and if you have already been running 2.2.0 you should be able to move to 2.2.1 with confidence: there have been no API changes, so all 2.2 code should run without modification. Its feature notes are therefore identical to the 2.2.0 release, and are included in the release notes below.

The most significant fixes have been made to provisional tools: Tests&Quizzes, OSP, and Search. For a complete list of the fixes, see 2.2.1 Fixed Issues.

The 2.2 codebase as a whole marks the culmination of a significant effort to restructure the framework into more logical functional/architectural units, paving the way for multiple focused teams to work in parallel on driving the framework and legacy code forward. This release also incorporates the Open Source Portfolio suite of tools, available in this first merged effort as provisional tools. Additional functional improvements include group awareness for each of the Resources, Assignments, and Schedule tools, the inclusion of French and Catalan translations, updated help content, and the addition of four innovative provisional tools.

On this page you'll find further details concerning what the release includes, along with system requirements, an installation guide, and links to other relevant community spaces for the Sakai project.


 

Downloads

Install Type Description Windows XP Mac/*nix
Demo The Sakai Demo is a pre-built Sakai with Tomcat 5.5.17 and a simple configuration, good for a quick and easy demo of Sakai or a small pilot on a single server. (NOTE: The demo version is not intended for large scale implementations. It is suitable for evaluating the software and small-scale pilot implementations on single servers.) sakai-demo_2-2-1.zip
(130.8M)
MD5
sakai-demo_2-2-1.tar.gz
(129.7M)
MD5
Binary The Sakai Binary is a pre-built Sakai without the Tomcat or extra configuration files. Download the Binary release if you want to just drop the Sakai bundle into a pre-existing Tomcat environment. sakai-bin_2-2-1.zip
(122.7M)
MD5
sakai-bin_2-2-1.tar.gz
(122.4M)
MD5
Source The Sakai Source is all the Sakai source code from this release.  Start from Source if you expect to make any code-level changes to your Sakai system. sakai-src_2-2-1.zip
(24.4M)
MD5
sakai-src_2-2-1.tar.gz
(17.7M)
MD5

System Requirements

Sakai is Java-based, and will therefore run on a wide variety of platforms.  The platforms against which Sakai 2.2.1 has been specifically tested, however, are:
  Solaris Linux Mac OS 10.4 Win 2003
HSQLDB  DT DT DT DT
MySQL 4.1 DT FT DT DT
MySQL 5.0     DT  
Oracle 9i FT      
Oracle 10g  DT FT   FT
  DT: Deployment Test (Installation and Configuration)
FT: Functional Test (Tool Functionality + DT)
Dark cell: In production at a Sakai partner institution

 

The basic underlying requirements for a successful deployment of Sakai 2.2.1 are:
Supporting Technology Required Version Notes
 

Java

1.4.2/1.5.0

Java 1.4.2 or 1.5.0 is required to build and run Sakai.

** NOTE: Security vulnerabilities have been reported for applets under certain minor versions of the JRE. Sakai does include some applets, so see the security alert from Sun to get details on the recommended minor versions.

 

Tomcat

5.5.17+

and the

JDK 1.4 compatibility package

Although Tomcat is not the only available web container, it is highly recommended, and the documentation assumes Tomcat use. Sakai QA was conducted on Tomcat 5.5.17, so this is the recommended version, but the latest stable release of 5.5 will likely not present problems.

** NOTE: Problems with CAS integration were discovered with Tomcat 5.5.16, so this version is not recommended.

Tomcat 5.5 requires a compatibility package in order to run with Java 1.4, and some Sakai dependencies will require this, even if you are using Java 1.5 to build and run it. This compatibility package is also available from the Tomcat download page.

 

Maven

Version 1.0.2

Maven is the build tool used to deploy the source code, and is therefore not strictly necessary if all you're going to do is install a Demo with the default configuration, but it will be essential for a production deployment.

** NOTE: Maven 2 is not yet supported.

 

Database

MySQL 4.1.12+

OR

Oracle 9i+

Sakai uses HSQLDB as its "out of the box" database, requiring no special installation steps to set up, but this database is not recommended for anything more than a demo or very small pilot.  Both MySQL 4.1.12+ and Oracle 9i+ are currently supported by Sakai 2.2, but setting them up to serve as Sakai's back end will require additional configuration (see the Installation Guide).

** NOTE: Sakai has not yet been tested adequately against MySQL 5.0, and it is therefore not yet recommended for production, although it has been used successfully in development.
** NOTE: There is an issue with publishing assessments for MySQL versions 4.1.11 or less (see SAK-4416), and so MySQL 4.1.12 or greater is recommended.

It's important to note that Oracle requires the 10g driver even if Oracle 9i is used for the database. The recommended driver for MySQL is 3.1.12, since there is a greater weight of production success behind it; although early testing has revealed no significant problems with the 3.1.13 driver, it should be used advisedly.

 

Hardware note: Hardware recommendations depend on the scale of the installation.  Sakai should run on a middle-class laptop for purposes of development or tool demonstration, but at least 1GB of memory is recommended for Sakai to run smoothly for multiple users concurrently accessing the system, while a production environment for a large institution will likely involve clustered application servers.

 

Documentation

Release Notes

 

HTML Guides

 

Reference Articles

Some of the most authoritative technical documentation on Sakai code and services is found in the form of .doc files in the reference module of Sakai, which can be directly reached through subversion (and is also included in release archives). The articles for the 2.2.1 release can be found at:
https://source.sakaiproject.org/svn/reference/tags/sakai_2-2-1/docs/architecture/


 

For New Developers

The best introduction for new developers is found in a wiki space called the Programmer's Cafe. A number of experienced Sakai developers have banded together there to produce guides and tutorial materials for those who wish to start hacking on Sakai.


 

Wiki notes

Confluence is the wiki software used by the Sakai project. Confluence is used for a wide variety of purposes: the collaborative forging of documentation and design ideas, project management reporting, and the sharing of notes on various topics. A few of the more informative spaces are identified below:

 

Support
Docs

JavaDocs and TagLibDocs are available on-line:

 

Getting the Latest Source Code

Sakai is using Subversion for its source control, and has maintenance branches - which include the latest bug fixes - for its most current releases . You can check out the maintenance branch for Sakai 2.2 with a subversion client:

svn export https://source.sakaiproject.org/svn/sakai/branches/sakai_2-2-x/

The Sakai development trunk can be checked out from here:

svn co https://source.sakaiproject.org/svn/sakai/trunk

A minimal source tree designed for developers is also made available, called "Sakai Mini," which is meant to build and start up relatively quickly. It includes the Sakai Framework Technologies, the developer's Sakai Mercury portal, and a few of the basic applications. You can check it out of subversion, then just add your application code and any further dependencies that your application needs. You can grab it here:

svn export https://source.sakaiproject.org/svn/sakai/branches/sakai_mini/

 

Issue Tracking

Bug reports and feature requests may be created and monitored through our Jira system: Sakai Jira

 

Community

The Sakai community interacts online mainly in two forums. The first is through the email archives attached to the sites on Sakai Collab. "Collab" is a Sakai-based service run by the Sakai Foundation to support the collaboration of its community. For technical questions, sakai-dev is the most active such site, but many others are available, ranging from pedagogy to UI design. We encourage you to create an account, join any groups on the collab server for which you may have an interest, and participate.

To join, for example, the developer's site, simply create an account from the gateway page, log in, and then use the "Membership" tool to join the site labeled DG: Development. By joining this site you are automatically added to the sakai-dev@collab.sakaiproject.org mailing list. To "unsubscribe" from any of the lists, simply use the same Membership tool to unjoin the sites. ** NOTE: This is not technically a listserv, so that sending an "unsubscribe" email will accomplish nothing.

The second forum is Confluence, the wiki web used by the project. Confluence is used for a wide variety of purposes: the collaborative forging of documentation or design ideas, project management reporting, and the sharing of notes on a wide array of topics. You can browse its pages there anonymously, but if you want to comment or otherwise participate you're encouraged to create an account there as well.

 

Older Releases

Older Sakai Releases are still available:

 

License

The Sakai Project Software is Licensed under the:
Educational Community License Version 1.0