BEA WebLogic Server の使用

このトピックでは、Workshop 製品ファミリとともに WebLogic Server を設定して使用する方法について説明します。ここでは以下のトピックを取り扱います。

IDE 内部でサーバを定義する
サーバの定義を更新する
アプリケーションを手動でデプロイする
リモートデバッグを使用する
トラブルシューティング

IDE 内部でサーバを定義する

サーバを定義するには、次の手順に従います。

最初にアプリケーションを実行する前に、[実行｜デバッグ] コマンドでサーバを定義します。

新しくサーバを定義するには、[J2EE Server] を右クリックして、[新規] を選択します。

[名前] フィールドにサーバの名前を指定します。この名前は IDE 内部でのみ使用されるものです。

[新規] をクリックしてサーバタイプを指定します。
WebLogic Server の使用可能なバージョンである v10.0、v8.1、v9.0/9.1、または 9.2 から選択します。
[次へ] をクリックして続行します。
BEA weblogic sever v10.0 または 9.2 を選択した場合、[ドメインホーム] フィールドで (1) ドロップダウンリストから使用可能な Workshop ドメインを選択する、(2) 以前にインストールした別のドメインホームを参照する、または (3) リンクをクリックして新しいドメインを作成する、のいずれかを行います。
[終了] をクリックします。

BEA WebLogic Server V9.0 および v9.1 または v8.1 を選択した場合、[JRE] フィールドで、ドロップダウンリストから値を選択します。(デフォルトの JRE だけでなく) 完全な JDK を指定する必要があります。
以前にインストールした 9.0/9.1 または 8.1 の WebLogic ホームを参照して、[アプリケーションおよびサーバディレクトリ] フィールドに入力します。
[次へ] をクリックします。
次の画面では、ドメイン、管理者のユーザ名/パスワード、デバッグポートなどの一般的な設定を変更できます。
[完了] をクリックします。
再び [デバッグ] ダイアログが表示されます。 ([Deployed Projects] ボックスの横) をクリックして、このサーバにデプロイするプロジェクトを指定します。
[終了] をクリックすると、指定したプロジェクトが [Deployed Projects] ボックスにリストされます。
[Select Project to Debug] フィールドでは、プルダウンを使用してデバッグするプロジェクトを指定します。

ネームスペースが衝突するおそれがあるため、JSP をデバッグする場合は、サーバ上で 1 度に 1 つのプロジェクトのデバッグのみが可能です。別のプロジェクト内の JSP をデバッグする必要がある場合は、はじめに [Select Project To Debug] フィールドを変更する必要があります。JSP デバッグ時のプロジェクト切り替えの詳細については、「JSP デバッグ時に特有の考慮事項」を参照してください。
[接続タイプ] のデフォルト設定は、IDE 内で管理されているローカルサーバについてのものです。
[適用] をクリックすると、サーバの定義が完了します。 [サーバ] ビューに新しいサーバエントリが表示されます。
この時点でアプリケーションをデバッグする場合は、[デバッグ] をクリックすると、選択されているアプリケーションがデバッグモードで実行されます。それ以外の場合は、[閉じる] をクリックします。
また、デプロイメントや実行時オプションを指定するために、サーバの定義を更新することもできます。

サーバの定義を更新する

サーバの定義を更新するには、次の手順を実行します。

[サーバ] ビューでサーバ名をダブルクリックすると、[サーバの概要] が表示されます。

[サーバの概要] からは、デプロイメントや実行時プロパティを参照したり設定したりできます。

[モジュールをワークスペースから直接実行します] オプションに注目してください。これは WTP の機能で、アプリケーションを「展開された」モードで実行できるようにするものです。この場合、アプリケーションは直接ワークスペースから実行されます。アプリケーションを WAR ファイルにコンパイルしてデプロイする場合は、このオプションのチェックをはずす必要があります。

手動でのデプロイメントについては、ここをクリックしてください。
Weblogic Server バージョン 8.1、9.0/9.1 の場合、[プロパティ] タブをクリックして、サーバのコンフィグレーション時に設定したプロパティを変更することもできます。

ホットデプロイメント

Workshop では、JSP やその他の Struts アクションなどのアーティファクトのホットデプロイメントがサポートされます。

JSP を更新すると、自動的に変更がサーバにパブリッシュされ、[更新] ボタンを押すだけでそうした変更がサーバ上で実行されていることを確認できます。その他の変更は自動的に再デプロイされ、必要に応じてアプリケーションが再起動されます。

アプリケーションを手動でデプロイする (バージョン 8.1、9.0/9.1 のみ)

