Scilla installation guide

Requirements

Several applications are needed to compile and run Scilla.

A list of compile-time dependencies:

Ant
Used to build and install Scilla. Available at the Jakarta project.
Servlet/JSP application server
Should work with any modern servlet engine. Tested with Tomcat and Jetty. Make sure the servlet API is available via your classpath before compilation.
JAI
Java Advanced Imaging API. Available at the Sun Microsystems. This imaging package can be omitted when you decided to use ImageMagick instead.

A list of run-time dependencies:

ImageMagick
A image manipulation suite. Available at the ImageMagick homepage.
Lame
A MP3 encoder used to recode MP3 files and encode WAV files to MP3. Available at the Lame homepage.
FFMpeg
A video format converter. Available at the FFMpeg homepage.

Examples installation

Extract the distributed zip-file and change directory to the newly created scilla directory. This directory contains a ant build file called build.xml. This file is used to compile all the Scilla Java classes, create a deployment hierarchy and a war file.

Build the examples war file by running ant. Here is an example:

Script started on Sun Jan  5 15:15:54 2003
$ cd scilla
$ ant -Dsource.dir=`pwd`/examples/data/source examples
Buildfile: build.xml

prepare:
    [mkdir] Created dir: /hm/remco/tmp/scilla/doc/apidoc
    [mkdir] Created dir: /hm/remco/tmp/scilla/build
    [mkdir] Created dir: /hm/remco/tmp/scilla/lib
    [mkdir] Created dir: /hm/remco/tmp/scilla/depend
    [touch] Creating /hm/remco/tmp/scilla/excludes.txt

prepare.jai:

prepare.compile:

depend:
    [style] Processing /hm/remco/tmp/scilla/depend.xml to /hm/remco/tmp/scilla/depend-build.xml
    [style] Loading stylesheet /hm/remco/tmp/scilla/misc/depend-build.xsl

all:

commons-logging.prepare:

commons-logging:

commons-logging.prepare:

commons-logging.download:
      [get] Getting: http://jakarta.apache.org/builds/jakarta-commons/release/commons-logging/v1.0.2/commons-logging-1.0.2.zip
    [unzip] Expanding: /hm/remco/tmp/scilla/depend/commons-logging-1.0.2.zip into /hm/remco/tmp/scilla/depend/commons-logging
     [copy] Copying 1 file to /hm/remco/tmp/scilla/lib

compile:
    [javac] Compiling 38 source files to /hm/remco/tmp/scilla/build
     [copy] Copying 4 files to /hm/remco/tmp/scilla/build

jar:
      [jar] Building jar: /hm/remco/tmp/scilla/scilla.jar

examples:
     [copy] Copying 1 file to /hm/remco/tmp/scilla/examples/lib
     [copy] Copying 1 file to /hm/remco/tmp/scilla/examples/lib

prepare:
    [mkdir] Created dir: /hm/remco/tmp/scilla/examples/deploy
     [copy] Copying 10 files to /hm/remco/tmp/scilla/examples/deploy
    [mkdir] Created dir: /hm/remco/tmp/scilla/examples/deploy/WEB-INF
    [mkdir] Created dir: /hm/remco/tmp/scilla/examples/deploy/WEB-INF/lib
     [copy] Copying 2 files to /hm/remco/tmp/scilla/examples/deploy/WEB-INF/lib
     [copy] Copying 1 file to /hm/remco/tmp/scilla/examples/deploy/WEB-INF
    [mkdir] Created dir: /hm/remco/tmp/scilla/examples/deploy/WEB-INF/classes
    [mkdir] Created dir: /hm/remco/tmp/scilla/examples/build

compile:
    [javac] Compiling 6 source files to /hm/remco/tmp/scilla/examples/deploy/WEB-INF/classes

webxml1:
     [copy] Copying 1 file to /hm/remco/tmp/scilla/examples/deploy/WEB-INF
  [replace] Replaced 2 occurrences in 1 files.

webxml2:

deploy:
     [echo] FIN

war:
      [jar] Building jar: /hm/remco/tmp/scilla/examples/scilla.war

BUILD SUCCESSFUL
Total time: 15 seconds
$ ^D

Script done on Sun Jan  5 15:19:49 2003

Now copy the war file to the application server deployment directory (typically called webapps). Tomcat needs no further configuration, upon restart it will recognize the new application and start it. Jetty needs to be told a new application is added but that's out of the scope of this document.

Now restart the server and point your browser to your scilla examples site; something like: http://localhost:8080/scilla/. A page with links to the examples should be visible now. Enjoy..

Usage

Please look at the included build.xml files and web.xml file for details on installation and look at the examples JSPs (and HTML source as generated by the JSPs) for pointers on the usage of the converters. All converters are documented using javadoc.