Guide de démarrage

Procédure 3.1. Télécharger le programme d'installation de JBoss EAP du Portail Client sous le programme Full Red Hat JBoss Commercial Program

1. Ouvrir un navigateur et connectez-vous au Portail Client https://access.redhat.com.
2. Sélectionner Downloads (Téléchargements)
3. Cliquer sur Red Hat JBoss Enterprise Application Platform dans la liste Product Downloads (Téléchargements de produit).
4. Sélectionner la version JBoss EAP du menu déroulant Version.
5. Chercher Red Hat JBoss Enterprise Application Platform 6.x.xInstaller dans la liste et cliquer sur l'option Downloads (Téléchargement).
6. Vous êtes invités à sauvegarder le fichier JAR dans un répertoire de votre choix. Sélectionner un répertoire et sauvegarder le fichier.

Procédure 3.2. Télécharger le programme d'installation de JBoss EAP de jboss.org sous le programme Red Hat JBoss Developer Program

1. Ouvrir un navigateur web et accéder à l'URL suivant : http://www.jboss.org/products/eap.
   • Pour télécharger le programme d'installation de la version GA courante du produit, cliquer sur le bouton Download à droite de la page.
   • Suivez ces étapes pour choisir une autre version qui pourrait inclure les dernières versions Alpha ou Beta, ainsi que les versions précédentes du produit.
     1. Cliquer sur le lien Download JBoss EAP qui se trouve à gauche de la page.
     2. Cliquer sur le lien Installer dans la colonne Download pour obtenir la version de produit qui convient.
2. Vous êtes invités à sauvegarder le fichier JAR dans un répertoire de votre choix. Sélectionner un répertoire et sauvegarder le fichier.

Procédure 3.3. Exécuter le programme d'installation de JBoss EAP

1. Ouvrir une session de terminal et naviguer vers le répertoire qui contient le JAR du programme d'installation téléchargé.
2. Saisir la commande suivante :

   java -jar jboss-eap-6.x.x-installer.jar

   Copy to Clipboard Toggle word wrap
3. Suivre les instructions du tableau suivant.

Procédure 3.4. Télécharger le fichier ZIP du Portail Client sous le programme Full Red Hat JBoss Commercial Program

1. Ouvrir un navigateur et connectez-vous au Portail Client de Red Hat à l'adresse suivante https://access.redhat.com.
2. Sélectionner Downloads (Téléchargements)
3. Cliquer sur Red Hat JBoss Enterprise Application Platform dans la liste Product Downloads (Téléchargements de produit).
4. Sélectionner la version JBoss EAP du menu déroulant Version.
5. Chercher Red Hat JBoss Enterprise Application Platform 6.x.x dans la liste et cliquer sur l'option Downloads.
6. Vous êtes invité à sauvegarder le fichier ZIP dans un répertoire de votre choix. Sélectionner un répertoire et sauvegarder le fichier.

Procédure 3.5. Télécharger le fichier ZIP de jboss.org sous le programme Red Hat JBoss Developer Program

1. Ouvrir un navigateur web, et accéder à cet URL: http://www.jboss.org/products/eap/
2. Cliquer sur le lien Download JBoss EAP qui se trouve à gauche de la page.
3. Cliquer sur le lien ZIP dans la colonne Download pour obtenir la version de produit qui convient.
4. Vous êtes invité à sauvegarder le fichier ZIP dans un répertoire de votre choix. Sélectionner un répertoire et sauvegarder le fichier.

Procédure 3.6. Installation du fichier Zip

1. Déplacer l'archive ZIP vers l'emplacement désiré.

   Déplacer le fichier ZIP vers le serveur et le répertoire où vous souhaitez installer JBoss EAP 6. Le répertoire doit être accessible par l'utilisateur qui va démarrer et arrêter la plate-forme (accès lecture et écriture).

2. Utiliser une application qui convient pour extraire l'archive ZIP et la mettre dans l'emplacement qui convient.

   Dans un environnement Red Hat Enterprise Linux, utiliser unzip pour extraire les contenus d'archives ZIP.
   Dans Microsoft Windows, cliquer à droite sur le fichier et sélectionner Extract All (Tout extraire).
   Dans un environnement Hewlett-Packard HP-UX, utiliser unzip pour extraire les contenus d'archives ZIP.

