Over 350 educational organizations use Sakai as a learning management system, research collaboration system and ePortfolio solution.
This tutorial assumes that you already have Ubuntu installed with no add-ons. If you are unsure of how to install Ubuntu please check their website (http://www.ubuntu.com) or please reconsider attempting this installation.
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install openssh-server openssh-client
sudo apt-get install apache2
sudo vi /etc/apt/sources.list
add deb http://archive.canonical.com/ubuntu lucid partner
add deb-src http://archive.canonical.com/ubuntu lucid partner
sudo apt-get install sun-java6-jdk
sudo apt-get install wget
cd /opt
sudo wget http://archive.apache.org/dist/tomcat/tomcat-5/v5.5.33/bin/apache-tomcat-5.5.33.tar.gz
sudo tar xvzf apache-tomcat-5.5.33.tar.gz
sudo ln -s /opt/apache-tomcat-5.5.33 tomcat
cd /opt/tomcat/bin
sudo vi startup.sh
add export JAVA_HOME=/usr/lib/jvm/java-6-sun after comments
sudo vi shutdown.sh
add export JAVA_HOME=/usr/lib/jvm/java-6-sun after comments
sudo vi setenv.sh
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'
sudo chmod 755 setenv.sh
export CATALINA_HOME=/opt/tomcat
sudo sh startup.sh
cd /opt/tomcat
sudo wget http://source.sakaiproject.org/release/2.7.0/artifacts/sakai-bin-2.7.0.tgz
sudo tar xvzf sakai-bin-2.7.0.tgz
sudo vi /opt/tomcat/sakai/sakai.properties and paste in text @ https://source.sakaiproject.org/svn/config/branches/sakai-2.7.x/configuration/bundles/src/bundle/org/sakaiproject/config/bundle/default.sakai.properties
Install MySQL server
Find DATABASE CONFIGURATION in /opt/tomcat/sakai/sakai.properties and replace yourDbUserName and yourDbPassword with MySQL username & password
Uncomment all MySQL lines:
# MySQL settings - make sure to alter as appropriate
vendor@org.sakaiproject.db.api.SqlService=mysql
driverClassName@javax.sql.BaseDataSource=com.mysql.jdbc.Driver
hibernate.dialect=org.hibernate.dialect.MySQLInnoDBDialect
url@javax.sql.BaseDataSource=jdbc:mysql://127.0.0.1:3306/sakai?useUnicode=true&characterEncoding=UTF-8
validationQuery@javax.sql.BaseDataSource=select 1 from DUAL
defaultTransactionIsolationString@javax.sql.BaseDataSource=TRANSACTION_READ_COMMITTED
cd /opt/tomcat/conf
cd /opt/tomcat/webapps/ROOT
sudo vi index.html
<html>
<head>
<title>Redirecting to /portal</title>
<meta http-equiv="Refresh" content="0:URL=/portal">
</head>
<body bgcolor="#ffffff" onLoad="javascript:window.location='/portal';">
<div style="margin:18px;width:288px;background-color:#cccc99;padding:18px;border:thin solid #666600;text-align:justify">
<p style="margin-top:0px">
You are being redirected to the Sakai portal. If you are not automatically redirected, use the link below to continue:<br/>
<a href="/portal">Take me to the Sakai portal</a>
</p>
</body>
</html>
At this point you should be able to navigate to your http://yourserver:8080/portal and login to Sakai with the username admin and password admin. Please be sure to give Sakai a few moments to start up once you have enabled your Tomcat servlet.
Thanks to Jonathan Vernon and Trevor Parker for their hard work on this tutorial.
This tutorial assumes that you already have Ubuntu installed with no add-ons. If you are unsure of how to install Ubuntu please check their website (http://www.ubuntu.com) or please reconsider attempting this installation.
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install openssh-server openssh-client
sudo apt-get install apache2
sudo vi /etc/apt/sources.list
add deb http://archive.canonical.com/ubuntu lucid partner
add deb-src http://archive.canonical.com/ubuntu lucid partner
sudo apt-get install sun-java6-jdk
sudo apt-get install wget
cd /opt
sudo wget http://archive.apache.org/dist/tomcat/tomcat-5/v5.5.33/bin/apache-tomcat-5.5.33.tar.gz
sudo tar xvzf apache-tomcat-5.5.33.tar.gz
sudo ln -s /opt/apache-tomcat-5.5.33 tomcat
cd /opt/tomcat/bin
sudo vi startup.sh
add export JAVA_HOME=/usr/lib/jvm/java-6-sun after comments
sudo vi shutdown.sh
add export JAVA_HOME=/usr/lib/jvm/java-6-sun after comments
sudo vi setenv.sh
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'
sudo chmod 755 setenv.sh
export CATALINA_HOME=/opt/tomcat
sudo sh startup.sh
cd /opt/tomcat
sudo wget http://source.sakaiproject.org/release/2.7.0/artifacts/sakai-bin-2.7.0.tgz
sudo tar xvzf sakai-bin-2.7.0.tgz
sudo vi /opt/tomcat/sakai/sakai.properties and paste in text @ https://source.sakaiproject.org/svn/config/branches/sakai-2.7.x/configuration/bundles/src/bundle/org/sakaiproject/config/bundle/default.sakai.properties
Install MySQL server
Find DATABASE CONFIGURATION in /opt/tomcat/sakai/sakai.properties and replace yourDbUserName and yourDbPassword with MySQL username & password
Uncomment all MySQL lines:
# MySQL settings - make sure to alter as appropriate
vendor@org.sakaiproject.db.api.SqlService=mysql
driverClassName@javax.sql.BaseDataSource=com.mysql.jdbc.Driver
hibernate.dialect=org.hibernate.dialect.MySQLInnoDBDialect
url@javax.sql.BaseDataSource=jdbc:mysql://127.0.0.1:3306/sakai?useUnicode=true&characterEncoding=UTF-8
validationQuery@javax.sql.BaseDataSource=select 1 from DUAL
defaultTransactionIsolationString@javax.sql.BaseDataSource=TRANSACTION_READ_COMMITTED
cd /opt/tomcat/conf
cd /opt/tomcat/webapps/ROOT
sudo vi index.html
<html>
<head>
<title>Redirecting to /portal</title>
<meta http-equiv="Refresh" content="0:URL=/portal">
</head>
<body bgcolor="#ffffff" onLoad="javascript:window.location='/portal';">
<div style="margin:18px;width:288px;background-color:#cccc99;padding:18px;border:thin solid #666600;text-align:justify">
<p style="margin-top:0px">
You are being redirected to the Sakai portal. If you are not automatically redirected, use the link below to continue:<br/>
<a href="/portal">Take me to the Sakai portal</a>
</p>
</body>
</html>
At this point you should be able to navigate to your http://yourserver:8080/portal and login to Sakai with the username admin and password admin. Please be sure to give Sakai a few moments to start up once you have enabled your Tomcat servlet.
Thanks to Jonathan Vernon and Trevor Parker for their hard work on this tutorial.