launchClient ツール

あなたはJava™ Platform, Enterprise Edition（ Java EE ) のコマンドライン構文launchClientツールWebSphere® Application Server。

重要：特定のプロファイルからコマンドを実行するすべてのユーザーには、同じプロファイルを使用する他のユーザーによって作成されたファイルを変更する権限が必要です。 持っていない場合は、ログ・ファイルにアクセス権拒否エラーが書き込まれます。 この問題を回避するには、以下のポリシーのいずれかを検討してください。
  • [AIX Solaris HP-UX Linux Windows]個々のユーザー権限に特定のプロファイルを使用する。
  • 特定のプロファイルで実行されるすべてのコマンドに常に同じユーザーを使用する。
  • 特定のプロファイルのユーザーがすべて同じグループに属するようにする。 さらに、グループの各ユーザーが、同じプロファイル内の他のメンバーが作成したファイルに対する読み取りおよび書き込み権限を持っていることを確認する。

以下は、launchClient ツールのコマンド行呼び出し構文の例です。

launchClient [-profileName pName | -JVMOptions options | -help | -?] userapp [-CCname=value] [app args]
ここで、
  • userapp は、アプリケーション・クライアントを含む EAR ファイルへのパスと名前です。
  • -CCname=value は、クライアント・コンテナーの名前と値のペアのパラメーターです。 サポートされている名前と値のペアの引数については、 クライアント・コンテナー・パラメーターのセクションを参照してください。
  • app args は、アプリケーション・クライアントに渡される引数です。
  • -profileName は、マルチ・プロファイルのインストールにおけるアプリケーション・サーバー・プロセスのプロファイルを定義します。 -profileName オプションは、単一プロファイル環境または アプリケーション・クライアント・インストールで実行する場合は必要ありません。

    [AIX Solaris HP-UX Linux Windows]デフォルトはdefault_profile。

  • -JVMオプション有効なJava標準または非標準のオプション文字列ですが、-cpまたは-classpath。 ストリングの前後には引用符を挿入してください。
  • -ヘルプ、 -？使用情報を出力します。

1 番目のパラメーターは、 -help, -? にするか、 あるいはパラメーターをまったく含まないかのいずれかにする必要があります。 -profileName pName および -JVMOptions オプションは、 オプショナル・パラメーターです。 使用する場合は、 <ユーザーアプリ>パラメータ。 他のパラメーターはすべてオプションであり、userapp パラメ ーターの後ろに任意の順番に指定できます。 のJava EEアプリケーションクライアントランタイムは、-CCプレフィックスを追加し、それらのパラメータをアプリケーション クライアントに渡します。

クライアント・コンテナー・パラメーター

サポートされている引数は以下のとおりです。

-CCadminConnectorHost
構成情報が取り出されるサーバーのホスト名を指定します。

[AIX Solaris HP-UX Linux Windows]デフォルトは-CCBootstrapHostパラメータまたは値、ローカルホスト、もし-CCBootstrapHostパラメータが指定されていません。

-CCadminConnectorPort
管理クライアント機能が使用するポート番号を示します。 SOAP 接続のデフォルト値は 8880、 リモート・メソッド呼び出し (RMI) 接続のデフォルト値は 2809 です。
-CCadminConnectorType
管理クライアントがサーバーに接続する方法を指定します。 RMI 接続タイプを使用する場合は RMI を指定し、 SOAP 接続タイプを使用する場合は SOAP を指定します。 デフォルト値は SOAP です。
-CCadminConnectorUser
サーバーで認証が必要な場合は、 管理クライアントがこのユーザー名を使用します。 接続タイプが SOAP で、サーバー上でセキュリティーが使用可能である場合は、 このパラメーターが必要です。
-CCadminConnectorPassword
-CCadminConnectorUser パラメーターが指定するユーザー名のパスワード。
-CCaltDD
代替デプロイメント記述子ファイルの名前。 このパラメーターは、使用するデプロイメント記述子を指定するために、 -CCjar パラメーターと一緒に使用されます。 クライアント JAR ファイルが複数のデプロイメント記述子で構成されている場合に、この引数を使用します。 値を null に設定して、クライアント JAR ファイルの標準デプロイメント記述子を使用します。
-CCBootstrapHost
最初に接続したいホスト・サーバーの名前。 フォーマットは your_server_of_choice.com です。
-CCBootstrapPort
サーバーのポート番号。 この引数を指定しない場合は、 WebSphere Application Serverデフォルト値は使用済み。
-CCclassLoaderMode
クラス・ローダー・モードを指定します。 PARENT_LAST が指定された場合、 クラス・ローダーはクラスをローカル・クラスパスからロードしてから、クラス・ロードをその親に委任します。 以下のためにロードされたクラスは影響を受けます。
  • 定義されたクラスJava EEアプリケーションクライアント
  • で定義されたリソースJava EE応用
  • マニフェストに指定されたクラスJava EEクライアント JAR ファイル
  • -CCclasspath オプションを使用して指定されたクラス
