管理コンソール、wsadmin ツール、アプリケーション・サーバー・コマンド、コマンド行インターフェースから実行されるスクリプト、またはユーザーが書き込むカスタム Java 管理クライアント・プログラムでプロパティーを指定または設定することができます。 また、soap.client.props ファイルで SOAP コネクター・プロパティーも設定することができます。
Java Management Extensions (JMX) コネクターは Remote Method Invocation (RMI) コネクターまたは Simple Object Access Protocol (SOAP) コネクターのいずれかです。
wsadmin ツール、アプリケーション・サーバー・コマ ンド、またはスクリプトの JMX コネクター・プロパティーをコード化する方法の特定の情報については、 特定のツールまたはコマンドを参照してください。 カスタム Java 管理クライアント・プログラムの JMX コネクター・プロパティーをコード化する方法の具体的な情報に ついては、 Java API documentation for Application Server を参照してください。
管理コンソールでは、このトピックは特定の設定またはプロパティーのコーディングを指定します。 JMX コネクターに固有の soap.client.props ファイルにあるプロパティーのコーディングが指定されます。 これらのプロパティーは、com.ibm.SOAP で始まります。Application Server の他の場所で設定される情報を含む、 soap.client.props ファイル内のその他のプロパティーについては、ここでは取り上げません。 soap.client.props ファイルでのみ設定可能な、 com.ibm.ssl.contextProvider プロパティーのコーディングが指定されます。
各プロファイルは、プロパティー・ファイルを installation root/profiles/profile name/properties/soap.client.props に保持しています。 これらのプロパティー・ファイルを使用すると、セキュリティー・プロパティーおよびタイムアウト・プロパティーを含む各種のプロパティーを設定することができます。 これらのプロパティーは、 特定のプロファイル内で実行するプロセス間で SOAP JMX コネクターを使用するすべての管理接続のデフォルトです。 例えば、特定のプロファイルの下で実行している wsadmin プログラムは、プロパティーが他のプログラマチックな方法でオーバーライドされない限り、 SOAP コネクターの振る舞いのため、そのファイルからのプロパティー値を使用します。
この項で説明する JMX コネクター・カスタム・プロパティー管理コンソール・パネルを表示するには、「サーバー 」>「 アプリケーション・サーバー」>「server_name」 >「 サーバー・インフラストラクチャー」>「管理」>「管理サービス」>「追加プロパティー」>「JMX コネクター」>「connector type」>「追加プロパティー」>「カスタム・プロパティー」をクリックします。
このセクションでは、 SOAP コネクターと関連する JMX コネクター・プロパティーについて説明します。
SOAP 要求タイムアウト
選択する値は、多くの要因に応じて異なります。例えば、サーバーにインストールされているアプリケーションのサイズおよび数、ご使用のマシンのスピード、およびマシンの使用レベルなどの要因があります。
要求タイムアウトのプログラムのデフォルト値は、600 秒です。 ただし、SOAP クライアントに接続するその他のコンポーネントは、デフォルトをオーバーライドすることができます。 soap.client.props ファイルを使用するコンポーネントのデフォルト値は 180 秒です。
プロパティー | com.ibm.SOAP.requestTimeout |
データ型 | 整数 |
範囲 (秒) | 0 から n まで プロパティーがゼロ (0) の場合、要求は決してタイムアウトになりません。 |
デフォルト | 180 |
プロパティー | requestTimeout |
データ型 | 整数 |
範囲 (秒) | 0 から n まで プロパティーがゼロ (0) の場合、要求は決してタイムアウトになりません。 |
デフォルト | 600 |
構成 URL
プロパティー | ConfigURL |
データ型 | ストリング |
有効な値 | http://Path/soap.client.props |
デフォルト | なし |
セキュリティー・コンテキスト・プロバイダー
このプロパティーは、Secure Sockets Layer (SSL) インプリメンテーションが、Application Server と SOAP クライアント間で使用されることを示します。
プロパティー | com.ibm.ssl.contextProvider |
データ型 | ストリング |
有効な値 | IBMJSSE2 |
デフォルト | IBMJSSE2 |
Secure Sockets Layer (SSL) セキュリティー
プロパティー | com.ibm.SOAP.securityEnabled |
データ型 | ブール |
デフォルト | False |
プロパティー | securityEnabled |
データ型 | ブール |
デフォルト | False |
このセクションでは、 SOAP コネクターと RMI コネクターの両方に関連する JMX コネクター・プロパティーについて説明します。
コネクター・タイプ
プロパティー | タイプ |
データ型 | ストリング |
有効な値 | SOAPConnectorRMIConnector |
デフォルト | SOAPConnector |
ホスト
プロパティー | ホスト |
データ型 | ストリング |
有効な値 | ホスト名または IP アドレス |
デフォルト | なし |
ポート
プロパティー | ポート |
データ型 | 整数 |
有効な値 | ポート番号 |
デフォルト | なし |
ユーザー名
プロパティー | com.ibm.SOAP.loginUserid |
データ型 | ストリング |
有効な値 | 値は、SOAP または RMI のグローバル SSL 設定値と一致する必要があります。 |
デフォルト | なし |
プロパティー | username |
データ型 | ストリング |
有効な値 | 値は、SOAP または RMI のグローバル SSL 設定値と一致する必要があります。 |
デフォルト | なし |
パスワード
プロパティー | com.ibm.SOAP.loginPassword |
データ型 | ストリング |
有効な値 | 値は、SOAP または RMI のグローバル SSL 設定値と一致する必要があります。 |
デフォルト | なし |
プロパティー | password |
データ型 | ストリング |
有効な値 | 値は、SOAP または RMI のグローバル SSL 設定値と一致する必要があります。 |
デフォルト | なし |
このセクションでは、RMI コネクターに付帯する JMX コネクター・プロパティーについて説明します。
JSR 160 RMI コネクターの無効化
仕様に準拠した JMX 機能を自動的に受け取れるよう、JMX リ モート・アプリケーション・プログラミング・インターフェース (JSR 160) のサポートはデフォルトで使用可能になっています。 特定のサーバーに対してこの機能を無効にするには、以下のオプションの 1 つを使用して、プロパティーを設定します。
プロパティー | disableJDKJMXConnector |
データ型 | ストリング |
値 | true |