Procédure 4.1. Téléchargement du fichier Zip

1. Connectez-vous à https://access.redhat.com.
2. Sélectionner Téléchargements → JBoss Enterprise Middleware → Téléchargements.
3. Sélectionner Plate-forme d'applications à partir du menu déroulant Produit.
4. Sélectionner la version JBoss EAP du menu déroulant Version drop-down menu.
5. Cliquez sur le bouton Télécharger qui se situe à côté de l'option Application Platform 6.1.0.

Procédure 4.2. Installation Zip

1. Déplacez l'archive Zip vers la location désirée.

   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 Tout extraire.
   Dans un environnement Hewlett-Packard HP-UX, utiliser unzip pour extraire les contenus d'archives Zip.

Procédure 4.3. Désinstaller JBoss EAP 6 (Installation Zip)

1. Rendez-vous dans le répertoire à partir duquel vous avez extrait le dossier JBoss EAP 6 du fichier Zip.

2. Supprimer le répertoire d'installation

   JBoss EAP 6 installe dans un répertoire unique quand vous utilisez la méthode d'installation Zip. Supprimer le répertoire d'installation pour désinstaller JBoss EAP 6.

3. Option: supprimer les scripts d'initialisation que vous avez créés.

   Si vous avez créé des scripts d'initialisation ou d'autres scripts qui dépendent de la plateforme JBoss EAP 6 installée sur votre ordinateur, les supprimer.

Procédure 4.4. Téléchargement du programme d'installation

1. Connectez-vous à https://access.redhat.com.
2. Sélectionner Téléchargements → JBoss Enterprise Middleware → Téléchargements.
   

   Figure 4.1. 

3. Sélectionner Plate-forme d'applications à partir du menu déroulant Produit qui se trouve sur l'écran suivant.
4. Sélectionner Application Platform 6.1.0 Installer.
5. Cliquer sur le bouton Télécharger.

Procédure 4.5. Démarrage du programme d'installation

1. Exécuter une des commandes suivantes pour démarrer le processus d'installation :

   • Mode graphique

     java -jar jboss-eap-6.1.1.ER4-installer.jar

   • Mode texte

     java -jar jboss-eap-6.1.1.ER4-installer.jar -console

2. Suivre les étapes suivantes etc.

Procédure 4.6. Désinstaller JBoss EAP 6 (Installation graphique)

1. Durant l'installation de JBoss EAP 6 sur la machine cible, un répertoire Uninstaller aura été créé dans le répertoire où vous avez installé JBoss EAP 6. Ce répertoire contient un fichier nommé uninstaller.jar. Naviguez vers ce répertoire dans une fenêtre du terminal.
2. Démarrez l'installateur GUI par la commande suivante :

   java -jar uninstaller.jar

3. L'exécution de la commande démarrera l'interface graphique de l'installation comme indiqué dans le schéma suivant. Sélectionner la case si vous souhaitez supprimer le répertoire d'installation de JBoss EAP 6.
   

   Figure 4.2. Supprimer l'installation JBoss 6.1 à partir d'une installation graphique

4. Appuyer sur le bouton Uninstall pour démarrer le processus de désinstallation.
5. Quand le processus de désinstallation est terminé, appuyer sur le bouton Quit (quitter) pour sortir du désinstallateur.
6. Après une installation réussie, vous souhaitez sans doute supprimer manuellement le répertoire Uninstaller à partir duquel vous avez lancé la désinstallation.

Procédure 4.7. Processus de désinstallation basé texte

1. Dans une console, naviguez dans le répertoire Uninstaller créé lors du processus d'installation. Vous pourrez le trouver au niveau qui se trouve au dessus EAP_HOME.
2. Démarrez l'installateur basé texte par la commande suivante :

   java -jar uninstaller.jar -console

3. Suives les étapes de désinstallation de JBoss EAP 6.

Procédure 4.8. Installer JBoss EAP 6 (Installation graphique RPM)

1. Démarrer PackageKit

   PackageKit est un logiciel de gestion de packages open source faisant partie de Red Hat Enterprise Linux. Démarrer PackageKit sur la machine cible en sélectionnant System → Administration → Add/Remove Software (Ajouter/Supprimer logiciels).