PARENT_LAST が指定されない場合、デフォルト・モード、 PARENT_FIRST により、クラス・ローダーはクラス・ロードを その親クラス・ローダーに委任してから、クラスをローカル・クラスパスからロードします。
-CCclasspath
クラスパスの値。 アプリケーションを立ち上げるとき、システム・クラスパスが使用されます。 EAR ファイルまたはシステム・クラスパスの一部にないクラスにアクセス する場合は、該当するクラスパスをここで指定します。 複数のパスは、連結してもかまいません。
-CCD
このオプションを使用すると、 WebSphere Application Server初期化中に指定されたシステム プロパティを設定します。 等号（=）記号は使用しないでください。-CCD。 例えば：-CCDcom.ibm.test.property=testvalue複数指定できます-CCDパラメーター。 このパラメータの一般的な形式は-CCD<property key>=<property value>。例えば、-CCDI18NService.enable=true 。
-CCdumpJavaNameSpace
Java のダンプの生成を制御します。起動されたアプリケーション用の名前空間。この名前空間は、デバッグの目的で使用できます。 値 true を指定すると、ダンプが短フォーマットで生成され、バインディングごとに、名前とオブジェクト・タイプが組み込まれます。 値 long を指定すると、ダンプが長フォーマットで生成され、ローカル・オブジェクト・タイプや、ローカル・オブジェクトのストリング表記など、バインディングごとの追加の情報が短フォーマットで組み込まれます。 デフォルト値は false であり、ダンプを生成しません。
-CCexitVM
このオプションを使用すると、 WebSphere Application Server電話をかけるSystem.exit()クライアント アプリケーションの完了後にメソッドを実行します。 デフォルトは以下のとおりです。false.
-CCinitonly
クライアント・アプリケーションを立ち上げずに、 ActiveX アプリケーション・クライアントに対するアプリケーション・クライアント・ランタイムを初期化する場合に、 このオプションを使用します。 デフォルトは以下のとおりです。false.
-CCjar
起動するアプリケーションの EAR ファイル内に存在するクライアント Java アーカイブ (JAR) ファイルの名前。 EAR ファイルの中に複数のクライアント JAR ファイルがある場合に、この引数を使用します。
-CCpropfile
launchClient プロパティーが入っているプロパティー・ファイルの名前を示します。 プロパティを-CCファイル内のプレフィックスは、securityManager,securityMgrClassそしてsecurityMgrPolicyプロパティ。 以下の例を参照してください。verbose=true.
-CCproviderURL
ブートストラップ・サーバー情報を提供します。 初期コンテキスト・ファクトリーは、この情報を使用して初期コンテキストを取得できます。 WebSphere Application Server初期コンテキスト ファクトリでは、Common Object Request Broker Architecture (CORBA) オブジェクト URL または Internet Inter-ORB Protocol (IIOP) URL のいずれかを使用できます。 CORBA オブジェクト URL は IIOP URL よりも柔軟性があり、 使用が推奨される URL フォーマットです。 この値には、複数のブートストラップ・サーバー・アドレスを入れることができます。 この機能は、 サーバー・クラスターから初期コンテキストを取得しようとするときに使用できます。 クラスター内のすべてのサーバーに対しては、URL でブートストラップ・サーバー・アドレスを 指定できます。 少なくとも 1 つのサーバーが稼働してれば、 オペレーションは正常に処理され、Single Point of Failure (SPOF) を回避できます。 宛先リストは、特定の順序で処理されるわけではありません。 命名操作の場合、この値は-CCBootstrapHostand-CCBootstrapPortパラメーター。 複数のシステムを指定する CORBA オブジェクト URL の例は、 以下のようになります。
-CCproviderURL=corbaloc:iiop:myserver.mycompany.com:9810,:mybackupserver.mycompany.com:2809
この値は、java.naming.provider.urlシステム・プロパティー。
-CCsecurityManager
有効にして実行するWebSphere Application Serverセキュリティマネージャーと一緒に。 デフォルトは以下のとおりです。disable.
-CCsecurityMgrClass
セキュリティー・マネージャーを実装するクラスの完全修飾名を示します。 この引数は、-CCsecurityManagerパラメータは次のように設定されているenableデフォルトはjava.lang.SecurityManager.
-CCsecurityMgrPolicy
セキュリティー・マネージャー・ポリシー・ファイルの名前を示します。 -CCsecurityManager パラメーターが enable に設定されている場合は、 この引数のみを使用します。 このパラメータを有効にすると、java.security.policyシステムプロパティが設定されています。 デフォルトはアプリケーションサーバールート/properties/client.policy。
-CCsoapConnectorPort
Simple Object Access Protocol (SOAP) コネクター・ポート。 この引数を指定しない場合は、 WebSphere Application Serverデフォルト値が使用されます。
-CCtrace
このオプションを使用して、デバッグ・トレース情報を取得します。 問題を報告するときにこの情報が必要になる場合がありますIBM®顧客サポート。 デフォルトは以下のとおりです。false詳細については、「トレースの有効化」のトピックを参照してください。
-CCtracefile
トレース情報を書き込むファイルの名前を示します。 デフォルトでは、コンソールに出力します。
-CCtraceMode
トレースで使用するトレース・フォーマットを指定します。 有効な値 basic が指定されていない場合、 デフォルトは advanced になります。 基本トレース・フォーマットは、さらにコンパクトなフォーマットのトレースです。

