Projet GlassFish - Démarrage

GlassFish Community

Projet GlassFish V2.1.1
Pour en savoir plus sur GlassFish V3, cliquez ICI
Conditions préalables à la création de GlassFish
Guide de démarrage rapide
Instructions complètes de version
GlassFish avec EDI NetBeans
Création à partir de la branche
Présentation des objectifs de GlassFish Maven

Cette page décrit la procédure de création de GlassFish V2. Voici des liens utiles si vous souhaitez signaler un bogue ou proposer une fonctionnalité. Vous pouvez consulter notre politique de gouvernance en cliquant ici.

Instructions complètes relatives à la création de GlassFish V2

GlassFish peut être mis en œuvre avec NetBeans ou à l’aide des options de ligne de commande.L’article suivant comporte de plus amples informations sur la procédure de création et de développement du projet GlassFish avec NetBeans.Les options de ligne de commande sont présentées ci-dessous.

Conditions préalables à la création de GlassFish

L’utilisateur doit disposer de Maven (1.0.2) : cela permettra de créer le référentiel local requis par Maven pour stocker les dépendances GlassFish.
Il doit également disposer d’une connexion à java.net et avoir accès au référentiel CVS pour le projet GlassFish.
Il doit se connecter une fois au référentiel CVS de GlassFish (afin que celui-ci puisse enregistrer le mot de passe dans le fichier .cvspass sous le répertoire de base de l’utilisateur).
J2SE 5.0 (1.5.0_12) doit être installé et configuré en tant que variable d’environnement JAVA_HOME dans votre chemin binaire.Nous vous recommandons d’utiliser la dernière version disponible.
Configuration du client CVS selon les instructions disponibles sur java.net.

Étapes de création de GlassFish

La première étape consiste à extraire les dépendances de module et les fichiers communs utilisés dans le système de création, puis à modifier le fichier de propriétés.

% mkdir workspace
% cd workspace
% cvs -d :pserver:<userid>@cvs.dev.java.net:/cvs checkout -r SJSAS91_FCS_BRANCH glassfish/bootstrap

Cette commande permet d’extraire les fichiers project.xml, maven.xml, project.properties, ainsi que les fichiers communs référencés à partir de project.xml.

Créez les fichiers workspace/glassfish/bootstrap/build.properties ou, pour un espace de travail GlassFish réutilisable, utilisez un processus unique en créant ${HOME}/build.properties (Unix) ou %HOMEPATH%\build.properties (Windows) et en définissant les variables suivantes : (vous pouvez obtenir la valeur de %HOMEPATH% en exécutant la commande echo %HOMEPATH% ou en exécutant « set » et en recherchant la variable HOMEPATH (windows)).
Définissez deux variables glassfish glassfish.os.name, glassfish.cvs.username (voir ci-dessus).
glassfish.os.name= <nom SE - les valeurs possibles sont WINNT, SunOS, Linux, SunOS_X86, Darwin>
glassfish.cvs.username= <id java.net>

Par exemple, sous Windows XP Professionnel

glassfish.os.name=WINNT

glassfish.cvs.username=carlavmott

Ensuite, procédez à l’extraction des sources.

% cd glassfish/bootstrap
% maven checkout

Limitation connue : il se peut que certaines sources requises pour la création de GlassFish ne soient pas directement disponibles sur java.net (par exemple MQ, ORB, JWSDP 2.0, etc). Celles-ci seront, pour le moment, traitées en tant que dépendances binaires. (Reportez-vous à l’étape suivante pour observer la manière dont les dépendances binaires sont utilisées.) Vous pouvez également extraire un sous-ensemble de modules en appelant :

% maven checkout -Dmodules=[liste des noms de module séparés par une virgule]

Les noms de module se trouvent sur cette page.

Initialisez l’image serveur (collection de scripts et de fichiers jar utilisés pour exécuter Glassfish). Le développeur peut sélectionner l’option « bootstrap », qui permet de télécharger le serveur précréé et de générer uniquement un sous-ensemble de modules. L’option « bootstrap-all » permet de créer un nouveau serveur et de générer tous les modules afin de vérifier le changement de version des dépendances binaires ou intermodules.

Option bootstrap-all : création de tous les modules à partir de la source.