2. Type

   jboss-eap6

   dans la case de recherche et appuyer sur le bouton Find. Le package JBoss EAP 6 apparaîtra dans la case de résultat.
3. Sélectionner le package JBoss EAP 6, et appuyer sur le bouton Apply. Voir le schéma ci-dessous.
   

   Figure 4.3. JBoss EAP 6 PackageKit Install

4. Suivez le reste des étapes d'installation de la plateforme JBoss EAP 6 sur votre machine cible.

Procédure 4.9. Étapes d'installation basée texte

1. Installer le Package RPM par YUM et Red Hat Network

   Vous pouvez utiliser YUM pour installer le package JBoss EAP 6 group par la commande groupinstall.

   [user@host ~]$ yum groupinstall jboss-eap6

2. Configurer les options init.

   L'installation RPM contient des scripts init pour démarrer le serveur. La configuration des scripts init est contenue dans un certain nombre de fichiers supplémentaires. Voir Section A.4, « Liste de packages RPM pour JBoss EAP 6 » pour obtenir des informations sur ces fichiers et sur les options contenues.

Procédure 4.10. Installation automatique

• Dans un terminal, exécuter la commande suivante pour installer JBoss EAP 6 par un script automatique :

  java -jar jboss-eap-6.1.0-installer.jar SCRIPT_NAME.xml

Procédure 4.11. Configurer JBoss EAP en tant que service dans Red Hat Enterprise Linux avec la méthode RPM

1. Installer JBoss EAP 6

   Installer la Plateforme JBoss EAP 6 par la méthode RPM en utilisant une des étapes listées dans les sections sur les prérequis ci-dessus.

2. Activer le service

   La méthode d'installation RPM de JBoss Enterprise Application Platform 6 installe les fichiers de service de prérequis dans les emplacements qui conviennent. Tout ce que vous aurez besoin de faire pour l'installer en tant que service est d'exécuter la commande suivante :

   chkconfig jbossas on

Procédure 4.12. Mise en place du service

1. Localiser le script de démarrage et le fichier de configuration.

   Le script de start-up et un fichier de configuration associé sont situés dans le répertoire EAP_HOME/bin/init.d/. Ouvrir le fichier de configuration jboss-as.conf pour le modifier.

2. Personnaliser les options de start-up dans le fichier jboss-as.conf

   Il existe plusieurs options dans le fichier jboss-as.conf. Au minimum, indiquer les valeurs qui conviennent pour les variables JBOSS_HOME et JBOSS_USER. Si ces variables sont absentes, ajouter les.

3. Copier les fichiers dans des répertoires de système

   1. Copier le fichier de configuration modifié dans le répertoire /etc/jboss-as.

      [user@host init.d]$sudo mkdir /etc/jboss-as

      [user@host init.d]$sudo cp jboss-as.conf /etc/jboss-as/

   2. Copier le script de start-up dans le répertoire /etc/init.d.

      [user@host init.d]$sudo cp jboss-as-standalone.sh /etc/init.d

4. Ajouter le script de démarrage comme service.

   Ajouter le nouveau service jboss-as-standalone.sh pour lister tous les services démarrés automatiquement, par la commande de gestion de service chkconfig.

   [user@host init.d]$sudo chkconfig --add jboss-as-standalone.sh

5. Démarrage du service

   Testez que le service soit bien installé en utilisant la syntaxe standard qui s'applique pour le démarrage des services Red hat Enterprise Linux.

   [user@host bin]$sudo service jboss-as-standalone.sh start

   Si tout va bien, vous devriez obtenir un [OK] vert. Si vous obtenez une erreur, vérifier les logs d'erreurs et veillez à ce que vos chemins d'accès soient corrects dans le fichier de configuration.

6. Faîtes démarrer le service automatiquement quand vous démarrerez le serveur à nouveau.

   Pour ajouter le service à la liste des services qui démarrent automatiquement quand votre serveur démarre à nouveau, lancer la commande suivante.

   [user@host init.d]$sudo chkconfig jboss-as-standalone.sh on

Procédure 4.13. Configurer un service de JBoss EAP 6 sur serveur Microsoft Windows.

