Chapitre 3. Installer JBoss EAP

Télécharger le fichier ZIP de JBoss EAP

1. Ouvrez un navigateur et connectez-vous au Portail Client Red Hat à l'adresse suivante https://access.redhat.com.
2. Cliquez sur Téléchargements.
3. Cliquez sur Red Hat JBoss Enterprise Application Platform dans la liste des Téléchargements de produits.
4. Sélectionnez la version correcte de JBoss EAP dans le menu déroulant Version.
5. Trouvez Red Hat JBoss Enterprise Application Platform 7.x.x dans la liste et cliquez sur le lien Télécharger.

1. Si nécessaire, déplacez le fichier ZIP sur le serveur et l'emplacement sur lequel JBoss EAP doit être installé.

   • L'utilisateur qui exécutera JBoss EAP doit avoir accès en lecture et en écriture à ce répertoire.

2. Veuillez extraire l'archive ZIP.

   $ unzip jboss-eap-7.x.x.zip

   Note

   Pour le serveur Windows, effectuez un clic droit sur le fichier ZIP et sélectionnez Tout extraire.

Télécharger le programme d'installation JBoss EAP

1. Ouvrez un navigateur et connectez-vous au Portail Client Red Hat à l'adresse suivante https://access.redhat.com.
2. Cliquez sur Téléchargements.
3. Cliquez sur Red Hat JBoss Enterprise Application dans la liste des Téléchargement de produits.
4. Sélectionnez la version correcte de JBoss EAP dans le menu déroulant Version.
5. Trouvez le programme d'installation de Red Hat JBoss Enterprise Application 7.x.x dans la liste et cliquez sur le lien Télécharger.

Exécuter le programme d'installation graphique JBoss EAP

1. Ouvrir une session de terminal et rendez-vous sur le répertoire contenant le fichier JAR du programme d'installation JBoss EAP.

2. Exécutez le programme d'installation graphique en utilisant la commande suivante :

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

   Note

   Sur les environnements Hewlett-Packard HP-UX ou Solaris, il est possible de spécifier l'architecture requise en utilisant l'option -d32 ou -d64. Lancez le programme d'installation en exécutant l'une des commandes suivantes :

   java -jar -d32 jboss-eap-7.x.x-installer.jar

   ou

   java -jar -d64 jboss-eap-7.x.x-installer.jar

