[Deploying Sakai] Sakai - Installation requirement

[Tapas Mishra]

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
/etc/apt/sources.list
	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
		JAVA_HOME=/usr/lib/jvm/java-6-sun
and not
		JAVA_HOME=/usr/lib/jvm/java-6-sun-1.6.0.20

(create a symbolic link 	/usr/lib/jvm/java-6-sun
--->	/usr/lib/jvm/java-6-sun-1.6.0.20 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-1.6.0.22 is downloaded then JAVA_HOME would be
pointing back to /usr/lib/jvm/java-6-sun-1.6.0.20 which will create
problem.)

Then  	export JAVA_HOME

Also  download apache-tomcat-5.5.31 since Sakai 2.7 needs this version
this can be downloaded from here
	
	http://archive.apache.org/dist/tomcat/tomcat-5/

Then in your .bashrc or /etc/profile

		CATALINA_HOME=/opt/apache-tomcat-5.5.31
		export CATALINA_HOME

		PATH=$PATH:$JAVA_HOME/bin:$CATALINA_HOME/bin
		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
	http://tomcat.apache.org/download-55.cgi
	keep the downloaded zip in /opt.

	Unzip it in /opt you will get apache-tomcat-5.5.31
	based on instructions here
	http://confluence.sakaiproject.org/display/DOC/Install+Guide+-+Binary+Install+%282.7%29

	
	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

	-Xms512m
	-Xmx1024m
	-XX:PermSize=128m
	-XX:Ma	xPermSize=256m
	-Dorg.apache.jasper.compiler.Parser.STRICT_QUOTE_ESCAPING=false
	-Dsun.lang.ClassLoader.allowArraySyntax=true
	-Dhttp.agent=Sakai

	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.
	/opt/apache-tomcat-5.5.31/sakai
	and download  the file default.sakai.properties file from here
https://source.sakaiproject.org/svn/config/branches/sakai-2.7.x/configuration/bundles/src/bundle/org/sakaiproject/config/bundle/default.sakai.properties
		
	into the folder /opt/apache-tomcat-5.5.31/sakai

	

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

	https://confluence.sakaiproject.org/display/DOC/Sakai+2.7


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

http://sakai.your_school.org

and there do a Reverse Proxy.

	The doc for configuring Apache as Reverse Proxy for sakai is here
		https://confluence.sakaiproject.org/display/~steve.swinsburg/Fronting+Tomcat+with+Apache+via+mod_proxy_ajp