アプリケーションを手動でデプロイするには、代わりのコンフィグレーションを作成する必要があります。代わりのコンフィグレーションの作成方法については、お使いのサーバのドキュメントを参考にしてください。

代わりのコンフィグレーションをデプロイするには、次の手順を実行します。

[サーバ] ビューでサーバ名をダブルクリックします。 [サーバの概要] が表示されます。
手動でのデプロイメントは、[モジュールをワークスペースから直接実行します] オプションが選択されている場合にのみ許可されています。

WebLogic Server 8.1 の場合、以下の画面が表示されます。この画面では、カスタムコンフィグレーション XML ファイルを指定するか、または更新せずに既存の config.xml を使用するかを指定できます。

WebLogic Server 9.0/9.1 の場合、以下の画面が表示されます。この画面では、更新せずに既存の config.xml を使用することを指定できます。WebLogic Server 9.0/9.1 の場合、カスタムコンフィグレーションファイルの名前を指定することはできません。[既存のコンフィグレーションファイルを使用した手動デプロイメント] をクリックすると、config.xml ファイルの名前を指定するフィールドは読み取り専用であり、[選択] ボタンは無効化されています。

リモートデバッグを使用する

リモートサーバ上 (または起動済みで IDE の「外部」で管理されているローカルサーバ上) でデバッグを行うには、サーバをリモートデバッグ用にコンフィグレーションし、手動でアプリケーションをデプロイしてから、リモートサーバのアドレスを定義する必要があります。

手順 1 : リモートデバッグが許可されるようにサーバをコンフィグレーションする

リモートデバッグ用のサーバのコンフィグレーションは、サーバ側の機能です。この情報は参考までに提供されています。最も確実な情報については、お使いのサーバのドキュメントを参考にしてください。

WebLogic Server 8.1

Workshop は、標準 JPDA と自己生成された行マップを使用します。JSR-45 のデバッグ情報は、無効にする必要があります。クラスのデバッグ情報は、アプリケーションの weblogic.xml ファイルに次のような属性を配置して有効にする必要があります。

<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE weblogic-web-app PUBLIC "-//BEA Systems, Inc.//DTD Web Application 8.1//EN" "http://www.bea.com/servers/wls810/dtd/weblogic810-web-jar.dtd" >
<weblogic-web-app>
 <jsp-descriptor>
        <jsp-param>
            <param-name>compileFlags</param-name>
            <param-value>-g</param-value>
        </jsp-param>
        <jsp-param>
            <param-name>keepgenerated</param-name>
             <param-value>true</param-value>
        </jsp-param>
 </jsp-descriptor>
</weblogic-web-app>

Weblogic Server の起動に使用するスクリプトファイル (startWeblogic.cmd など) に以下の行を追加します。

    set JAVA_OPTIONS=-Xdebug -Xnoagent -Xrunjdwp:transport=dt_socket,address=8453,server=y,suspend=n

Weblogic Server のコンソールに以下のメッセージが表示されます。

   Listening for transport dt_socket at address: 8453

WebLogic 9.2 および 10.0

Workshop は、標準 JPDA と自己生成された行マップを使用します。クラスのデバッグ情報は、アプリケーションの weblogic.xml ファイルに次のような属性を配置して有効にする必要があります。

<?xml version="1.0" encoding="UTF-8"?> 
<weblogic-web-app xmlns="http://www.bea.com/ns/weblogic/90">
    <jsp-descriptor>
        <keepgenerated>true</keepgenerated>
<working-dir>C:\MyApp\jsp-servlet\struts-example_1_1\work</working-dir>
        <backward-compatible>true</backward-compatible>
		<debug>true</debug>
    </jsp-descriptor>
    <context-root>/</context-root>
</weblogic-web-app>

手順 2 : リモートデバッグ用にアプリケーションを準備する

リモートサーバ上でアプリケーションのデバッグを試行する前には、次の手順を実行する必要があります。

アプリケーションをビルドします ([自動的にビルド] が設定されている場合には不要)。
アプリケーションを手動でデプロイします。展開されたアプリケーションとしてデプロイすることも、WAR または EAR ファイルを使用してデプロイすることもできます。
work/temp ディレクトリの内容を消去して、デバッグ情報のないファイルを削除します。
デプロイしたアプリケーションのバージョンが IDE のバージョンと一致していることを確認します。

手順 3 : (省略可能) 別のサーバ上での JSP サーブレットソースのデバッグを有効化する

アプリケーションを物理的に別のマシンでリモートデバッグしている場合、デバッガで jsp のブレークポイントにヒットしても IDE では JSP 内の正しいソース行が表示されません。これは、Workshop で行をマップするために JSP サーブレットソースを見つけようとしても、そのファイルが IDE で利用できないためです。

