WebSphere Application Server 管理 Java API を使用したカスタム Java 管理クライアント・プログラムの作成

製品の管理アプリケーション・プログラミング・インターフェース (API) を使用して、 WebSphere® Application Server 管理システムにアクセスするための Java™ プログラムを開発できます。

開始前に

このタスクでは、Java Management Extensions (JMX) API プログラミングに関する基本的な知識があることを前提としています。 Java API については、アプリケーション・プログラミング・インターフェースの資料を参照してください。

このタスクについて

さまざまな JMX コネクターを使用し、セキュリティーが使用可能である管理クライアントを開発し、実行する場合、次のガイドラインを使用します。これらのガイドラインに従えば、異なる JMX コネクターの実装間の振る舞いが保障されます。これらのガイドラインから外れるいかなるプログラミング・モデルもサポートされません。

単一の管理クライアントを作成し、使用してから、他の管理クライアントを作成して使用します。
同じスレッドに管理クライアントを作成して使用します。
次の方法の 1 つを使用してユーザー ID およびパスワードを指定し、新規管理クライアントを作成します。
- プロパティー・ファイルにデフォルトのユーザー ID およびパスワードを指定します。
- デフォルト以外のユーザー ID およびパスワードを指定します。デフォルトでないユーザー ID およびパスワードで管理クライアントを作成した場合は、その後作成する管理クライアントでは、デフォルトでないユーザー ID およびパスワードを指定してください。

手順

管理クライアント・プログラムを開発します。
管理クライアントが Simple Object Access Protocol (SOAP) をコネクターとして使用する場合は、Java Secure Socket Extension (JSSE) をトランスポート層として構成する必要があります。この製品は、Secure Sockets Layer (SSL) および Transport Layer Security (TLS) を、Java Secure Sockets Extension (JSSE) および System SSL パッケージとともに使用します。
管理クライアントを実行するために使用されるユーザー ID のデジタル証明書を作成します。 System Authorization Facility (SAF) を使用してデジタル証明書を作成し、それらを SAF 鍵リングに保管する場合、クライアント・アウトバウンド要求の SSL セキュリティーの定義を参照してください。 (作成する鍵リングの名前を、次のステップで使用するために保存することができます。)
以下を更新します。soap.client.propsファイルprofile_root/propertiesSAF 鍵リングの名前を持つ管理クライアントによって使用されているディレクトリー。更新の手順については、「Java Secure Sockets Extension での System Authorization Facility 鍵リングの使用」の 2 番目のステップを参照してください。soap.client.propsを適用します。
管理クライアント・プログラムを作成します。
これを javac コマンドでコンパイルし、必要な JAR ファイルの場所をクラスパス引数に提供します。
例えば、インストール・ディレクトリーが以下のようになっているとします。/DeploymentManager標準的なコマンドは、以下の例のようになります。
```
javac -extdirs "$JAVA_HOME/lib/ext;
/DeploymentManager/classes;/DeploymentManager/lib;
/DeploymentManager/lib/ext"  MyAdminClient.java
```
(上記のコマンドは印刷スペースの関係上、複数行に分割されています。)

管理クライアント・プログラムを実行します。

ランタイム環境をセットアップして、管理クライアント・プログラムを実行し、このプログラムですべての前提条件を検出できるようにします。バッチ・ファイルまたはスクリプト・ファイルの多くは、binインストール・ルートの下のディレクトリーは、同様の機能を実行します。以下は、管理クライアント・プログラムを実行するバッチ・ファイルの例です。MyAdminClientfollows:

@echo off

call "%~dp0setupCmdLine.bat"

"%JAVA_HOME%\bin\java" "%CLIENTSAS%" "-Dwas.install.root=%WAS_HOME%" 
"-Dwas.repository.root=%CONFIG_ROOT%" 
-Dcom.ibm.CORBA.BootstrapHost=%COMPUTERNAME% 
 "-Djava.ext.dirs=%JAVA_HOME%\jre\lib\ext;%WAS_HOME%\classes;
%WAS_HOME%\lib;%WAS_HOME%\lib\ext" MyAdminClient %*</pre>--><!--(The contents of the previous batch file is split on multiple lines for publication.)--><pre>@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 $@

(上記のバッチ・ファイルの内容は、印刷スペースの関係上、複数行に分割されています。)