Administration Thin Client の使用

Administration Thin Client では、wsadmin ツールまたはスタンドアロンの管理 Java™ プログラムを、いくつかの Java アーカイブ (JAR) ファイルのみで実行することができます。これによって wsadmin ツールの始動に掛かる時間が減り、パフォーマンスが改善されます。 この情報は、JMX クライアント・プログラムをセットアップするためのものです。

始める前に

IBM® Software Development Kit (SDK) が Administration Thin Client にインストールされていることを確認します。 Administrative Thin Client 環境では、接続先のサーバーと同じ IBM SDK を使用することをお勧めします。
重要: Administration Thin Client は IBM SDK に対してサポートされます。 また、以下の条件を満たす限りにおいて、同じメジャー・バージョンを持つ対応する Oracle Java Development Kit (JDK) 用にもサポートされています。
  • クライアント管理アプリケーションが SOAP コネクターのみを使用する。
  • クライアント管理アプリケーションが、com.ibm.websphere.management.AdminClientFactory API を使用して JMX クライアントを取得する。
重要: シン管理クライアントを -conntype NONE オプションを指定して実行することはできません。

このタスクについて

Administration Thin Client を使用して、フィーチャー・パックを管理したり、 フィーチャー・パックに固有のアプリケーション成果物をデプロイしたりすることはできません。

Administration Thin Client は、SIP アプリケーション・アーカイブ (SAR) ファイルのインストールや、Tivoli® Access Manager などの外部 Java Authorization Contract for Containers (JACC) プロバイダーを使用するアプリケーションの編集をサポートしません。

Administrative Thin Client はサーバーへの Kerberos トークンの引き渡しはサポートしていません。ユーザー ID とパスワードを渡す基本認証のみがサポートされています。

Administration Thin Client は他のシン・クライアントとの共存をサポートしていません。

z/OS® プラットフォーム上の Administration Thin Client は localcomm を使用しません。

Administration Thin Client の情報のトレースとロギングについては、の『クライアントおよびスタンドアロン・アプリケーションでのトレースの使用可能化』を参照してください。

