Konfigurationsdokumente

WebSphere Application Server speichert Konfigurationsdaten in mehreren Dokumenten in einer kaskadierenden Verzeichnishierarchie. Die meisten Konfigurationsdokumente weisen XML-Inhalt auf.

Die Konfigurationsdokumente beschreiben Ihren Server, dessen Konfiguration und Inhalt.

Verzeichnishierarchie mit Dokumenten

Änderungen, die an Konfigurationsdokumenten vorgenommen werden, werden im Zellenrepository gespeichert.

Die höchste Ebene der Hierarchie ist das Verzeichnis cells. Es enthält ein Unterverzeichnis für die Zelle. Der Name des Unterverzeichnisses für die Zelle entspricht dem Namen der Zelle. Die Konfigurationsdokumente für eine Zelle mit dem Namen cell1 befinden sich beispielsweise im Unterverzeichnis cell1.

Die Unterverzeichnisse unterhalb der Zelle enthalten den gesamten Satz von Dokumenten für den Knoten und den Server in der Zelle.

Jedes Unterverzeichnis für eine Zelle weist die folgenden Dateien und Unterverzeichnisse auf:

  • Die Datei cell.xml, die Konfigurationsdaten für die Zelle bereitstellt.
  • Dateien wie z. B. security.xml, virtualhosts.xml, resources.xml und variables.xml, in denen Konfigurationsdaten bereitgestellt werden, die für den Knoten in der Zelle gelten.

  • Das Unterverzeichnis nodes, in dem ein Unterverzeichnis für den Knoten in der Zelle enthalten ist. Die Namen des Unterverzeichnisses für den Knoten entspricht dem Namen des Knotens.

    Das Unterverzeichnis für einen Knoten enthält Dateien wie z. B. variables.xml und resources.xml, in denen Konfigurationsdaten bereitgestellt werden, die auf dem gesamten Knoten gelten. Beachten Sie, dass diese Dateien dieselben Namen haben, wie die Dateien im Verzeichnis der übergeordneten Zelle. Die in diesen Knotendokumenten angegebenen Konfigurationen setzen die Konfigurationen außer Kraft, die in Zellendokumenten mit demselben Namen angegeben wurden. Beispiel: Wenn eine bestimmte Variable in beiden Dateien variables.xml, also auf Zellen- und auf Knotenebene, vorhanden ist, verwendet der Server auf dem Knoten die Variablendefinition im Knotendokument und ignoriert die Definition im Zellendokument.

    Das Unterverzeichnis eines Knotens enthält ein Unterverzeichnis für den Server, der auf dem Knoten definiert ist. Der Name des Unterverzeichnisses entspricht dem Namen des Servers. Das Unterverzeichnis für den Server enthält eine Datei server.xml, in der Konfigurationsdaten bereitgestellt werden, die für den Server spezifisch sind. In Serverunterverzeichnissen befinden sich möglicherweise die Dateien security.xml, resources.xml und variables.xml, die nur für den Server geltende Konfigurationsdaten enthalten. Die in diesen Serverdokumenten angegebenen Konfigurationen setzen die Konfigurationen außer Kraft, die in übergeordneten Zellen- oder Knotendokumenten mit demselben Namen angegeben wurden.

  • Das Unterverzeichnis applications, in dem für jede in der Zelle implementierte Anwendung ein Unterverzeichnis enthalten ist. Die Namen der Unterverzeichnisse für Anwendungen entsprechen den Namen der implementierten Anwendungen.

    Jedes Unterverzeichnis für eine implementierte Anwendung enthält eine Datei deployment.xml, in der Konfigurationsdaten für die Anwendungsimplementierung enthalten sind. Jedes Unterverzeichnis enthält auch ein Unterverzeichnis META-INF, in dem eine J2EE-Anwendungsimplementierungsdeskriptordatei (Java™ 2 Platform Enterprise Edition) sowie IBM® Erweiterungs- und Bindungsdateien für die Implementierung enthalten sind. Unterverzeichnisse für implementierte Anwendungen enthalten auch Unterverzeichnisse für alle WAR-Dateien und Entity-Bean-JAR-Dateien in der Anwendung. Binärdateien wie z. B. JAR-Dateien sind auch Bestandteil der Konfigurationsstruktur.

Beispiel für eine Dateistruktur:

cells
  cell1
     cell.xml resources.xml virtualhosts.xml variables.xml security.xml
     nodes
        nodeX
           node.xml variables.xml resources.xml serverindex.xml
           serverA
              server.xml variables.xml
     applications
        sampleApp1
           deployment.xml           META-INF
              application.xml ibm-application-ext.xml ibm-application-bnd.xml
        sampleApp2
           deployment.xml           META-INF
              application.xml ibm-application-ext.xml ibm-application-bnd.xml

Konfigurationsdokumente ändern

Sie können eines der Verwaltungstools (Konsole, wsadmin, Java-APIs) verwenden, um Konfigurationsdokumente zu ändern oder direkt zu bearbeiten. Die Verwendung der Administrationskonsole ist vorzuziehen, da die Konsole an den Konfigurationen vorgenommene Änderungen prüft. Der Abschnitt "Beschreibung der Konfigurationsdokumente" enthält Informationen dazu, ob Sie ein Dokument mithilfe der Verwaltungstools bearbeiten können oder ob Sie es direkt bearbeiten müssen.

Umsetzung von Konfigurationsdateien

Das Repository der Masterkonfiguration für WebSphere Application Server speichert Konfigurationsdateien für alle Knoten in der Zelle. Wenn Sie für den Deployment Manager ein Upgrade von einem Release von WebSphere Application Server auf ein anderes durchführen, werden die Konfigurationsdateien, die im Master-Repository für die Knoten mit dem älteren Release gespeichert sind, in das Format des neuen Release konvertiert.

Durch diese Konvertierung kann der Deployment Manager die Konfigurationsdateien einheitlich verarbeiten. Knoten mit einem alten Release können Konfigurationsdateien, die das Format des neuen Release aufweisen, jedoch nicht einfach verwenden. WebSphere Application Server löst das Problem, indem die Konfigurationsdateien vom Master-Repository mit einem Knoten mit einem älteren Release synchronisiert werden. Die Konfigurationsdateien werden zunächst in das Format des älteren Release transformiert, bevor sie an den Knoten geliefert werden. WebSphere Application Server führt folgende Transformationen für die Konfigurationsdokumente aus:
  • Der XML-Namensbereich wird vom Format des neuen Release in das Format des alten Release geändert.
  • Attribute aus Dokumenten der Zellebene, die nur für das neue Release gelten, werden entfernt.
  • Neue Ressourcendefinitionen, die für die Knoten mit einem älteren Release nicht verständlich sind, werden entfernt.

Symbol, das den Typ des Artikels anzeigt. Konzeptartikel



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