Sakai 1.0.0

QuickStart

Sakai Installation

Sakai Download

Sakai Documentation

Developing with Sakai

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 QuickStart

Users wanting to quickly setup and demonstrate a Sakai site may download the QuickStart distribution of Sakai.  This distribution provides a "drop it in and go" configuration of Sakai.  The intent is to make it easier for potential content developers to quickly get Sakai up and running. The builds include a working configuration of the Tomcat Servlet Engine.

Users intending to deploy Sakai in a small to medium production environment must further configure the QuickStart so as to connect to a database among other configuration changes.

Users intent on deploying Sakai 1.0 in a large production environment should expect some development involvement and should become familiar with the developer source.

Prerequisite: Java

Prior to running Sakai you will need to have a properly installed and configured Java Run-Time Environment (JRE) or Java Software Development Kit (SDK). We have provided instructions to check your Java installation and install Java if necessary.

UNIX: Sakai QuickStart
Download the Sakai QuickStart to a location on your hard drive. If you have the curl command you can download the file at the command line:
$ curl -O http://cvs.sakaiproject.org/release/1.0.0/src/sakai_quickstart.zip
Or you could use the wget command:
$ wget http://cvs.sakaiproject.org/release/1.0.0/src/sakai_quickstart.zip

After downloading the QuickStart zip file use 'jar xf filename' to extract the distribution. It will all be put in a single 'sakai' directory.

$ jar xf sakai_quickstart.zip 
Change to the sakai directory extracted from the distribution zip file. Executing the start.sh script will auto-configure Sakai and start up the associated Tomcat. You can change the permissions on the script or simply source it into a shell command line.
$ cd sakai
$ sh start.sh
You may want to watch the Tomcat log as the program starts:
$ tail -f jakarta-tomcat-5.0.28/logs/catalina.out
Startup ususally takes about a minute and the following message indicates that startup is complete:
Oct 1, 2004 9:21:14 AM org.apache.catalina.startup.Catalina start
INFO: Server startup in 44237 ms
If there are problems, there are additional logs in sakai/localfiles/logs.
Windows:Sakai QuickStart
Download the Sakai QuickStart to a location on your hard drive. Extract the files by right clicking on the ZIP file and choosing the extract all option.

The rest of the operations will be performed in a command window Start -> Run -> cmd -> OK. Change into the directory where the files were extracted

> cd \tmp\sakai_quickstart\sakai
> start.bat
The Tomcat console window should pop up, and after a while Tomcat should be up. Startup ususally takes about a minute and the following message indicates that startup is complete:
Oct 1, 2004 9:21:14 AM org.apache.catalina.startup.Catalina start
INFO: Server startup in 44237 ms
If there are problems, there are additional logs in sakai/localfiles/logs.
Test QuickStart
Sakai will be available on http://localhost:8080/portal if it has successfully started. If there are problems the logs are likely to be helpful. The Tomcat logs are in the Tomcat directory and the Sakai log is under sakai/localfiles/logs.
Shut Down Tomcat
For UNIX:
$ sh stop.sh
Windows:
> stop.bat
Sample Output
Running Sakai QuickStart with a Database

This QuickStart distribution stores its data in flat files and should not be used for any production application at all. The QuickStart install can be configured to store data in a MySql database which is suitable for small production enviromnets.

If you would like to reconfigure your QuickStart to run a small production environment you should continue with the database configuration instructions.

Joining the Sakai Developer Community

If you intend stay involved in the Sakai project you should join one of two Mailing Lists/Sakai Groups. Since Sakai is a collaborative environment, we use Sakai to communciate with those installing/maintaining Sakai and those who are developing for Sakai.

For more information, see the page describing the Sakai User and Developer Lists.