Procédure 3.7. Télécharger les quickstart sous le programme Full Red Hat JBoss Commercial Program

1. Ouvrir un navigateur et connectez-vous au Portail Client de Red Hat à l'adresse suivante https://access.redhat.com.
2. Sélectionner Downloads (Téléchargements)
3. Cliquer sur Red Hat JBoss Enterprise Application Platform dans la liste Product Downloads (Téléchargements de produits).
4. Sélectionner la version JBoss EAP du menu déroulant Version.
5. Chercher Red Hat JBoss Enterprise Application Platform 6.x.xQuickstarts dans la liste et cliquer sur l'option Downloads (Téléchargements).
6. Vous êtes invités à sauvegarder le fichier Zip dans un répertoire de votre choix. Sélectionner un répertoire et sauvegardez le fichier.
7. Décompresser l'archive dans un répertoire de votre choix.

Procédure 3.8. Télécharger les quickstart sous le programme Red Hat JBoss Developer Program

1. Ouvrir un navigateur web, et accéder à cet URL: http://www.jboss.org/products/eap/
2. Cliquer sur le lien Download JBoss EAP qui se trouve à gauche de la page pour afficher les informations de téléchargement de produit.
3. Sous Download JBoss EAP, cliquer sur le lien Quickstarts pour télécharger l'archive zip qui contient les exemples.
4. Vous êtes invité à sauvegarder le fichier ZIP dans un répertoire de votre choix. Sélectionner un répertoire et sauvegarder le fichier.
5. Décompresser l'archive dans un répertoire de votre choix.

1. Visiter https://www.jboss.org/products/devstudio.html.
2. Cliquer le bouton Download. On vous demandera de sauvegarder le fichier ZIP dans un répertoire de votre choix.

1. Ouvrir une session de terminal et naviguer vers le répertoire qui contient le fichier .jar.
2. Exécuter la commande suivante pour lancer le GUI d'installation :

   java -jar jbdevstudio-build_version.jar

   Copy to Clipboard Toggle word wrap

   Note

   Sinon, ouvrez-le fichier .jar d'un double-clic pour lancer le programme d'installation.
