Enterprise JavaBeans (EJB) モジュールをデプロイする場合には、デプロイされたモジュールをサポートするように構成されたサーバーにそのモジュールをインストールします。
始める前に
1 つ以上の EJB モジュールをアセンブルし、1 つ以上の Web モジュールをアセンブルして、それらを Java™ EE
アプリケーションにアセンブルします。
EJB 3.x 用 EJB デプロイメント・モデルの変更の概要については、『EJB 3.x デプロイメントの概要』トピックを参照してください。
手順
- デプロイメント環境を準備します。 『アプリケーションをホストするための準備』のトピックを参照してください。
- デプロイメント環境での必要に応じて、各 EJB モジュールの構成を更新します。
- 必須: 汎用やアノテーションなどの Java 5 固有の拡張機能にモジュールが依存している場合は、そのモジュール、またはそのモジュールが含まれるアプリケーションをインストールする前に、EJBDeploy コマンド行ツールを個別に実行する必要があります。
これは、管理コンソールおよび wsadmin コマンド行ツールでは、ejbdeploy -complianceLevel 5.0 オプションを指定することができないためです。
エンティティー
Bean を含んでいる EJB 2.1 モジュールの場合にのみ、EJB デプロイメント・ツールの実行が必要になります。
- 潜在的なインターオペラビリティーの問題に対処します。
WebSphere® スタック製品、または EJB 3.x をサポートしないバージョンの Application Server で稼働するその他の製品が、EJB 3.x をサポートするバージョンの Application Server を実行している別のサーバー上にある、EJB 3.x に準拠したエンタープライズ Bean のメソッドをリモートから呼び出そうとすると、予期しない結果が発生することがあります。このような製品がエンタープライズ Bean の EJB 3.x リモート・ビジネス・インターフェースを通じてメソッドを呼び出そうとすると、EJB 3.x で導入された例外が発生し、環境が EJB 3.x に準拠していない状態に戻されることがあります。
このシナリオは、EJB 3.x 準拠および非準拠の Application Server のインスタンスが混在するスタック製品の組み合わせを含む環境の管理者にとっても、問題になる場合があります。
EJB 3.0 で導入された例外クラスは、次のとおりです。
- javax.ejb.ConcurrentAccessException
- javax.ejb.EJBAccessException
- javax.ejb.EJBTransactionRequiredException
- javax.ejb.EJBTransactionRolledbackException
- javax.ejb.NoSuchEJBException
- Application Server が 7.0.0.3 に更新されていることを確認します。
- <app_server_root>/runtimes/ejb3exceptions.jar
ファイルを、Application Server から、EJB 3.x クライアントとして使用する各スタック製品のインストール済み環境またはその他の製品のインストール済み環境のディレクトリーに手動でコピーします。
- ejb3exceptions.jar
ファイルが格納されたディレクトリーがクラスパス上にあることを確認します。 この要件を満たす JAR ファイルの場所として考えられるのは、EJB 3.x に準拠していないサーバー上の <app_server_root>/lib ディレクトリーです。
トラブルの回避 (Avoid trouble): EJB シン・クライアント JAR と同様、更新が提供された場合、ユーザーは更新されたバージョンを含む WebSphere Application Server のバージョンをインストールした後に、ejb3exceptions.jar ファイルを再度コピーする必要があります。
gotcha
- アプリケーションをデプロイします。 『エンタープライズ・アプリケーションのデプロイおよび管理』トピックを参照してください。
次のタスク
EJB デプロイメント・ツールがアプリケーションのインストール中に
稼働するように指定していて、NameNotFoundException メッセージが表示されて
インストールに失敗する場合は、入力 Java アーカイブ (JAR) または
エンタープライズ・アーカイブ (EAR) ファイルがソース・ファイルを含んでいないことを確認してください。
ソース・ファイルを除去するか、またはクラスパスにすべての従属クラスおよびリソース・ファイルを含めます。
入力 JAR ファイルまたは EAR ファイルにソース・ファイルが存在する場合、EJB デプロイメント・ツールはデプロイメント・コードを生成する前に、再ビルドを実行します。
モジュールが正常にデプロイされた場合は、モジュールのテストおよびモジュールのデバッグを行います。『問題の診断 (診断ツールを使用)』トピックを参照してください。