Konfiguration von WebSphere Application Server

Zur Konfiguration von WebSphere Application Server for z/OS gehört das Einrichten einer Datenquelle, einer Anzahl von Servern sowie die Konfiguration von JMS und Sicherheitseinstellungen. Alle diese Tasks können durch Ausführen des bereitgestellten Ziels configure durchgeführt werden.

Das vom Ant-Ziel configure erstellte Profil übernimmt die folgenden Standardwerte. Beim Aufruf des Ziels kann die Eigenschaft 'cell.name' überschrieben werden. Die Eigenschaft 'profile.name' hat möglicherweise keinen anderen Wert als "default", da dies der einzige Wert ist, der von WebSphere Application Server for z/OS unterstützt wird.

Der Befehl build.sh configure sollte vom Verzeichnis $SERVER_DIR aus ausgeführt werden, damit die automatische Konfiguration aufgerufen wird. Dieses Ziel erfordert, dass die Dateien AppServer.properties und Bootstrap.properties im Verzeichnis $SERVER_DIR/project/properties1 vorhanden sind. Siehe Eigenschaftendateien sowie das Dokument Cúram Server Developer's Guide zu weiteren Informationen bezüglich der Einrichtung von Bootstrap.properties. In Konfiguration von WebSphere Application Server werden Beispielinhalte der Datei AppServer.properties gezeigt.

Standardmäßig wird vom Ziel configure eine Datenquelle für den DB2 Universaltreiber vom Typ 4 (XA) eingerichtet. Es kann jedoch auch eine Datenquelle für den DB2 Universaltreiber vom Typ 2 (RSS) konfiguriert werden, indem man die Eigenschaft 'curam.db.type2.required' in AppServer.properties setzt. Bei Verwendung dieser Eigenschaft müssen Sie die Umgebungsvariable 'DB2DIR' auf Ihren DB2 for z/OS-Installationspfad gesetzt haben.

Es gibt eine Anzahl möglicher Arten, DB2 for z/OS und WebSphere Application Server for z/OS so zu konfigurieren, dass ein Treiber vom Typ 2 unterstützt wird. Lesen Sie hierzu WebSphere Application Server, Version 7.0 Information Center und den Artikel "DB2 Universal JDBC Driver Support" sowie verwandte Informationen.

Es besteht die Möglichkeit, einen Universaltreiber vom Typ 2 zu konfigurieren, indem man die optionale Eigenschaft 'curam.db.zos.jcc.propfile' übergibt und den vollständig qualifizierten Namen einer DB2 for z/OS jcc-Eigenschaftendatei angibt, die in der Servant-JVM-Eigenschaft 'db2.jcc.propertiesFile' gesetzt wird, in der verschiedene Einstellungen wie die Subsystem-ID enthalten sind.

Abbildung 1. Beispiel für eine Eigenschaftendatei des Anwendungsservers
## APPLICATION SERVER PROPERTIES

# Property to indicate WebSphere is installed.
as.vendor=IBM

# The username and encrypted password for admin server.
security.username=<z.B. websphere>
security.password=<encrypted password>

# The name of the WebSphere Cell.
cell.name=mycell

# The name of the WebSphere Node.
node.name=MyNode

# The name of the server on which the application will be hosted.
curam.server.name=CuramServer
curam.server.port=2809

# The alias that should be used for the database authorization
curam.db.auth.alias=dbadmin

# HTTP Port for the server on which the client
# will be accessed
curam.client.httpport=9044

# HTTP Port for the server on which the Web services
# will be accessed
curam.webservices.httpport=9082

# Property to set JVM initial and maximum heap size.
curam.server.jvm.heap.size=1024

Standardmäßig setzt das Ziel configure die JVM-Initialen und die maximale Größe des Heapspeichers auf "1024" MB. Man kann diese Standardwerte jedoch überschreiben, indem man die Eigenschaft 'curam.server.jvm.heap.size' in der Datei AppServer.properties einrichtet.

Für WebSphere Application Server for z/OS muss für die Eigenschaft auch ein Zellenname, 'cell.name', eingeschlossen werden, der gleich dem augeschriebenen Namen der Zelle ist.

Anmerkung:
  1. Die Einstellung des Java-Heapspeichers, wie in dem Beispiel unter Konfiguration von WebSphere Application Server beschrieben und von den Konfigurationsscripts gesetzt, dient nur Anschauungszwecken. Je nach Größe Ihrer angepassten Anwendung, Implementierungsstrategie usw. können diese Einstellungen zu hoch oder zu niedrig sein. Der optimale Wert wird durch das Überwachen der Speicherleistung Ihres Servers bestimmt.
  2. Bei den eingeschlossenen Datenbanktreibern von WebSphere Application Server for z/OS können während des Abrufens großer CLOBS und BLOBS (3MB+) aus der Datenbank Speicherprobleme auftreten. Solche Probleme können umgangen werden, indem man auf dem implementierten Server den JVM-Parameter der maximalen Heapspeichergröße angemessen erhöht.
1 Es ist möglich, diesen Standardort für die Eigenschaftendatei zu überschreiben, indem man

bei der Ausführung des Ziels configure -Dprop.file.location=<new location> angibt.