webLogic での開発環境の準備

WebLogic をEARファイルを作成せずに実行するには、 WebLogic に適切な設定でアプリケーションを定義し、アプリケーションが必要とするCLASSPATHを設定するために起動スクリプトを構成する必要があります。

このタスクについて

アプリケーションのディレクトリー 構造を設定すると、WebLogic で EAR ファイルからではなく、ファイルから 直接読み取れるようになります。

アプリケーションをエクスプロード・モードで 実行するよう WebLogic を構成するには、以下の手順を実行します。

手順

  1. Windows(UNIXの場合は startWebLogic.sh)用の <WEBLOGIC_DOMAIN> /bin/startWebLogic.cmdスクリプトを編集し、オプションの引数としてJava™パラメータを以下のように設定します
    -Dsci.opsproxy.disable=Y -Dvendor=shell
    -DvendorFile=/servers.properties
  2. WebLogic サーバーを始動し、WebLogic システム・コンソールを開きます。 システム・コンソールには、次のような URL を使用してアクセスすることができます。
    http://<hostname or ip-address>:<port number of your 
    WebLogic Server>/console
  3. WebLogic サーバーのシステム管理者 ID およびパスワードを使用して、システム・コンソールにログインします。
  4. 「ドメイン構造」パネルで、 「デプロイメント」をクリックします。

    既にアプリケーションがデプロイされている場合は、以下の手順で、アプリケーションを停止し 削除します。

    1. 既存のアプリケーションのデプロイメントを停止するには、以下の手順を実行します。
      • 削除する当該デプロイメントのボックスにチェック・マークを付けます。
      • 「停止」をクリックし、ポップアップ・メニューから 「今すぐ強制終了 (Force Stop Now)」を選択します。
      • 「アプリケーション・アシスタントの削除 (Delete Application Assistant)」で、「はい」をクリックします。
      • 「メッセージ (Messages)」で、メッセージ"Selected Deployments have been requested to stop"表示されます。
    2. 既存のアプリケーションのデプロイメントを削除するには、以下の手順を実行します。
      • 削除する当該デプロイメントのボックスにチェック・マークを付けます。
      • 「削除」をクリックします。
      • 「アプリケーション・アシスタントの削除 (Delete Application Assistant)」で、「はい」をクリックします。
      • 「メッセージ」で、このメッセージは以下を表示します。"Selected Deployments were deleted. Remember to click Activate Changes after you are finished."
      • 「センターの変更 (Change Center)」パネルで、「変更のアクティブ化 (Activate Changes)」をクリックします。
  5. 「ロケーション」で、 < application_name>.war ファイルが解凍されたディレクトリーを参照し、 「次へ」をクリックします。
  6. 「このデプロイメントをアプリケーションとしてインストールする」 を選択し、 「次へ」をクリックします。
  7. 「ソースのアクセシビリティー (Source accessibility)」で、 「デプロイメントを以下の場所からアクセス可能にする」を選択します。

    「場所:」で、その場所が、 < application_name>.war ファイルが解凍されたディレクトリーを指していることを確認します。

  8. weblogic.xml ファイルを INSTALL_DIR/repository/eardata/platform/descriptors/weblogic/WAR/WEB-INF ディレクトリーから INSTALL_DIR/extensions/smcfs ディレクトリーにコピーします。
  9. ycpapibundle.properties ファイルおよび ycpapibundle_< 言語>_ < 国名または地域名>.properties (該当する場合) を < インストール・ DIR>/resources ディレクトリーから < インストール・ DIR>/repository/eardata/SMFS/war/yfscommon ディレクトリーにコピーします。
  10. yscpapibundle.properties ファイルおよび yscpapibundle_< 言語>_ < 国名または地域名>.properties (該当する場合) を < インストール・ DIR>/resources ディレクトリーから < インストール・ DIR>/repository/eardata/SMFS/war/yfscommon ディレクトリーにコピーします。
  11. extnbundle.properties ファイルおよび extnbundle_< 言語>_ < 国名または地域名>.properties (該当する場合) を < インストール・ DIR>/resources/extn ディレクトリーから < インストール・ DIR>/repository/eardata/SMFS/war/yfscommon ディレクトリーにコピーします。
  12. (オプション) PCA がインストールされている場合は、以下のファイルを < INSTALL_DIR>/repository/eardata/smcfs/war/yfscommon ディレクトリーにコピーします。
    • < INSTALL_DIR>/resources/com.yantra.yfc.rcp.common_bundle.properties
    • < INSTALL_DIR>/resources/com.yantra.yfc.rcp_bundle.properties
    • < INSTALL_DIR>/resources/PCA_Codebundle.properties。 たとえば、 Sterling™ Call Center および Sterling Store Engagement (レガシー) アプリケーションの場合、 ycdbundle.properties ファイルをコピーします。
  13. 行った拡張を < INSTALL_DIR>/extensions/global/webpages ディレクトリーにコピーします。
    例外: カスタマイズされた JSP を特定のパッケージに組み込むには、それを < INSTALL_DIR>/extensions/< package>/webpages に入れます。 例えば、smcfs または sbc war の場合は、それぞれ < INSTALL_DIR>/extensions /smcfs/webpages および < INSTALL_DIR>/extensions/sbc/webpages を使用します。

    カスタマイズされた JSP をすべてのパッケージに組み込むには、それを < INSTALL_DIR>/extensions /global/webpages に入れます。

  14. インストール・プロセス時に行ったのと同様に、EAR ファイルを再ビルドします。
    文書 EAR をアプリケーション EAR と一緒に ビルドすることもできます。 DOC EAR は、コンテキスト・ヘルプ・ファイルなどのエンド・ユーザー文書を 含みません。 これには、実動サーバーにデプロイしてはならない開発関連の資料 (API Javadoc、ERD、XSD など) のみが含まれています。
    文書 EAR smcfsdocs.ear をアプリケーション EAR と共にビルドするには、ビルダー・コマンドを実行する前に、 BUILD_DOC_EAR プロパティーを追加して、<INSTALL_DIR>/properties/sandbox.cfg ファイル内で 値を「true」に設定し、setupfiles スクリプトを実行します。
    注: デフォルトでは、文書 EAR はアプリケーション EAR とともにビルドおよびデプロイされません。
    注: -Dnodocear パラメーターは、BUILD_DOC_EAR プロパティーよりも優先されます。 例えば、BUILD_DOC_EAR プロパティーが「true」に設定されていても -Dnodocear パラメーターが create-ear スクリプトと一緒に使用されている場合は、 文書 EAR はビルドされません。
  15. 以下の war ファイルを smcfs.ear ファイルから解凍します。
    • smcfs.war
    • sbc.war
    • sma.war

    smcfsdocs.ear ファイルから smcfsdocs.war ファイルを 解凍します。

    次に、これらの war ファイルのそれぞれを希望のディレクトリーに解凍します。

  16. smcfs.ear ファイルから残りの jar ファイルを解凍し、すべての解凍された jar ファイルを WEB-INF/lib にコピーします。 これにより、 WebLogic からこれらの jar ファイルにアクセスできるようになります。 これらの jar ファイルを WebLogic CLASSPATH に含める必要はありません。
  17. WebLogic 上の各ディレクトリーを Web アプリケーションとしてデプロイします。
  18. 以下の WebLogic Hot Deployment Test Mode 標準を使用して、カスタマイズ内容をテストします。
    変更の対象 変更を行うファイル アクション
    始動パラメーター プロパティ- WebLogic を再始動する
    UI 拡張性 JSP、 JavaScript,、CSS、テーマXML 動的にロードする
    ローカライズ・リテラル alertmessages ファイルおよびローカライズ・バンドル・ファイル WebLogic を再始動する
    データベース拡張 エンティティー XML entities.jar ファイルを再ビルドし、その jar をクラスパス・ディレクトリーに組み込んでから、 WebSphere®を再始動します。
    API およびその他のテンプレート・ファイル テンプレート XML resources.jar ファイルを再ビルドしてその jar ファイル をクラスパス・ディレクトリーに含めてから、WebLogic を再始動する

次に行うこと

次に、後述するように WebLogic を構成する 必要があります。 さらに情報が必要な場合は、WebLogic の資料を参照してください。

サーバーで application_name.war ファイルが解凍されたディレクトリーから読み取れるように WebLogic を構成する必要があります。 開発環境においてエクスプロード (非 EAR) ・モードでアプリケーションを 実行できるよう WebLogic を構成するために必要なステップは、 以下に示します。

注:

爆発モードでデプロイされたものは、EARモードでデプロイされたソリューションと同様に動作します。 エクスプロード・モードに固有のパフォーマンス上の影響はありません。

IBM® では、実稼働環境での EAR モードのデプロイメントを推奨しています。 1 つのアプリケーション・サーバーで 複数のアプリケーションをホストする場合、アプリケーション間で jar またはクラスの 競合はありません。 これは、各アプリケーションが、その他のアプリケーション・ パッケージ (EAR) とは分離された単一の EAR ファイルとしてパッケージ化または デプロイされるためです。 ただし、エクスプロード・モードでは、クラスパスに最初に 追加されるクラスが常に考慮されます。