Pleade Quickstart

Installation du SDK

Notice :

On recommande d'utiliser la dernière version du Oracle Java *S*DK (et non le *J*DK). Le logiciel est disponible sur le site site: http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-javase6-419409.html.

cd /home/ctate/Téléchargements/
JRE_FILE="jre-6u34-linux-i586.bin"
JRE_VERSION="jre1.6.0_34"
chmod u+x "$JRE_FILE"
./"$JRE_FILE"
sudo mv "$JRE_VERSION"/ /usr/lib/jvm/
sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/"$JRE_VERSION"/bin/java 1
sudo update-alternatives --install /usr/bin/javac javac /usr/lib/jvm/"$JRE_VERSION"/bin/javac 1
sudo update-alternatives --install /usr/bin/javaws javaws /usr/lib/jvm/"$JRE_VERSION"/bin/javaws 1
sudo update-alternatives --config java
sudo update-alternatives --config javac
sudo update-alternatives --config javaws
ls -la /etc/alternatives/java*

Environnement Linux

On commence par éditer le fichier /home/ctate/.profile et ajouter cette ligne :

JAVA_HOME=/usr/lib/jvm/"$JRE_VERSION"
export JAVA_HOME

Notice :

On pourra Localiser et définir JAVA HOME de façon automatique.

Installation de PostgreSQL

sudo apt-get install postgresql
sudo -u postgres psql postgres
create database pleade3;
create user sdxapp with password 'sdxapp-pwd';
\q

Configuration d'Eclipse

sudo apt-get install libsvn-java

Ensuite on éditera le fichier /usr/lib/eclipse/eclipse.ini pour utiliser openjdk. On ajoute le chemin vers l'executable java avant le ligne -vmargs:

-vm
/usr/lib/jvm/java-1.6.0-openjdk/bin/java
-vmargs
-Djava.library.path=/usr/lib/x86_64-linux-gnu/jni

Encodage

Notice :

Pour prévenir tout problème d'encodage on se réfèrera à l'article Encodage.

Module Eclipse

Si vous souhaitez travaillez uniquement dans Eclipse pour la gestion SVN, on recommande d'installer le module Subclipse.

• On ajoutera le site de mise à jour (update site) : http://subclipse.tigris.org/update_1.8.x
• Puis on installera les modules suivants :
  1. Subclipse -> Subclipse
  2. Subclipse -> Subclipse Integration for Mylyn 3.x
  3. Subclipse -> Subversion Client Adapter
  4. Subclipse -> Subversion JavaHL Native Library Adapter

Récupération un projet SVN

L'url des projets est de la forme : svn+ssh://moorea/home/svn/pleade-libre/trunk

Notice :

moorea est résolu grâce à votre fichier /etc/hosts.

Créer un nouveau workspace et les projets

• J'aime bien créer un nouveau workspace dans Eclipse pour chaque client/projet. Pour un projet test, on va créer un workspace «test» dans eclipse ici: /home/ctate/projet/test
• Télécharge le projet SVN de svn+ssh://moorea/home/svn/pleade-libre/trunk à /home/ctate/projet/test/pleade-libre
• Télécharge le projet SVN de svn+ssh://moorea/home/svn/pleade-entreprise/trunk à /home/ctate/projet/test/pleade-entreprise
• Télécharge le projet SVN de svn+ssh://moorea/home/svn/sdx-ajlsm/trunk à /home/ctate/projet/test/sdx-ajlsm. C'est pour les sources pour débouger l'application.
• Télécharge le projet SVN de svn+ssh://moorea/home/svn/thesx/trunk à /home/ctate/projet/test/thesx
• Télécharge les sources de cocoon 2.1.10 de http://archive.apache.org/dist/cocoon/cocoon-2.1.10-src.zip à /home/ctate/projet/test/cocoon-2.1.10
• Télécharge un nouveau tomcat6 de http://apache.crihan.fr/dist/tomcat/tomcat-6/v6.0.36/bin/apache-tomcat-6.0.36.zip à /home/ctate/projet/test/tomcat
• Créer un nouveau Projet dans eclipse (New Project -> General -> Project) avec le chemin comme: /home/ctate/projet/test/examples
  • Créer un nouveau dossier /home/ctate/projet/test/examples/preparees
  • Créer un nouveau dossier /home/ctate/projet/test/examples/racines
  • Dans le «SVN Repository Exploring perspective», ouvrez le chemin Modèle:Pleade-ajlsm/trunk/exemples-ead, clic droit sur le exemples-ead dossier et choississez «Export...», utilisez le chemin /home/ctate/projet/test/exemples/racines.