手順

  1. com.ibm.ws.admin.clientXXX.jar を WebSphere® Application Server 環境から WebSphere Application Server の外部の環境 (例えば c:¥MyThinClient) にコピーすることによって、Administration Thin-Client の JAR ファイルを使用可能にします。 Administration Thin Client JAR ファイル com.ibm.ws.admin.client_9.0.jar および com.ibm.ws.admin.client.forJython21_9.0.jar は、以下のいずれかのロケーションにあります。
    • AppServer/runtimes ディレクトリー。
    • アプリケーション・クライアントをインストールする際に オプションで Administration Thin Client を選択した場合は、AppClient/runtimes ディレクトリー。

    jython27 には com.ibm.ws.admin.client_9.0.jar を使用する必要があり、jython21 には com.ibm.ws.admin.client.forJython21_9.0.jar を使用する必要があります。

    注: バージョン 9 では、wsadmin はデフォルトで jython27 を使用します。Jython21 はまだサポートされており、jython21 を使用するには、wsadmin 引数 -usejython21 true を使用するか、wsadmin.properties ファイル内で com.ibm.ws.scripting.usejython21=true に更新する必要があります。
    トラブルの回避 (Avoid trouble) トラブルの回避 (Avoid trouble): エラーが発生し、jython がロードされない場合は、例えば、jython21 を使用しているのにクラスパスが com.ibm.ws.admin.client_9.0.jar に設定されていたり、jython27 を使用しているのに Java クラスパスが com.ibm.ws.admin.client.forJython21_9.0.jar に設定されていたりするなど、構成に誤りがあります。Java クラスパスを正しい jar に設定していることを確認してください。Jython27 では Java7 以下はサポートされません。接続しようとしている WebSphere サーバーと同じ Java レベルを使用する必要があります。gotcha
  2. Administration Thin-Client JAR ファイルを使用して、管理クライアント・プログラムをコンパイルおよびテストします。Java アプリケーションの場合、JAR ファイルを標準 Java 2 Platform, Standard Edition 環境内でコンパイルして実行することができます。詳しくは、シン管理クライアントを使用した管理アプリケーションのコンパイルの項を参照してください。
  3. メッセージ・ディレクトリーを app_server_root/properties ディレクトリーから C:¥MyThinClient¥properties directory.
  4. セキュリティーがオンの場合、次のファイルも必要になります。
    • com.ibm.ws.security.crypto.jar ファイルを AppServer/plugins ディレクトリーまたは AppClient/plugins ディレクトリーからコピーし、これを C:¥MyThinClient ディレクトリーに置きます。
    • IPC コネクターを使用している場合は、AppServer¥profiles¥profileName/properties または AppClient¥properties ディレクトリーから ipc.client.props ファイルをコピーし、C:¥MyThinClient¥properties ディレクトリーに置きます (これはオプションです)。 あるいは、ipc.client.props ファイルのプロパティーを Java コードの中でプログラムで設定します。
    • SOAP コネクターを使用する場合には、オプションで soap.client.props ファイルを AppServer¥profiles¥profileName¥properties ディレクトリーからコピーし、これを C:¥MyThinClient¥properties ディレクトリーに置きます。 次に、com.ibm.CORBA.securityEnabled プロパティーを true に設定することによって、クライアント・セキュリティーを使用可能にします。あるいは、soap.client.props ファイルのプロパティーを Java コードの中でプログラムで設定します。
    • RMI または JSR160RMI コネクターを使用している場合は、AppServer/profiles/profileName/properties ディレクトリーから sas.client.props ファイルをコピーし、C:¥MyThinClient¥properties ディレクトリーに置きます。

      インストール済み環境に ファイアウォールがあり、アプリケーション・クライアントが RMI を使用して通知を受け取る場合、アプリケーションを デプロイしようとした後、RemoteException エラーが出されることが あります。RMI を使用する通知リスナーは、通知を listen するクライアント上のリスナー・ポートを 必要とするため、ファイアウォールを越えて機能することはありません。このリスナー・ポート は、サーバーがクライアント・ポートに通知を戻そうとするとき、直接アクセス可能 ではありません。RMI の代わりに、通知をポーリングする SOAP コネクターを使用してください。

    • AppServer¥profiles¥profileName/properties ディレクトリーまたは AppClient/properties ディレクトリーから wsjaas_client.conf ファイルをコピーし、C:¥MyThinClient¥properties ディレクトリーに置きます。
    • ssl.client.props ファイル を、AppServer¥profiles¥profileName/properties ディレクトリー または AppClient/properties ディレクトリーのいずれかからコピーまたは生成して、 C:¥MyThinClient¥properties ディレクトリーに置きます。
      重要: このファイルには user.root プロパティーが含まれています。値をシン・クライアント・ディレクトリーに変更する必要があります。例えば、C:¥MyThinClient となります。
    • IBM SDK を使用する場合には、key.p12 ファイルと trust.p12 ファイルを AppServer¥profiles¥profileName¥etc ディレクトリーからコピーし、 これを C:¥MyThinClient¥etc ディレクトリーに置きます。 このタスクを完了するには、ファイルをシン・クライアント・ディレクトリーにコピーするか、スクリプトを実行してファイルを生成します。 詳細は、以下のトピックを参照してください。
      • ssl.client.props クライアント構成ファイル
      • 製品の旧バージョンとの相互運用
      • retrieveSigners コマンド
      • クライアント署名者を SSL で取得するためのセキュア・インストール
    • Sun JDK を使用する場合には、ssl.client.props ファイルで以下のプロパティーを変更して、 JKS 鍵ストアと JKS トラストストアを使用し、鍵マネージャーとトラスト・マネージャーで Sun Microsystems の実装を使用するようにします。
      com.ibm.ssl.alias=DefaultSSLSettings
      com.ibm.ssl.protocol=SSL
      com.ibm.ssl.securityLevel=HIGH
      com.ibm.ssl.trustManager=SunX509
      com.ibm.ssl.keyManager=SunX509
      com.ibm.ssl.contextProvider=SunJSSE
      com.ibm.ssl.enableSignerExchangePrompt=gui
      
      # Keystore information
      com.ibm.ssl.keyStoreName=ClientDefaultKeyStore
      com.ibm.ssl.keyStore=${user.root}/etc/keystore.jks
      com.ibm.ssl.keyStorePassword=keystore_password
      com.ibm.ssl.keyStoreType=JKS
      com.ibm.ssl.keyStoreProvider=SUN
      com.ibm.ssl.keyStoreFileBased=true
      
      # Truststore information
      com.ibm.ssl.trustStoreName=ClientDefaultTrustStore
      com.ibm.ssl.trustStore=${user.root}/etc/truststore.jks
      com.ibm.ssl.trustStorePassword=truststore_password
      com.ibm.ssl.trustStoreType=JKScom.ibm.ssl.trustStoreProvider=SUN
      com.ibm.ssl.trustStoreFileBased=true
  5. Administration Thin Client を起動するか、または Java 2 Platform, Standard Edition 環境内でリモートに wsadmin ツールを実行します。 管理アプリケーションを起動するには、以下のサンプル起動スクリプトを使用します。
    注: Oracle JDK を使用する場合、com.ibm.websphere.thinclient JVM プロパティーを true に設定してください。
    [Windows]
    set WAS_HOME=c:¥MyThinClient
    set USER_INSTALL_ROOT=%WAS_HOME%
    set JAVA_HOME=location_of_the_JRE_file
    
    REM C_PATH is the class path. Add to it as needed. 
    REM Classpath to use for jython27 (comment this out if using jython21)
    set C_PATH=%WAS_HOME%\com.ibm.ws.admin.client_9.0.jar;%WAS_HOME%\com.ibm.ws.security.crypto.jar 
    
    REM Classpath to use for jython21 (uncomment this to use jython21)
    REM set C_PATH=%WAS_HOME%\com.ibm.ws.admin.client.forJython21_9.0.jar;%WAS_HOME%\com.ibm.ws.security.crypto.jar 
    
    set SOAPURL=-Dcom.ibm.SOAP.ConfigURL=%WAS_HOME%¥properties¥soap.client.props
    set TC=-Dcom.ibm.websphere.thinclient=true
    
    if exist %JAVA_HOME%¥bin¥java.exe (
           set JAVA_EXE=%JAVA_HOME%¥bin¥java
    ) else (
           set JAVA_EXE=%JAVA_HOME%¥jre¥bin¥java
    ) 
    
    %JAVA_EXE% -classpath "%C_PATH%" %TC% -Duser.install.root=%USER_INSTALL_ROOT% -Dcom.ibm.SSL.ConfigURL=file %WAS_HOME%/properties/ssl.client.props %SOAPURL% your_class_file#
    [AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
    !/bin/bash 
    WAS_HOME=/MyThinClient
    USER_INSTALL_ROOT=${WAS_HOME}
    JAVA_HOME=location_of_the_JRE_file
    
    # C_PATH is the class path.  Add to it as needed. 
    # Classpath to use for jython27 (comment this out if using jython21)
    C_PATH=${WAS_HOME}/com.ibm.ws.admin.client_9.0.jar:${WAS_HOME}/com.ibm.ws.security.crypto.jar 
    
    # Classpath to use for jython27 (comment this out if using jython27)
    C_PATH=${WAS_HOME}/com.ibm.ws.admin.client.forJython21_9.0.jar:${WAS_HOME}/com.ibm.ws.security.crypto.jar 
    
    SOAPURL=-Dcom.ibm.SOAP.ConfigURL=${WAS_HOME}/properties/soap.client.props
    TC=-Dcom.ibm.websphere.thinclient=true
    
    if [[ -f ${JAVA_HOME}/bin/java ]]; then
           JAVA_EXE="${JAVA_HOME}/bin/java"
    else
           JAVA_EXE="${JAVA_HOME}/jre/bin/java"
    fi
    
    ${JAVA_EXE} -classpath "${C_PATH}" $TC -Duser.install.root=${USER_INSTALL_ROOT} -Dcom.ibm.SSL.ConfigURL=file:${WAS_HOME}/properties/ssl.client.props ${SOAPURL} your_class_file

トピックのタイプを示すアイコン タスク・トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_adminclient
ファイル名:txml_adminclient.html