Zusammengeführte Plug-in-Konfiguration für Liberty-Server mit dem Job-Manager generieren

Sie können den Job Zusammengeführte Plug-in-Konfiguration für Liberty-Profilserver generieren übergeben, um eine einfache zusammengeführte Datei mit dem Namen plugin-cfg.xml zu erstellen, mit der ein Web-Server-Plug-in angewiesen wird, Anforderungen an mehrere Anwendungsserver auf mehreren Hosts weiterzuleiten. Der Job generiert zunächst auf jedem Zielhost serverspezifische Dateien des Typs plugin-cfg.xml. Anschließend werden die serverspezifischen plugin-cfg.xml-Dateien von diesem Job zu einer einzelnen Datei plugin-cfg.xml auf dem Job-Manager-Host zusammengeführt.

Vorbereitende Schritte

Starten Sie den Job-Manager und die Liberty-Server auf den Zielhosts.

Wenn Sie eine Konfiguration des Web-Server-Plug-ins für eine einzelne Instanz eines Liberty-Servers generieren, lesen Sie die Informationen in der Liberty-Dokumentation unter "Liberty mit einem Web-Server-Plug-in konfigurieren".

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 Zielhost beim Job-Manager registrieren, können Sie Sicherheitsinformationen des Betriebssystems speichern. Wenn Sie einen Job an ein oder mehrere Ziele übergeben, für die Sicherheitsinformationen gespeichert wurden, müssen Sie einen berechtigten Betriebssystembenutzernamen und entweder ein Kennwort oder die Informationen zum öffentlichen und privaten Schlüssel für den Benutzernamen angeben. Diese Sicherheitsberechtigungsnachweise müssen für alle Jobziele gültig sein.

Für diesen Job wird auf dem Zielhost eine JMX-Verbindung (Java Management Extensions) zu den Liberty-Servern auf den Zielhosts benötigt. Damit ein Liberty-Server für die Unterstützung von JMX-Verbindungen konfiguriert ist, nehmen Sie entweder das Feature "Lokaler Connector" oder das Feature "HTTP/REST-Connector" in die Datei server.xml des Servers auf. Im folgenden Beispiel sind die Features "Lokaler Connector" und "HTTP/REST-Connector" im Feature-Manager-Element einer Datei server.xml angegeben:
<featureManager>
  <feature>localConnector-1.0</feature>
  <feature>restConnector-1.0</feature>
  ...
</featureManager>
Wenn bei der Jobübergabe ein oder mehrere Liberty-Server nur das Feature "HTTP/REST-Connector" enthalten, müssen Sie den Benutzernamen und das Kennwort eines Liberty-Serveradministrators angeben. Der Job-Manager verwendet diese Berechtigungsnachweise, wenn er eine JMX-Verbindung zu den Servern herstellt. Falls alle Server das Feature "Lokaler Connector" enthalten, ist die Angabe eines Benutzernamens und Kennworts nicht erforderlich.

Weitere Informationen zum Definieren von Serveradministratoren finden Sie unter "Administratorrolle für Liberty zuordnen".

Zur Ausführung dieses Jobs benötigt ein Liberty-Server ein JDK (Java Development Kit) oder eine JRE (Java Runtime Environment). Legen Sie die JDK-oder JRE-Position fest, indem Sie eine der folgenden Aktionen ausführen:
  • Setzen Sie die Eigenschaft JAVA_HOME in der Datei server.env auf die JDK- oder JRE-Position. Der Job liest die Eigenschaft JAVA_HOME und setzt sie in der Zielumgebung, bevor der Befehl zum Generieren einer Datei plugin-cfg.xml für den Liberty-Server ausgeführt wird.
  • [AIX][HP-UX][Linux][Solaris][z/OS]Setzen Sie die Eigenschaft JAVA_HOME in der Benutzerdatei .bashrc auf die JDK- oder JRE-Position.
  • [AIX][HP-UX][Linux][Solaris][z/OS]Hängen Sie den JDK- oder JRE-Pfad an die Umgebungsvariable PATH an.
  • [Windows]Setzen Sie die Eigenschaft JAVA_HOME als Systemumgebungsvariable auf die JDK- oder JRE-Position.
  • [Windows]Hängen Sie den JDK- oder JRE-Pfad an die Systemvariable PATH an.

Informationen zu diesem Vorgang

Sie können die Administrationskonsole des Job-Managers oder des Deployment Manager verwenden, um eine einzelne zusammengeführte Datei mit dem Namen plugin-cfg.xml zu generieren, mit der ein Web-Server-Plug-in angewiesen wird, Anforderungen an mehrere Liberty-Server auf mehreren Hosts weiterzuleiten. Wählen Sie in der Konsole Zusammengeführte Plug-in-Konfiguration für Liberty-Server generieren aus, geben Sie die Server und Joboptionen an, überprüfen Sie die Zusammenfassung, und übergeben Sie dann den Job.

Diese Schritte beschreiben, wie der Job Zusammengeführte Plug-in-Konfiguration für Liberty-Profilserver generieren über eine Job-Manager- oder Deployment-Manager-Konsole ausgeführt wird. Anstatt eine Konsole zu verwenden, können Sie das Jobscript "generateMergedPluginConfigForLibertyProfileServers" in der Befehlsgruppe "AdministrativeJobs" ausführen. Weitere Informationen hierzu finden Sie im Artikel zu den Typen von Verwaltungsjobs.

