[Windows][Linux]

Befehl WASService

Mit dem Befehlszeilentool WASService können Sie einen Dienst für einen Java™-Prozess des Produkts auf Linux- und Windows-Betriebssystemen erstellen.

Sie können Dienste für Java-Prozesse in WebSphere Application Server erstellen. Zu den potenziellen Diensten gehören die folgenden Serverprozesse:
  • Standardprozess server1 auf einem Anwendungsserverknoten
  • Anwendungsserverprozesse, die Sie auf einem Anwendungsserverknoten erstellen
  • Prozess nodeagent auf einem Anwendungsserverknoten, der zu einer Deployment-Manager-Zelle gehört
  • Deployment-Manager-Prozess dmgr
[Windows]Anmerkung: Fügen Sie keinen Anwendungsserver, der zu einem eingebundenen oder verwalteten Knoten gehört, als Windows-Dienst hinzu. Verwenden Sie den Node Agent, um eingebundene Knoten zu verwalten.
Fehler vermeiden Fehler vermeiden: Als Alternative zum Befehl WASService können Sie das Dienstprogramm "WASServiceHelper" verwenden, das den Befehl WASService ergänzt und potenzielle Konfigurationsfehler reduziert. Weitere Informationen finden Sie in der Dokumentation zur Verwendung von WASServiceHelper für das Erstellen von Windows-Diensten.gotcha
[Windows]Zum Konfigurieren und Ausführen dieser Funktion auf einem System mit Microsoft Windows muss der Benutzer zur Administratorgruppe gehören und die folgenden erweiterten Benutzerberechtigungen besitzen:
  • Einsetzen als Teil des Betriebssystems
  • Als Dienst anmelden

Position der Befehlsdatei

[Linux]Die Befehlsdatei wasservice.sh befindet sich im Verzeichnis Stammverzeichnis_des_Anwendungsservers\bin.

[Windows]Die Befehlsdatei WASService.exe befindet sich im Verzeichnis Stammverzeichnis_des_Anwendungsservers\bin.

Befehlssyntax

Befehlssyntax für das Starten eines vorhandenen Dienstes

Der Befehl hat die folgende Syntax:

[Linux]
wasservice.sh -start Dienstname [optional startServer.bat parameters] 
[Windows]
WASService.exe -start Dienstname [optional Parameter für startServer.bat]

Befehlssyntax für das Erstellen eines Dienstes oder Aktualisieren eines vorhandenen Dienstes

Der Befehl hat die folgende Syntax:

[Linux]
wasservice.sh -add Dienstname
   -serverName  Servername    -profilePath Verzeichnis_für_Serverprofil
   [-wasHome  Stammverzeichnis_des_Anwendungsservers]
   [-startArgs weitere_Startargumente]
   [-stopArgs weitere_Stoppargumente]
   [-userid Benutzer-ID -password Kennwort]
        
[Linux]Anmerkung: Verwenden Sie für WebSphere Application Server Version 7.0 und höher nicht das Zeichen "@" als Präfix in der Benutzer-ID bei der Angabe von wasservice.sh. Die Verwendung des Zeichens "@" als Präfix in der Benutzer-ID für wasservice.sh gilt nur für WebSphere Application Server Version 6.1.

wasservice.sh darf in Version 7.0 und höher nicht mit -userid @myuser angegeben werden.

[Windows]
WASService.exe -add Dienstname
   -serverName  Servername    -profilePath Verzeichnis_für_Serverprofil
   [-wasHome  Stammverzeichnis_des_Anwendungsservers]
   [-configRoot Verzeichnis_für_Konfigurationsrepository]
   [-startArgs weitere_Startargumente]
   [-stopArgs weitere_Stoppargumente]
   [-userid Benutzer-ID -password Kennwort]
   [-logFile Protokolldatei_des_Dienstes]
   [-logRoot Verzeichnis_für_Serverprotokoll]
   [-restart true | false]
   [-startType automatic | manual | disabled]
      