% maven bootstrap-all

Option bootstrap : création de votre propre module à l’aide du serveur précréé.

% maven bootstrap

Cette étape est facultative si vous avez déjà installé une version promue de GlassFish. Pour utiliser cette dernière, vous devez définir la propriété correspondante dans glassfish/project.properties.

glassfish.image.version=<<numéro de version>>

Cela permet de faire « pointer » le système de génération vers cette installation. Il est également possible d’ajouter cette propriété à ${HOME}/build.properties.

Générez le code source extrait. L’ordre de compilation est déterminé par un fichier de configuration commun extrait à l’étape 2. Cette étape permet de mettre à jour l’image installée après la compilation de chaque module.

% maven build

Vous pouvez toujours générer un sous-ensemble de modules en invoquant :

% maven build -Dmodules=[liste des noms de module séparés par une virgule]

ou allez sur ../[nom-module] et invoquez :

% maven build

Configurez l’exécution du serveur GlassFish.Cela permet de créer le script asadmin, d’exécuter create-domain, etc., étapes nécessaires à l’exécution du serveur GlassFish.

% maven configure-runtime (installation silencieuse par défaut)

Si vous souhaitez spécifier des informations de configuration communes (par exemple, les numéros de port, etc. ), utilisez configure-runtime en mode détaillé.

% maven configure-runtime -Dinteractive

En règle générale, il vous suffit d’exécuter cette commande une fois. Une reconfiguration sera en revanche nécessaire si vous modifiez, par exemple, l’environnement de domaine (voir la FAQ pour plus d’informations). Vous trouverez les valeurs par défaut de la configuration de l’exécution dans glassfish/bootstrap/project.properties :

domain.name="domain1"
instance.name="server"
admin.user="admin"
admin.password="adminadmin"
admin.port="4848"
instance.port"="8080"
orb.port="3700"
imq.port="7676"
https.port="8181"

Le goal Maven « configure-runtime » permet de créer un domaine à instance unique, similaire à GlassFish V1. Si vous souhaitez créer un domaine en mode cluster de GlassFish V2, exécutez la commande suivante :
% maven configure-cluster

Démarrez le serveur à l’aide de la commande suivante. L’ensemble des commandes serveur GlassFish se trouve dans le répertoire <racine.glassfish>/publish/bin. Pour obtenir de plus amples informations sur le mode d’administration du serveur, reportez-vous à la documentation de Sun Java System Application Server PE versions 8.x. La plupart de ces informations sont encore valables pour la version 9. Remarque : actuellement, GlassFish prend uniquement en charge l’option de ligne de commande sur toutes les plates-formes.

% asadmin start-domain

Nettoyez le serveur.

% maven clobber

Cela permet de supprimer tous les scripts et fichiers jar utilisés pour exécuter le serveur. En outre, tous les éléments sous glassfish.home sont supprimés ; cela fait, retournez à l’étape 2.

Nettoyez le build/serveur : vous pouvez utiliser l’un des trois goals ci-dessus à tout moment lors de votre processus de développement. Mettez à jour les sources à l’aide de votre EDI favori, puis utilisez l’une des commandes suivantes sur un espace de travail existant de manière à restaurer ce dernier sur son état d’origine à regénérer, puis vérifiez vos modifications.

Pour nettoyer les modules de manière à supprimer les fichiers build générés, tels que .class, .properties et ceux prêts à être recompilés, exécutez la commande suivante :
```
% maven clean (ou maven -Dmodules=mail,activation clean)
```
Pour nettoyer le serveur configuré à l’étape 5, utilisez la commande ci-dessous ; le serveur d’administration et le domaine1 sont supprimés et le serveur est restauré à son état d’origine. (Les nouveaux fichiers à jeton remplacés sont supprimés des répertoires de configuration ${glassfish.home}/bin.)
```
% maven clean-config
```
Vous pouvez utiliser « maven clean-config » pour vérifier vos modifications associées au démarrage du domaine et du serveur d’administration. Utilisez le goal « clobber » pour supprimer votre serveur et en obtenir un nouveau. Utilisez « clean » pour supprimer les fichiers build et ceux prêts à être compilés.

