3.9.3. Configurer JBoss EAP 6 en tant que service dans Microsoft Windows Server (Zip, Installer)
Conditions préalables
- Installer la Plateforme JBoss EAP 6 par les méthodes Zip, Texte, Installateur graphique.
- Les privilèges administrateurs sont requis sur le serveur.
- La variable système d'environnement
JAVA_HOME
doit être définie. - L'instance de serveur JBoss EAP 6 ne doit pas être en cours d'exécution.
Important
set
à une invite de commande du serveur Windows ne fixera pas la variable d'environnement de façon permanente. Vous devez utiliser la commande setx
, ou l'interface du System dans le Control Panel (Panneau de configuration).
Utiliser les procédures suivantes pour configurer JBoss EAP 6 en tant que service sur serveur Microsoft Windows.
Procédure 3.19. Configurer un service de JBoss EAP 6 sur serveur Microsoft Windows.
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
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épertoirenative
dans l'emplacement suivant, dans l'installation JBoss EAP 6:EAP_HOME\modules\system\layers\base\
Installer le service
Ouvrir un terminal, et changer de répertoireEAP_HOME\modules\system\layers\base\native\sbin
Vous pourrez créer un nouveau service par la commandeservice 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 estlocalhost: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 estmaster
./loglevel LEVEL Niveau de journalisation du service, soit:ERROR
,INFO
,WARN
ouDEBUG
. S'il ne figure par, la valeur par défaut seraINFO
/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 seraJBossEAP6
./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 eststandalone.xml
oudomain.xml
./hostconfig XML_FILE Indique l'hôte à utiliser en mode Domaine uniquement. La valeur par défaut esthost.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 commandeinstall
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 nomJBossEAP6
.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.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
Un service JBoss EAP est alors configuré dans le serveur Microsoft Windows.
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épertoireEAP_HOME\modules\system\layers\base\native\sbin
et exécuter la commande suivante :service uninstall
Le service JBoss EAP 6 a été supprimé du serveur Microsoft Windows.