3. Veuillez appliquer les instructions situées dans le tableau ci-dessous.

   Tableau 3.1. Écrans du programme d'installation JBoss EAP

   Nom de l'écran	Apparition	Description
   Sélection de la langue	Toujours	Choisissez la langue souhaitée pour le programme d'installation, puis cliquez sur Valider.
   Contrat de licence	Toujours	EULA pour RED HAT JBOSS MIDDLEWARE. Sélectionnez « I accept the terms of this license agreement » (J'accepte les conditions de ce contrat de licence), puis cliquez sur Suite.
   Chemin d'accès de l'installation	Toujours	Sélectionnez le chemin d'accès de l'installation pour JBoss EAP, puis cliquez sur Suite.
   Sélection des composants	Toujours	Sélectionnez les composants à installer. La dé-sélection des composants requis n'est pas autorisée.
   	Figure 3.1. Programme d'installation JBoss EAP - Écran de sélection des composants
   Création de l'utilisateur Admin	Toujours	Créer un utilisateur administratif et lui assigner un mot de passe. Puis, cliquer sur Next.
   Vue d'ensemble de l'installation	Toujours	Examinez vos options d'installation, puis cliquez sur Suite.
   Installation des composants	Toujours	Lorsque la progressions de l'installation se termine, cliquez sur Suite.
   Configurez l'environnement d'exécution	Toujours	Il est possible de choisir une configuration par défaut pour votre installation JBoss EAP, ou de choisir d'effectuer une configuration avancée avec le programme d'installation. Remarquez que même si vous choisissez une configuration par défaut, vous pourrez toujours altérer la configuration en utilisant les interfaces de gestion JBoss EAP ultérieurement. Sélectionnez Appliquer une configuration par défaut, ou Appliquer une configuration avancée et sélectionnez les éléments à configurer, puis cliquez sur Suite.
   	Figure 3.2. Programme d'installation JBoss EAP - Écran de configuration de l'environnement d'exécution
   Configurer un fichier d'archivage de sécurité de mots de passe	Si vous choisissez d'installer un fichier d'archivage de sécurité de mots de passe dans la configuration avancée de l'environnement d'exécution.	Configurez un fichier d'archivage de sécurité de mots de passe pour stocker tous vos mots de passe importants dans unkeystore chiffré, puis cliquez sur Suite. Pour obtenir davantage d'informations, veuillez consulter la documentation sur le fichier d'archivage de sécurité de mots de passe dans le guide Comment configurer la sécurité du serveur.
   	Figure 3.3. Programme d'installation JBoss EAP - Écran de configuration du fichier d'archivage de sécurité de mots de passe
   Sécurité SSL	Si vous choisissez d'activer la sécurité SSL dans la configuration avancée de l'environnement d'exécution.	Spécifiez un keystore SSL et le mot de passe du keystore pour sécuriser les interfaces de gestion JBoss EAP, puis cliquez sur Suite. Pour obtenir davantage d'informations, veuillez consulter la documentation pour sécuriser les interfaces de gestion dans le guide Comment configurer la sécurité du serveur. Avertissement Red Hat recommande de désactiver SSLv2, SSLv3, et TLSv1.0 explicitement en faveur de TLSv1.1 ou TLSv1.2 dans tous les paquets affectés.
   Configuration LDAP	Si vous choisissez d'activer l'authentification LDAP dans la configuration avancée de l'environnement d'exécution.	Permettre à l'authentification LDAP d'utiliser un serveur de répertoire LDAP comme source d'authentification pour la console de gestion, l'interface CLI, et l'API de gestion. Quand vous aurez terminé, cliquer sur Suite. Pour plus d'informations, voir la documentation LDAP dans le guide Comment configurer la gestion des identités.
   	Figure 3.4. Programme d'installation JBoss EAP - Écran de configuration LDAP
   Configuration du domaine de sécurité LDAP	Si vous choisissez d'activer l'authentification LDAP dans la configuration avancée de l'environnement d'exécution.	Une nouveau domaine de sécurité sera créé et associé aux interfaces de gestion en utilisant la connexion LDAP définie dans l'étape précédente. Spécifiez les valeurs de votre environnement LDAP, puis cliquez sur Suite. Pour obtenir davantage d'informations, veuillez consulter la documentation LDAP dans le guide Comment configurer la gestion des identités.
   	Figure 3.5. Programme d'installation JBoss EAP - Écran de configuration du domaine de sécurité LDAP
   Configuration Infinispan	Si vous choisissez d'installer un cache Infinispan dans la configuration avancée de l'environnement d'exécution.	Créez un cache d'Infinispan pour la gestion des données en mémoire cache. Donnez un nom Infinispan, configurez les autres champs et cliquez sur Suite. Pour plus d'informations, voir : documentation Infinispan dans le Guide de configuration.
   	Figure 3.6. Programme d'installation JBoss EAP - Écran de configuration Infinispan
   Configuration du domaine de sécurité	Si vous choisissez d'ajouter un domaine de sécurité dans la configuration avancée de l'environnement d'exécution.	Configurez un domaine de sécurité pour l'instance de serveur JBoss EAP. La plupart des champs sont déjà remplis par des valeurs par défaut et ne nécessitent aucune modification. Lorsque vous aurez terminé, cliquez sur Suite. Pour obtenir davantage d'informations, veuillez consulter les Domaines de sécurité dans le Guide d'architecture de sécurité.
   	Figure 3.7. Programme d'installation JBoss EAP - Écran de configuration du domaine de sécurité
   Configuration JSSE	Si vous choisissez d'ajouter un domaine de sécurité dans la configuration avancée de l'environnement d'exécution.	Configurez JSSE (« Java Secure Socket Extension ») pour le domaine de sécurité défini dans l'étape précédente, en utilisant un keystore ou un truststore. Une fois terminé, veuillez cliquer sur Suite.
   	Figure 3.8. Programme d'installation JBoss EAP - Écran de configuration JSSE
   Quickstarts	Si vous choisissez d'installer des quickstarts dans la configuration avancée de l'environnement d'exécution.	Sélectionnez le chemin d'accès de l'installation du quickstart, puis cliquez sur Suivant.
   Installation du référentiel Maven	Si vous choisissez d'installer des quickstarts dans la configuration avancée de l'environnement d'exécution.	Sélectionnez le référentiel Maven et le fichiers des paramètres.
   	Figure 3.9. Programme d'installation JBoss EAP - Écran d'installation du référentiel Maven
   Liaisons de sockets	Si vous choisissez de configurer les liaisons de ports du serveur dans la configuration avancée de l'environnement d'exécution.	Déterminez si l'installation utilisera les liaisons de ports par défaut, configurez les décalages de ports pour toutes les liaisons par défaut, ou configurez les liaisons de port personnalisées. Si vous choisissez de configurer les décalages de ports, sélectionnez le chiffre du décalage. Si vous choisissez de configurer les liaisons personnalisées, sélectionnez de configurer les ports pour le mode autonome, le mode de domaine, ou pour les deux. Si l'hôte est configuré pour IPv6 uniquement, sélectionnez la case à cocher Activer la configuration IPv6 pure et le programme d'installation effectuera les changements de configuration requis. Cliquez sur Suivant.
   	Figure 3.10. Programme d'installation JBoss EAP - Écran des liaisons de sockets
   Liaisons de sockets personnalisées pour configurations autonomes	Si vous choisissez de configurer les liaisons de ports personnalisées en mode autonome.	Configurez les ports et les propriétés système pour chacune des configurations autonomes (standalone, standalone ha, standalone full, standalone full-ha), puis cliquez sur Suivant.
   	Figure 3.11. Programme d'installation JBoss EAP - Écran des liaisons de sockets personnalisées pour configurations autonomes
   Liaisons de sockets personnalisées pour configurations de domaine	Si vous décidez de configurer les liaisons de port personnalisées en mode de domaine.	Configurez les ports et les propriétés système pour la configuration de l'hôte (domain host) et pour chaque profil de domaine (domain default, domain ha, domain full, domain full-ha), puis cliquez sur Suivant.
   	Figure 3.12. Programme d'installation JBoss EAP - Écran des liaisons de sockets personnalisées pour configurations de domaines
   Options de journalisation	Si vous choisissez de configurer les niveaux de journalisation dans la configuration avancée de l'environnement d'exécution.	Sélectionnez les niveaux de journalisation souhaités, puis cliquez sur Suivant.
   Installation du pilote JDBC	Si vous choisissez d'installer un pilote JDBC dans la configuration avancée de l'environnement d'exécution.	Installer et paramétrer un pilote JDBC. Choisissez le fournisseur de pilotes approprié dans la liste déroulante et spécifiez l'emplacement (ou les emplacements) JAR du pilote. Lorsque vous aurez terminé, veuillez cliquer sur Suivant. Pour obtenir davantage d'informations, veuillez consulter la section du pilote JDBC datasource dans le Guide de configuration.
   	Figure 3.13. Programme d'installation JBoss EAP - Écran d'installation du pilote JDBC
   Installation de la source de données	Si vous choisissez d'installer un pilote JDBC et une source de données dans la configuration avancée de l'environnement d'exécution.	Configurer une source de données qui puisse être utilisée par les applications. Fournir un nom de source de données et configurer les autres options, puis cliquer sur Suivant. Pour plus d'informations, voir gestion des sources de données dans le Guide de configuration.
   	Figure 3.14. Programme d'installation JBoss EAP - Écran d'installation de la source de données
   Configurer le serveur	Toujours	Lorsque la progression de la configuration se sera terminée, veuillez cliquer sur Suivant.
   Configuration des raccourcis	Toujours	Sélectionnez la case à cocher Créer des raccourcis dans le menu de démarrage pour créer des raccourcis. Seuls les caractères alphanumériques, comme le tiret (-) et le trait de soulignement (_) sont autorisés. Sur Microsoft Windows, la barre oblique (/) et la barre oblique inversée (\) sont également autorisées. Veuillez cliquer sur Suivant.
   Installation terminée	Toujours	Cliquez sur Générer le script d'installation et le fichier des propriétés si vous souhaitez capturer les options d'installation actuellement sélectionnées pour une installation automatisée, puis cliquez sur Terminé. L'installation est désormais terminée. Le répertoire créé par l'installateur est le répertoire du niveau le plus élevé du serveur. Celui-ci est nommé EAP_HOME.

Exécuter le programme d'installation JBoss EAP basé texte

1. Ouvrez un terminal et rendez-vous sur le répertoire contenant le JAR téléchargé du programme d'installation JBoss EAP.

2. Exécutez le programme d'installation basé texte en utilisant la commande suivante :

   java -jar jboss-eap-7.x.x-installer.jar -console

3. Veuillez suivre les instructions pour installer JBoss EAP. Le répertoire créé par l'installateur est le répertoire du niveau le plus élevé du serveur. Celui-ci est nommé EAP_HOME.

1. Installer JBoss EAP à partir du référentiel auquel vous êtes abonné en utilisant la commande suivante :

   yum groupinstall jboss-eap7

Changez de référentiel JBoss EAP

1. Avant de changer de référentiel, veillez à ce que l'installation JBoss EAP ait bien toutes les mises à jour applicables :

   yum update

2. À l'aide du Red Hat Subscription Manager, vous désabonner du référentiel existant, et abonnez-vous au nouveau référentiel que vous souhaitez modifier. Dans la commande ci-dessous, remplacer EXISTING_REPOSITORY et NEW_REPOSITORY par les noms de référentiels respectifs.

   subscription-manager repos --disable=EXISTING_REPOSITORY --enable=NEW_REPOSITORY

Installation automatisée sans assistance du programme d'installation à l'aide d'un fichier de variables

1. Ouvrez le fichier .variables dans un éditeur de texte et fournissez une valeur de mot de passe pour chaque clé. Par exemple :

   adminPassword = password#2
   vault.keystorepwd = vaultkeystorepw
   ssl.password = user12345

2. Exécutez le programme d'installation en utilisant le fichier XML du script d'installation automatique. Le programme d'installation détecte le fichier des variables automatiquement si le fichier des variables complet se trouve dans le même répertoire que le fichier XML du script d'installation et si son nom de fichier n'a pas été modifié.

   java -jar jboss-eap-7.x.x-installer.jar auto.xml
   
   Checking for corresponding .variables file
   Variables file detected: auto.xml.variables
   [ Starting automated installation ]
   ...

   Alternativement, vous pouvez spécifier le chemin du fichier des variables en utilisant -variablefile :

   java -jar jboss-eap-7.x.x-installer.jar auto.xml -variablefile auto.xml.variables

Installation automatisée sans assistance du programme d'installation à l'aide de l'argument -variables

1. Exécutez le programme d'installation en utilisant le fichier XML du script d'installation automatique, et spécifiez les mots de passe requis en tant que paires clés/valeurs en utilisant l'argument -variables. Par exemple :

   java -jar jboss-eap-7.x.x-installer.jar auto.xml -variables adminPassword=password#2,vault.keystorepwd=vaultkeystorepw,ssl.password=user12345

   Note

   Il est important que vous n'ayez pas d'espaces lorsque vous spécifiez les paires clés/valeurs -variables.