Eigenschaftendateien zum Konfigurieren von Servern über den Job-Manager anwenden

In einer flexiblen Verwaltungsumgebung können Sie den Job Eigenschaften konfigurieren übergeben, um Eigenschaftendateien auf Anwendungsserver anzuwenden, die vom Job-Manager verwaltet werden. Nach der Bearbeitung einer Eigenschaftendatei für ein verwaltetes Anwendungsserverziel verwenden Sie den Job-Manager, um die Eigenschaftendatei an das verwaltete Ziel zu verteilen und die geänderte Datei zur Aktualisierung der Anwendungsserverkonfiguration anzuwenden.

Vorbereitende Schritte

Eigenschaftendateien sind eine Methode für die Abfrage und Änderung der Produktkonfiguration. In diesen Dateien sind die am häufigsten verwendeten Eigenschaften in Form von Name/Wert-Paaren aufgelistet.

Bevor Sie einen Job zum Anwenden einer Eigenschaftendatei übergeben können, führen Sie die folgenden Schritte aus:

  1. Starten Sie den Job-Manager. Wenn Sie die Eigenschaftendatei auf ein Deployment-Manager-Ziel anwenden, starten Sie den Deployment Manager und den eingebundenen Knoten des Deployment Manager. Wenn Sie die Eigenschaftendatei auf ein eigenständiges Anwendungsserverziel anwenden, starten Sie den Verwaltungsagenten. Die Ziele müssen vom Job-Manager verwaltet werden.
  2. Verwenden Sie den Befehl "extractConfigProperties" in der Befehlsgruppe "PropertiesBasedConfiguration" für das AdminTask-Objekt, um eine Eigenschaftendatei eines Anwendungsservers zu extrahieren, der vom Job-Manager verwaltet wird. Sie müssen den Befehl "extractConfigProperties" lokal ausführen oder ein wsadmin-Script ausführen, das die Eigenschaftendatei in einem Job wsadmin-Script ausführen entpackt. Der Job-Manager hat keinen Job für das explizite Entpacken einer Eigenschaftendatei.

    Angenommen, Sie möchten die Serverkonfiguration eines Anwendungsserverziels mit einem Server server1 und einem Profil AppSrv02 extrahieren. Führen Sie dazu die folgenden wsadmin-Befehle im Verzeichnis bin des Profils "AppSrv02" aus:

    wsadmin -lang jython
    
    AdminTask.extractConfigProperties('[-propertiesFileName server.props -configData Server=server1 ]')

    Das Produkt extrahiert die Serverkonfiguration in eine Datei mit dem Namen server.props im Verzeichnis bin des Profils "AppSrv02".

  3. Öffnen Sie die Eigenschaftendatei in einem Editor, ändern Sie den Wert einer oder mehrerer Eigenschaften, und speichern Sie die Datei.
    Wichtig: Die Eigenschaftendatei muss das Format UTF-8 haben. Die generierte Datei hat automatisch das Format UTF-8. Stellen Sie sicher, dass die Datei auch nach der Bearbeitung das Format UTF-8 behält. Verwenden Sie einen Editor, der UTF-8 bzw. US-ASCII (falls die Datei keine Zeichen außerhalb des 7-Bit-US-ASCII-Zeichensatzes enthält) unterstützt.
  4. Kopieren Sie die Eigenschaftendatei in das Verzeichnis /config/temp/JobManager des Job-Manager-Profils.

    Wenn das Verzeichnis JobManager nicht vorhanden ist, erstellen Sie das Verzeichnis JobManager im Verzeichnis /config/temp des Job-Manager-Profils. Sie müssen die entsprechende Berechtigung haben, um das Verzeichnis erstellen und auf es zugreifen zu können.

    Wenn die Eigenschaftendatei auf einem verwalteten Ziel vorhanden ist, können Sie den Job Datei erfassen ausführen, um die Eigenschaftendatei vom verwalteten Ziel in das Verzeichnis Job-Manager-Profil/config/temp/JobManager/Job-Token/Zielname zu kopieren. Sehen Sie sich den Artikel zum Job "Datei erfassen" an.

  5. Führen Sie den Job Datei verteilen aus, um die Eigenschaftendatei über den Job-Manager an ein oder mehrere Anwendungsserverziele zu verteilen. Merken Sie sich den Wert, den Sie für Ziel angeben, weil Sie diese Position für den Job verwenden, der die Eigenschaftendatei anwendet.
    Fehler vermeiden Fehler vermeiden: Sie müssen die Eigenschaftendatei an die Ziele verteilen, bevor Sie den Job Eigenschaften konfigurieren ausführen. Der Job "Datei verteilen" kopiert die Eigenschaftendatei im Verzeichnis "/config/temp/JobManager" des Job-Manager-Profils auf die Ziele. Als Name der Eigenschaftendatei auf den Zielen wird der Wert verwendet, den Sie bei der Verteilung der Datei als Ziel angegeben haben. Sehen Sie sich den Artikel zum Job "Datei verteilen" an.gotcha
  6. Wenn die Eigenschaftendatei eine Variablenzuordnungsdatei verwendet, führen Sie den Job Datei verteilen aus, um die Variablenzuordnungsdatei zu verteilen. Merken Sie sich den Wert, den Sie für Ziel angeben.

