Java管理クライアントプログラムの作成WebSphere Application Server管理用Java API

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

開始前に

このタスクでは、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/properties管理クライアントが使用しているディレクトリに SAF キーリングの名前を指定します。更新手順については、「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

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 $@
```
(上記のバッチ・ファイルの内容は、印刷スペースの関係上、複数行に分割されています。)