Verwaltungsjobs mit wsadmin-Scripting ausführen

Verwenden Sie diesen Artikel, um Verwaltungsjobs in einer flexiblen Verwaltungsumgebung mit dem Tool "wsadmin" zu übergeben und zu verfolgen.

Vorbereitende Schritte

Konfigurieren Sie einen Job-Manager, einen Verwaltungsagenten, und registrieren Sie Knoten und Deployment Manager beim Job-Manager, um eine flexible Verwaltungsumgebung einzurichten. Optional können Sie Verwaltungsgruppen erstellen, um einen Job an mehrere Knoten gleichzeitig zu übergeben.

Informationen zu diesem Vorgang

Nach der Konfiguration der flexiblen Verwaltungsumgebung können Sie Jobs für die beim Job-Manager registrierten Knoten übergeben, überwachen und verwalten. Ihre ID für den Job-Manager muss für die Rolle "Verwaltung" (Administrator) oder "Bedienung" (Operator) berechtigt sein, damit Sie Jobs übergeben können. Wenn Sie einen Job übergeben, können Sie einen Benutzernamen und ein Kennwort für die Authentifizierung und Berechtigung auf den Zielknoten angeben. Wenn Sie mit dem Jobparametern keinen Benutzernamen und kein Kennwort angeben, werden die Berechtigungsnachweise desjenigen, der den Job übergibt, für diesen Zweck verwendet.
Anmerkung: Wenn Sie einen Job an mehrere Zielknoten übergeben, müssen Benutzername und Kennwort oder Berechtigungsnachweise für den Übergebenden für alle Jobziele gültig sein.

