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.
- 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.
Konzeptartikel