3.9.3. Configurer JBoss EAP 6 en tant que service dans Microsoft Windows Server (Zip, Installer)

Procédure 3.19. 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 3.3. Options service install

   Argument ou Option	Description
   /startup	Indique les services en auto-start. Si non spécifié, le service est défini en démarrage manuel par défaut.
   /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é.
   /config XML_FILE	Indique le server-config à utiliser. La valeur par défaut est standalone.xml ou domain.xml.
   /hostconfig XML_FILE	Indique l'hôte à utiliser en mode Domaine uniquement. La valeur par défaut est host.xml.
   /base directory	Indique le répertoire de base pour le contenu du serveur/domaine sous forme de chemin d'accés complet %JBOSS_HOME%\standalone ou %JBOSS_HOME%\domain.
   /logpath path	Indique le chemin des fichiers de journalisation. /base s'applique quand le /logpath n'est pas défini. La valeur par défaut dépend si on est en mode de domaine ou en mode autonome, %JBOSS_HOME%\domain\log ou %JBOSS_HOME%\standalone\log.
   /debug	Exécute l'installation du service en mode de débogage.

   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: JBossEAP6. 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 3.20. 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