3.9.3. Konfiguration der JBoss EAP 6 als Dienst im Microsoft Windows Server (Zip, Installer)

Prozedur 3.19. Konfigurieren Sie einen Dienst für die JBoss EAP 6 im Microsoft Windows Server

1. Erstellen Sie System-Umgebungsvariablen

   Erstellen Sie zwei System-Umgebungsvariablen:
   • JBOSS_HOME auf das JBoss EAP 6 Installationsverzeichnis weisend.
   • NOPAUSE=1

2. Falls nicht bereits konfiguriert, laden Sie das native Dienstprogrammpaket für Ihre Architektur herunter und extrahieren Sie es.

   Falls das native Dienstprogramm für Windows Server Paket nicht als Teil der JBoss EAP 6 Installation installiert wurde, laden Sie das relevante 32-bit- oder 64-bit-Paket vom Red Hat Kundenportal unter https://access.redhat.com herunter. Extrahieren Sie das Zip-Archiv des nativen Dienstprogramms über der JBoss EAP 6 Installation.
   Dies resultiert in einem native-Verzeichnis am folgenden Speicherort in der JBoss EAP 6 Installation: EAP_HOME\modules\system\layers\base\

3. Installieren Sie den Dienst

   Öffnen Sie eine Befehlszeile, und ändern Sie Verzeichnisse zu EAP_HOME\modules\system\layers\base\native\sbin
   Ein neuer Dienst kann mit dem Befehl service install erstellt werden, wobei Sie die verfügbaren Optionen in der nachfolgenden Tabelle finden:

   Tabelle 3.3. service install-Optionen

   Argument oder Switch	Beschreibung
   /startup	Zeigt den automatischen Start der Dienste an. Falls nicht festgelegt, so ist der Dienst auf den manuellen Start eingestellt
   /controller HOST:PORT	Der Host und Port des Management Interface. Falls weggelassen, so lautet der Standard localhost:9999.
   /host [DOMAIN_HOST]	Zeigt an, dass der Domain Modus verwendet werden soll, wobei die Festlegung des Namens des Domain Controllers optional ist. Wird der Name des Domain Controllers weggelassen, so lautet der Standardname master.
   /loglevel LEVEL	Die Protokollebene für den Dienst, entweder: ERROR, INFO, WARN oder DEBUG. Falls weggelassen, so lautet der Standard INFO
   /name SERVICE_NAME	Der Name des Dienstes der erstellt werden soll, darf keine Leerstellen enthalten. Falls weggelassen, lautet der Standard JBossEAP6
   /desc "DESCRIPTION"	Die Beschreibung des Dienstes. Falls weggelassen, lautet der Standard "JBoss Enterprise Application Platform 6"
   /serviceuser DOMAIN\USERNAME	Legt den Namen des Kontos fest, unter dem der Dienst laufen wird. Verwenden Sie einen Kontonamen im Format DOMAIN\USERNAME. Falls weggelassen, so läuft der Dienst als Local System Konto.
   /servicepass PASSWORD	Passwort für /serviceuser Konto.
   /jbossuser USERNAME	Optional; der JBoss EAP 6 Benutzername, der für den Shutdown-Befehl verwendet wird.
   /jbosspass PASSWORD	Passwort für /jbossuser Konto, erforderlich wenn /jbossuser festgelegt ist.
   /config XML_FILE	Legt die zu verwendende server-config fest. Der Standard lautet standalone.xml oder domain.xml.
   /hostconfig XML_FILE	Legt die zu verwendende Host-Konfiguration für den Domain-Modus fest (nur für diesen). Die Standardeinstellung lautet host.xml.
   /base directory	Legt das Basisverzeichnis für server/domain-Inhalte als vollständig angegebenen Pfad an. Der Standard ist %JBOSS_HOME%\standalone oder %JBOSS_HOME%\domain.
   /logpath path	Legt den Pfad der protokolldateien fest. /base gilt, wenn /logpath nicht definiert ist. Der Standard ist abhängig davon, ob der Domain-Modus oder der Standalone-Modus definiert ist, %JBOSS_HOME%\domain\log oder %JBOSS_HOME%\standalone\log.
   /debug	Führt die Installation des Dienstes im Fehlerbehebungsmodus aus.

   Nachfolgend sehen Sie einige einfache Beispiele eines install-Befehls zur Erstellung eines neuen Dienstes im Standalone- oder Domain-Modus. Führen Sie den folgenden Befehl aus, wobei Sie je nach Anforderung die Protokollebene des Dienstes anpassen:
   • Standalone-Modus:

     service.bat install /loglevel INFO

   • Domain-Modus:
     Falls Sie nicht den Standard-Master für Ihren JBoss EAP 6 Domain Controller verwenden, ersetzen Sie master durch den korrekten Hostnamen oder Alias des JBoss EAP 6 Domain Controllers.

     service.bat install /host master /loglevel INFO

   Ein neuer Windows- mit dem Namen JBossEAP6 wird erstellt.

4. Verifizieren Sie den neuen Dienst in der Services-Konsole

   Führen Sie den folgenden Befehl in einem Terminal aus, um die Windows Services-Konsole zu öffnen:

   services.msc

   Wurde der standardmäßige Dienstname in der Liste der Windows-Dienste verwendet, so lautet der angezeigte Name des neuen Dienstes: JBossEAP6. Sie können den Dienst von der Services-Konsole starten und stoppen sowie die Einstellungen dazu ändern, wie und wann er gestartet wird.

5. Starten und Beenden des JBoss EAP 6 Dienstes von einem Terminal

   Um den Dienst von einem Terminal aus zu starten, verwenden Sie den folgenden Befehl, wobei Sie den Dienstnamen falls notwendig ändern:

   net start JBossEAP6

   Um den Dienst von einem Terminal aus zu stoppen, verwenden Sie den folgenden Befehl, wobei Sie den Dienstnamen falls notwendig ändern:

   net stop JBossEAP6

Prozedur 3.20. Deinstallation des JBoss EAP 6 Dienstes vom Microsoft Windows Server

• Falls der Dienst läuft, öffnen Sie zuerst ein Terminal und stoppen Sie den Dienst, indem Sie den Befehl net stop mit dem Namen des Dienstes ausführen:

  net stop JBossEAP6

  Öffnen Sie eine Befehlszeile, ändern Sie Verzeichnisse zu EAP_HOME\modules\system\layers\base\native\sbin und führen Sie den folgenden Befehl aus:

  service uninstall