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 ~/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 ~/.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.

Configuration d'Eclipse

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

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.

Notice :

La version 1.7-1.8 semble incompatible au moment de l'écriture de cette notice. On travaille donc avec la version 1.6.

• On ajoutera le site de mise à jour (update site) : http://subclipse.tigris.org/update_1.6.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: ~/projets/test
• Télécharge le projet SVN de svn+ssh://moorea/home/svn/pleade-libre/trunk à ~/projets/test/pleade-libre
• Télécharge le projet SVN de svn+ssh://moorea/home/svn/pleade-entreprise/trunk à ~/projets/test/pleade-entreprise
• Télécharge le projet SVN de svn+ssh://moorea/home/svn/sdx-ajlsm/trunk à ~/projets/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 à ~/projets/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 à ~/projets/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 à ~/projets/test/tomcat
• Créer un nouveau Projet dans eclipse (New Project -> General -> Project) avec le chemin comme: ~/projets/test/examples
  • Créer un nouveau dossier ~/projets/test/examples/preparees
  • Créer un nouveau dossier ~/projets/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 ~/projets/test/exemples/racines.

mv ~/projets/test/exemples/racines/exemples-ead/* ~/projets/test/exemples/racines/
rmdir ~/projets/test/exemples/racines/exemples-ead/

Configuration simple du projet

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

chmod 775 ~/projets/test

Répertoire du projet compilé (build)

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

install.dir=../tomcat/webapps/pleade-entreprise
src.module.thesaurus=~/projets/test/thesx/dev

• On modifiera le fichier ~/projets/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=~/projets/test/exemples/racines
pleade.eadeac.fs-files=~/projets/test/exemples/racines
pleade.img-server.racines=~/projets/test/exemples/racines
pleade.images.preparees=~/projets/test/exemples/preparees

• On modifiera le fichier ~/projets/test/pleade-entreprise/pleade-entreprise.properties :

install.dir=../tomcat/webapps/pleade-entreprise
pleade.src.dir=~/projets/test/pleade-libre
src.module.thesaurus=~/projets/test/thesx/dev

Fichiers pour Tomcat

• On modifiera le fichier ~/projets/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 ~/projets/test/pleade-entreprise
./ant.sh install

• Pour rédémarrer l'application:

../tomcat/bin/catalina.sh stop
export JPDA_ADDRESS=8000 # Pour débouger l'application
export JPDA_TRANSPORT=dt_socket # Pour débouger l'application
../tomcat/bin/catalina.sh jpda start

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

../tomcat/bin/catalina.sh stop
rm -rf ../tomcat/webapps/pleade-entreprise/
./ant.sh clean
./ant.sh install
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.