1. Créer des variables système d'environnement.

   Créer deux variables système d'environnement :
   • JBOSS_HOME pointant sur le répertoire d'installation JBoss EAP 6.
   • NOPAUSE=1

2. S'il n'est pas encore configuré, télécharger et extraire le package Native Utilities pour votre architecture.

   Si le package Native Utilities d'un serveur Windows n'a pas été installé dans le cadre de l'installation JBoss EAP 6, télécharger le package 32-bit ou 64-bit qui convient à partir du Portail Clients Red Hat https://access.redhat.com. Extraire l'archive zip Native Utilities pour se superposer à l'installation JBoss EAP 6.
   Vous aurez alors un répertoire native dans l'emplacement suivant, dans l'installation JBoss EAP 6: EAP_HOME\modules\system\layers\base\

3. Installer le service

   Ouvrir un terminal, et changer de répertoire EAP_HOME\modules\system\layers\base\native\sbin
   Vous pourrez créer un nouveau service par la commande service install, avec les options figurant dans le tableau suivant.

   Tableau 4.3. Options service install

   Argument ou Variable	Description
   /controller HOST:PORT	L'hôte et le port de l'interface de gestion. Si non indiqués, la valeur par défaut est localhost:9999.
   /host [DOMAIN_HOST]	Indique que le mode Domaine doit être utilisé, spécifiant ainsi en option le nom du contrôleur de domaine. Si le nom du contrôleur de domaine ne figure pas, le nom par défaut est master.
   /loglevel LEVEL	Niveau de journalisation du service, soit: ERROR, INFO, WARN ou DEBUG. S'il ne figure par, la valeur par défaut sera INFO
   /name SERVICE_NAME	Le nom du service à créer, et qui ne doit pas contenir d'espaces. S'il ne figure pas, la valeur par défaut sera JBossEAP6.
   /desc "DESCRIPTION"	La description du service. S'il ne figure pas, la valeur par défaut sera "JBoss Enterprise Application Platform 6"
   /serviceuser DOMAIN\USERNAME	Indique le nom du compte sous lequel le service sera exécuté. Utiliser un nom de compte du format DOMAIN\USERNAME. S'il ne figure pas, le service sera exécuté en tant que compte Système local.
   /servicepass PASSWORD	Mot de passe pour le compte /serviceuser.
   /jbossuser USERNAME	En option, le nom d'utilisateur JBoss EAP à utiliser pour la commande de fermeture du système.
   /jbosspass PASSWORD	Mot de passe pour le compte /jbossuser, requis si /jbossuser est spécifié.

   Vous trouverez ci-dessous des exemples de base de la commande install pour créer un nouveau service soit en mode autonome, soit en mode de domaine. Exécuter la commande suivante, en ajustant le niveau de journalisation du service selon les besoins :
   • Mode autonome :

     service.bat install /loglevel INFO

   • Mode de domaine :
     Si vous n'utilisez pas le master par défaut du contrôleur de domaine JBoss EAP 6, remplacer master par le nom d'hôte qui convient ou un alias du contrôleur de domaine JBoss EAP 6.

     service.bat install /host master /loglevel INFO

   Un nouveau service Windows sera alors créé, portant le nom JBossEAP6.

4. Vérifier le nouveau service dans la Console de services

   Exécuter la commande suivante dans un terminal pour ouvrir la Console de services Windows :

   services.msc

   Si le nom de service par défaut était utilisé, dans la liste des services Windows, le nouveau service aura pour nom: JBoss Enterprise Application Platform 6. Vous pourrez démarrer et arrêter le service à partir de la Console de services, ainsi que changer ses paramètres de configuration de démarrage.

5. Démarrage et arrêt du service JBoss EAP 6 à partir d'un terminal.

   Pour démarrer le service d'un terminal, utiliser la commande suivante, en modifiant le nom du service si nécessaire.

   net start JBossEAP6

   Pour stopper le service d'un terminal, utiliser la commande suivante, en modifiant le nom du service si nécessaire.

   net stop JBossEAP6

Procédure 4.14. Supprimer l'installation du service JBoss EAP 6 dans un serveur Microsoft Windows

