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:
- 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.
- 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".
- Ö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.
- 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.
- 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: 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
- 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
- Klicken Sie in der Navigationsstruktur der Administrationskonsole auf
.
- Wählen Sie einen Job zum Anwenden einer Eigenschaftendatei auf ein oder mehrere Anwendungsserverziele aus.
- Wählen Sie in der Liste den Job Eigenschaften konfigurieren aus.
- (Optional) Beschreiben Sie den Job.
- Klicken Sie auf Weiter.
- Wählen Sie als Jobziel die Anwendungsserverziele
aus, die Sie durch Anwenden einer Eigenschaftendatei konfigurieren möchten.
- Wählen Sie Zielknoten aus.
- 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.
- Klicken Sie auf Weiter.
- Wenn die Benutzerauthentifizierung erforderlich ist, geben Sie einen Benutzernamen, ein Kennwort und bei Bedarf weitere Authentifizierungswerte an.
- Klicken Sie auf Weiter.
- Geben Sie Parameter für den Job zum Konfigurieren von Eigenschaften an.
- 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.
- 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.
- Klicken Sie auf Weiter.
- Planen Sie den Job.
Die Uhrzeiten und Datumsangaben, die Sie
angeben, sind für den Job-Manager relativ.
- 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.
- 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.
- 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.
- Geben Sie optional ein Wiederholungsintervall, das Startdatum und das Enddatum des Intervalls an.
- Klicken Sie auf Weiter.
- 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
, 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.