Deploying Sakai:First Steps

David Haines

University of Michigan

June 8, 2005 2

Goal

• Get to the point where you have a to-do list, not a panic attack

June 8, 2005 3

Overview• Focus on 2.0 since it is most up to date and

least documented

• Covering: – How to get Sakai– How to compile– How to start to customize and integrate

• Not covering – detailed configuration (Stay for John Leasia’s talk)

June 8, 2005 4

Skills

• Development

• Database

• Design

• Production

June 8, 2005 5

Setup Environment

• Maven

• Java (1.4.2)

• Tomcat – 5.5.9 + compatibility package for Sakai2 – 5.0.28 for Sakai 1.5

June 8, 2005 6

Ways to get Sakai - 1

• Go to the release website: http://cvs.sakaiproject.org/release/2.0.0/rc2

– Demo - preconfigured (not production)– Src

June 8, 2005 7

Ways to get Sakai - 2

• Use CVS repository– Checkout directly from repository– Or do a bootstrap configuration

• Extract module config from CVS – cvs -z9 -d:ext:sakai@cvs.sakaiproject.org:/cvs co config

• Type “maven sakai2” - to get the head• Type “maven sakai_2-0-0-rc2” to get release

candidate 2

June 8, 2005 8

Compiling sakai• Build.properties

– maven.repo.remote =• http://www.ibiblio.org/maven/,http://cvs.sakaiproject.org/maven/

– maven.tomcat.home = ????

June 8, 2005 9

Compiling Sakai

• Maven goals (sakai2)– [sakai] clean then build then deploy– build .......................... compile and package the build– clean .......................... cleanup from prior builds– clean_build .................... clean and then build– clean_build_deploy ............. clean then build then deploy– deploy ......................... deploy to the local tomcat– undeploy ....................... remove from the local tomcat

June 8, 2005 10

Running

• unset CATALINA_HOME and CATALINA_BASE

• Startup Tomcat: bin/startup.sh http://localhost:8080

• Login as admin with password admin

June 8, 2005 11

Customize OOTB Make it do what you need

• Little stuff

• Big stuff

• Nerd stuff

June 8, 2005 12

Little stuff

• Literals (e.g. version, service name)

• Opening text

• Take out things you don’t need (e.g. Presentation)

• Change default skin

June 8, 2005 13

Big stuff

• Your skin

• Your local database

• Provider

June 8, 2005 14

Database

• Select which database, connection parameters

• Put parameters in security.properties file

• Setup access / users / permissions

• Load tables

June 8, 2005 15

Provider

• Your local information e.g.

• See sakai2/providers directory for samples

• Course management

• Permissions / roles

• User information

June 8, 2005 16

Nerd stuff

• JVM settings

• Tomcat ports

• Tomcat location

June 8, 2005 17

More information

• Readmes

• Confluence (http://bugs.sakaiproject.org/confluence)

• Release website

• (http://cvs.sakaiproject.org/release)

• Sakaiproject.org

• Mailing lists

June 8, 2005 18

Questions