Compilation des services sasd et sesd

Introduction

Les composantes sasd et sesd formant le volet serveur du système sgdebrowser sont écrites en langage java. Les codes exécutables (les classes java) de ces services sont contenus dans une archive au format JAR nommée sgde-servers-version.jar, que l'installation du sgdebrowser place sous $SERVER_ROOT/lib. Grâce à Java, ces exécutables peuvent être directement utilisés, sans besoin d'être compilés en fonction de la plateforme d'installation.

Le projet edms-sgde offre toutefois un paquetage sgde-servers-src-version.tar.gz contenant les codes source des services sasd et sesd, de manière à permettre la modification et la recompilation ces composantes. Un JDK 1.4 ou plus doit être installé, pour avoir accès aux programmes javac et jar. La compilation peut aussi se faire au moyen d'un projet Eclipse, défini dans le paquetage.

NOTE. La recompilation des composantes n'est expliquée que pour une plateforme linux.

Définitions

Variable environnementale	Description	Défaut
$KITDIR	répertoire où le paquetage sgde-servers-src-version.tar.gz a été téléchargé	au choix
$VERSION	version du paquetage
$WORK	répertoire de travail	au choix
$WORKSPACE	répertoire de travail spécifié lors de l'installation d'Eclipse	$HOME/workspace
$SERVER_ROOT	répertoire d'installation	/opt/sgde-version

Utilisation du script de compilation

Se placer dans le répertoire de travail et déballer le paquetage. Un répertoire sgde-servers-$VERSION sera créé. Naviguer vers le sous-répertoire src.

% cd $WORK
% tar xfz $KITDIR/sgde-servers-src-$VERSION.tar.gz
% cd sgde-servers-$VERSION/src

Exécuter le script compile. Le script demande d'avoir accès en lecture au contenu du répertoire $SERVER_ROOT/lib (le privilège root pourrait avoir à être utilisé si le répertoire est à accès restreint). On peut ignorer les avertissements du compilateur java.

% sh compile
...
created sgde-servers-version.jar

Utilisation d'un projet Eclipse

Création du projet

Les instructions qui suivent ont été testées dans un environnement Linux en utilisant le JDK 1.6 (version SUN) et la version 3.3.2 d'Eclipse (Java IDE, packaging Europa). Le répertoire de travail (workspace) doit avoir été préalablement initialisé par une installation appropriée d'Eclipse.

Se placer dans le répertoire de travail d'Eclipse.

% cd $WORKSPACE

Déballer le paquetage contenant les sources. Un répertoire sgde-servers-$VERSION sera créé.

% tar xfz $KITDIR/sgde-servers-src-$VERSION.tar.gz
% ls sgde-servers-$VERSION
./ ../ archives/ .classpath config.xml extractions/ lib/ logs/ .project sasd/ sesd/ .settings/ src/

Les fichiers cachés .classpath, .project et .settings servent à la configuration du projet Eclipse.

Démarrer Eclipse.

% eclipse

Informer Eclipse de l'existence du nouveau projet sgde-servers-$VERSION .

Ouvrir le menu File > Import
Sélectionner "Existing Projects into workspace" et cliquer Next .

Activer le bouton radio "Select directory" et entrer le chemin menant au répertoire de travail. Sélectionner le projet sgde-servers-$VERSION. Cliquer Finish.

Le projet sgde-servers-$VERSION apparaîtra dans la vue Package Explorer d'Eclipse.

Création du jar avec Eclipse

Ouvrir la perspective java.
Développer le projet sgde-servers-$VERSION dans la vue Package Explorer.
Bouton droit sur le répertoire src
Choisir le menu Export...

Sélectionner JAR file et cliquer cliquer Next

Créer le fichier jar sgde-servers-$VERSION.jar dans le répertoire $WORK. Cliquer le bouton Finish.

Accepter la boîte de dialogue à propos des messages d'avertissement à la compilation (qui peuvent être ignorés).

Installation du jar

L'installation doit se faire en tant qu'usager root.

Copier le jar dans le répertoire des bibliothèques du sgdebrowser. Redémarrer ensuite les services sasd et sesd.
IMPORTANT. Purger du répertoire toute autre version différente du jar qui pourrait y exister.

%
su -
# rm -f $SERVER_ROOT/lib/sgde-servers*.jar

# cp -f $WORK/sgde-servers-$VERSION.jar $SERVER_ROOT/lib

# service restart sasd

# service restart sesd

# exit