Erstellen eines benutzerdefinierten Java-Verwaltungsclientprogramms mit WebSphere Application Server administrative Java-APIs

Dieser Abschnitt beschreibt die Entwicklung eines Java™-Programms für den Zugriff auf WebSphere® Application Server Verwaltungssystem durch Verwendung der administrativen Anwendungsprogrammierschnittstellen (APIs) des Produkts.

Vorbereitungen

Diese Task setzt Grundkenntnisse in der Programmierung mit JMX-APIs (Java Management Extensions) voraus. Informationen zu den Java-APIs finden Sie in der Dokumentation zu den Anwendungsprogrammierschnittstellen.

Informationen zu dieser Task

Halten Sie sich an die folgenden Richtlinien, wenn Sie Verwaltungsclients entwickeln und ausführen, die verschiedene JMX-Connector verwenden, in denen die Sicherheit aktiviert ist. Die Einhaltung dieser Richtlinien gewährleistet das Verhalten zwischen den verschiedenen JMX-Connector-Implementierungen. Alle Programmiermodelle, die von diesen Richtlinien abweichen, werden nicht unterstützt.

Erstellen Sie einen einzelnen Verwaltungsclient, bevor Sie weitere Verwaltungsclients erstellen und verwenden.
Erstellen und verwenden Sie einen Verwaltungsclient im selben Thread.
Gehen Sie wahlweise wie folgt vor, um eine Benutzer-ID und ein Kennwort für einen neuen Verwaltungsclient anzugeben:
- Legen Sie in der Eigenschaftendatei eine Standardbenutzer-ID und ein Kennwort fest.
- Legen Sie eine individuelle Benutzer-ID und das zugehörige Kennwort fest. Wenn Sie einen Verwaltungsclient mit einer individuellen Benutzer-ID und dem zugehörigen Kennwort (kein Standard) erstellen, geben Sie beim Erstellen weiterer Verwaltungsclients ebenfalls diese diese Benutzer-ID und das Kennwort an.

Vorgehensweise

Entwickeln Sie ein administratives Clientprogramm.
Erstellen und führen Sie das administrative Clientprogramm aus.
Die erforderlichen Schritte für das Erstellen und Ausführen des Programms richten sich nach der Anwendungsumgebung, in der der Code ausgeführt wird.

Einzelheiten zum Erstellen und Ausführen von Verwaltungsclientprogrammen finden Sie im Artikel "Anwendungsclients verwenden".
Wenn Ihr Verwaltungsclient Simple Object Access Protocol (SOAP) als Connector verwendet, müssen Sie Java Secure Socket Extension (JSSE) als Transportschicht konfigurieren. Das Produkt unterstützt Secure Sockets Layer (SSL) und Transport Layer Security (TLS) für die Pakete Java Secure Sockets Extension (JSSE) und System SSL.
Erstellen Sie digitale Zertifikate für die Benutzer-ID, unter der der Verwaltungsclient ausgeführt wird. Wenn Sie System Authorization Facility (SAF) zum Erstellen und Speichern digitaler Zertifikate in einem SAF-Schlüsselring verwenden möchten, lesen Sie den Artikel "SSL-Sicherheit für abgehende Clientanforderungen definieren". (Sie können den Namen des Schlüsselrings, den Sie erstellen, im nächsten Schritt speichern.)
Aktualisieren Sie diesoap.client.propsDatei improfile_root/propertiesVerzeichnis, das von Ihrem Verwaltungsclient mit dem Namen des SAF-Schlüsselrings verwendet wird. Anweisungen zum Aktualisieren dersoap.client.propseportiert.
Erstellen Sie das Verwaltungsclientprogramm.
Kompilieren Sie das Programm mit dem Befehl javac und geben Sie die Position der erforderlichen JAR-Dateien im Klassenpfad an.
Wenn Ihr Installationsverzeichnis beispielsweise/DeploymentManagerEin typischer Befehl würde wie im folgenden Beispiel aussehen:
```
javac -extdirs "$JAVA_HOME/lib/ext;
/DeploymentManager/classes;/DeploymentManager/lib;
/DeploymentManager/lib/ext"  MyAdminClient.java
```
(Dieser Befehl wurde zur besseren Übersichtlichkeit in mehreren Zeilen angegeben.)
Führen Sie das administrative Clientprogramm aus.
Führen Sie das Verwaltungsclientprogramm aus. Konfigurieren Sie die Laufzeitumgebung so, dass das Programm alle vorausgesetzten Komponenten finden kann. Viele der Batch- oder Skriptdateien imbinDas Verzeichnis im Installationsstammverzeichnis erfüllt eine ähnliche Funktion. Das folgende ist ein Beispiel für eine Batchdatei, die ein administratives Clientprogramm namensMyAdminClientfolgt:
```
@echo off

binDir=`dirname "$0"`       
. "$binDir/setupCmdLine.sh"


"$JAVA_HOME/bin/java" "$CLIENTSOAP" "-Dwas.install.root=$WAS_HOME"
"-Dwas.repository.root=$CONFIG_ROOT" 
-Dcom.ibm.CORBA.BootstrapHost=$COMPUTERNAME 
 "-Djava.ext.dirs=$JAVA_HOME/lib/ext;$WAS_HOME/classes;
$WAS_HOME/lib;$WAS_HOME/lib/ext" MyAdminClient $@
```
(Der Inhalt dieser Stapeldatei wurde zur besseren Übersichtlichkeit in mehreren Zeilen angegeben.)