Exécutez des tests QuickLook : les tests QuickLook permettent au développeur de contrôler les fonctionnalités principales du serveur d’application et d’exécuter un contrôle de validité pour vérifier qu’aucun élément important n’est endommagé.

Récupérez les fichiers de test requis à partir de glassfish/appserv-tests comme indiqué ci-dessous.

% cd glassfish/bootstrap
% maven checkout-quicklook

Définissez APS_HOME. Il s’agit du répertoire à partir duquel vous avez extrait l’espace de travail, notamment son nom racine ( /workspace/appserv-tests)

Définissez S1AS_HOME. Il s’agit du répertoire d’installation du serveur GlassFish ( /workspace/publish/glassfish)

Les propriétés d’installation se trouvent sous ${APS_HOME}/config.properties, correspondant à votre recherche ( admin.password, http.port, etc.). Si vous avez modifié des valeurs par défaut, modifiez alors le fichier config.properties.

Assurez-vous que le serveur n’est PAS exécuté avant de lancer les tests, sinon, arrêtez-le.

Exécutez le test :

% cd $APS_HOME
% maven runtest

Ouvrez le fichier ${APS_HOME}/test_results.html dans un navigateur puis examinez les résultats.

Cliquez ICI pour obtenir des instructions détaillées relatives à l’exécution des tests QuickLook.

Si vous rencontrez des problèmes, n’oubliez pas de consulter le wiki FAQ sur GlassFish.

Prise en charge de l’EDI

Création et développement de GlassFish avec NetBeans 4.1.

Pour plus d’informations, consultez les directives relatives à l’espace de travail et les procédures de validation. Vous pouvez également utiliser FishEye pour repérer les modifications apportées à l’espace de travail.

Création de Glassfish pour V2.1, SGES21_FS_BRANCH :

Vous trouverez ci-dessous les étapes nécessaires à la création à partir d’une branche GlassFish :
% mkdir workspace % cd workspace % cvs -d :pserver:<userid>@cvs.dev.java.net:/cvs checkout -r SGES21_FCS_BRANCH glassfish/bootstrap

glassfish/bootstrap/project.properties de la branche SGES21_FCS_BRANCH comporte une variable « glassfish.cvstag » définie sur « glassfish.cvstag=SGES21_FCS_BRANCH ». Les sources de la branche FCS seront extraites et générées en conséquence.

Définissez deux variables glassfish, glassfish.os.name et glassfish.cvs.username (voir ci-dessus).

Ensuite :
% cd glassfish/bootstrap % maven checkout bootstrap-all build configure-runtime

Vous pouvez choisir quel goal exécuter entre les commandes bootstrap et bootstrap-all ci-dessus, en cliquant ici.

Aperçu des goals Maven sous GlassFish :

Nom du goal	Commande correspondante	Description
bootstrap	maven -Dmodules=admin bootstrap checkout build	Télécharge le fichier glassfish-image-SNAPSHOT.jar et le décompresse sous ${glassfish.home}(image serveur) pour générer des modules individuels.
bootstrap-all	maven checkout bootstrap-all build	Installe une image glassfish vide pouvant uniquement contenir des dépendances binaires, puis télécharge les dépendances binaires individuelles, les décompresse sous ${glassfish.home} et génère tous les modules à partir des sources.
checkout	maven checkout	Extrait un module.
build	maven build	Génère le module.
configure-runtime	maven configure-runtime	Configure ${glassfish.home} avec un domaine à instance unique.
configure-cluster	maven configure-cluster	Configure le domaine à l’aide des fonctionnalités de clustering pour GlassFish V2.
clean	maven clean clobber	Nettoie le module.
clobber	maven clobber	Nettoie l’image serveur GlassFish et supprime le répertoire ${glassfish.home. Doit être utilisé avec « bootstrap-all » pour obtenir une nouvelle image et nettoyer toute image serveur corrompue.
clean-config	maven clean-config	Nettoie le serveur. Le domaine1 et les fichiers à jeton remplacé sont supprimés du répertoire bin,config.
-Dmodules=	maven -Dmodules=admin bootstrap checkout build	Nettoie/extrait/génère certains modules uniquement : maven -Dmodules={liste d’éléments séparés par une virgule} nom de goal