Fehler vermeiden Fehler vermeiden: Obwohl der Parameter -logroot optional ist, sollte dieser optionale Parameter in den Befehl aufgenommen werden. Wenn Sie diesen optionalen Parameter nicht angeben, kann in einigen Fällen ein Fehler im Ereignisprotokoll angezeigt werden, der angibt, dass der Anwendungsserver versucht, einen Dienst mit dem Parameter -logroot zu erstellen.gotcha

Befehlssyntax für das Löschen eines Dienstes

Der Befehl hat die folgende Syntax:

[Linux]
wasservice.sh -remove Dienstname
[Windows]
WASService.exe -remove Dienstname

Befehlssyntax für das Stoppen eines Dienstes

Der Befehl hat die folgende Syntax:

[Linux]
wasservice.sh -stop Dienstname [optional stopServer.bat parameters]
[Windows]
WASService.exe -stop Dienstname [optional Parameter für stopServer.bat]

Befehlssyntax für das Abrufen des Dienststatus

Der Befehl hat die folgende Syntax:

[Linux]
wasservice.sh -status Dienstname
[Windows]
WASService.exe -status Dienstname

Erforderliche Parameter

Die folgenden Parameter müssen mit diesem Befehl angegeben werden:

-profilePath Verzeichnis_für_Serverprofil
Geben Sie mit dieser Option den Verzeichnispfad des Profils an, das den Serverprozess definiert.
-serverName Servername
Geben Sie mit dieser Option den Server an, der vom Dienst gesteuert wird.

Optionale Parameter

Die folgenden Parameter sind für diesen Befehl optional:

-add Dienstname
Verwenden Sie diese Option, um einen Dienst mit dem Namen Dienstname zu erstellen oder einen vorhandenen Dienst zu aktualisieren. Die Syntax ist in beiden Fällen dieselbe.
-configRoot Konfigurationsrepository-Verzeichnis (nur Windows)
Verwenden Sie diese Option, um das Konfigurationsverzeichnis des Installationsstammverzeichnisses eines WebSphere Application Server-Produkts anzugeben.
-encodeParams Dienstname (nur Windows)
Verwenden Sie diese Option, um den den Dienst anzuweisen, die Argumente -startArgs und -stopArgs zu verschlüsseln, damit die Argumente nicht durch Editieren der Registry ermittelt werden können. Verwenden Sie den Parameter, wenn Sie einen Dienst mit dem Parameter -add erstellen. Geben Sie den Parameter -encodeParams in der Befehlszeile ohne Argumente an.
[Windows]Verwenden Sie folgende Eingabe, um die Parameter eines vorhandenen Dienstes zu verschlüsseln:
WASService -encodeParams Dienstname
-logFile Dienstprotokolldatei (nur Windows)
Verwenden Sie diese Option, um eine Protokolldatei anzugeben, die vom Befehl WASService aufgezeichnet wird.
Fehler vermeiden Fehler vermeiden: Achten Sie darauf, die Serviceprotokolldatei als vollständig qualifizierten Namen mit einem eindeutigen Pfad anzugeben. Wenn Ihr System mehrere Instanzen hat, sind ohne diese Qualifikation unvorhersehbare Ergebnisse zu erwarten und WASService kann nicht feststellen, wann die Initialisierung abgeschlossen ist. gotcha
-logRoot Serverprotokollverzeichnis (nur Windows)
Verwenden Sie diese Option, um das Serverprotokollverzeichnis für das Profil anzugeben. Der Befehl WASService sucht eine Datei mit dem Namen Servername.pid, um festzustellen, ob der Server aktiv ist.
-remove Dienstname
Verwenden Sie diese Option, um den angegebenen Dienst zu löschen.
-restart true | false (nur Windows)
Geben Sie mit diesem Parameter an, ob der vorhandene Dienst nach Auftreten eines Fehlers automatisch erneut gestartet werden soll. Der vorhandene Dienst wird nicht automatisch erneut gestartet, wenn Sie den Wert "false" angeben. Standardmäßig ist "restart" auf "true" gesetzt, wodurch der vorhandene Dienst in die Lage versetzt wird, im Falle eines Fehlers automatisch erneut zu starten.
-start Dienstname [optionale Parameter für startServer.bat]
Verwenden Sie diese Seite, um den vorhandenen Dienst zu starten.
-startArgs weitere_Startargumente
Verwenden Sie diese Option, um weitere Parameter anzugeben.
-startType automatic | manual | disabled (nur Windows)
Verwenden Sie diese Option, um den Starttyp für den neuen Dienst zu definieren. Bei Auswahl der Start "automatic" wird der Dienst automatisch gestartet, wenn der Dienst zum ersten Mal aufgerufen wird. Ein manueller Dienst muss gestartet werden, damit das Betriebssystem ihn laden und bereitstellen kann. Ein inaktivierter Dienst kann erst nach Änderung des Starttyps gestartet werden. Der Wert für diesen Parameter ist standardmäßig auf manual (manuell) gesetzt.
-status Dienstname
Verwenden Sie diese Option, um den aktuellen Dienststatus zurückzugeben, der angibt, ob der Dienst aktiv ist oder gestoppt wurde.
-stop Dienstname [optionale Parameter für stopServer.bat]
Verwenden Sie diese Option, um den angegebenen Dienst zu stoppen.
-stopArgs zusätzliche_Stoppargumente
Verwenden Sie diese Option, um weitere Parameter anzugeben.
-userid Benutzer-ID -password Kennwort
Verwenden Sie diese Option, um eine privilegierter Benutzer-ID und ein privilegiertes Kennwort anzugeben, mit denen der Windows-Dienst ausgeführt werden soll.
-wasHome Stammverzeichnis_des_Anwendungsservers
Verwenden Sie diese Option, um das Installationsstammverzeichnis des Produkts anzugeben.
Anmerkung: Die folgenden Parameter gelten nur für Windows:
  • -configRoot
  • -encodeParams
  • -logFile
  • -logRoot
  • -restart
  • -startType