Vorgehensweise

  1. Starten Sie das Tool "wsadmin". Navigieren Sie zum Verzeichnis "Stammverzeichnis_des_Anwendungsservers/bin", und verwenden Sie den folgenden Befehl, um eine Verbindung zwischen dem Tool "wsadmin" und dem Job-Manager-Prozess herzustellen:
    wsadmin -profileName myJobManager -lang jython
  2. Übergeben Sie den Verwaltungsjob an den Job-Manager.
    Verwenden Sie den Befehl "submitJob", um Verwaltungsjobs zu übergeben. Eine Jobübergabe setzt sich aus den folgenden Informationen zusammen:
    Jobtyp
    Der Jobtyp gibt den Typ des auszuführenden Jobs an. In einer flexiblen Verwaltungsumgebung existieren viele Jobs, z. B. Jobs für die Anwendungsverwaltung, Konfigurationsjobs und Steuerjobs für die Laufzeitumgebung des Anwendungsservers.
    Liste der Jobziele und Zielgruppe
    Die Liste der Jobziele und die Zielgruppe geben die Knoten und Knotengruppen an, in denen der Job ausgeführt wird.
    Jobspezifische Parameter
    Die meisten Verwaltungsjobs erfordern neben dem Jobtyp und dem Ziel zusätzliche Informationen, um den Job ausführen zu können. Die Jobparameter sind für jeden Jobtyp spezifisch.
    Anmerkung: Wenn Sie einen Job an mehrere Zielknoten übergeben, müssen Benutzername und Kennwort oder Berechtigungsnachweise für den Übergebenden für alle Jobziele gültig sein.
    Optionale generische Parameter
    Zusätzlich zu den jobspezifischen Parametern können Sie jeden der folgenden optionalen Parameter in die Jobübergabe einschließen:
    Tabelle 1. Beschreibung optionaler generischer Parameter für submitJob. Geben Sie optionale Parameter mit einem Bindestrich (-) vor dem Parameternamen an.
    Parameter Beschreibung Typ
    username Gibt den Benutzernamen an, der für die Übergabe des Jobs verwendet werden soll, wenn die Sicherheit aktiviert ist. String
    password Gibt den Kennwort für den Benutzernamen an, der für die Übergabe des Jobs verwendet werden soll, wenn die Sicherheit aktiviert ist. String
    description Gibt eine Beschreibung für den Job an. String
    activationDateTime Gibt das Datum (inklusive Uhrzeit), an dem der Job aktiviert werden soll, im Format "2006-05-03T10:30:45-0000" an. Der Abschnitt "-0000" des Werts des Parameters "activationDateTime" stellt die Zeitzone dar. Sie können Z als Kurzform für Greenwich Mean Time (GMT) verwenden, z. B. "2006-05-03T10:30:45Z". Wenn Sie die Zeitzone nicht angeben, verwendet das System die Zeitzone des Servers. String
    expirationDateTime Gibt das Verfallsdatum für den Job im Format "2006-05-03T10:30:45-0000" an. Der Abschnitt "-0000" des Werts des Parameters "expirationDateTime" stellt die Zeitzone dar. Sie können Z als Kürzel für Greenwich Mean Time (GMT) angeben, z. B. "2006-05-03T10:30:45Z". Wenn Sie die Zeitzone nicht angeben, verwendet das System die Zeitzone des Servers. String
    executionWindow Gibt das Wiederholungsintervall für den Job an. String
    executionWindowUnit Gibt die Maßeinheit für das Wiederholungsintervall an, dessen Wert mit dem Parameter "executionWindow" angegeben wird. Geben Sie DAILY an, wenn der Job täglich ausgeführt werden soll, WEEKLY, wenn der Job wöchentlich ausgeführt werden soll, MONTHLY, wenn der Job monatlich ausgeführt werden soll, YEARLY, wenn der Job jährlich ausgeführt werden soll, oder CONNECTION, wenn der Job jedesmal ausgeführt werden soll, wenn der Knoten eine Verbindung herstellt und Jobs abfragt. String
    email Gibt die E-Mail-Adresse an, an die das System Jobbenachrichtigungen sendet. String
    Im folgenden Beispiel wird ein Job zum Starten eines Anwendungsservers übergeben. Der folgende Beispielbefehl übergibt den Job zu Starten der Anwendung und setzt das zurückgegebene Jobtoken auf die Variable MyStartJob:
    myStartJob = AdminTask.submitJob('-jobType startApplication -targetList [MyNode01] -jobParams [applicationName myApplication] -email admin@company.com')
  3. Optional: Überwachen Sie den Jobstatus.
    Verwenden Sie den Befehl "getOverallJobStatus", wie im folgenden Beispiel gezeigt, um den Status eines Jobs anzuzeigen:
    AdminTask.getOverallJobStatus('[-jobTokenList [myStartJob]]')
    Wenn Sie die Variable "myStartJob" im vorherigen Schritt nicht gesetzt haben, geben Sie den Rückgabewert des Befehls submitJob für den Parameter "-jobTokenList" an.
    Der Befehl gibt Jobstatusinformationen für den bzw. die gewünschten Jobs zurück. Das System zeigt die folgenden Informationen im Gesamtjobstatus an:
    • Das Attribut STATE gibt den aktuellen Status des Jobs an.
    • Das Attribut TOTAL_RESULTS gibt die Gesamtanzahl der Jobs an.
    • Das Attribut DISTRIBUTED gibt die Anzahl verteilter Jobs an.
    • Das Attribut ASYNC_IN_PROGRESS gibt die Anzahl asynchroner Jobs an, die in Bearbeitung sind.
    • Das Attribut SUCCEEDED gibt die Anzahl erfolgreicher Jobs an.
    • Das Attribut PARTIALLY_SUCCEEDED gibt die Anzahl teilweise erfolgreicher Jobs an. Eine teilweise erfolgreiche Ausführung liegt dann vor, wenn ein Knoten beispielsweise mehrere Server darstellt und der Job nur auf einigen der Server dieses Knotens erfolgreich ausgeführt wird.
    • Das Attribut FAILED gibt die Anzahl gescheiterter Jobs an.
    • Das Attribut REJECTED gibt die Anzahl zurückgewiesener Jobs an.
    • Das Attribut NOT_ATTEMPTED gibt die Anzahl der Jobs an, die das System nicht ausgeführt hat.

Nächste Schritte

Übergeben Sie weitere Verwaltungsjobs an den Job-Manager, und überwachen Sie die vorhandenen Jobs. Sie können auch künftige Verwaltungsjobs planen.


Symbol, das den Typ des Artikels anzeigt. Taskartikel



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