Die Scripting-Bibliothek enthält Jython-Scriptprozeduren, die Sie bei der Automatisierung Ihrer Umgebung unterstützen.
Verwenden Sie die Scripts für die Verwaltung von Anwendungen, um Geschäftsanwendungen in Ihrer Umgebung
zu installieren, zu deinstallieren, zu exportieren, zu starten, zu stoppen und zu verwalten.
Informationen zu diesem Vorgang
Die Scripting-Bibliothek enthält eine Reihe von Prozeduren für die Automatisierung der meisten gebräuchlichen Verwaltungsfunktionen
des Anwendungsservers.
Die Jython-Scriptbibliothek kann auf verschiedene Arten verwendet werden.
- Sie können Scripts aus der Jython-Scriptbibliothek im Dialogmodus
über das Tool "wsadmin" ausführen. Sie können das Tool "wsadmin" starten und einzelne Scripts aus der
Scriptbibliothek mit der folgenden Syntax ausführen:
wsadmin>AdminServerManagement.createApplicationServer("myNode", "myServer", "default")
- Verwenden Sie einen Texteditor, um mehrere Scripts aus der Jython-Scriptbibliothek zu kombinieren, wie im folgenden Beispiel gezeigt wird:
#
# My Custom Jython Script - file.py
#
AdminServerManagement.createApplicationServer("myNode", "Server1", "default")
AdminServerManagement.createApplicationServer("myNode", "Server2", "default")
# Ein Member als erstes Member eines Clusters verwenden
AdminClusterManagement.createClusterWithFirstMember("myCluster", "APPLICATION_SERVER", "myNode", "Server1")
# Dem Cluster ein zweites Member hinzufügen
AdminClusterManagement.createClusterMember("myCluster", "myNode", "Server3")
# Anwendung installieren
AdminApplication.installAppWithClusterOption("DefaultApplication",
"..\installableApps\DefaultApplication.ear", "myCluster")
# Alle Server und Anwendungen auf dem Knoten starten
AdminServerManagement.startAllServers("myNode")
Speichern Sie das angepasste Script, und führen Sie es über die Befehlszeile mit der folgenden Syntax aus:
bin>wsadmin -language jython -f Pfad/zu/Ihrer/Jython/Datei.py
- Verwenden Sie den Code aus der Jython-Scripting-Bibliothek als Verwendungsbeispiel, um eigene Scripts zu schreiben.
Jedes Scriptbeispiel in der Scriptbibliothek demonstriert bewährte Verfahren für das Schreiben von wsadmin-Scripts. Der Code der Scriptbibliothek
befindet sich im Verzeichnis Stammverzeichnis_des_Anwendungsservers/scriptLibraries.
In diesem Verzeichnis sind die Scripts in Unterverzeichnissen nach Funktionalität organisiert.
Das Unterverzeichnis Stammverzeichnis_des_Anwendungsservers/scriptLibraries/application/V70 enthält beispielsweise
Prozeduren, die Tasks für die Anwendungsverwaltung in Version 7.0 und höher des Produkts ausgeführt werden. Das Unterverzeichnis
V70 in den Scriptbibliothekspfaden bedeutet nicht, dass die darin enthaltenen Scripts Scripts der Version
7.0 sind.
Die Prozeduren für Geschäftsanwendungen in der Scripting-Bibliothek
befinden sich im Unterverzeichnis "
Stammverzeichnis_des_Anwendungsservers/scriptLibraries/application/V70".
Alle Scripts im Verzeichnis werden automatisch geladen, wenn Sie das Tool "wsadmin" starten.
Damit eigene Jython-Scripts (*.py) beim Starten des Tools "wsadmin" automatisch geladen werden, erstellen Sie ein neues
Unterverzeichnis und speichern Sie die vorhandenen Automationsscripts im Verzeichnis "
Stammverzeichnis_des_Anwendungsservers/scriptLibraries".
Bewährtes Verfahren: Wenn Sie über die Prozeduren in der Scripting-Bibliothek angepasste Scripts erstellen möchten,
speichern Sie die geänderten Scripts in einem neuen Unterverzeichnis, um zu vermeiden, dass die Prozeduren in der Bibliothek überschrieben werden.
Bearbeiten Sie keine Scriptprozeduren in der Scripting-Bibliothek.
bprac
Sie können die Scripts "AdminBLA.py" verwenden, um mehrere
Kombinationen der Verwaltungsfunktionen zu erstellen. Informationen zum Anzeigen von Argumentbeschreibungen und Syntaxbeispiele finden Sie in der Dokumentation der Konfigurationsscripts für Geschäftsanwendungen.
Verwenden Sie diesen Artikel und die Scripting-Bibliothek, um eine leere Geschäftsanwendung
zu erstellen, Assets als Kompositionseinheiten hinzuzufügen und die Geschäftsanwendung zu starten.
Vorgehensweise
- Starten Sie das Tool "wsadmin".
Verwenden Sie diesen Schritt, um das Tool "wsadmin" zu starten und eine Verbindung zu
einem Server herzustellen oder um das Tool im lokalen Modus auszuführen.
Wenn Sie das Tool "wsadmin" starten, verwenden Sie für die Ausführung der Scripts
die Dialogmodusbeispiele in diesem Artikel.
Beim Starten des Tools "wsadmin" lädt das System alle Scripts aus der Scripting-Bibliothek.
- Importieren Sie Assets in Ihre Konfiguration.
Assets stellten Anwendungsbinärdateien
dar, die Geschäftslogik enthalten, die in der Ziellaufzeitumgebung ausgeführt wird und Clientanforderungen bearbeitet.
Ein Asset kann eine Datei, ein Archiv von Dateien, wie z. B. eine ZIP- oder eine
JAR-Datei (Java-Archiv), oder ein Archiv von Archivdateien, wie z. B.
eine EAR-Datei, enthalten.
Weitere Beispiele für Assets sind EJB-JAR-Dateien, EAR-Dateien,
OSGi-Pakete, JAR-Dateien für Mediation, JAR-Dateien für gemeinsam genutzte Bibliotheken oder Inhalte, die keine Java EE-Inhalte sind
(z. B. PHP-Anwendungen).
Führen Sie das Script "importAsset" aus der Scriptbibliothek "AdminBLA", wie im folgenden Beispiel gezeigt, aus, um Assets in das Konfigurationsrepository des Anwendungsservers
zu importieren:
bin>wsadmin -lang jython -c "AdminBLA.importAsset("asset.zip", "true", "true")"
Sie können zum Ausführen
der Scriptprozedur auch den Dialogmodus verwenden, wie im folgenden Bespiel gezeigt wird:
wsadmin>AdminBLA.importAsset("asset.zip", "true", "true")
- Erstellen Sie eine leere Geschäftsanwendung.
Führen Sie das Script
"createEmptyBLA" aus der Scriptbibliothek "AdminBLA", wie im folgenden Beispiel gezeigt, aus, um eine neue
Geschäftsanwendung zu erstellen:
bin>wsadmin -lang jython -c "AdminBLA.createEmptyBLA("myBLA", "bla to control transactions")"
Sie können zum Ausführen
der Scriptprozedur auch den Dialogmodus verwenden, wie im folgenden Bespiel gezeigt wird:
wsadmin>AdminBLA.createEmptyBLA("myBLA", "bla to control transactions")
- Fügen Sie der Geschäftsanwendung Assets als Kompositionseinheiten hinzu.
Kompositionseinheiten können implementierte Assets, andere Geschäftsanwendungen oder externe Artefakte darstellen, die in der Laufzeitumgebung von
WebSphere Application Server oder in anderen Laufzeitumgebungen ohne Sicherungsassets implementiert sind.
Geschäftsanwendungen enthalten keine oder mehrere Kompositionseinheiten.
Es ist nicht möglich, eine Kompositionseinheit mehreren Geschäftsanwendungen hinzuzufügen, aber Sie können ein einziges Asset verwenden, um mehrere
Kompositionseinheiten zu erstellen.
Führen Sie das Script "addCompUnit" aus der Scriptbibliothek
"AdminBLA", wie im folgenden Beispiel gezeigt, aus, um das Asset "asset.zip" der Geschäftsanwendung "myBLA" als Kompositionseinheit
hinzuzufügen:
bin>wsadmin -lang jython -c "AdminBLA.addCompUnit("myBLA", "asset.zip", "default",
"myCompositionUnit", "Kompositionseinheitenbeschreibung", "1", "server1", "specname=actplan1")"
Sie können zum Ausführen
der Scriptprozedur auch den Dialogmodus verwenden, wie im folgenden Bespiel gezeigt wird:
wsadmin>AdminBLA.addCompUnit("myBLA", "asset.zip", "Standard", "myCompositionUnit", "Kompositionseinheitenbeschreibung", "1", "server1", "specname=actplan1")
- Speichern Sie die Konfigurationsänderungen.
Verwenden Sie den folgenden Beispielbefehl, um Ihre Konfigurationsänderungen zu speichern:
AdminConfig.save()
- Synchronisieren Sie den Knoten.
Verwenden Sie das Script "syncActiveNodes" aus der Scriptbibliothek "AdminNodeManagement", wie im folgenden Beispiel gezeigt, um
jeden aktiven Knoten in Ihrer Umgebung zu synchronisieren:
wsadmin>AdminNodeManagement.syncActiveNodes()
- Starten Sie die Geschäftsanwendung.
Verwenden Sie das Script "startBLA"
aus der Scriptbibliothek "AdminBLA", wie im folgenden Beispiel gezeigt, um jede Kompositionseinheit
der Geschäftsanwendung auf den Implementierungszielen zu starten, für die die Kompositionseinheiten konfiguriert sind:
wsadmin>AdminBLA.startBLA("myBLA")
Ergebnisse
Die Geschäftsanwendung wurde konfiguriert und auf den gewünschten Implementierungszielen gestartet.
Die wsadmin-Scriptbibliotheken geben dieselbe Ausgabe wie die entsprechenden
wsadmin-Befehle zurück. Das Script "AdminServerManagement.listServers()"
gibt beispielsweise eine Liste mit verfügbaren Servern zurück.
Das Script "AdminClusterManagement.checkIfClusterExists()" gibt den Wert
true zurück, wenn der Cluster vorhanden ist, bzw. den Wert false, wenn der Cluster nicht vorhanden ist.
Wenn der Befehl nicht die erwartete Ausgabe zurückgibt, geben die Scriptbibliotheken
den Wert 1 bei erfolgreicher Ausführung des Scripts zurück. Scheitert das Script, geben die
Scriptbibliotheken den Wert -1 und eine Fehlernachricht mit der Ausnahme zurück.
Standardmäßig wird die Option "failonerror" vom System inaktiviert.
Zum Aktivieren dieser Option geben Sie
true als letztes Argument für die Scriptprozedur an, wie im folgenden
Beispiel gezeigt wird:
wsadmin>AdminApplication.startApplicationOnCluster("myApplication","myCluster","true")
Nächste Schritte
Verwenden Sie die Konfigurationsscripts für Geschäftsanwendungen, um angepasste Scripts für die Automatisierung Ihrer Umgebung zu erstellen.
Speichern Sie die angepassten Scripts in einem neuen Unterverzeichnis des Verzeichnisses
"Stammverzeichnis_des_Anwendungsservers/scriptLibraries".