Als Alternative für die Protokollierung und das Auslösen von Fehlern unter Linux ist die Verwendung des Standardwerts des Systems, sysvinit, für die Ausführung des normalen Scripts startServer.sh.
Vorsicht:
Nicht erkannte Parameter werden ignoriert.

Standardnamen für Dienste, die vom Assistenten erstellt werden

Die Namen der Dienste, die das Profile Management Tool erstellen kann, sind:
Deployment Manager
IBM WebSphere Application Server V9.x - Knotenname_des_Deployment-Manager-Knotens
Anwendungsserver
IBM WebSphere Application Server V9.x - Knotenname_des_Knotens_von_server1
Angepasstes Profil
Nachdem Sie den Knoten eingebunden und einen Anwendungsserver erstellt haben, können Sie einen Dienst mit dem Namen IBM WebSphere Application Server V9.x - Knotenname_des_verwalteten_Knotens erstellen.

Nach dem Erstellen eines angepassten Profils müssen Sie den Knoten einbinden, um einen Node-Agent-Server auf dem Knoten zu erstellen. Anwendungsserverprozesse für den Knoten können auch mit der Administrationskonsole des Deployment Manager erstellt werden. Sie können einen Windows-Dienst für den Node-Agent-Serverprozess erstellen.

Ein Node-Agent-Server wird auch erstellt, wenn ein Anwendungsserverknoten einer Deployment-Manager-Zelle hinzugefügt wird. Sie können einen Dienst für den Node-Agent-Serverprozess erstellen. Dies wird später beschrieben.

Anzeige "Dienste" aufrufen