[AIX Solaris HP-UX Linux Windows]基本および拡張トレース・フォーマット設定について詳しくは、『トレース出力の解釈』を参照してください。

-CCverbose
このオプションは、追加の情報メッセージを表示します。 デフォルトは false です。

セキュリティーを使用可能にした EJB クライアント・アプリケーションを使用している場合は、sas.client.props ファイルを編集します。このファイルは profile_root/properties ディレクトリーにあります。 ファイル内で com.ibm.CORBA.loginSource の値を none に変更します。

sas.client.props ユーティリティーについて詳しくは、『プロパティー・ファイルでの手動によるパスワードのエンコード』および『PropFilePasswordEncoder コマンド解説書』の各トピックを参照してください。

セキュリティー使用の RMI 接続。 EJB および管理クライアント・アプリケーションで使用します。
Jacl を使用:
[AIX Solaris HP-UX Linux Windows]
wsadmin -conntype RMI -port  rmiportnumber -user userid 
-password password

Jython を使用:

[AIX Solaris HP-UX Linux Windows]
wsadmin -lang jython -conntype RMI -port  rmiportnumber -user userid 
-password password

接続の rmiportnumber は、管理コンソールで BOOTSTRAP_ADDRESS と表示されます。

注意：上のAIX®、 HP-UX、 Linux®、 IBM i、Solaris、およびz/OS®オペレーティング システムでは、-password オプションを使用すると、パスワード情報が ps コマンドなどのシステム ステータス プログラムに表示されるため、セキュリティが侵害される可能性があります。ps コマンドは、他のユーザーが呼び出して実行中のすべてのプロセスを表示できます。 機密漏れの恐れがある場合には、このオプションは使用しないでください。 代わりに、SOAP コネクターの場合には soap.client.props ファイル、RMI コネクターの場合には sas.client.props ファイルで、ユーザーおよびパスワード情報を指定します。 のsoap.client.propsそしてsas.client.propsファイルは、 WebSphere Application Serverプロフィール。

Kerberos (KRB5) が管理認証用に使用可能になっている場合、認証ターゲットは、BasicAuth および KRB5 をサポートします。 KRB5 を使用するには、コネクター・タイプに応じて、sas.client.props、soap.client.props、および ipc.client.props ファイルを更新します。

注意：使用する場合Kerberos認証では、ユーザー パスワードはネットワーク経由で送信されません。 クライアントを識別するために、片方向ハッシュのパスワードが使用されます。

以下は、正しい構文の例です。

[Windows]
launchClient c:\earfiles\myapp.ear -CCBootstrapHost=myWASServer -CCverbose=true app_parm1 app_parm2
[AIX HP-UX Solaris]
./launchClient.sh /usr/earfiles/myapp.ear -CCBootstrapHost=myWASServer -CCverbose=true app_parm1 app_parm2