Guide d'installation
À utiliser dans JBoss Enterprise Application Platform 6
Édition 1
Nidhi Chaudhary
Lucas Costi
Russell Dickenson
Sande Gilda
Vikram Goyal
Eamon Logue
Darrin Mison
Scott Mumford
David Ryan
Misty Stanley-Jones
Keerat Verma
Tom Wells
Résumé
Preface
Chapitre 1. Introduction
1.1. JBoss Enterprise Application Platform 6
1.2. Portail Clients Red Hat
- Gérer et maintenir les abonnements et contrats de support de Red Hat;
- Télécharger des logiciels officiellement pris en charge;
- Accéder à la Documentation produits et à la Base de connaissance Red Hat;
- Contacter Global Support Services; et
- Soumettre des bogues pour les produits Red Hat.
Chapitre 2. Prérequis
2.1. Prérequis pour l'installation de JBoss Enterprise Application Platform 6
Pré-requis communs
- Ouvrez un compte dans le Portail Clients Red Hat à l'adresse suivante https://access.redhat.com. Voir Section 1.2, « Portail Clients Red Hat »
- Vérifiez les configurations prises en charge et veillez à ce que votre système puisse être pris en charge : https://access.redhat.com/site/articles/111663.
- Veillez à ce que votre système soit aux dernières mises à jour et tienne compte des dernières errata.
Prérequis ZIP/Installateur
- Privilèges d'administration pour le répertoire d'installation.
- Veillez à ce que le JDK choisi ait bien été extrait (ou installé). Voir la documentation de JDK pour obtenir des informations sur la façon de procéder.
- Veillez à ce que JAVA_HOME et PATH aient bien été définis dans les propriétés d' environnement pour que les raccourcis fonctionnent bien sur les serveurs Microsoft Windows.
Prérequis RPM
- Enregistrez le système su le Red Hat Network (RHN).
- Abonnez-vous au réseau
Red Hat Enterprise Linux Servercorrespondant à votre version Red Hat Enterprise Linux. - Abonnez-vous au sous-réseau
JBoss Application Platform for Server, du groupeJBoss Enterprise Platform. - Un Java 6 JDK est requis. Vous pourrez l'obtenir en vous abonnant au réseau
supplémentairede votre installation Red Hat Enterprise Linux. Par exemple; le réseau pour la version 6 de Red Hat Enterprise Linux installée sur l'architecture i386 estrhel-i386-server-supplementary-6.Important
Un Java 6 JDK devra être installé, même si vous souhaitez installer un Java 7 JDK.
Chapitre 3. Installation
3.1. Méthodes d'installation de JBoss Enterprise Application Platform 6
Tableau 3.1. Méthodes d'installation
|
Méthode
|
Description
|
Instructions
|
|---|---|---|
|
Installation Zip
|
L'archive Zip convient pour des installations sur n'importe quel système d'exploitation pris en charge. Ce processus devra être utilisé si vous souhaitez extraire une instance manuellement.
| |
|
Programme d'installation JAR
|
Le programme d'installation peut être exécuté dans une console, ou en tant que qu'assistant graphique. Ces deux options fournissent des instructions étape par étape pour installer et configurer l'instance de serveur. Une installation supplémentaire, comprenant les Quiskstarts et le référentiel Maven, sont également possibles avec le programme d'installation.
| |
|
Installation RPM
|
JBoss Enterprise Application Platform 6 peut être installée par le programme d'installation graphique RPM supporté, ou par interface de ligne de commande. Cette méthode convient plus particulièrement pour les installations Red Hat Enterprise Linux 6.
|
3.2. Installation Zip
3.2.1. Télécharger l'installation ZIP de JBoss Enterprise Application Platform 6
Le fichier d'installation JBoss Enterprise Application Platform 6 Zip se trouve à https://access.redhat.com. Le fichier d'installation Zip est indépendant de la plate-forme et constitue la méthode de choix pour installer JBoss Enterprise Application Platform 6 sur toute plate-forme prise en charge. Cette section couvre les étapes de téléchargement de l'archive.
Prérequis
Procédure 3.1. Téléchargement du fichier Zip
- Connectez-vous à https://access.redhat.com.
- Sélectionner Téléchargements → JBoss Enterprise Middleware → Téléchargements.
- Sélectionner Plate-forme d'applications à partir du menu déroulant Produit.
- Sélectionner la version JBoss Enterprise Application Platform à partir du menu déroulant Version.
- Cliquez sur le bouton Télécharger qui se situe à côté de l'option
Application Platform 6.1.0.
JBoss Enterprise Application Platform 6 a été téléchargé avec succès dans la machine cible, et est prêt à l'installation.
3.2.2. Installation ZIP de JBoss Enterprise Application Platform 6
Cette section couvre les étapes d'installation de la plateforme JBoss Enterprise Application 6 via chargement ZIP
Prérequis
Procédure 3.2. Installation Zip
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 la plate-forme JBoss EAP 6. Le répertoire doit être accessible par l'utilisateur qui va démarrer et arrêter la plate-forme.Utiliser une application qui convient pour extraire l'archive Zip et la mettre dans l'emplacement qui convient.
Dans un environnement Linux, la commande d'extraction d'archive Zip estunzip.Dans Microsoft Windows, cliquer à droite sur le fichier et sélectionner Tout extraire.
JBoss Enterprise Application Platform 6 a été installée avec succès. Le répertoire créé par extraction de l'archive Zip se trouve au niveau supérieur du répertoire du serveur. Il s'agit de EAP_HOME/.
3.2.3. Supprimer une installation ZIP JBoss Enterprise Application Platform 6
Cette section couvre les étapes requises pour supprimer l'installation Zip de JBoss Enterprise Application Platform 6.
Sauvegardez tous les fichiers de configuration modifiés et déploiements qui pourraient être réutilisés ultérieurement.
Procédure 3.3. Supprimer une installation ZIP JBoss Enterprise Application Platform 6
- Rendez-vous dans le répertoire d'où vous avez extrait le dossier JBoss Enterprise Application Platform 6 du fichier Zip.
Supprimer le répertoire d'installation
JBoss Enterprise Application Platform 6 s'installe dans un seul répertoire quand vous utilisez la méthode d'installation Zip. Supprimer le répertoire d'installation pour désinstaller Jboss EAP 6.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.
La plateforme Enterprise Application Platform JBoss 6 est désinstallée sur votre serveur.
3.3. Installateur graphique
3.3.1. Télécharger JBoss Enterprise Application Platform 6 (Programme d'installation)
L'archive d'installation de JBoss Enterprise Application Platform 6 se trouve à https://access.redhat.com. L'archive .jar peut soit être utilisée pour exécuter des programmes d'installation Graphique ou Texte. Cette section couvre les étapes de téléchargement de l'archive.
Prérequis
Procédure 3.4. Téléchargement du programme d'installation
- Connectez-vous à https://access.redhat.com.
- Sélectionner Téléchargements → JBoss Enterprise Middleware → Téléchargements.

Figure 3.1.
- Sélectionner Plate-forme d'applications à partir du menu déroulant Produit qui se trouve sur l'écran suivant.
- Sélectionner
Application Platform 6.1.0 Installer. - Cliquez sur le bouton Télécharger.
JBoss Enterprise Application Platform 6 a été téléchargé avec succès dans la machine cible, et est prête à l'installation.
3.3.2. Installer la Plateforme JBoss Enterprise Application 6 par la Méthode graphique
La méthode graphique vous permet d'installer JBoss Enterprise Application Paltform 6 sur une machine cible en utilisant les instructions du GUI étape par étape. Cette section couvre les étapes d'installation de la plateforme JBoss Enterprise Application 6 par cette méthode.
Prérequis
Procédure 3.5. Installer JBoss Enterprise Application Platform 6
- Ouvrir une fenêtre de terminal dans la machine cible et naviguez vers l'emplacement où le programme d'installation a été téléchargé.
- Démarrez l'installateur GUI par la commande Java suivante :
java -jar jboss-eap-6.1.0-installer.jar - L'exécution de la commande démarrera l'interface graphique de l'installation et la première fenêtre vous demandera de sélectionner le language pour l'installation.

Figure 3.2. JBoss EAP 6.1.0 Install - Première étape
- Suivez le reste des étapes d'installation de la plateforme JBoss Enterprise Application 6 sur votre machine cible.
- L'étape finale du processus d'installation va vous permettre de créer un script d'installation automatique. Ce script pourra être utilisé pour installer JBoss sur d'autres machines cibles dans votre réseau ou pourra servir à des installation par la suite. Voir le schéma ci-dessous. Appuyer sur le bouton Générer un script d'installation automatique si vous souhaitez créer ce script XML.

Figure 3.3. Dernière étape de l'installation JBoss EAP
- Appuyer sur le bouton Terminé pour sortir de l'installation.
L'installation est terminée et la plate-forme JBoss Enterprise Application Platform 6 est maintenant installée dans votre machine cible.
3.3.3. Supprimer une installation de Plateforme JBoss Enterprise Application 6 par la Méthode graphique
Cette section vous indique les étapes requises pour supprimer l'installation d'une instance de JBoss Enterprise Application Platform 6 installée à partir d'une installation graphique.
Prérequis
- Sauvegardez tous les fichiers de configuration modifiés et déploiements qui pourraient être réutilisés ultérieurement.
Procédure 3.6. Supprimer une installation graphique GUI JBoss Enterprise Application Platform 6
- Durant l'installation de JBoss Enterprise Application Platform 6 sur la machine cible, un répertoire
Uninstalleraura été créé dans le répertoire où vous avez installé JBoss Enterprise Application Platform 6. Ce répertoire contient un fichier nomméuninstaller.jar. Naviguez vers ce répertoire dans une fenêtre du terminal. - Démarrez l'installateur GUI par la commande suivante :
java -jar uninstaller.jar - L'exécution de la commande démarrera l'interface graphique de l'installation comme indiqué dans le schéma numéro un. Sélectionner la case si vous souhaitez supprimer le répertoire
EAP_HOME.
Figure 3.4. Supprimer l'installation JBoss 6.1 à partir d'une installation graphique
- Appuyer sur le bouton Uninstall pour démarrer le processus de désinstallation.
- Quand le processus de désinstallation est terminé, appuyer sur le bouton Quit (quitter) pour sortir du désinstallateur.
- Après une installation réussie, vous souhaitez sans doute supprimer manuellement le répertoire
Uninstallerà partir duquel vous avez lancé la désinstallation.
La plateforme Enterprise Application Platform JBoss 6 est désinstallée sur votre serveur.
3.4. Installateur basé texte
3.4.1. Télécharger JBoss Enterprise Application Platform 6 (Programme d'installation)
L'archive d'installation de JBoss Enterprise Application Platform 6 se trouve à https://access.redhat.com. L'archive .jar peut soit être utilisée pour exécuter des programmes d'installation Graphique ou Texte. Cette section couvre les étapes de téléchargement de l'archive.
Prérequis
Procédure 3.7. Téléchargement du programme d'installation
- Connectez-vous à https://access.redhat.com.
- Sélectionner Téléchargements → JBoss Enterprise Middleware → Téléchargements.

Figure 3.5.
- Sélectionner Plate-forme d'applications à partir du menu déroulant Produit qui se trouve sur l'écran suivant.
- Sélectionner
Application Platform 6.1.0 Installer. - Cliquez sur le bouton Télécharger.
JBoss Enterprise Application Platform 6 a été téléchargé avec succès dans la machine cible, et est prête à l'installation.
3.4.2. Installer la Plateforme JBoss Enterprise Application 6 par un installateur basé texte
Cette section couvre les étapes d'installation de la plateforme JBoss Enterprise Application 6 via chargement ZIP
Prérequis
Procédure 3.8. installateur basé texte
- Ouvrir un terminal.
- Démarrez l'installateur par la commande suivante :
java -jar jboss-eap-6.1.0-installer.jar -console - Suivez les invites d'installation.
- On peut générer un fichier XML à utiliser avec la fonction d'installation automatique. Cela permet d'effectuer des installations multiples sur plusieurs instances. Si vous souhaitez créer un script d'installation, sélectionner
yes.
JBoss Enterprise Application Platform 6 a été installée avec succès sur la machine cible.
3.4.3. Supprimer une installation de Plateforme JBoss Enterprise Application 6 par un installateur basé texte.
Cette section couvre les étapes de désinstallation de la plateforme JBoss Enterprise Application 6 via désinstallateur basé texte.
Prérequis
- Sauvegardez tous les fichiers de configuration modifiés et déploiements qui pourraient être réutilisés ultérieurement.
Procédure 3.9. Processus de désinstallation basé texte
- Dans une console, naviguez dans le répertoire
Uninstallercréé lors du processus d'installation. Vous pourrez le trouver au niveau qui se trouve au dessus de EAP_HOME. - Démarrez l'installateur basé texte par la commande suivante :
java -jar uninstaller.jar -console - Suives les étapes de désinstallation de JBoss Enterprise Application Platform 6
La plateforme Enterprise Application Platform JBoss 6 est désinstallée sur votre serveur.
3.5. Installation RPM graphique
3.5.1. Installation graphique RPM JBoss Enterprise Application Platform 6
La méthode RPM d'installation de JBoss Enterprise Application Platform 6 convient pour Red Hat Enterprise Linux 6. Cette section couvre les étapes nécesssaires requises pour compléter l'installation.
Prérequis
Procédure 3.10. Installation graphique RPM JBoss Enterprise Application Platform 6
Démarrer PackageKit
PackageKit est un logiciel de gestion de packages open source faisant partie de RHEL6. Démarrer PackageKit sur la machine cible en sélectionnant System → Administration → Add/Remove Software (Ajouter/Supprimer logiciels).- 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. - Sélectionner le package JBoss EAP 6, et appuyer sur le bouton Apply. Voir le schéma ci-dessous.

Figure 3.6. JBoss EAP 6 PackageKit Install
- Suivez le reste des étapes d'installation de la plateforme JBoss Enterprise Application 6 sur votre machine cible.
L'installation est terminée et la plate-forme JBoss Enterprise Application Platform 6 est maintenant installée dans votre machine cible.
3.6. installation RPM basée texte
3.6.1. Installation graphique RPM basée texte de JBoss Enterprise Application Platform 6
La méthode RPM d'installation de JBoss Enterprise Application Platform 6 convient pour Red Hat Enterprise Linux 6. Cette section couvre les étapes nécessaires pour compléter l'installation par ligne de commande.
Prérequis
Procédure 3.11. Étapes d'installation basée texte
Installer le Package RPM par YUM et Red Hat Network
Vous pouvez utiliser YUM pour installer le groupe de packages JBoss Enterprise Application Platform 6 par la commandegroupinstall.[user@host ~]$ yum groupinstall jboss-eap6
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 Enterprise Application Platform 6 » pour obtenir des informations sur ces fichiers et sur les options contenues.
L'installation est terminée. Le chemin par défaut EAP_HOME de l'installation RPM est /usr/share/jbossas. Voir Section A.3, « Liste de packages RPM pour JBoss Enterprise Application Platform 6 » pour obtenir une liste complète de tous les packages installés.
3.7. Installation de correctif
3.7.1. Mécanismes de correction
- Mises à jour planifiées: faisant partie d'une mise à jour micro, mineure, ou majeure d'un produit existant.
- Mises à jour non synchronisées: correctif exceptionnel délivré en dehors du cycle de mise à jour normal d'un produit existant.
- Est-ce que le défaut peut être exploité facilement ?
- Quel sorte de dégât peut avoir lieu en cas d'exploitation du défaut ?
- Y a t-il d'autres facteurs typiques impliqués qui pourraient diminuer la force de l'impact du défaut (comme les pare-feux, Security-Enhanced Linux, des directives de compilateurs, etc)?
3.7.2. Abonnez-vous aux Listes de diffusion de correctifs (Patch Mailing Lists)
L'équipe JBoss de Red Hat maintient une liste de diffusion pour les annonces de sécurité pour les produits Red Hat JBoss Enterprise Middleware. Cette section couvre ce que vous devez faire pour vous abonner à cette liste.
Prérequis
- Aucun
Procédure 3.12. Abonnez-vous à JBoss Watch List
- Cliquer sur le lien suivant pour vous rendre sur la page de la liste de diffusion JBoss Watch: JBoss Watch Mailing List.
- Saisir votre adresse email dans la section Subscribing to Jboss-watch-list.
- [Vous pourrez également saisir votre nom et sélectionner un mot de passe. Ceci est tout à fait optionnel, mais conseillé.]
- Cliquer sur le bouton Subscribe pour démarrer le processus d'abonnement.
- Vous pouvez naviguer les archives de la liste de diffusion en vous rendant à: JBoss Watch Mailing List Archives.
Une fois que votre compte email aura été confirmé, vous pourrez recevoir des communiqués liés à la sécurité de la liste de diffusion JBoss patch (Correctifs JBoss).
3.7.3. Installer des correctifs en Zip
Les correctifs de sécurité JBoss sont distribués de deux façons: zip (pour tous les produits) et RPM (pour un sous ensemble de produits). JBoss bug traite les correctifs distribués en format zip uniquement. Cette tâche décrit les étapes à prendre pour installer les correctifs (sécurité ou bogues) via zip.
Prérequis
- Accès valide et abonnement au Portail Clients de Red Hat.
- Un abonnement en cours à un produit JBoss installé en format zip.
Procédure 3.13. Appliquer un correctif à un produit JBoss via la méthode zip
Avertissement
- 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.
Note
Seuls les correctifs de sécurité sont annoncés sur la liste de diffusion JBoss watch. - Lire l'errata du correctif de sécurité et confirmer qu'elle s'applique bien à un produit JBoss de votre environnement.
- Si le correctif de sécurité s'applique à un produit JBoss de votre environnement, alors suivez le lien pour télécharger le correctif du Portail Clients de Red Hat.
- Le fichier zip téléchargeable à partir du Portail Clients contiendra tous les fichiers requis pour résoudre le problème de sécurité ou un bogue. Télécharger ce fichier zip de correctifs dans le même emplacement que votre produit JBoss.
- Décompresser le fichier de correctifs dans le même emplacement où le produit JBoss est installé. Les versions corrigées remplacent les fichiers existants.
Le produit JBoss est corrigé par la dernière mise à jour en format zip.
3.7.4. Installer des correctifs en RPM
Les correctifs de sécurité JBoss sont distribués de deux façons: zip (pour tous les produits) et RPM (pour un sous ensemble de produits). Cette tâche décrit les étapes nécessaires pour installer les correctifs en format RPM. La méthode de mise à jour RPM est utilisée pour diffuser des correctifs de sécurité asynchrones et des mises à jour macro/mineur/majeur de produits uniquement.
Prérequis
- Un abonnement RHN valide.
- Un abonnement en cours à un produit JBoss installé via un package RPM.
Procédure 3.14. Appliquer un patch à un produit JBoss via méthode RPM
Avertissement
- 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.
- Lire l'errata du correctif de sécurité et confirmer qu'elle s'applique bien à un produit JBoss de votre environnement.
- 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.
- Utilisation
ou commande similaire pour installer le correctif.yum update
Le produit JBoss est corrigé par la dernière mise à jour en format RPM.
3.7.5. Évaluation de la gravité et de l'impact des correctifs JBoss Security
Tableau 3.2. Système d'évaluation de gravité de JBoss Security Patches (Correctifs de sécurité JBoss)
| Gravité | Description |
|---|---|
| Critique |
Ce score est donné aux failles pouvant être facilement exploitées par un attaquant non authentifié à distance et conduire à des compromis de système (exécution de code arbitraire) sans intervention de la part de l'utilisateur. Ce sont les types de vulnérabilités pouvant être exploitées par des vers informatiques. Il s'agit de failles nécessitant un utilisateur distant authentifié, un utilisateur local ou une configuration peu probable ne sont pas classées comme impact critique.
|
| Important |
Ce score est donné aux failles qui peuvent facilement compromettre la confidentialité, l'intégrité ou la disponibilité des ressources. Ce sont les types de vulnérabilités qui permettent à des utilisateurs locaux d'obtenir des privilèges, qui permettent à des utilisateurs distants non authentifiés d'afficher des ressources qui devraient normalement être protégées par une authentification, qui permettent à des utilisateurs authentifiés distants d'exécuter du code arbitraire, ou d'autoriser des utilisateurs locaux ou distants de causer un déni de service.
|
| Modéré |
Ce score est donné aux failles qui risquent d'être plus difficiles à exploiter mais qui peuvent toujours résulter en compromis de confidentialité, d'intégrité, et disponibilité de ressources, sous certaines circonstances. Ce sont les types de vulnérabilités qui auraient pu avoir un impact critique ou un impact important, mais pouvant être moins facilement exploités selon une évaluation technique de la faille, ou qui risquent moins d'affecter les configurations.
|
| Moindre |
Ce score est donné à toutes les autres questions qui ont un impact de sécurité. Ce sont les types de vulnérabilités qui semblent liées à des circonstances improbables pour pouvoir être exploitées, ou dans les cas ou l'exploitation de la faille aurait des conséquences minimes.
|
Exemple 3.1. CVSS v2 Impact Score
C:N/I:P/A:C3.8. Installation automatique
3.8.1. Installer des Instances multiples de JBoss Enterprise Applicatin Platform 6 (Programme d'installation)
Plusieurs instances identiques de JBoss Enterprise Application Platform 6 peuvent être installées à l'aide d'un script automatisé, généré lors du processus d'installation, en utilisant l'installateur textuel ou graphique. Cette section décrit les étapes requises pour installer JBoss Enterprise Application Platform 6 à l'aide d'un script généré.
Prérequis
- Générer un script automatique par installateur graphique ou basé texte :
Procédure 3.15. Installation automatique
- Dans un terminal, exécuter la commande suivante pour installer JBoss Enterprise Application Platform 6 par un script automatique :
java -jar jboss-eap-6.1.0-installer.jarSCRIPT_NAME.xml
Une instance identique de JBoss Enterprise Application Platform 6 a été installée, basée sur le script généré automatiquement.
3.9. Configuration de service
3.9.1. Configurer JBoss Enterprise Application Platform en tant que service dans Red Hat Enterprise Linux (Méthode RPM)
Utiliser cette procédure pour installer JBoss EAP 6 en tant que service dans Red Hat Enterprise Linux quand l'installation a été effectuée par la méthode RHN (RPM).
Prérequis
- Installer la Plateforme JBoss Enterprise Application 6 par la méthode RPM (basée graphique ou texte).
- Les privilèges administrateurs sont requis sur le serveur.
Procédure 3.16. Configurer JBoss Enterprise Application Platform en tant que service dans Red Hat Enterprise Linux avec la méthode RPM
Installer JBoss Enterprise Application Server 6
Installer la Plateforme JBoss Enterprise Application Server 6 par la méthode RPM en utilisant une des étapes listées dans les sections sur les prérequis ci-dessus.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
La plate-forme JBoss EAP 6 démarre automatiquement lorsque Red Hat Enterprise Linux atteint son niveau d'exécution par défaut et s'arrête automatiquement lorsque le système d'exploitation passe par sa routine de fermeture.
3.9.2. Configurer JBoss Enterprise Application Platform en tant que service dans Red Hat Enterprise Linux (Zip, Installateur)
Utiliser cette procédure pour installer JBoss EAP 6 en tant que service dans Red Hat Enterprise Linux quand l'installation a été effectuée par les méthodes Zip, Basée-texte, ou Graphique. Ce processus ne s'applique pas quand l'installation a été effectuée par la méthode RHN (RPM).
Prérequis
- Installer la Plateforme JBoss Enterprise Application 6 par les méthodes Zip, Basée-texte, Graphique, Installateur.
- Les privilèges administrateurs sont requis sur le serveur.
Procédure 3.17. Mise en place du service
Copier le script de démarrage dans le répertoire
/etc/init.d/Le script de start-up et un fichier de configuration associé sont situés dans le répertoireEAP_HOME/bin/init.d/. Ouvrir le fichier de configurationjboss-as.confpour le modifier.Personnaliser les options de start-up dans le fichier
jboss-as.confIl existe plusieurs options dans le fichierjboss-as.conf. Au minimum, indiquer les valeurs qui conviennent pour les variablesJBOSS_HOMEetJBOSS_USER. Si ces variables sont absentes, ajouter les.Copier les fichiers dans des répertoires de système
- Copier le script de start-up dans le répertoire
/etc/jboss-as.[user@host init.d]$sudo mkdir /etc/jboss-as[user@host init.d]$sudo cp jboss-eap-6.1/bin/init.d/jboss-as.conf /etc/jboss-as/ - Copier le fichier de configuration modifié dans le répertoire
/etc/init.d.[user@host init.d]$sudo cp jboss-as-standalone.sh /etc/init.d
Ajouter le script de démarrage comme service.
Ajouter le nouveau servicejboss-as-standalone.shpour lister tous les services démarrés automatiquement, par la commande de gestion de servicechkconfig.[user@host init.d]$sudo chkconfig --add jboss-as-standalone.shDé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 startSi 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.
La plate-forme JBoss EAP 6 démarre automatiquement lorsque Red Hat Enterprise Linux atteint son niveau d'exécution par défaut et s'arrête automatiquement lorsque le système d'exploitation passe par sa routine de fermeture.
Chapitre 4. Mise à niveau à la dernière version
4.1. Mettre à niveau l'installation ZIP de JBoss Enterprise Application Platform 6
La mise à niveau vers la dernière version de JBoss Enterprise Application Platform 6 requiert un travail initial pour sauvegarder l'installation existante. Cette section couvre la mise à niveau de l'installation ZIP.
Prérequis
- Assurez-vous que le système d'exploitation de base est à jour.
- Déterminer les fichiers qui ont été modifiés depuis que JBoss Enterprise Application Platform 6 a été installée.
- Sauvegardez tous les fichiers de configuration modifiés, déploiements et toutes les données utilisateur.
Avertissement
Procédure 4.1. Mettre à niveau vers la dernière version de JBoss Enterprise Application Platform 6
- 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 Enterprise Application Platform 6 existante.
Important
Si vous souhaitez installer la dernière version de JBoss Enterprise Application Platform 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. - Décompressez l'archive. Cette étape installe une nouvelle instance de la dernière version de JBoss Enterprise Application Platform 6.
- Copiez les répertoires
EAP_HOME/domain/etEAP_HOME/standalone/de l'installation précédente sur les répertoires de la nouvelle installation. - Examinez les changements apportés au répertoire
binde l'installation précédente, puis effectuez les modifications équivalentes sur le nouveau répertoire.Avertissement
Les fichiers du répertoirebinne doivent pas être remplacés par les fichiers de versions précédentes. Les changements doivent être effectués manuellement. - 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.
L'installation ZIP de JBoss Enterprise Application Platform 6 a été mise à niveau à la dernière version avec succès.
4.2. Mettre à niveau l'installation RPM JBoss Enterprise Application Platform 6
La mise à niveau vers JBoss Enterprise Application Platform 6 requiert un travail initial pour sauvegarder l'installation existante. Ce sujet couvre la mise à niveau de l'installation RPM via RHN (Red Hat Network).
Prérequis
- Veillez à ce que votre système d'exploitation de base soit aux dernières mises à jour, que le système soit bien abonné, et activé pour pouvoir recevoir les dernières mises à jour du réseau Base OS.
- Veillez à ce que le réseau JBoss Enterprise Application Platform 6 RHN qui convient soit activé. Par exemple, sur une architecture x86, 64, ce sera JBoss Application Platform (v 6) pour le réseau 6Server x86_64 (
jbappplatform-6-x86_64-server-6-rpm). - Sauvegardez tous les fichiers de configuration modifiés, déploiements et toutes les données utilisateur.
Avertissement
Procédure 4.2. Mettre à niveau vers la dernière version de JBoss Enterprise Application Platform 6
- Exécutez la commande suivante dans un terminal pour mettre à niveau l'installation :
[user@host] yum update
- Fusionnez manuellement chaque fichier
*.rpmnewcréé contenant des modifications en fichiers de configuration de production.
La plateforme JBoss Enterprise Application Platform 6 a été mise à jour avec succès.
4.3. Mettre à niveau JBoss Enterprise Application Server Cluster de 6.0 vers 6.11
JBoss Enterprise Application Server 6.1 ne prend pas en charge la création de clusters si les noeuds sont composés de diverses versions de serveurs JBoss Enterprise Application. Ainsi, un cluster mixte basé sur différentes versions ne sera pas pris en charge et tous les noeuds d'un cluster devront être à la même version - 6.1.
Avertissement
Prérequis
- Aucun
Procédure 4.3. Installer un groupement de serveurs JBoss Enterprise Application dans 6.1
- Voir le chapitre HTTP Clustering and Load Balancing de JBoss Enterprise Application Platform 6.1 Adminstration and Configuration Guide pour obtenir des instructions sur la façon d'installer un groupement de serveurs JBoss Enterprise Application dans 6.1.
- Migrer tout le traffic vers ce nouveau groupement 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
Votre groupement JBoss Enterprise Application Server 6.0 a été migré vers un groupement basé sur JBoss Enterprise Application Server 6.1.
Annexe A. Informations Supplémentaires
A.1. Téléchargements disponibles dans JBoss Enterprise Application Platform 6
Tableau A.1. Téléchargements disponibles
| Nom | Description | Systèmes d'exploitation |
|---|---|---|
| Server HTTP Apache |
Une instance de serveur autonome Apache HTTP pour chaque système d'exploitation et architecture prise en charge. Ce serveur HTTP a été testé et vérifié pour fonctionner avec JBoss Enterprise Application Platform 6.
|
Red Hat Enterprise Linux 5, Red Hat Enterprise Linux 6, Microsoft Windows Server 2008, Solaris 10 et 11
|
| Composants natifs |
Composants qui ont été compilés pour être optimisés pour une plateforme particulière. Ainsi, les DLL sont fournis pour les environnements Microsoft Windows Server. Dans certains cas, les composants natifs peuvent apporter des améliorations au niveau de la performance.
|
Red Hat Enterprise Linux 5, Red Hat Enterprise Linux 6, Microsoft Windows Server 2008, Solaris 10 et 11
|
| Utilitaires natifs |
Utilitaires spécifiques à chaque système d'exploitation ou architecture, comme les scripts ou les utilitaires pour installer JBoss Enterprise Application Platform en tant que service de votre système d'exploitation et pour générer des certificats et des clés de cryptage SSL.
|
Red Hat Enterprise Linux 5, Red Hat Enterprise Linux 6, Microsoft Windows Server 2008, Solaris 10 et 11
|
| Connecteurs natifs de serveur web |
Les modules pré-compilés des serveurs web Apache, Microsoft, et Oracle iPlanet, pour l'équilibrage des charges HTTP et pour les fonctionnalités HA (haute disponiblité). Ces binaires sont testés de façon extensive et on sait qu'ils fonctionnent bien dans JBoss Enterprise Application Platform 6.
|
Red Hat Enterprise Linux 5, Red Hat Enterprise Linux 6, Microsoft Windows Server 2008, Solaris 10 et 11
|
| Javadocs |
Documentation pour tous les API publics exposés par JBoss Enterprise Application Platform 6. Vous pouvez les installer sur votre serveur local HTTP ou IDE, ou encore, vous pouvez les visualiser sur votre machine locale.
|
Platform-independent
|
| Installateur |
Programme d'installation Java pour JBoss Enterprise Application Platform 6. Inclut les étapes d'installation des Quickstarts et du référentiel Maven.
|
Platform-independent
|
| Référentiel Maven |
Un référentiel Maven, que vous pouvez télécharger et mettre à la disposition de votre environnement de développement local, et qui contient des objets communs pour les applications générées sur JBoss Enterprise Application Platform 6. Le référentiel Maven est également disponible par l'intermédiaire du programme d'installation de JBoss Enterprise Application Platform 6.
|
Platform-independent
|
| Quickstarts |
Exemples d'applications qui peuvent vous aider à démarrer pour développer des applications Java EE 6 avec des API fournis dans JBoss Enterprise Application Platform 6. Les Quickstarts sont également disponibles par l'intermédiaire du programme d'installation de JBoss Enterprise Application Platform 6.
|
Platform-independent
|
| Code source |
Le code source Java pour JBoss Enterprise Application Platform 6, fourni afin que vous puissiez le recompiler dans votre propre environnement ou le vérifier vous-même.
|
Platform-independent
|
| Plateforme d'applications |
Le package ZIP d'installation qui peut être installé et exécuté sur toutes les plates-formes prises en charge. C'est la façon la plus courante d'installer JBoss Enterprise Application Platform 6.
|
Platform-independent
|
Important
A.2. Structure de répertoire de JBoss Enterprise Application Platform 6
JBoss Enterprise Application Platform 6 inclut une structure de répertoires simplifiée, par rapport aux versions antérieures. Vous trouverez ci-dessous un listing de la structure du répertoire, et une description du contenu de chaque répertoire.
standalone/
Tableau A.2. Fichiers et répertoires de niveau supérieur
| Nom | But |
|---|---|
| appclient/ | Contient les détails de configuration pour le conteneur du client application. |
| bin/ | Contient des scripts de démarrage pour JBoss EAP sur Red Hat Enterprise Linux ou Microsoft Windows. |
| bundles/ | Contient les lots OSGi associés à la fonctionnalité interne de JBoss EAP 6. |
| docs/ | Fichers de licences, schéma, et exemples. |
| domain/ | Fichiers de configuration, contenu de déploiement, zones d'écriture, utilisés quand la plateforme JBoss EAP 6 exécute en tant que domaine géré. |
| modules/ | Les modules qui sont chargés de façon dynamique par JBoss EAP 6 quand les services les réclament. |
| standalone/ | Fichiers de configuration, contenu de déploiement, zones d'écriture utilisés quand la plateforme JBoss EAP 6 exécute en tant que domaine autonome. |
| welcome-content/ | Contient un contenu utilisé par l'application web Welcome disponible sur le port 800 comme installation par défaut. |
jboss-modules.jar
| Le mécanisme d'amorçage pour charger les modules. |
Tableau A.3. Répertoires qui contiennent le répertoire domain/.
| Nom | But |
|---|---|
| configuration/ | Les fichiers de configuration pour le domaine géré. Ces fichiers sont modifiés par la Console de gestion et le Management CLI, et ne sont pas sensés être édités directement. |
| data/ | Information sur les services déployés. Les services sont déployés par la Console de gestion et le Management CLI, et non pas par un scanner de déploiement. Donc, ne mettez pas les fichiers dans ce répertoire directement. |
| log/ | Contient les fichiers de journalisation d'exécution de l'hôte et des contrôleurs de processus qui exécutent sur l'instance locale. |
| servers/ | Contient les répertoires data/, log/, et tmp/ pour chaque instance de serveur de domaine, qui contient des données similaires aux mêmes répertoires dans le répertoire domain/ au niveau supérieur. |
| tmp/ | Contient des données temporaires sous forme de fichiers associés au mécanisme de clé partagée utilisée par le Management CLI pour authentifier les utilisateurs locaux dans le domaine partagé. |
Tableau A.4. Répertoires qui se trouvent dans le répertoire standalone/
| Nom | But |
|---|---|
| configuration/ | Les fichiers de configuration pour le domaine autonome. Ces fichiers sont modifiés par la Console de gestion et le Management CLI, et ne sont pas sensés être édités directement. |
| deployments/ | Information sur les services déployés. Le serveur autonome n'inclut pas un scanner de déploiement, donc vous pouvez mettre les archives dans un répertoire à déployer. Cependant, l'approche qui est recommandée est de gérer les déploiements par la Console de gestion et le Management CLI. |
| lib/ | Bibliothèques externes se rapportant à un mode de serveur autonome. Vide par défaut. |
| tmp/ | Contient des données temporaires sous forme de fichiers associés au mécanisme de clé partagée utilisée par le Management CLI pour authentifier les utilisateurs locaux dans le domaine. |
A.3. Liste de packages RPM pour JBoss Enterprise Application Platform 6
JBoss Enterprise Application Platform 6 peut être installée sur Red Hat Enterprise Linux 6 par l'intermédiaire du groupe de packages YUM JBoss EAP 6. Ce groupe est composé des packages suivants :
Tableau A.5. Liste de packages
| Package | Description |
|---|---|
| jbossas-appclient | JEE Application Client Container |
| jbossas-bundles | OSGi bundles |
| jbossas-core | Composants principaux. Requis pour toutes les configurations. |
| jbossas-domain | Configuration de domaine |
| jbossas-hornetq-native | Conteneur pour les fichiers JBoss AS HornetQ |
| jbossas-jbossweb-native | JBoss Enterprise Web Platform |
| jbossas-modules-eap | Modules EAP |
| jbossas-product-eap | Composants de configuration de produits. Ceci personnalise l'exécution des produits. |
| jbossas-standalone | Standalone configuration |
| jbossas-welcome-content-eap | Contenu de page de bienvenue utilisé pour les messages de démarrage et pour les pages de console. |
Important
jbossas-hornetq-native est inclus en tant que méthode d'implémentation HA dans JBoss Enterprise Application Platform 6 mais n'est activé par défaut.
A.4. Liste de packages RPM pour JBoss Enterprise Application Platform 6
L'installation RPM de JBoss Enterprise Application Platform 6 comprend trois fichiers de configuration supplémentaires pour l'installation de ZIP. Ces fichiers sont utilisés par le script d'initialisation de service pour spécifier l'environnement de lancement du serveur d'applications. Un de ces fichiers s'applique à toutes les instances de JBoss Enterprise Application Platform 6, tandis que les deux autres fournissent des substitutions pour les serveurs de mode autonome et de domaine.
Tableau A.6. Fichiers de configuration RPM supplémentaires
| Fichier | Description |
|---|---|
/etc/jbossas/jbossas.conf | Ce fichier est en lecture préalable et s'applique à toutes les instances de JBoss Enterprise Application Platform 6. |
/etc/sysconfig/jbossas | Paramètres spécifiques aux serveurs autonomes. Les valeurs spécifiées ici remplaceront celles qui se trouvent dans jbossas.conf lors de l'exécution en tant que serveur autonome. |
/etc/sysconfig/jbossas-domain | Paramètres spécifiques aux serveurs autonomes. Les valeurs spécifiées ici remplaceront celles qui se trouvent dans jbossas.conf lors de l'exécution en tant que serveur en mode de domaine. |
Tableau A.7. Propriétés de configuration d'installation RPM
| Propriété | Description |
|---|---|
JBOSS_USER |
Le compte d'utilisateur système sur lequel la plate-forme JBoss Enterprise Application Platform 6 exécute. Cet utilisateur est également propriétaire des fichiers.
Valeur par défaut :
jboss
|
JBOSS_GROUP |
Le groupe d'utilisateurs du système auquel les fichiers de JBoss Entrprise Application Platform 6 appartiennent.
Valeur par défaut :
jboss
|
JBOSS_STARTUP_WAIT |
Le nombre de secondes pendant lesquelles le script init attendra avant de confirmer que le serveur a été lancé avec succès après avoir reçu la commande
start ou restart.
Valeur par défaut :
60
|
JBOSS_SHUTDOWN_WAIT |
Le nombre de secondes pendant lesquelles le script init attendra que le serveur se ferme avant de continuer, après avoir reçu la commande
start ou restart.
Valeur par défaut :
20
|
JBOSS_CONSOLE_LOG |
Le fichier vers lequel le Log Handler de la CONSOLE sera redirigé.
Valeur par défaut :
/var/log/jbossas/$JBOSSCONF/console.log
|
JAVA_HOME |
Le répertoire dans lequel le Java Runtime Environment est installé.
Valeur par défaut :
/usr/lib/jvm/jre
|
JBOSS_HOME |
Le répertoire dans lequel les fichiers du serveur d'application sont installés.
Valeur par défaut :
/usr/share/jbossas
|
JAVAPTH |
Le chemin d'accès où les fichiers Java exécutables sont installés.
Valeur par défaut :
$JAVA_HOME/bin
|
JBOSSCONF |
Le mode de serveur dans lequel démarrer ce serveur,
standalone (autonome) or domain (domaine).
Valeur par défaut:
standalone (autonome) ou domain (domaine) suivant le mode de serveur.
|
JBOSSSH |
Le script utilisé pour démarrer dans un serveur
Valeur par défaut:
$JBOSS_HOME/bin/$JBOSSCONF.sh
|
JBOSS_SERVER_CONFIG |
Le fichier de configuration de serveur à utiliser.
Il n'y a pas de valeur par défaut pour cette propriété. Vous pouvez définir
standalone.xml ou domain.xml au départ.
|
| JBOSS_HOST_CONFIG | Cette propriété autorise un utilisateur à spécifier la configuration de l'hôte (comme host.xml). Elle ne possède pas de valeur par défaut. |
Annexe B. Revision History
| Historique des versions | |||
|---|---|---|---|
| Version 1.1-20 | Thu Jul 11 2013 | Russell Dickenson | |
| |||