Wenn Sie die Dienste anzeigen möchten, öffnen Sie die Systemsteuerung, und klicken Sie anschließend auf Verwaltung > Dienste. Wählen Sie einen Dienst aus, um Informationen zu diesem Dienst anzuzeigen. Klicken Sie mit der rechten Maustaste auf den Dienst, und klicken Sie dann auf Eigenschaften. Die Informationen zu dem Dienst und seiner Funktionalität werden auf vier Registerkarten anzeigt. Wählen Sie beispielsweise auf der Registerkarte Allgemein das Feld Starttyp aus, wenn Sie den Starttyp ändern möchten.

[Windows]

Beispiele

Deployment-Manager-Dienst erstellen

In diesem Beispiel wird ein Dienst mit dem Namen IBM® WebSphere Application Server V9.x - Name_des_Deployment-Manager-Dienstes erstellt, der den Prozess "dmgr" startet:

WASService -add Name_des_Deployment-Manager-Dienstes
   -servername Name_des_Deployment-Manager-Servers
   -profilePath Profilstammverzeichnis
   -wasHome Stammverzeichnis_des_Anwendungsservers
   -logFile WS_startManager.log
   -logRoot Profilstammverzeichnis\logs\Name_des_Deployment-Manager-Servers
   -restart true
Für diese Angaben gilt Folgendes:
  • Name_des_Deployment-Manager-Dienstes steht für den Namen, den Sie dem Dienst geben möchten.
  • Name_des_Deployment-Manager-Servers steht für den Namen des Servers.

Nach der Eingabe des Befehls werden Nachrichten ähnlich den folgenden im Befehlsfenster angezeigt:

Adding Service: Name_des_Deployment-Manager-Dienstes
   Config Root: Profilstammverzeichnis\config
   Server Name: Name_des_Deployment-Manager-Servers
   Profile Path: Profilstammverzeichnis
   Was Home: Stammverzeichnis_des_Anwendungsservers
   Start Args:
   Restart: 1
IBM WebSphere Application Server V9.x - Name_des_Deployment-Manager-Dienstes service successfully added.

Klicken Sie auf Start > Einstellungen > Systemsteuerung > Verwaltung > Dienste, um mit dem neuen Dienst zu arbeiten.

Node-Agent-Dienst erstellen

In diesem Beispiel wird ein Dienst mit dem Namen IBM WebSphere Application Server V9.x - Knotenname_des_Node-Agent-Dienstes erstellt, der den Node-Agent-Serverprozess startet:

WASService -add Name_des_Node-Agent-Dienstes
   -servername Name_des_Node-Agent-Servers
   -profilePath Profilstammverzeichnis
   -wasHome Stammverzeichnis_des_Anwendungsservers
   -logFile WS_startNode.log
   -logRoot Profilstammverzeichnis\logs\Name_des_Node-Agent-Servers
   -restart true
Für diese Angaben gilt Folgendes:
  • Name_des_Node-Agent-Dienstes steht für den Namen, den Sie dem Dienst geben möchten.
  • Profilstammverzeichnis gibt die Position an, an der sich der Node Agent im Dateisystem befindet.
  • Name_des_Node-Agent-Servers gibt den Namen des Node Agent an.

    Normalerweise lautet der Name einfach nodeagent.

Nach der Eingabe des Befehls werden Nachrichten ähnlich den folgenden im Befehlsfenster angezeigt:

Adding Service: Name_des_Node-Agent-Dienstes
   Config Root: Profilstammverzeichnis\config
   Server Name: Name_des_Node-Agent-Servers
   Profile Path: Profilstammverzeichnis
   Was Home: Stammverzeichnis_des_Anwendungsservers
   Start Args:
   Restart: 1
IBM WebSphere Application Server V9.x - Name_des_Node-Agent-Dienstes service successfully added.

Anwendungsserverdienst erstellen

In diesem Beispiel wird ein Dienst mit dem Namen IBM WebSphere Application Server V9.x - Name_des_Anwendungsserverdienstes erstellt, der einen Anwendungsserverprozess startet:

WASService -add Name_des_Anwendungsserverdienstes
   -servername Name_des_Anwendungsservers
   -profilePath Profilstammverzeichnis
   -wasHome Stammverzeichnis_des_Anwendungsservers
   -logFile WS_startServer.log
   -logRoot Profilstammverzeichnis\logs\Name_des_Anwendungsservers
   -restart true
Für diese Angaben gilt Folgendes:
  • Name_des_Anwendungsserverdienstes steht für den Namen, den Sie dem Dienst geben möchten.
  • Name_des_Anwendungsservers steht für den Namen des Servers.

Nach der Eingabe des Befehls werden Nachrichten ähnlich den folgenden im Befehlsfenster angezeigt:

Adding Service: Name_des_Anwendungsserverdienstes
  Config Root: Profilstammverzeichnis\config
  Server Name: Name_des_Anwendungsservers
  Profile Path: Profilstammverzeichnis
  Was Home: Stammverzeichnis_des_Anwendungsservers
  Start Args:
  Restart: 1
IBM WebSphere Application Server V9.x - Name_des_Anwendungsserverdienstes service successfully added.

Vorhandenen Anwendungsserverdienst aktualisieren

In diesem Beispiel für das Betriebssystem Windows wird ein vorhandener Dienst mit dem Namen IBM WebSphere Application Server V9.x - Server2 Service mit zusätzlichen Stoppargumenten, dem Benutzernamen und dem Kennwort, aktualisiert. Die Parameter werden automatisch an das Script übergeben, das der Windows-Dienst verwendet, um das System herunterzufahren.

WASService -add "Server2 Service"
   -servername server2
   -profilePath Profilstammverzeichnis
   -logRoot Profilstammverzeichnis\logs\server2
   -stopArgs "-username Benutzername  -password Kennwort"
   -encodeParams
[Windows]

Einen Serverprozess nach dem Erstellen eines Windows-Dienstes starten und stoppen

Wenn Sie in diesem Beispiel für das Betriebssystem Windows den Befehl startServer server1 oder den Befehl stopServer server1 absetzen, nachdem Sie einen Windows-Dienst für server1 erstellt haben, wird eine Nachricht ähnlich der folgenden angezeigt:

Da server1 als Windows-Dienst registriert ist, wird die Anforderung zum Starten dieses Servers durch Starten des zugehörigen Windows-Dienstes ausgeführt.

Wenn Sie den Befehl startNode oder den Befehl stopNode absetzen, nachdem Sie einen Windows-Dienst für den Node-Agent-Prozess erstellt haben, wird eine Nachricht ähnlich der folgenden angezeigt:

Da nodeagent als Windows-Dienst registriert ist, wird die Anforderung zum Starten oder Stoppen dieses Servers durch Starten des zugehörigen Windows-Dienstes ausgeführt.
Suchen Sie in den Protokolldateien nach Nachrichten, die sich auf diesen Befehl beziehen.

Wenn Sie den Befehl startManager oder den Befehl stopManager absetzen, nachdem Sie einen Windows-Dienst für den Deployment Manager erstellt haben, wird eine Nachricht ähnlich der folgenden angezeigt:

Da dmgr als Windows-Dienst registriert ist, wird die Anforderung zum Starten oder Stoppen dieses Servers durch Starten des zugehörigen Windows-Dienstes ausgeführt.
Suchen Sie in den Protokolldateien nach Nachrichten, die sich auf diesen Befehl beziehen.
Fehler vermeiden Fehler vermeiden: Das Erstellen und Entfernen eines WebSphere-Dienstes in Windows kann verwirrend und fehlerträchtig sein. Hilfe zum Diagnostizieren von Fehlern finden Sie in den Informationen zur Verwendung des Dienstprogramms "WASServiceCmd" zum Erstellen von Windows-Diensten für WebSphere Application Server.gotcha

Symbol, das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rins_wasservice
Dateiname:rins_wasservice.html