mv exemples/racines/exemples-ead/* exemples/racines/
mv exemples/racines/series/* exemples/racines/
rmdir exemples/racines/exemples-ead/
rmdir exemples/racines/series/

Configuration simple du projet

On vérifiera les permissions et si besoin on les changera :

chmod 775 /home/ctate/projet/test

Répertoire du projet compilé (build)

• On modifiera le fichier /home/ctate/projet/test/pleade-libre/pleade.properties, notamment la propriété install.dir et src.module.thesaurus :

install.dir=../tomcat/webapps/pleade-entreprise
src.module.thesaurus=/home/ctate/projet/test/thesx/dev

• On modifiera le fichier /home/ctate/projet/test/pleade-libre/src/webapp/WEB-INF/properties/pleade-admin.properties :

pleade.url-interne=http://localhost:8080/pleade-entreprise
pleade.public-url=http://localhost:8080/pleade-entreprise
pleade.sdx-database=POSTGRESQL:pleade3
pleade.sdx-ead-repository=POSTGRESQL:pleade3
pleade.sdx-eac-repository=POSTGRESQL:pleade3
pleade.eadeac.fs-pdf=/home/ctate/projet/test/exemples/racines
pleade.eadeac.fs-files=/home/ctate/projet/test/exemples/racines
pleade.img-server.racines=/home/ctate/projet/test/exemples/racines
pleade.images.preparees=/home/ctate/projet/test/exemples/preparees

• On modifiera le fichier /home/ctate/projet/test/pleade-entreprise/pleade-entreprise.properties :

install.dir=../tomcat/webapps/pleade-entreprise
pleade.src.dir=/home/ctate/projet/test/pleade-libre
src.module.thesaurus=/home/ctate/projet/test/thesx/dev

Fichiers pour Tomcat

• On modifiera le fichier /home/ctate/projet/test/tomcat/conf/tomcat-users.xml et ajoutez ces lignes avant le </tomcat-users> :

<role rolename="manager-gui"/>
<user username="username" password="password" roles="manager-gui"/>

Construire l'application

• Pour construire l'application:

cd pleade-entreprise
./ant.sh install
cd ..

• Pour démarrer l'application:

export JPDA_ADDRESS=8000 # Pour débouger l'application
export JPDA_TRANSPORT=dt_socket # Pour débouger l'application
export CATALINA_PID=tomcat/bin/catalina.pid
export JAVA_OPTS="-Xms400m -Xmx1000m -Djava.awt.headless=true -server"
tomcat/bin/catalina.sh jpda start

• Pour éteindre l'application:

export CATALINA_PID=tomcat/bin/catalina.pid
tomcat/bin/catalina.sh stop -force

• Pour rédémarrer et reconstruire l'application:

tomcat/bin/catalina.sh stop
rm -rf tomcat/webapps/pleade-entreprise/
cd pleade-entreprise
./ant.sh clean
./ant.sh install
cd ..
export JPDA_ADDRESS=8000
export JPDA_TRANSPORT=dt_socket
tomcat/bin/catalina.sh jpda start

• Pour reconstruire la base de données, créez un fichier nommé drop_pleade_tables.sql comme ça:

DROP TABLE "public"."module_eadeac_eac";
DROP TABLE "public"."module_eadeac_eac_docs";
DROP TABLE "public"."module_eadeac_ead";
DROP TABLE "public"."module_eadeac_ead_docs";
DROP TABLE "public"."lien_ark";

• • Utilisez un command comme ça:

psql -h localhost -U sdxapp -d pleade3 -f drop_pleade_tables.sql

L'application est consultable à l'adresse : http://localhost:8080/pleade-libre/. On se connecte avec l'utilisateur admin et le mot de passe pleade

• Suivre cette document Déboguer une application pleade-libre pour débouger votre application.