Skin Manager Installation

Skin Manager Installation

The Sakai Skin manager comes as source distribution, this distribution needs to be build from within the Sakai source tree.

Prerequisites

This manual assumes that you are familiar with installing, building, and running Sakai. You must be familiar with the concepts in the Sakai installation guide, which can be found at:

• 2.2.1 Installation Guide
• 2.3.1 Installation Guide
• 2.4.0 Installation Guide

Of course, you need a Sakai installation to use this Sakai tool.

Installing from source

Downloading the source

The sakai skin manager depends on the edia-sakai-utils, both the skin manager and the dependent util project can be found at the following locations:

Running the build on sakai 2.4.x

Both projects downloaded above should be placed in the source root of Sakai. If you run an entire build on Sakai, it will automatically be part of that build. But if the source tree has already been build, it can be build individually by running a build in the following order:

1. edia-sakai-utils
2. edia-sakai-skin-manager

Of course, to do the build the Sakai target needs to be be used:

maven sakai

Maven 1.x and ibiblio Note: the ibiblio repository has been restructured, and maven 1.x on *nix has trouble understanding the http return code 301 (moved permanently). For that reason, it might be necessary to add the following to the maven.repo.remote property in the build.properties located in the home dir: http://repo1.maven.org/maven/

Running the build on sakai 2.5.x (M2)

Both projects downloaded above should be placed in the source root of Sakai. The project can be added to the main build by adding them as a module to the root pom.xml, but they can also be run individually in the following order:

1. edia-sakai-utils
2. edia-sakai-skin-manager

Database

Database support

database installation

The Sakai skin manager makes use of one table, which is mapped by hibernate. Sakai needs to be started with the

auto.ddl=true

set in the sakai.properties on the first run of the skin manager to let hibernate create the required table for you.