• Si le service est en cours d'exécution, ouvrir tout d'abord un terminal et arrêter le service en exécutant la commande net stop accompagnée du nom du service :

  net stop JBossEAP6

  Dans un terminal, changer de répertoire EAP_HOME\modules\system\layers\base\native\sbin et exécuter la commande suivante :

  service uninstall

Procédure 5.1. Abonnez-vous à JBoss Watch List

1. Cliquer sur le lien suivant pour vous rendre sur la page de la liste de diffusion JBoss Watch: JBoss Watch Mailing List.
2. Saisir votre adresse email dans la section Subscribing to Jboss-watch-list.
3. [Vous pourrez aussi saisir votre nom et sélectionner un mot de passe. Ceci est en option, mais recommandé.]
4. Cliquer sur le bouton Subscribe pour démarrer le processus d'abonnement.
5. Vous pouvez naviguer les archives de la liste de diffusion en vous rendant à : JBoss Watch Mailing List Archives.

Procédure 5.4. Appliquer un patch à un produit JBoss via méthode RPM

1. Recevez vos notifications de correctifs de sécurité soit en tant qu'abonné de la liste de diffusion JBoss watch ou en parcourant les archives de la liste de diffusion de JBoss watch.
2. Lire l'errata du correctif de sécurité et confirmer qu'elle s'applique bien à un produit JBoss de votre environnement.
3. Si le correctif de sécurité s'applique à un produit JBoss de votre environnement, alors suivez le lien pour télécharger le package RPM mis à jour qui contient l'errata.
4. Utilisation

   yum update

   pour installer le correctif.

   Important

   Quand vous mettez une installation RPM à jour, votre produit JBoss sera mis à jour de façon cumulative avec tous les correctifs sortis-RPM.

Procédure 5.5. Mettre à niveau vers la dernière version de JBoss EAP 6

1. Déplacez l'archive ZIP sur l'emplacement souhaité. Il est recommandé que cet emplacement soit différent de celui de l'installation de JBoss EAP 6 existante.

   Important

   Si vous souhaitez installer la dernière version de JBoss EAP 6 sur le même emplacement de répertoire que celui de l'installation existante, vous devrez déplacer l'installation existante sur un autre emplacement avant de procéder. Ceci sert à empêcher de perdre les fichiers de configuration, déploiements et mises à niveau.
2. Décompressez l'archive. Cette étape installe une nouvelle instance de la dernière version de JBoss EAP 6.
3. Faîtes fusionner vos changements des répertoires EAP_HOME/domain/ et EAP_HOME/standalone/ d'une version antérieure vers la nouvelle installation.

   Avertissement

   Les fichiers de configuration ne doivent pas être copiés à partir d'une version antérieure vers une nouvelle installation. Les changements doivent être effectués manuellement.
4. Examinez les changements apportés au répertoire bin de l'installation précédente, puis effectuez les modifications équivalentes sur le nouveau répertoire.

   Avertissement

   Les fichiers du répertoire bin ne doivent pas être remplacés par les fichiers de versions précédentes. Les changements doivent être effectués manuellement.
5. Examinez les fichiers restants de l'installation précédente, et déplacez ces modifications sur la nouvelle installation. Ces fichiers peuvent inclure :
   • Le répertoire welcome-content.
   • Des modules personnalisés dans le répertoire modules.
   • Des lots (« bundles ») personnalisés dans le répertoire bundles.

Procédure 5.6. Mettre à niveau vers la dernière sortie de JBoss EAP 6

1. Exécutez la commande suivante dans un terminal pour mettre à niveau l'installation :

   [user@host] yum update

2. Fusionnez manuellement chaque fichier *.rpmnew créé contenant des modifications en fichiers de configuration de production.

Procédure 5.7. Installation d'un cluster JBoss EAP dans 6.1.

1. Consulter le chapitre HTTP Clustering and Load Balancing (Clustering HTTP et Équilibrage des charges) du guide JBoss EAP 6.1 Administration and Configuration Guide pour obtenir des instructions sur la façon d'installer un cluster JBoss EAP dans 6.1.
2. Migrer tout le traffic vers ce nouveau groupement (cluster) en utilisant les étapes définies dans le chapitre Migrate Traffic between Clusters du guide JBoss Enterprise Application Platform 6.1 Administration and Configuration Guide