3. Cliquer sur Next pour commencer le processus d'installation.
4. Sélectionner I accept the terms of this license agreement (J'accepte les conditions de licence) et cliquer sur Next.
5. Ajuster le chemin d'accès de l'installation et cliquer sur Next.

   Note

   Si le dossier de chemin d'installation n'existe pas, vous verrez une invite. Cliquer alors sur Ok pour créer le dossier.
6. Choisir une JVM, ou bien conserver la JVM sélectionnée par défaut, et cliquer sur Next.
7. Red Hat JBoss Developer Studio inclut Red Hat JBoss Enterprise Application Platform. Si la plateforme était déjà installée, choisissez No. Sinon, choisissez Yes pour l'installer et la configurer à être utilisée avec Red Hat JBoss Developer Studio.
8. Vérifier les informations d'installation et cliquer sur Next.
9. Cliquer sur Next une fois le processus d'installation terminé.
10. Configurer les raccourcis bureau pour Red Hat JBoss Developer Studio et cliquer sur Next.
11. Cliquer sur le bouton Done (Terminé).

Procédure 4.1. Commande de démarrage de Red Hat JBoss Developer Studio

1. Ouvrir un terminal et naviguer dans le répertoire d'installation de Red Hat JBoss Developer Studio.
2. Lancer la commande suivante pour démarrer JBoss Developer Studio :
   Dans Linux :

   [localhost]$ ./jbdevstudio

   Copy to Clipboard Toggle word wrap
   Dans Microsoft Windows :

   C:\JBDS_INSTALL_DIRECTORY > jbdevstudio.bat

   Copy to Clipboard Toggle word wrap

Procédure 4.2. Ajouter le serveur

1. Ouvrir l'onglet Serveurs. S'il n'y a pas d'onglet Serveurs, l'ajouter au panneau comme suit :
   1. Cliquer sur Window → Show View → Other....
   2. Sélectionner Servers à partir du dossier Server et cliquer sur OK.
2. Cliquer sur le lien No servers are available. Click this link to create a new server... (Aucun serveur disponible. Cliquer sur ce lien pour créer un nouveau serveur...) ou bien, cliquer à droite dans le panneau vide Serveur, et sélectionner New → Server.
   

   Figure 4.1. Ajouter un nouveau serveur - Aucun serveur disponible

3. Étendre JBoss Enterprise Middleware et choisir JBoss Enterprise Application Platform 6.1+. Saisir un nom de serveur, comme par exemple "JBoss Enterprise Application Platform 6.4", puis cliquer sur Next pour créer le JBoss Runtime et définir le serveur. La prochaine fois que vous définirez un nouveau serveur, ce dialogue affichera un menu de sélection Server runtime environment avec la nouvelle définition de runtime.
   

   Figure 4.2. Définir un nouveau serveur

4. Créer un Adaptateur de serveur pour gérer le démarrage et l'arrêt du serveur. Conserver les valeurs par défaut, et cliquer sur Next.
   

   Figure 4.3. Créer un nouvel Adpatateur de serveur

5. Saisir un nom comme "JBoss EAP 6.4 Runtime". Sous Home Directory, cliquer sur Browse puis, naviguer vers l'emplacement de l'installation de JBoss EAP. Puis, cliquer sur Next.
   

   Figure 4.4. Ajouter un environnement de runtime du nouveau serveur

   Note

   Certains quickstarts exigent que vous exécutiez le serveur avec un profil différent ou avec des arguments supplémentaires. Pour déployer un quickstart qui nécessite le profil full, vous devez définir un nouveau serveur et ajouter un Server Runtime Environment qui spécifie standalone-full.xml dans le Configuration file. Veillez à bien donner un nom descriptif au nouveau serveur.
6. Vous permet de configurer les projets existants pour le nouveau serveur. Puisque vous n'avez pas de projet à ce stade, cliquer sur Finish.
   

   Figure 4.5. Modifier les ressources dans le nouveau serveur de JBoss

Procédure 5.1. Importer les quickstarts dans Red Hat JBoss Developer Studio

1. Si vous ne l'avez pas encore fait, Section 4.2.4.2, « Configurer les paramètres Maven pour une utilisation en ligne de commande ».

2. Démarrer Red Hat JBoss Developer Studio.

3. À partir du menu, sélectionner File → Import.

4. Dans la liste sélectionnée, choisir Maven → Existing Maven Projects, puis cliquer sur Next.
   

   Figure 5.1. Importer les projets Maven existants

5. Naviguer vers le répertoire du quickstart que vous souhaitez tester, comme helloworld, et cliquer sur OK. La zone de liste Projects fera apparaître le fichier pom.xml du projet quickstart sélectionné.
   

   Figure 5.2. Sélectionner les projets Maven

6. Cliquer sur Finish.

Procédure 5.2. Générer et déployer le Quickstart helloworld

1. Si vous ne voyez pas l'onglet Servers ou si vous n'avez pas encore défini de serveur, suivre les instructions suivantes : Section 4.1.5, « Ajouter le serveur de JBoss EAP en utilisant Define New Server ». Si vous avez l'intention de déployer un quickstart qui requiert un profil full et des arguments de démarrage supplémentaires, veillez bien à créer un environnement de runtime selon les instructions de quickstart.
2. Cliquer à droite sur jboss-helloworld sur l'onglet Project Explorer, puis sélectionner Run As. On vous présentera une liste de choix. Sélectionner Run on Server.
   

   Figure 5.3. Run As - Run on Server

3. Sélectionner JBoss EAP 6.1+ Runtime Server de la liste de serveurs, et cliquer sur Next.
   

   Figure 5.4. Exécuter sur le serveur

4. L'écran suivant affiche les ressources qui sont configurées sur le serveur. Le quickstart de jboss-helloworld est configuré pour vous. Cliquer sur Finish pour déployer le quickstart.
   

   Figure 5.5. Modifier les ressources configurées sur le serveur

5. Vérifier les résultats.

   • Dans l'onglet Server, le statut de JBoss EAP 6.x Runtime Server passe à [Started, Republish] .
   • L'onglet Console du serveur affiche des messages détaillant le démarrage du serveur JBoss EAP 6.x et le déploiement du quickstart helloworld.
   • Un onglet helloworld apparaîtra avec l'URL http://localhost:8080/jboss-helloworld/HelloWorld et le texte "Hello World!".
   • Les messages suivants de la Console confirment le déploiement du fichier jboss-helloworld.war :

     JBAS018210: Register web context: /jboss-helloworld
     JBAS018559: Deployed "jboss-helloworld.war" (runtime-name : "jboss-helloworld.war")
     

     Copy to Clipboard Toggle word wrap

     Le contexte web enregistré se rajoute à http://localhost:8080 pour fournir l'URL utilisé pour accéder à l'application qui est déployée.
6. Pour vérifier que le quickstart helloworld soit déployé correctement dans le serveur JBoss, ouvrir le navigateur web, et accéder à l'application dans l'URL : http://localhost:8080/jboss-helloworld

Procédure 5.3. Exécuter les tests Arquillian du quickstart bean-validation

1. Suivre la procédure ci-dessus pour importer le quickstart bean-validation dans le Red Hat JBoss Developer Studio.
2. Dans l'onglet Servers, cliquer à droite dans le serveur et sélectionner le bouton Start pour démarrer le serveur JBoss EAP. Si vous n'apercevez pas l'onglet Servers et ou si vous n'avez pas encore défini de serveur, suivre les instructions suivantes : Section 4.1.5, « Ajouter le serveur de JBoss EAP en utilisant Define New Server ».
3. Cliquer à droite sur le projet jboss-bean-validation qui se trouve dans l'onglet Project Explorer et sélectionner Run As. On vous présentera une liste d'options. Sélectionner Maven Build.
4. Dans le champ d'entrée Goals du dialogue Edit Configuration, saisir : clean test -Parq-jbossas-remote
   Cliquer ensuite sur Run.
   

   Figure 5.6. Modifier la configuration

5. Vérifier les résultats.
   L'onglet de serveur Console affiche des messages donnant des informations sur le démarrage du serveur JBoss EAP et la sortie des tests Arquillian de quickstart bean-validation.

   -------------------------------------------------------
    T E S T S
   -------------------------------------------------------
   Running org.jboss.as.quickstarts.bean_validation.test.MemberValidationTest
   Tests run: 5, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 2.189 sec
   
   Results :
   
   Tests run: 5, Failures: 0, Errors: 0, Skipped: 0
   
   [INFO] ------------------------------------------------------------------------
   [INFO] BUILD SUCCESS
   [INFO] ------------------------------------------------------------------------
   

   Copy to Clipboard Toggle word wrap

Procédure 5.4. Générer et déployer les quickstarts par Ligne de commandes

1. Si vous ne l'avez pas encore fait, Section 4.2.4.2, « Configurer les paramètres Maven pour une utilisation en ligne de commande ».
2. Vérifier le fichier README.html qui se trouve dans le répertoire racine des quickstarts.
   Ce fichier contient des informations générales sur les prérequis de systèmes, sur la façon de configurer Maven, comment ajouter des utilisateurs, et comment exécuter les quickstarts. Lisez attentivement avant de commencer.
   Il contient également un tableau qui répertorie les quickstarts disponibles. Le tableau répertorie chaque nom de quickstart et chaque technologie dont il s'agit. Il y a une brève description pour chaque quickstart et une indication du niveau d'expérience requis pour l'installer. Pour des informations plus détaillées, cliquer sur le nom du quickstart.
   Certains quickstarts sont conçus pour améliorer ou étendre d'autres quickstarts. Ils sont indiqués dans la colonne Prerequisites (Conditions préalables). Si un quickstart est associé à une liste de conditions préalables, vous devrez les remplir avant d'utiliser le quickstart.
   Certains quickstart ont besoin de l'installation et de la configuration de composants optionnels. Ne pas installer ces composants à moins que le quickstart ne les exige.
3. Exécuter le quickstart helloworld
   Le quickstart helloworld est un des quickstarts les plus simples, et est un bon moyen de vérifier si le serveur JBoss est configuré et exécute correctement. Ouvrir le fichier README.html dans la racine du quickstart helloworld. Il contient des instructions détaillées sur la façon de construire et de déployer le quickstart et d'accéder à l'application en cours.
4. Exécuter d'autres quickstarts.
   Suivre les instructions dans le fichier README.html qui se trouve dans le dossier racine de chaque quickstart pour exécuter l'exemple.