[Deploying Sakai] Sakai - Installation requirement

Tapas Mishra mightydreams at gmail.com
Wed Feb 9 19:34:57 PST 2011

On Tue, Feb 8, 2011 at 12:18 AM, Jesmond Navarro <wetfish at maltanet.net> wrote:
> Hi Everyone,
> I am new to Sakai and to this list. Please excuse me if this question has
> already been answered.
> I would like to install Sakai as it looks to be great for my school
> environment.
> Are there any docs that I could read to be able to install Sakai by myself?
> Would appreciate if someone could send me some links or info.
> This is what I am searching for:
> 1.       Base O/S
> 2.       Installation requirements for MySQL / Tomcat
> 3.       Instructions on how to install Sakai
> Thanks in advance for your help
> Jesmond
> _______________________________________________
I have done it on a Linux Machine and the docs which every one say are
good ones.
Though I still mention how I did that

Where I  installed  sakai 2.7 binary is a Ubuntu 10.04 64 bit server.

	To get things running you need Java 1.6 and Tomcat 5.5.30 for Sakai 2.7

	a) Creating Environment for Sakai installation

	We begin our installation first.To  verify if Java is installed on
your VM just type
	java -version

	if you get following output then
	 java version "1.6.0_20"
	 Java(TM) SE Runtime Environment (build 1.6.0_20-b02)
	 Java HotSpot(TM) 64-Bit Server VM (build 16.3-b01, mixed mode)

	that means it is installed.But if not then you need to enable partner
repositories in /etc/apt/sources.list

	The java (jdk) is not available from Ubuntu repositories so in
	following line should be added

	 deb http://archive.canonical.com/ubuntu lucid partner
	 deb-src http://archive.canonical.com/ubuntu lucid partner

 apt-get install sun-java6-jdk

	As for Sakai 2.7 Java 1.6 is needed.

	So before you proceed to install Sakai make sure the Java correct
version is downloaded and installed,
	I have described how to set class path etc for this environment below.

	If JAVA_HOME is not set then following lines should be added to .bashrc
do it like this
and not

(create a symbolic link 	/usr/lib/jvm/java-6-sun
--->	/usr/lib/jvm/java-6-sun- if it is not there in most case
it will be there because in case of an OS upgrade if version
/usr/lib/jvm/java-6-sun- is downloaded then JAVA_HOME would be
pointing back to /usr/lib/jvm/java-6-sun- which will create

Then  	export JAVA_HOME

Also  download apache-tomcat-5.5.31 since Sakai 2.7 needs this version
this can be downloaded from here

Then in your .bashrc or /etc/profile


		export PATH

	b) Sakai Installation begins here

download sakai 2.7 binary as follows
	wget http://source.sakaiproject.org/release/2.7.1/artifacts/sakai-bin-2.7.1.tgz
	and Tomcat 5.5 from here
	keep the downloaded zip in /opt.

	Unzip it in /opt you will get apache-tomcat-5.5.31
	based on instructions here

	In Tomcat/bin there I created a file setenv.sh and it has following contents
	export JAVA_OPTS='-server -Xms512m -Xmx1024m -XX:PermSize=128m
-XX:MaxPermSize=512m 	-XX:NewSize=192m -XX:MaxNewSize=384m
-Djava.awt.headless=true -Dhttp.agent=Sakai
	-	Dorg.apache.jasper.compiler.Parser.STRICT_QUOTE_ESCAPING=false
	-	Dsun.lang.ClassLoader.allowArraySyntax=true'

	Sakai doc  https://confluence.sakaiproject.org/display/DOC/Sakai+2.7
mentions  to have value 	as shown above  for setenv.sh how ever they
mention in Section 2.4 this setenv.sh two times i.e.

	First time in Section 2.3 the  mention to have setenv.sh and have the
line just as it is marked above.

	Second time in same section 2.4 they again mentioned as follows

	-XX:Ma	xPermSize=256m

	This had given a confusion and I had added the above entries in
setenv.sh later on it was found that 	they were mentioned twice.

	CATALINA_HOME  in our case  refers to /opt/apache-tomcat-5.5.31
	which also defined in our .bashrc

	Created a folder named sakai in CATALINA_HOME i.e.
	and download  the file default.sakai.properties file from here
	into the folder /opt/apache-tomcat-5.5.31/sakai


	The link to above file is available on Sakai installation page documentation


So the docs are perfectly fine when you need to host on your school
site get some thing like


and there do a Reverse Proxy.

	The doc for configuring Apache as Reverse Proxy for sakai is here

More information about the production mailing list