Ihre ID für den Job-Manager muss für die Rolle "Administrator" (Verwaltung) oder "Operator" (Bedienung) 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 Zielen angeben. Wenn Sie einen Job an mehrere Ziele übergeben, müssen Benutzername und Kennwort oder Berechtigungsnachweise für den Übergebenden für alle Jobziele gültig sein.

Informationen zu diesem Vorgang

Sie können die Administrationskonsole des Job-Managers oder des Deployment Manager verwenden, um einen Job zu übergeben, der eine Eigenschaftendatei anwendet und einen Anwendungsserver konfiguriert. Wählen Sie in der Konsole den Job Eigenschaften konfigurieren aus, geben Sie die anzuwendende Eigenschaftendatei an, geben Sie die Joboptionen an, planen Sie den Job, sehen Sie sich die Zusammenfassung an, und übergeben Sie den Job.

Der Job nimmt die folgenden Änderungen an einer Anwendungsserverkonfiguration vor:
  • Er setzt die Attribute entsprechend den in der Eigenschaftendatei angegebenen Eigenschaften auf die neuen Werte.
  • Wenn ein Attribut, das der angegebenen Eigenschaft entspricht, nicht in der Konfiguration vorhanden ist, erstellt der Job ein Attribut in der Konfiguration.
  • Wenn ein in der Eigenschaftendatei angegebenes Konfigurationsobjekt nicht in der Konfiguration vorhanden ist, erstellt der Job ein Konfigurationsobjekt.

Sie können festlegen, dass der Job beim Anwenden der Eigenschaftendatei Variablen verwenden soll, die in einer Variablenzuordnungsdatei enthalten sind. Geben Sie die Position der in die Eigenschaftendatei einzuschließenden Variablenzuordnungsdatei an.

Diese Schritte beschreiben, wie Sie die Konsole des Job-Managers oder des Deployment Manager zum Übergeben des Jobs verwenden. Anstelle der Konsole können Sie den Job durch Ausführen des Befehls configProperties in der Befehlsgruppe "AdministrativeJobs" übergeben, um die Eigenschaften für das Anwendungsserverziel zu konfigurieren. Weitere Informationen hierzu finden Sie im Artikel zu den Typen von Verwaltungsjobs.

Der Job "Eigenschaften konfigurieren" verwendet den Befehl applyConfigProperties in der Befehlsgruppe "PropertiesBasedConfiguration" für das Objekt "AdminTask", um die Eigenschaften des Ziels zu konfigurieren.

