Sie können das Tool "wsadmin" verwenden, um Anwendungsserver, Anwendungsimplementierungen und
Laufzeitoperationen des Servers zu konfigurieren und zu verwalten.
Informationen zu diesem Vorgang
Sie können mit dem Tool "wsadmin" Konfigurationstasks
für Ihre Umgebung automatisieren, indem Sie Scripts ausführen. Bei der Verwendung des Tools "wsadmin" sind jedoch
einige Einschränkungen zu beachten von denen einige im Folgenden beschrieben sind:
- Das Tool "wsadmin" unterstützt die Scripting-Sprachen Jython und Jacl.
Ab WebSphere Application Server Version 6.1 gilt
die Jacl-Syntax, die dem Tool wsadmin zugeordnet ist, als veraltet. Die Jacl-Syntax für
das Tool wsadmin bleibt weiterhin im Produkt und wird mindestens für zwei weitere Hauptreleases
des Produkts unterstützt. Danach wird die Unterstützung der Sprache Jacl aus dem Tool wsadmin entfernt. Die Verwendung der Jython-Syntax für das Tool wsadmin ist die strategische Ausrichtung für die Automatisierung der Verwaltung unter WebSphere Application Server. Der
Anwendungsserver enthält deutlich verbesserte Verwaltungsfunktionen und
-tools, die die Produktautomatisierung und die Verwendung der Jython-Syntax unterstützen.
Veraltetes Feature: Jacl ist veraltet
und die Standard-Scripting-Sprache ist
Jython.
depfeat
Fehler vermeiden: Nicht alle Klassen von
WebSphere Application Server-Komponenten
sind in derselben
.jar-Datei gepackt. Wenn Sie das Tool "wsadmin" verwenden, um Jython-Scripts auszuführen,
nehmen Sie die Systemeigenschaft "jython.package.path" in Ihren "wsadmin"-Befehl auf, um sicherzustellen, dass für alle erforderlichen
JAR-Dateien während des Starts von "wsadmin" derselbe
Jython-Paketpfad festgelegt ist.
./wsadmin.sh -lang jython -javaoption
"-Djython.package.path=/usr/WebSphere70/AppServer/plugins/com.ibm.ws.wlm.jar"
Wenn Sie WebSphere Application Server-Funktionen aus anderen Klassen
von WebSphere Application Server aufrufen möchten,
die in anderen
.jar-Dateien als den Dateien
runtime.jar und admin.jar gepackt sind, können Sie
in den mit der Systemeigenschaft
"jython.package.path" angegebenen Pfad mehrere JAR-Dateien aufnehmen, die durch ein Semikolon (;)
getrennt sind.
./wsadmin.sh -lang jython -javaoption
"-Djython.package.path=/usr/WebSphere70/AppServer/plugins/com.ibm.ws.wlm.jar;com.ibm.ws.wccm.jar"
Wenn Sie
WebSphere Application Server-Funktionen in einem Jython-Script
mit "ws_ant" aufrufen möchten, können Sie eine
.prop-Textdatei verwenden und die folgende Zeile in diese Datei aufnehmen:
jython.package.path=/usr/WebSphere70/AppServer/plugins/com.ibm.ws.wlm.jar
Anschließend nehmen Sie die Eigenschaftendatei in
die XML-Datei des Ant-Scripts auf. Beispiel:
<taskdef name="wsadmin" classname="com.ibm.websphere.ant.tasks.WsAdmin"/>
<target name="main">
<wsadmin conntype="NONE" lang="jython" failonerror="true" properties="/tmp/jython.prop"
script="/home/fsgapp/MSTWasBuild/project/scripts/socr/socr/jython/configure.py">
</wsadmin>
</target>
gotcha
- Das Tool "wsadmin" verwaltet Installation, Konfiguration, Implementierung und
Laufzeitoperationen für Anwendungsserver, Deployment Manager, Verwaltungsagenten und Job-Manager, die dieselbe Version wie bzw. eine höhere Version als das Produkt haben. Das Tool "wsadmin " kann keine Verbindung zu einem Anwendungsserver, Deployment Manager, Verwaltungsagenten oder Job-Manager herstellen, der eine ältere Produktversion als das Tool "wsadmin" hat. Ein wsadmin-Client der Version 7.x kann beispielsweise keine Verbindung zu einem Anwendungsserver der Version 6.x herstellen.
Ein wsadmin-Client der Version 6.x kann jedoch eine Verbindung zu einem Anwendungsserver der Version 7.x herstellen.
Diese Einschränkung existiert, weil dem Tool "wsadmin" in jedem Produktrelease neue Funktionen hinzugefügt werden. Sie können die neuen Funktionen nicht in a Anwendungsservern älterer Produktversionen verwenden.
- Das Tool "wsadmin" arbeitet in einer heterogenen Zellenumgebung auf der Ebene des Deployment-Manager-Knotens. Führen Sie wsadmin nicht auf der Ebene der Anwendungsserverknoten aus, damit sichergestellt ist, dass alle Befehlsfunktionen verfügbar sind.
Das wsadmin-Startprogramm unterstützt mehrere Scripting-Objekte, einschließlich
AdminConfig, AdminControl, AdminApp, AdminTask und Help. Scripts verwenden diese Objekte für die
Anwendungsverwaltung, Konfiguration, Betriebssteuerung und Kommunikation mit MBeans, die
in Produktprozessen ausgeführt werden. Sie müssen den Scripting-Client "wsadmin" starten, bevor Sie eine Task mit Scripting
ausführen.
Bevor Sie das Tool "wsadmin"
mit aktivierter Sicherheit starten, lesen Sie den Artikel mit SSL-Hinweisen für Administratoren von WebSphere
Application Server und den Artikel "SSL-Sicherheit für Clients und Server".
In einer flexiblen Verwaltungsumgebung können Sie eine Verbindung zwischen dem Tool
"wsadmin" und einem Basisanwendungsserver-, Deployment-Manager-, Verwaltungsagenten- oder Job-Manager-Prozess herstellen. Wenn Sie den Port
des Basisanwendungsservers oder den Profilnamen, der dem Job-Manager zugeordnet ist, nicht angeben, stellt das
Tool "wsadmin" automatisch eine Verbindung zum Verwaltungsagent her.
Fehler vermeiden: Das Anwendungsmanagementdesign erlaubt keine Installation
einer EAR-Datei oder eines Moduls mit einer EE-Spezifikationsstufe die höher ist als die des Clients. Der Client-Code, der in
"wsadmin" ausgeführt wird, liest die EAR-Datei und generiert mittels Introspektion des Inhalts
die Implementierungskonfigurationsoptionen, die für die betreffende Anwendung geeignet sind. Der Code auf der Clientseite kann keine Spezifikationsstufe verarbeiten, die höher ist als die vom Client unterstützte
Stufe.
gotcha
Ergebnisse
Das Tool "wsadmin" gibt die folgende Ausgabe zurück, wenn es die Verbindung zum Serverprozess hergestellt hat:
Beispielausgabe für Jython:
Applications currently installed:
DefaultApplication
ivtApp
query
WASX70311: Wenn Sie Hilfe benötigen, geben Sie "print Help.help()" ein.
wsadmin>
Beispielausgabe für Jacl:
Applications currently installed:
DefaultApplication
ivtApp
query
WASX70311: Wenn Sie Hilfe benötigen, geben Sie "$Help help" ein.
wsadmin>
![[z/OS]](../images/ngzos.gif)
Sie empfangen die folgende Nachricht:
[ Unable to allocate an initial java heap of 268435456 bytes. ]
[ **Out of memory, aborting** ]
[ *** panic: JVMST016: Cannot allocate memory for initial java heap ]
CEE5207E The signal SIGABRT was received.
Der wsadmin-Scripting-Client konnte nicht gestartet werden, da die Regionsgröße
in Ihrer Anmeldung nicht ausreicht, um die Mindestheapspeichergröße (-Xms) zuzuordnen,
die in der Java Virtual Machine (JVM) angegeben ist, die beim Start von wsadmin erstellt wird. Der Standardwert für die Option "-Xms", die in der Datei "wsadmin.sh" mit der Anweisung
"PERF_JVM_OPTIONS="-Xms256m -Xmx256m" angegeben wird, sind 256
MB. Zur Behebung dieses Problems melden Sie sich bei TSO ab. Wenn Sie sich wieder bei TSO anmelden, versuchen Sie,
den Wert des Parameters
Size auf Ihrem Anmeldebildschirm zu erhöhen. Wenn Sie den Wert des Parameters
Size auf Ihrem Anmeldebildschirm nicht erhöhen können,
prüfen Sie, ob IEFUSI-Exits vorhanden sind, die eine Erhöhung des Parameterwerts verhindern.
Wenn Sie sich über Telnet bei OMVS anmelden, wird der Wert, der zum Bestimmen der
für Ihre Anmeldung zugeteilten Adressraumgröße verwendet wird, im Parmlib-Member BPXPRMxx angegeben. BPXPRMxx steuert die vollständige Umgebung von z/OS-UNIX. Deshalb bestimmt der für den Parameter
MAXASSIZE angegebene Wert die Größe des Adressraums. Wenn Sie RACF verwenden, kann der Adressraum jedoch auch für einen einzelnen Benutzer im entsprechenden
RACF-OMVS-Segment festgelegt werden. In dieser Situation gibt der für den Parameter ASSIZEMAX (in Byte) angegebene
Wert den Grenzwert für die Adressraumgröße für diesen Benutzer. Die Einstellung ASSIZEMAX=0268435456 gibt
beispielsweise an, dass dem Adressraum für diesen Benutzer 256 MB zugeordnet sind.