OW2 Consortium ocelot

Rev

Blame | Last modification | View Log | RSS feed

This file is written for unix based users.


-----------------------------------------------------------------------
Prerequisites
-----------------------------------------------------------------------

If you want to enjoy the full features of OCELOT, you need to first install
the binaries for multimedia processing. 

In order to install those tools, you first need to download and install:
        - x264: http://www.videolan.org/developers/x264.html
        - FFMPEG (0.5.1 version): http://ffmpeg.org/ 
        - xerces-C: http://xerces.apache.org/xerces-c/
        - GPAC (last svn): http://gpac.wp.institut-telecom.fr/
(due to licence agreements, we are not allowed to distribute binaries for 
those libraries)

see the README files for all subprojects in OCELOT-tools/ to compile the 
needed tools.

NOTE: those tools are required if you want to use a multimedia user interface.




Part of OCELOT is based on Java to Enterprise Edition and the application server JOnAS. 
If not already installed, you have to install a J2EE SDK from Oracle / Sun Developer 
Network website. Current version of Java to Enterprise Edition is JEE 5 : 
http://java.sun.com/javaee/downloads/index.jsp

You will also need to install Maven in order to compile OCELOT. 
Maven is available at : http://maven.apache.org/download.html 



-----------------------------------------------------------------------
Installing JOnAS
-----------------------------------------------------------------------


It is highly recommended to download and install a stable version of the application server JOnAS. 
Current version is 5.1.5 : http://wiki.jonas.ow2.org/xwiki/bin/view/Main/Downloads   
(you can choose the installer file).

Add to your environment the $JONAS_ROOT variable as the directory to JOnAS.


-----------------------------------------------------------------------
Configuring JOnAS
-----------------------------------------------------------------------


Download the source package : http://forge.ow2.org/projects/ocelot/ 
Untar it. 

tar -xvwf OCELOT.tar
cd OCELOT

then add to your environment the $OCELOT variable as the url_to_ocelot/OCELOT



You may need to give proper rights to your files and subfolders 
get root
chmod -R 755 $OCELOT/

Open a terminal window that we will call Build.
In the file OCELOT-conf/setenv.sh, you have to change the values of 
JONAS_ROOT as the one you choose when you installed JOnAS.


After that, type the following command:
cd $OCELOT
mkdir jonas_base
. ./OCELOT-conf/setenv.sh


You can check you have properly set your environment by the following unix command : 
env | grep JONAS


Then create a link in your /home folder to the file jb.config :
cd
ln -sf $OCELOT/OCELOT-conf/jb.config

You can check the link is created with the command ls -l 

Then : 
cd $OCELOT
newjb
(The script newjb is located in JONAS_ROOT/bin)

Verify that the 5 folders conf, deploy, lib, logs and repositories have been build : 
ls -l jonas_base

And then copy those files : 
cd jonas_base/conf
cp ~/jb.config/conf/*.xml .
cp ~/jb.config/conf/ocelot.properties .



-----------------------------------------------------------------------
Building OCELOT
-----------------------------------------------------------------------


Open an other terminal windows that we will call JOnAS.

In JOnAS terminal window, you have to launch the server JOnAS:
cd $OCELOT
. ./OCELOT-conf/setenv.sh
jonas start -fg


In Build terminal window : 
cd $OCELOT/OCELOT-client/db


You will have to change the file ’’create-tables.sh’’, according to your version of JOnAS (currently 5.1.5).
And then :
./create-tables.sh

Both modules « jndc » and « datasocket » don’t exist today in maven artifact forms.
So, you have to install them locally in the maven repository (do it just once) before compiling the entire application : 
cd ../../OCELOT-externals
./install-local.sh


And then you can install the all framework : 

cd ..
mvn clean install

This could take few minutes...
At the end of the installation, you can check in your JOnAS terminal window that you have the following message : EarDeployer.doDeploy : ‘ocelot-0.1-SNAPSHOT.ear’ EAR Deployable is now deployed



-----------------------------------------------------------------------
Running the OCELOT instruments
-----------------------------------------------------------------------


Open 2 others terminal windows called Inst and User :
In both of those terminal windows : 
cd $OCELOT
. ./OCELOT-conf/setenv.sh

In your Inst terminal window : 
cd OCELOT-client
./demo_inst.sh

you should have a dialog box asking for a login and a password :
login : ocelot1
pwd : demo1

Your demo instrument should be now running.



-----------------------------------------------------------------------
Running the OCELOT client
-----------------------------------------------------------------------


In OCELOT-client/player, you can find the GPAC player installer.
Open it and open the file Anritsu.bt in OCELOT-client/files.