Vorgehensweise

  1. Klicken Sie in der Navigationsstruktur der Administrationskonsole auf Jobs > Übergeben.
  2. Wählen Sie einen Job zum Anwenden einer Eigenschaftendatei auf ein oder mehrere Anwendungsserverziele aus.
    1. Wählen Sie in der Liste den Job Eigenschaften konfigurieren aus.
    2. (Optional) Beschreiben Sie den Job.
    3. Klicken Sie auf Weiter.
  3. Wählen Sie als Jobziel die Anwendungsserverziele aus, die Sie durch Anwenden einer Eigenschaftendatei konfigurieren möchten.
    1. Wählen Sie Zielknoten aus.
    2. Geben Sie die Namen der Ziele an, an die Sie die Eigenschaftendatei zuvor verteilt haben, und klicken Sie auf Hinzufügen oder auf Suchen und geben Sie die Anwendungsserverziele auf der Seite "Ziele suchen" an.
    3. Klicken Sie auf Weiter.
    4. Wenn die Benutzerauthentifizierung erforderlich ist, geben Sie einen Benutzernamen, ein Kennwort und bei Bedarf weitere Authentifizierungswerte an.
    5. Klicken Sie auf Weiter.
  4. Geben Sie Parameter für den Job zum Konfigurieren von Eigenschaften an.
    1. Geben Sie die Position der Eigenschaftendatei an, die Sie anwenden möchten.

      Die Position der Eigenschaftendatei ist der Zielwert, den Sie für den Job Datei verteilen angegeben haben.

    2. Wenn die Eigenschaftendatei eine Variablenzuordnungsdatei verwendet, geben Sie die Position der Variablenzuordnungsdatei an.

      Verwenden Sie den Zielwert, den Sie für den Job Datei verteilen angegeben haben.

    3. Klicken Sie auf Weiter.
  5. Planen Sie den Job.

    Die Uhrzeiten und Datumsangaben, die Sie angeben, sind für den Job-Manager relativ.

    1. Geben Sie optional eine oder mehrere E-Mail-Adressen an, an die nach Abschluss des Jobs Benachrichtigungen gesendet werden sollen.

      Wenn Sie mehrere E-Mail-Adressen angeben, trennen Sie diese durch Kommas voneinander. Die E-Mail-Adressen werden in Ihren Konsoleinstellungen gespeichert. Jede E-Mail-Adresse wird auf Formatfehler überprüft.

    2. Wählen Sie aus, wann der Job für die Übergabe verfügbar ist.

      Sie können den Job für sofortige Übergabe planen oder ein Datum mit Uhrzeit angeben, an dem der Job vom Job-Manager abgerufen werden soll.

    3. Wählen Sie die Verfallszeit für den Job aus.

      Die Verfallszeit des Jobs gibt an, wann der Job für die Ausführung auf den Zielen nicht mehr verfügbar ist. Sie können die Standardverfallszeit verwenden, Uhrzeit und Datum für den Jobverfall angeben oder einen Zeitraum angeben, nach dem der Job verfällt. Die Standardverfallszeit ist auf der Konfigurationsseite des Job-Managers definiert.

    4. Geben Sie optional ein Wiederholungsintervall, das Startdatum und das Enddatum des Intervalls an.
    5. Klicken Sie auf Weiter.
  6. Sehen Sie sich die Zusammenfassung an und klicken Sie auf Fertigstellen, um den Job zu übergeben.

Ergebnisse

Der Job-Manager führt die folgenden Operationen aus:

  • Macht den Job Eigenschaften konfigurieren für die Ziele verfügbar.
  • Meldet den Status des Jobs auf jedem Ziel.

Nächste Schritte

Klicken Sie auf der Seite "Jobstatus" auf die Job-ID, und sehen Sie sich den Jobstatus an. Klicken Sie auf das Symbol für Statusaktualisierung Symbol für Aktualisierung der Anzeige mit dem Jobstatus, um den angezeigten Status zu aktualisieren.

Wenn der Job nicht erfolgreich ist, sehen Sie sich alle Fehlernachrichten zur Jobausführung an, beheben Sie alle Fehlerbedingungen, und übergeben Sie den Job anschließend erneut.

Wenn der Jobstatus Erfolgreich ist, überprüfen Sie das Ziel, um sicherzustellen, dass die Eigenschaftendatei angewendet wurde.


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=tagt_jobmgr_server_propfile
Dateiname:tagt_jobmgr_server_propfile.html