別のサーバ上でサーブレットのソースをデバッグできるようにするには、以下の (リモートサーバ上の) ディレクトリをローカルのディレクトリにマップします。続いて [ソースルックアップパス] ダイアログ、または [起動のコンフィグレーション] ダイアログ ([実行｜実行] コマンド) の [ソース] タブを使用して、マップしたディレクトリを [ソースルックアップパス] に追加します。

Weblogic Server 9.x の場合 :

JSP サーブレットの src 出力フォルダは web アプリケーション内の \WEB-INF\weblogic.xml に指定されます。これは、デバッグ用にリモートの Weblogic Server を設定する場合に以下のようにコンフィグレーションする必要があります。

  <jsp-descriptor>
    <keepgenerated>true</keepgenerated>
    <working-dir>C:\MyApp\jsp-servlet\struts-example_1_1\work</working-dir>
    <backward-compatible>true</backward-compatible>
    <debug>true</debug>
  </jsp-descriptor>

Weblogic 8.1 の場合 :

  $WLS_DOMAIN\server\.wlnotdelete\extract
    たとえば、
  C:\bea\user_projects\domains\mydomain\myserver\.wlnotdelete\extract\myserver___wstudio_autoconfig_deployment___struts-example_1_1_dbg

手順 4 : リモートサーバを定義して、アプリケーションをデバッグする

リモートサーバを定義するには、次の手順を実行します。

サーバを定義します。
[実行｜デバッグ] の順にクリックして、リモート操作向けにサーバの定義を変更します。 [J2EE Server] の下に表示されるお使いのサーバ名をクリックします。
[接続タイプ] を [標準 (ソケットアタッチ)] に変更して、[ホスト] および [ポート] を指定します。
[リモート VM の終了を許可] チェックボックスでは、サーバがトランザクション途中であっても IDE でサーバのハードを停止できるようになるので、このチェックボックスの使用はお勧めしません。
[適用] をクリックして変更を保存します。
[デバッグ] をクリックして、アプリケーションをデバッグモードで実行します。

なお、リモートサーバ上でアプリケーションをデバッグする場合は、サーバの設定を更新する際に [モジュールをワークスペースから直接実行します] オプションを無効化しないようにする必要があります。

トラブルシューティング

Kodo ライセンスの問題

WebLogic Server (9.1 または 9.2) で Kodo JPA アプリケーションを実行しようとすると、以下のエラーが生じます。

kodo.persistence.PersistenceException: No product license key was found...

Kodo の license.bea の内容を WebLogic Server の license.bea ファイルにマージする必要があります。これには、次の手順を実行します。

ファイル WebLogic-server-Home\license.bea を編集します。
ファイル Project\src\license.bea を編集し、<license-group> .. </license-group> タグの内容をコピーして、WebLogic-server-Home\license.bea ファイル内に貼り付けます。注意 : Kodo のライセンス内容は、必ず <bea-licenses> ... </bea-licenses> タグで囲まれているが <license-group format="1.0" product="WebLogic Platform" release="xx"> の外部である箇所に貼り付けるようにします。

WebLogic Server 9.1 で JPA ライブラリを正しく解決する

Workshop では、JPA JAR ファイルの最終リリースが必要とされます。WebLogic Server 9.1 にはこれよりも古いバージョンの JAR が同梱されています。この状況は WebLogic Server 9.2 では発生しません。

WebLogic Server バージョン 9.1 のコピーで JPA アプリケーション (Kodo、Hiberate など) を実行したときに、[No Such Method exception] というエラーを受け取った場合は、以下の回避策を使用してアプリケーションが正しく機能するようにできます。

このエラーを修正するための回避策は以下のとおりです。

手順 1: サーバの CLASSPATH の冒頭に JPA JAR を挿入します。

Hibernate ベースのアプリケーションの場合 :

set HIB_JARS=C:\<Project>\WEB-INF\lib\ejb3-persistence.jar;

set CLASSPATH=%HIB_JARS%;%CLASSPATH%

Kodo ベースのアプリケーションの場合 :http://edocs.beasys.co.jp/e-docs/kodo/docs40/full/html/ref_guide_deploy.html#ref_gu

set KODO_JARS=D:\<Project>\WEB-INF\lib\kodo.jar;D:\<Project>\WEB-INF\lib\jpa.jar

set CLASSPATH=%KODO_JARS%;%CLASSPATH%

手順 2: WAR デプロイメントを使用してテストします。([サーバの概要] の [モジュールをワークスペースから直接実行します] オプションのチェックをはずします)。このモードでは、サーバの起動に startWebLogic.cmd が使用されるため、正しい JPA ライブラリが検出されます。

BEA WebLogic Server