Vorgehensweise

  1. Klicken Sie in der Navigationsstruktur der Administrationskonsole auf Jobs > Übergeben.
  2. Wählen Sie einen Job aus, um eine zusammengeführte Web-Server-Plug-in-Konfigurationsdatei für mehrere Liberty-Server zu generieren.
    1. Wählen Sie in der Liste den Jobtyp Zusammengeführte Plug-in-Konfiguration für Liberty-Profilserver generieren aus.
    2. Geben Sie optional eine Beschreibung für den Job an.
    3. Klicken Sie auf Weiter.
  3. Wählen Sie die Jobziele aus.
    1. Wählen Sie in der Liste eine Gruppe von Zielen aus, oder wählen Sie Zielnamen aus.

      In der Liste der Zielgruppen werden nur die Gruppen angezeigt, die für den ausgewählten Jobtyp gültig sind.

    2. Wenn Sie Zielnamen ausgewählt haben, geben Sie einen Zielnamen an und klicken Sie auf Hinzufügen oder auf Suchen und geben Sie die ausgewählten Ziele auf der Seite Ziele suchen an.
    3. Wenn Sie beim Regstrieren der Zielhosts mit dem Job-Manager nicht angegeben haben, dass die Sicherheitsauthentifizierungsinformationen gespeichert werden sollen, geben Sie für den Zugriff auf die Zielhosts einen Betriebssystembenutzernamen und ein Kennwort oder die Informationen zum öffentlichen und privaten Schlüssel an. Diese Sicherheitsberechtigungsnachweise müssen für alle Jobziele gültig sein.
    4. Klicken Sie auf Weiter.
  4. Geben Sie für den Job Zusammengeführte Plug-in-Konfiguration für Liberty-Profilserver generieren Parameter an.
    1. Geben Sie im Feld Server einen Ressourcennamen oder die vollständig qualifizierte Ressourcen-ID eines Servers an oder ein Muster, das ein oder mehrere Server angibt.

      Wenn ein Servername in mehrere Server mit demselben Namen aufgelöst wird, gibt das Produkt einen Fehler zurück und generiert die Datei plugin-cfg.xml nicht.

      Beispiel: Angenommen, sie möchten defaultServer für den Server angeben. Sie können die Serverressource mit einem der folgenden Werte angeben:

      Ressourcenname
      defaultServer
      Vollständig qualifizierte Ressourcen-ID
      runtime/wlp/liberty_server/defaultServer
      Ressourcennamensmuster
      *Server
      Vollständig qualifiziertes Ressourcen-ID-Muster
      runtime/wlp/liberty_server/*

      Wenn Sie die Namen der vorhandenen Liberty-Server auf den Zielen anzeigen möchten, klicken Sie auf der Seite Jobparameter angeben auf Suchen. Klicken Sie auf der Seite Zielressourcen suchen auf Suchen, um nach einer Liberty-Server-ID zu suchen, die auf allen Zielhosts existiert. Wählen Sie die Serverressourcen-ID aus, für die eine zusammengeführte Web-Server-Plug-in-Konfiguration generiert werden soll.

    2. Wenn einer oder mehrere dieser Server nur das Feature "HTTP/REST-Connector" (restConnector) enthält, geben Sie unter Benutzername den Benutzernamen eines Liberty-Serveradministrators an. Der Job-Manager verwendet diesen Wert, wenn er eine JMX-Verbindung zu den Servern herstellt.
    3. Wenn einer oder mehrere dieser Server nur das Feature "HTTP/REST-Connector" (restConnector) enthält, geben Sie als Kennwort das Kennwort eines Liberty-Serveradministrators an. Der Job-Manager verwendet diesen Wert, wenn er eine JMX-Verbindung zu den Servern herstellt.
    4. 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.

    2. Wählen Sie aus, wann der Job für die Übergabe verfügbar ist.
    3. Wählen Sie die Verfallszeit für den Job aus.
    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

Auf jedem Zielhost werden serverspezfische Dateien des Typs plugin-cfg.xml erstellt. Anschließend werden die Dateien vom Job-Manager in einer einzelnen Datei plugin-cfg.xml auf dem Job-Manager-Host zusammengeführt.

Nächste Schritte

Klicken Sie auf der Seite Jobstatus auf die ID des Jobs Zusammengeführte Plug-in-Konfiguration für Liberty-Profilserver generieren, 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 erfolgreich ausgeführt wird, schreibt das Produkt die zusammengeführte Datei plugin-cfg.xml in das Verzeichnis Stammverzeichnis_des_Anwendungsservers/profiles/Job-Manager-Profil/config/temp/JobManager/Job-ID/_mergedPluginDir/.

Wenn der Job nicht erfolgreich ausgeführt wird, wird der Job gestoppt, und das Produkt gibt einen Fehler zurück, wenn eine der folgenden Bedingungen vorliegt:
  • Ein Ziel-Liberty-Server ist nicht aktiv.
  • Für einen als Ziel verwendeten Liberty-Server ist kein JMX-Connector definiert.
  • Die Jobeigenschaften legen keine gültigen Berechtigungsnachweise für den Serveradministrator fest, um eine JMX-Verbindung zu einem als Ziel verwendeten Liberty-Server herzustellen, der nur das Feature HTTP/REST-Connector (restConnector) enthält.
Sehen Sie sich alle Fehlernachrichten zur Jobausführung an, beheben Sie alle Fehlerbedingungen, und übergeben Sie den Job anschließend erneut.

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_liberty_plugin_merge
Dateiname:tagt_jobmgr_liberty_plugin_merge.html