test

Java CAPS の JBI コンポーネントの管理

JavaTM CAPS の JBI コンポーネントの管理

次の節では、JBI コンポーネントの種類の概要と、これらの JBI コンポーネントを管理するために Sun Java System Application Server (GlassFish V2) および NetBeans で使用できる管理ツールについて説明します。このマニュアルでは、これらのユーティリティーで使用される JBI コマンドについて説明し、追加情報へのリンクを提供します。ご質問またはご不明な点がありましたら、Java CAPS の Web サイト (http://www.sun.com/software/javaenterprisesystem/javacaps/index.jsp) を参照してください。

このマニュアルで説明する内容は次のとおりです。

JBI コンポーネントの概要

Java Business Integration (JBI) は、JSR 208 仕様の実装であり、サービス指向アーキテクチャー (SOA) を実装する 1 つの方法として開発されました。JBI は、サービスプロバイダ (サービスの提供側)、サービスコンシューマ (サービスの消費側) のどちらかまたは両方の役割を果たすプラグインコンポーネントを提供する環境を定義します。各プラグインコンポーネントは、WSDL (Web Services Description Language) 2.0 に直接基づいたサービスモデルを使用して相互に作用します。

Java CAPS では、次の 4 種類の JBI (Java Business Integration) コンポーネントを利用します。

JBI フレームワーク内のライフサイクル状態

JBI コンポーネント、サービスアセンブリ、およびサービスユニットは、それぞれが、JBI 管理ツールによって制御されるライフサイクル状態を持ちます。サービスユニットのライフサイクル状態は、サービスアセンブリによって間接的に管理されます。ライフサイクル状態には、「インストール済み」「停止済み」、「起動済み」、「シャットダウン」、「配備」などがあります。

JBI 実行時サーバーは、JBI コンポーネントのライフサイクル状態を保持します。アプリケーションサーバーがシャットダウンしてから再起動した場合、JBI コンポーネントは、アプリケーションサーバーがシャットダウンした時点のライフサイクル状態に戻ります。

注 –

JBI ランタイムは、JBI コンポーネントを「望ましい」状態に戻そうとします。たとえば、JBI コンポーネントを起動しようとしたのに、コンポーネントでエラーが発生したために起動できなかったとします。その場合、アプリケーションサーバーを再起動すると、JBI ランタイムはそのコンポーネントを起動を再試行します。

JBI 管理ツールの概要

いくつかのツールを使用して、結合コンポーネント、サービスエンジン、共用ライブラリ、およびサービスアセンブリを管理できます。このマニュアルでは、これらのコンポーネントはすべて一般用語の JBI コンポーネントとみなします。

JBI コンポーネントの管理に使用する 4 つの主要ツールは次のとおりです。

特定の JBI コンポーネント管理ツールの詳細については、次の各節を参照してください。

NetBeans IDE の JBI マネージャーによる JBI コンポーネントの管理

JBI マネージャーは、NetBeans IDE. の「サービス」ウィンドウからアクセスする JBI ノード (およびそれに関連付けられている機能) に対して使用される用語です。「JBI」ノード は、「サービス」ツリーの「サーバー」 > 「GlassFish V2」の下にあり、GlassFish が実行中の場合にのみ使用できます。GlassFish Application Server を起動するには、「GlassFish V2」を右クリックし、「開始」を選択します。

展開された JBI ノードには、JBI コンポーネントのディレクトリが含まれています。JBI コンポーネントディレクトリを右クリックすると、次の機能にアクセスできます。

機能 

説明 

サービスエンジン  

結合コンポーネント 

共用ライブラリ 

サービスアセンブリ 

ディレクトリ機能: 機能にアクセスするには、ディレクトリを右クリックします

「インストール」 

コンポーネントの新しいインスタンスを選択してインストールします。 

使用可 

使用可 

使用可 

 

「インストールして起動」 

コンポーネントの新しいインスタンスを選択してインストールし、起動します。 

使用可 

使用可 

   

「配備」 

コンポーネントの新しいインスタンスを選択して配備します。 

     

使用可 

「配備して起動」 

コンポーネントの新しいインスタンスを選択して配備し、起動します。 

     

使用可 

「再表示」 

コンポーネントディレクトリを再表示して、コンポーネントを最新の設定および情報で更新します。 

使用可 

使用可 

使用可 

使用可 

コンポーネント機能: 機能にアクセスするには、コンポーネントを右クリックします

「開始」 

コンポーネントを起動して、データの読み取り、変換、書き込みや、接続のシーク、作成、ドロップなどの処理を開始します。 

使用可 

使用可 

 

使用可 

「停止」 

コンポーネントを停止して、データの読み取り、変換、書き込みや、接続のシーク、作成、ドロップなどの処理を終了します。 

使用可 

使用可 

 

使用可 

「シャットダウン」 

コンポーネントをシャットダウンし、そのコンポーネントをアプリケーションサーバーで使用可能な状態のままにして、現在は処理を行っていないというフラグを設定します。 

使用可 

使用可 

 

使用可 

「アンインストール」 

コンポーネントをアンインストールして、アプリケーションサーバーが使用できるコンポーネントのセットからそのコンポーネントを削除します。 

使用可 

使用可 

使用可 

 

「アップグレード」 

コンポーネントをアップグレードします。コンポーネントの現在のインスタンスの配備を取り消してアンインストールし、コンポーネントの新しいインスタンスをインストールしてそのインスタンスに設定を転送します。 

使用可 

使用可 

   

「詳細」 > 「強制終了」 

コンポーネントをシャットダウンできない状況において、コンポーネントを強制的にシャットダウンします。このオプションは、コマンドの処理時にコンポーネントのメソッドでエラーが発生しても無視するように JBI ランタイムに指示します。この場合もコンポーネントのメソッドは呼び出され、完了を求められますが、メソッドが例外をスローした場合、その例外は無視されます (だたし、アプリケーションサーバーログには記録されます)。 

使用可 

使用可 

 

使用可 

「詳細」 > 「強制的にアンインストール」 

コンポーネントをアンインストールできない状況において、コンポーネントを強制的にアンインストールします。JBI ランタイムは、コマンドの処理時にコンポーネントのメソッドでエラーが発生しても無視します。この場合もコンポーネントのメソッドは呼び出され、完了を求められますが、メソッドが例外をスローした場合、その例外は無視されます (だたし、アプリケーションサーバーログには記録されます)。 

使用可 

使用可 

   

「詳細」 > 「強制的に配備を取消し」 

コンポーネントの配備取り消しができない状況において、強制的にサービスアセンブリの配備を取り消します。JBI ランタイムは、コマンドの処理時にサービスアセンブリのメソッドでエラーが発生しても無視します。この場合もメソッドは呼び出され、完了を求められますが、メソッドが例外をスローした場合、その例外は無視されます (だたし、アプリケーションサーバーログには記録されます)。 

     

使用可 

「持続性データの削除」 

持続性が有効になっていて、データが使用可能な場合、(BPEL SE の状態に依存する)「持続性データの削除」が使用可能になります。持続性イベントレコードを削除します。 

BPEL SE の場合 

     

「アクションの監視」 > 「データの削除」 

持続性が有効になっていて、データが使用可能な場合、(BPEL SE の状態に依存する)「データの削除」が使用可能になります。監視イベントレコードを削除します。 

BPEL SE の場合 

     

「配備の取り消し」 

コンポーネントの配備を取り消して、アプリケーションサーバーが使用できるコンポーネントのセットからそのコンポーネントを削除します。 

使用可 

使用可 

 

使用可 

「プロパティー」 

コンポーネントプロパティーエディタを開きます。 

使用可 

使用可 

使用可 

使用可 

「再表示」 

コンポーネントを再表示して、コンポーネントを最新の設定と情報で更新します。 

使用可 

使用可 

 

使用可 

「エンドポイント統計情報の表示」 

コンポーネントの「エンドポイント統計情報」ウィンドウを開き、そのコンポーネントのプロビジョニングエンドポイントとコンシューミングエンドポイントを表示します。統計情報には、受信した完了、エラー、フォルト、および送信した完了、エラー、フォルトが含まれます。 

その他の使用可能な統計情報は、コンポーネントのプロパティーから表示できます。  

使用可 

使用可 

   

管理コンソールによる JBI コンポーネントの管理

Sun Java System (GlassFish) Application Server には、管理コンソールという Web ブラウザベースの管理ツールが含まれています。管理コンソールを使用して、ドメインの起動と停止、サーバーの設定、アプリケーションの配備などを行えます。管理コンソールでは、管理タスクの実行を支援するためのコンテキスト依存型ヘルプを利用できます。

管理コンソールの起動

NetBeans から管理コンソールを起動するには、「サービス」ウィンドウで「サーバー」の下の Sun Java System Application Server (「GlassFish V2」) ノードを右クリックし、ポップアップメニューから「管理コンソールを表示」を選択します。

アプリケーションサーバーを実行しているコンピュータ上にある Web ブラウザから管理コンソールを起動するには、Web ブラウザを開いて「 http://localhost:4848/」と入力します。これは設定されているデフォルトです。アプリケーションサーバーのインストール時に別のポートを指定した場合は、そのポート番号を使用します。

アプリケーションサーバーをホストしていないコンピュータで管理コンソールを起動するには、Web ブラウザを開いて「http://<hostname>:<port> 」という Web アドレスを入力します。hostname は、アプリケーションサーバーを実行しているコンピュータの名前、port はサーバーのポート番号です。

正常に接続できたら、アプリケーションサーバーをインストールしたときに指定したユーザー名とパスワードを入力します。管理コンソールのデフォルトのユーザー名とパスワードは、admin (ユーザー名) と adminadmin (パスワード) です。

管理コンソールでの JBI コンポーネントの管理

管理コンソールの左区画で、JBI 管理用の画面を表示する JBI ノードを選択します。アプリケーションサーバーツリーで各種の JBI ノードを選択することにより、JBI 管理画面を開いて、次の表に示すタスクを実行できます。

JBI ノード (選択ノード) 

コンソール画面  

使用できる機能 

JBI 

全般 (タブ) 

インストールされている JBI 実行時コンポーネントの概要と、各種コンポーネントの画面へのリンクが表示されます。 

設定 (タブ) 

JBI ランタイムを設定します。JBI コンポーネントおよびライブラリのインストールと操作、JBI サービスアセンブリの配備と操作などを行います。 

ログ (タブ) 

JBI システム実行時ロガーを設定します。個々のロガーのログレベルを指定します。  

監視 (タブ) 

JBI 実行時フレームワークおよび正規化メッセージルーターの実行時監視統計情報を表示します。 

サービスアセンブリ 

サービスアセンブリ 

JBI サービスアセンブリを管理します。配備、配備の取り消し、開始、停止、シャットダウンなどの機能があり、各サービスアセンブリの現在の状態を表示できます。 

特定のサービスアセンブリ (「サービスアセンブリ」ノードの下で特定のサービスアセンブリを選択) 

次の 3 つのタブで操作を行います。

  • 全般: JBI サービスアセンブリの詳細を表示します。

  • 記述子: JBI アーカイブメタデータ 'jbi.xml' の内容を表示します。

  • 監視: サービスアセンブリの統計情報を表示します。

コンポーネント 

コンポーネント 

JBI 結合コンポーネントとサービスエンジンを管理します。インストール、アンインストール、アップグレード、開始、停止、シャットダウンなどの機能があり、各コンポーネントの現在の状態を表示できます。 

特定の結合コンポーネントまたはサービスエンジン (「コンポーネント」ノードの下で特定のコンポーネントを選択) 

次の 7 つのタブで操作を行います。

  • 全般: JBI 結合コンポーネントまたはサービスエンジンの詳細を表示します。

  • 設定: コンポーネントに応じたプロパティーを設定します。コンポーネントの中には設定プロパティーを持たないものもあります。

  • アプリケーション: ユーザー指定のアプリケーション設定またはアプリケーション変数を選択または作成できます。

  • 記述子: JBI アーカイブメタデータ 'jbi.xml' の内容を表示します。

  • ロガー: JBI コンポーネントのロガーを管理します。個々のロガーのログレベルを指定します。

  • 監視: サービスアセンブリの統計情報を表示します。

  • ライブラリ: このコンポーネントで必須のインストール済み共用ライブラリを表示します。

共用ライブラリ  

共用ライブラリ 

JBI 共用ライブラリを管理します。インストールとアンインストールの機能があり、インストール済みライブラリの説明が表示されます。 
 

特定の共用ライブラリ (「共用ライブラリ」ノードの下で特定の共用ライブラリを選択) 

次の 3 つのタブで操作を行います。

  • 全般: JBI 共用ライブラリの詳細を表示します。

  • 記述子: JBI アーカイブメタデータ 'jbi.xml' の内容を表示します。

  • コンポーネント: この共用ライブラリを必須とするコンポーネントを表示します。

カスタム MBean 

カスタム MBean 

サーバーに配備されているカスタム MBean を管理します。配備、配備取り消し、有効化の機能があり、配備されている MBean の名前、実装クラス名、状態が表示されます。 

管理コンソールの使用の詳細については、『Sun Java System Application Server 9.1 クイックスタートガイド』(http://docs.sun.com/app/docs/doc/820-3028?l=ja) を参照してください。

asadmin 管理コマンド行インタフェース (CLI) による JBI コンポーネントの管理

Sun Java System (GlassFish) Application Server には、asadmin というコマンド行管理ユーティリティーが含まれています。asadmin ユーティリティーを使用して、JBI コンポーネントの管理を含むアプリケーションサーバーのすべての管理タスクを実行できます。

asadmin ユーティリティーを使用する際のガイドラインは次のとおりです。

asadmin CLI の JBI コマンドとオプション

次の表に、JBI コンポーネントの管理に使用する JBI CLI コマンドとオプションを示します。これらの CLI コマンドの中には、Java CAPS をサポートするために追加されたオプションを持つものもあります。

コマンド名  

オプションと値 

オペランドと例 

install-jbi-component: サービスエンジンまたは結合コンポーネントを JBI 環境にインストールします。

 

--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--properties: 
  [(name=value)[:name=value]*
  |file 
--passwordfile: [filename]
--target: 
  target name|[server]|domain
--help

オプションとその使用法の詳細については、JBI Command Options and Values Tableを参照してください。

ファイルパスまたはコンポーネント名: コンポーネントの属性を格納するアーカイブファイル、またはドメインにあらかじめインストールされているコンポーネントの名前。 

start-jbi-component: 指定されたターゲットでサービスエンジンまたは結合コンポーネントを起動します。ターゲットが指定されていない場合、組み込み DAS サーバー上のコンポーネントが起動されます。

 

--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user] 
--passwordfile: [filename]
--target: 
  target name|[server]|domain
--help

コンポーネント名: 起動する結合コンポーネントまたはサービスエンジンの名前。 

stop-jbi-component: 指定されたターゲットでサービスエンジンまたは結合コンポーネントを停止します。ターゲットが指定されていない場合、組み込み DAS サーバー上のコンポーネントが停止されます。

 

--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--target: 
  target name|[server]|domain
--help

コンポーネント名: 停止する結合コンポーネントまたはサービスエンジンの名前。 

shut-down-jbi-component: 指定されたターゲットでサービスエンジンまたは結合コンポーネントをシャットダウンします。ターゲットが指定されていない場合、組み込み DAS サーバー上のコンポーネントがシャットダウンされます。

 

--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--force|-F: true|[false]
--port|-p: [port number]
--host|-H: [localhost] 
--user|-u: [admin user]
--passwordfile: [filename]
--target: 
  target name|[server]|domain
--help

オプションとその使用法の詳細については、JBI Command Options and Values Tableを参照してください。

コンポーネント名: シャットダウンするコンポーネントの名前。 

uninstall-jbi-component: 指定されたターゲットでサービスエンジンまたは結合コンポーネントをアンインストールします。ターゲットが指定されていない場合、組み込み DAS サーバーからコンポーネントがアンインストールされます。

 

--echo|-e: true|[false]
--interactive|-I :[true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--force|-F: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--keeparchive: true|[false] 
--passwordfile: [filename]
--target: 
  target name|[server]|domain
--help

コンポーネント名: アンインストールするコンポーネントの名前。 

deploy-jbi-service-assembly: サービスアセンブリを JBI 環境に配備します。 ターゲットオプション (--target) は、Application Server Enterprise Edition でのみ使用します。 


--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--upload: [true]|false 
--target: 
  target name|[server]|domain
--help

ファイルパスまたはサービスアセンブリ名: サービスアセンブリの属性を格納するアーカイブファイル、またはドメインにあらかじめ配備されているサービスアセンブリの名前。 

start-jbi-service-assembly: 指定されたターゲットでサービスアセンブリを起動します。ターゲットが指定されていない場合、サーバーインスタンスに対してコマンドが実行されます。

 

--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--target: 
  target name|[server]|domain
--help

オプションとその使用法の詳細については、JBI Command Options and Values Tableを参照してください。

サービスアセンブリ名: 起動するサービスアセンブリの名前。 

stop-jbi-service-assembly: 指定されたターゲットでサービスアセンブリを停止します。ターゲットが指定されていない場合、サーバーインスタンスに対してコマンドが実行されます。

 

--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--target: 
  target name|[server]|domain
--help

サービスアセンブリ名: 停止するサービスアセンブリの名前。 

shut-down-jbi-service-assembly: 指定されたターゲットでサービスアセンブリをシャットダウンします。ターゲットが指定されていない場合、サーバーインスタンスに対してコマンドが実行されます。

 

--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--target: 
  target name|[server]|domain
--help

サービスアセンブリ名: シャットダウンするサービスアセンブリの名前。 

undeploy-jbi-service-assembly: 指定されたターゲットでサービスアセンブリの配備を取り消します。ターゲットが指定されていない場合、サーバーインスタンスに対してコマンドが実行されます。

 

--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--force|-F: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--keeparchive: true|[false]
--passwordfile: [filename]
--target: 
  target name|[server]|domain
--help

オプションとその使用法の詳細については、JBI Command Options and Values Tableを参照してください。

サービスアセンブリ名: 配備を取り消すサービスアセンブリの名前。 

install-jbi-shared-library: 共用ライブラリを JBI 環境にインストールします。

 

--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--upload: [true]|false
--target: 
  target name|[server]|domain
--help

ファイルパス: 共用ライブラリを格納するアーカイブファイル。 

uninstall-jbi-shared-library: 指定されたターゲットインスタンスまたはクラスタから共用ライブラリをアンインストールします。ターゲットが指定されていない場合、組み込み DAS サーバーから共用ライブラリがアンインストールされます。

 

--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--force|-F: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--keeparchive: true|[false]
--passwordfile: [filename]
--target: 
  target name|[server]|domain
--help

共用ライブラリ名: アンインストールする共用ライブラリの名前。 

list-jbi-service-engines: その JBI 環境にインストールされているサービスエンジンを一覧表示します。フィルタが指定されていない場合、インストールされているすべてのサービスエンジンが表示されます。

 

--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--lifecyclestate: 
  shutdown|started|stopped
--libraryname: 
  shared library name
--assemblyname: 
  service assembly name
--target: 
  target name|[server]|domain
--help

オプションとその使用法の詳細については、JBI Command Options and Values Tableを参照してください。

なし。 

list-jbi-binding-components: その JBI 環境にインストールされている結合コンポーネントを一覧表示します。フィルタが指定されていない場合、インストールされているすべての結合コンポーネントが表示されます。

 

--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--lifecyclestate: 
  shutdown|started|stopped
--libraryname: 
  shared library name
--assemblyname: 
  service assembly name
--target: [target name]
--help

なし。 

list-jbi-shared-libraries: その JBI 環境にインストールされている共用ライブラリを一覧表示します。フィルタが指定されていない場合、インストールされているすべての共用ライブラリが表示されます。

 

--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--target: [target name]
--componentname: 
  [component name]
--help

なし。 

list-jbi-service-assemblies: JBI 環境にインストールされているサービスアセンブリを一覧表示します。フィルタが指定されていない場合、インストールされているすべてのサービスアセンブリが表示されます。

 

--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--lifecyclestate: 
  shutdown|started|stopped
--target: [target name]
--componentname: 
  [component name]
--help

オプションとその使用法の詳細については、JBI Command Options and Values Tableを参照してください。

なし。 

show-jbi-service-engine: 指定されたサービスエンジンの詳細情報を表示します。デフォルトでは、一般情報が表示されます。configuration、loggers、または descriptor オプションが指定されている場合は、追加の情報が表示されます。

 

--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--target: 
  target name|[server]|domain
--configuration: true|[false]
--loggers: true|[false]
--descriptor: true|[false]
--help

サービスエンジンの名前。 

例:show-jbi-service-engine sun-javaee-engine

show-jbi-binding-component: 指定された結合コンポーネントの詳細情報を表示します。デフォルトでは、一般情報が表示されます。configuration、loggers、または descriptor オプションが指定されている場合は、追加の情報が表示されます。

 

--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--target: 
  target name|[server]|domain
--configuration: true|[false]
--loggers: true|[false]
--descriptor: true|[false]
--help

結合コンポーネントの名前。 

例:show-jbi-binding-component sun-http-binding

show-jbi-shared-library: 指定された共用ライブラリの詳細情報を表示します。デフォルトでは、一般情報が表示されます。descriptor オプションが指定されている場合は、記述子情報が表示されます。

 

--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--target: 
  target name|[server]|domain
--descriptor: true|[false]
--help

オプションとその使用法の詳細については、JBI Command Options and Values Tableを参照してください。

共用ライブラリの名前。 

例:show-jbi-shared-library cli_test_sns1

show-jbi-service-assembly: 指定されたサービスアセンブリの詳細情報を表示します。デフォルトでは、一般情報が表示されます。descriptor オプションが指定されている場合は、記述子情報が表示されます。

 

--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--target: 
  target name|[server]|domain
--descriptor: true|[false]
--help

サービスアセンブリの名前。 

例:show-jbi-service-assembly PingApp

upgrade-jbi-component: 現在 JBI 環境にインストールされているサービスエンジンまたは結合コンポーネントをアップグレードします。 


--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--upload: [true]|false
--upgradefile: [filepath]
--help

現在ドメインにインストールされているコンポーネントの名前。 

例:upgrade-jbi-component --upgradefile=cli-test-engine4-1.jar cli_test_engine4

set-jbi-runtime-logger: JBI ランタイムのロガーのログレベルを設定します。 


--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--target: 
  target name|[server]|domain
--help

オプションとその使用法の詳細については、JBI Command Options and Values Tableを参照してください。

名前と値 (「名前=値」の形式) のペアをコンマで区切って指定するか、または設定するロガーの名前と値のペアが格納されたファイルの名前を指定します。オペランドに空白が含まれる場合は、そのオペランドを二重引用符で囲みます。引用符内の空白は文字とみなされます。  

指定する値は、正当なロガーレベルを表すテキストでなければなりません。または、「DEFAULT」のテキストを指定できます。「DEFAULT」を使用すると、ロガーは初期状態にリセットされ、ロガーレベルは親から継承されます。 

例:set-jbi-runtime-logger com.sun.jbi.messaging=WARNING

set-jbi-component-logger: 指定されたコンポーネントのログレベルを設定します。

 

--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--target: 
  target name|[server]|domain
--component: [component name]
--help

名前と値 (「名前=値」の形式) のペアをコンマで区切って指定するか、または設定するロガーの名前と値のペアが格納されたファイルの名前を指定します。オペランドに空白が含まれる場合は、そのオペランドを二重引用符で囲みます。引用符内の空白は文字とみなされます。  

指定する値は、正当なロガーレベルを表すテキストである必要があります。または、「DEFAULT」のテキストを指定できます。「DEFAULT」を使用すると、ロガーは初期状態にリセットされ、ロガーレベルは親から継承されます。 

例:set-jbi-component-logger --component=sun-http-binding sun-http-binding.com.sun.jbi.httpsoapbc.HttpSoapBindingDeployer=INFO

set-jbi-runtime-configuration: JBI ランタイム設定値を設定します。 


--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--target: 
  target name|[server]|domain
--help

名前と値 (「名前=値」の形式) のペアをコンマで区切って指定するか、または設定する設定値の名前と値のペアが格納されたファイルの名前を指定します。オペランドに空白が含まれる場合は、そのオペランドを二重引用符で囲みます。  

設定変数の正確な名前を指定します。ランタイム設定の名前と現在の値を表示するには、show-jbi-runtime-configuration コマンドを使用します。 

例: set-jbi-runtime-configuration heartBeatInterval=6000

set-jbi-component-configuration: 指定されたコンポーネント名の結合コンポーネント設定値またはサービスエンジン設定値を設定します。

 

--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--target: target name|[server]
--component: [component name]
--help

オプションとその使用法の詳細については、JBI Command Options and Values Tableを参照してください。

名前と値 (「名前=値」の形式) のペアをコンマで区切って指定するか、または設定する設定値の名前と値のペアが格納されたファイルの名前を指定します。オペランドに空白が含まれる場合は、そのオペランドを二重引用符で囲みます。  

設定変数の正確な名前を指定します。コンポーネント設定の名前と現在の値を表示するには、show-jbi-binding-component または show-jbi-service-engine コマンドを --configuration オプションと一緒に使用します。 

例:set-jbi-component-configuration OutboundThreads=5,ProxyPort=2345

update-jbi-application-configuration: 指定されたコンポーネントのアプリケーション設定を更新します。

 

--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--target: target name|[server]
--component: [component name]
--configname: [configuration name]
--help

名前と値 (「名前=値」の形式) のペアをコンマで区切って指定するか、または更新するアプリケーション設定値の名前と値のペアが格納されたファイルの名前を指定します。オペランドに空白が含まれる場合は、そのオペランドを二重引用符で囲みます。 

例: update-jbi-application-configuration --component=cli-config-binding --configname=testConfig ConfigData.properties

update-jbi-application-variable: 指定されたコンポーネントのアプリケーション変数を更新します。アプリケーション変数は、「名前=型の値」の形式で設定します。型が指定されていない場合は、デフォルトの型である String が使用されます。有効な型は、String、Number、Boolean、および Password です。

変数を更新する場合、指定された変数の型が、その変数が作成されたときの型と一致していなければなりません。  

 

--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--target: target name|[server]
--component: [component name]
--help

名前と値 (「名前=値」の形式) のペアをコンマで区切って指定するか、または更新するアプリケーション変数の名前と値のペアが格納されたファイルの名前を指定します。オペランドに空白、または型を指定する大括弧が含まれる場合は、そのオペランドを二重引用符で囲みます。 

指定された型は、create コマンドで指定した元の型と一致していなければなりません。 

例: update-jbi-application-variable --component=cli-config-binding some-property-file.properties

create-jbi-application-configuration: 指定されたコンポーネントのアプリケーション設定を作成します。

 

--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--target: target name|[server]
--component: [component name]
--configname: 
  [configuration name]
--help

オプションとその使用法の詳細については、JBI Command Options and Values Tableを参照してください。

名前と値 (「名前=値」の形式) のペアをコンマで区切って指定するか、または作成するアプリケーション設定値の名前と値のペアが格納されたファイルの名前を指定します。オペランドに空白が含まれる場合は、そのオペランドを二重引用符で囲みます。 

例: create-jbi-application-configuration --component=cli-config-binding --configname=testConfig ConfigData.properties

create-jbi-application-variable: 指定されたコンポーネントのアプリケーション変数を作成します。アプリケーション変数は、「名前=[型]値」の形式で設定します。型が指定されていない場合は、デフォルトの型である String が使用されます。有効な型は、String、Number、Boolean、および Password です。 


--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--target: target name|[server]
--component: [component name]
--help

名前と値 (「名前=値」の形式) のペアをコンマで区切って指定するか、または更新するアプリケーション変数の名前と [型]値のペアが格納されたファイルの名前を指定します。オペランドに空白、または型を指定する大括弧が含まれる場合は、そのオペランドを二重引用符で囲みます。 

例: create-jbi-application-variable --component=cli-config-binding some-property-file.properties

delete-jbi-application-configuration: 指定されたコンポーネントのアプリケーション設定を削除します。

 

--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--target: target name|[server]
--component: [component name]
--help

削除するアプリケーション設定の名前。 

例: delete-jbi-application-configuration --component=cli-config-binding testConfig

delete-jbi-application-variable: アプリケーション変数を削除します。 


--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--target: target name|[server]
--component: [component name]
--help

オプションとその使用法の詳細については、JBI Command Options and Values Tableを参照してください。

削除する 1 つまたは複数のアプリケーション変数の名前。オペランドに空白が含まれる場合は、そのオペランドを二重引用符で囲みます。空白は文字とみなされます。 

例:delete-jbi-application-variable --component cli-config-binding FirstName

list-jbi-application-configurations: 指定されたコンポーネントの JBI アプリケーション設定を一覧表示します。

 

--echo|-e : true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--target: target name|[server]
--component: [component name]
--help

なし。 

例:list-jbi-application-configurations --component=cli-config-binding

list-jbi-application-variables: 指定されたコンポーネントの JBI アプリケーション変数を一覧表示します。

 

--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--target: target name|[server]
--component: [component name]
--help

なし。 

例:list-jbi-application-variables --component=cli-config-binding

show-jbi-runtime-loggers: JBI 実行時ロガーを表示します。

 

--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--target: 
  target name|[server]|domain
--help

オプションとその使用法の詳細については、JBI Command Options and Values Tableを参照してください。

なし。 

例:show-jbi-runtime-loggers

show-jbi-runtime-configuration: JBI ランタイム設定値を表示します。

 

--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--passwordfile: [filename]
--target: 
  target name|[server]|domain
--help

なし。 

例:show-jbi-runtime-configuration

show-jbi-statistics: 指定されたオプション値を使用してフィルタリングした JBI 統計情報を表示します。コマンド行で複数のオプション値を指定して、複数の統計カテゴリを表示できます。

 

--echo|-e: true|[false]
--interactive|-I: [true]|false
--terse|-t: true|[false]
--secure|-s: true|[false]
--port|-p: [port number]
--host|-H: [localhost]
--user|-u: [admin user]
--framework: true|[false]
--nmr: true|[false]
--component: [component name]
--endpoint: [endpoint name]
--serviceassembly: 
  [service assembly name]
--passwordfile: [filename]
--target: 
  target name|[server]|domain
--help

なし。 

例:show-jbi-statistics --nmr

JBI コマンドのオプションと値

次の表に、JBI コマンドオプションの説明を示します。

オプション 

値 

説明 

共通オプション: これらのオプションは、ほとんどの JBI コンポーネント asadmin コマンドに共通します。

--echo | -e 

true | false 

true は、コマンド行で指定されたコマンドがシステム出力にエコーされることを示します。

--interactive| -I 

true | false 

true (デフォルト) は、必要なパスワードオプションのみの入力が求められることを示します。

--terse | -t 

true | false 

true は、出力が最小限の量に減らされることを示します。

--port | -p 

ポート番号 

管理用の HTTP/S ポート。PE のデフォルトポートは 4848、EE のデフォルトポートは 4849 です。 

--secure | -s 

true | false 

true は、ドメイン管理サーバーとの通信に SSL/TLS が使用されることを示します。

--host | -H 

localhost 

JBI アプリケーションが実行されているマシン名。デフォルト値は localhost です。 

--user | -u 

管理ユーザー 

承認された、ドメイン管理サーバーの管理ユーザー名。 

--passwordfile 

filename 

パスワードエントリが格納されているファイルの名前。 

--target 

target name | [server]|domain 

ターゲットの名前。  

--help 

 

コマンドのヘルプテキストを表示します。 

専用オプション: これらのオプションは、特定の JBI コンポーネント asadmin コマンドでのみ使用されます。

--assemblyname 

サービスアセンブリ名 

指定されたサービスアセンブリ名を持つサービスアセンブリユニットの一部として ASA が配備されているコンポーネントを一覧表示します。 

--component 

コンポーネント名 

参照されているコンポーネントの名前。 

--componentname 

コンポーネント名 

指定したコンポーネントで参照される共用ライブラリを一覧表示します。 

--configuration 

true|[false] 

コンポーネントの設定値を表示します。 

--descriptor 

true|[false] 

コンポーネントの XML 記述子を表示します。 

--endpoint 

エンドポイント名 

エンドポイントの統計情報を表示します。 

--force| -F 

true|[false] 

true は、コンポーネントが強制的にシャットダウンされることを示します。

--framework 

true|[false] 

フレームワークの統計情報を表示します。 

--keeparchive 

true|[false] 

true は、コンポーネントがドメイン内に保持されることを示します。

--libraryname 

共用ライブラリ名 

指定された共用ライブラリを現在使用しているコンポーネントを一覧表示します。 

--lifecyclestate 

shutdown|started|stopped 

コンポーネントのライフサイクル状態によって一覧をフィルタリングできます。 

--loggers 

true|[false] 

コンポーネントのロガーおよびそのレベルを表示します。 

--nmr 

true|[false] 

NMR (正規化メッセージルーター) の統計情報を表示します。 

--serviceassembly 

サービスアセンブリ名 

コンポーネントの統計情報を表示します。 

--upgradefile 

[filepath] 

コンポーネントの更新に使用される新しいアーカイブファイルパスです。 

--upload 

[true]|false  

true は、管理サーバーにファイルをアップロードすることを示します。インストール可能ファイルのファイルパスがサーバーマシンにマウントされている場合、または管理サーバーがローカルで実行されている場合は、upload オプションを false に設定します。

asadmin ユーティリティーの起動

コマンド行から asadmin ユーティリティーを起動するには、install-dir /bin (install-dir はアプリケーションサーバーのインストールディレクトリ) ディレクトリに移動し、asadmin コマンドを入力します。

asadmin ユーティリティーツールを使用するための Windows 環境の設定方法については、「GlassFish クイックスタートガイド」 を参照してください。

asadmin ユーティリティーの使用の詳細については、「GlassFish JBICLI Project Plan」 および「JBI ADMIN CLI」 を参照してください。