WebLogic をEARファイルを作成せずに実行するには、 WebLogic に適切な設定でアプリケーションを定義し、アプリケーションが必要とするCLASSPATHを設定するために起動スクリプトを構成する必要があります。
このタスクについて
アプリケーションのディレクトリー
構造を設定すると、WebLogic で EAR ファイルからではなく、ファイルから
直接読み取れるようになります。
アプリケーションをエクスプロード・モードで
実行するよう WebLogic を構成するには、以下の手順を実行します。
手順
- Windows(UNIXの場合は startWebLogic.sh)用の <WEBLOGIC_DOMAIN> /bin/startWebLogic.cmdスクリプトを編集し、オプションの引数としてJava™パラメータを以下のように設定します
-Dsci.opsproxy.disable=Y -Dvendor=shell
-DvendorFile=/servers.properties
- WebLogic サーバーを始動し、WebLogic システム・コンソールを開きます。 システム・コンソールには、次のような URL を使用してアクセスすることができます。
http://<hostname or ip-address>:<port number of your
WebLogic Server>/console
- WebLogic サーバーのシステム管理者 ID およびパスワードを使用して、システム・コンソールにログインします。
- 「ドメイン構造」パネルで、 「デプロイメント」をクリックします。
既にアプリケーションがデプロイされている場合は、以下の手順で、アプリケーションを停止し
削除します。
- 既存のアプリケーションのデプロイメントを停止するには、以下の手順を実行します。
- 削除する当該デプロイメントのボックスにチェック・マークを付けます。
- 「停止」をクリックし、ポップアップ・メニューから
「今すぐ強制終了 (Force Stop Now)」を選択します。
- 「アプリケーション・アシスタントの削除 (Delete Application Assistant)」で、「はい」をクリックします。
- 「メッセージ (Messages)」で、メッセージ"Selected Deployments have been
requested to stop"表示されます。
- 既存のアプリケーションのデプロイメントを削除するには、以下の手順を実行します。
- 削除する当該デプロイメントのボックスにチェック・マークを付けます。
- 「削除」をクリックします。
- 「アプリケーション・アシスタントの削除 (Delete Application Assistant)」で、「はい」をクリックします。
- 「メッセージ」で、このメッセージは以下を表示します。"Selected Deployments
were deleted. Remember to click Activate Changes after you are finished."
- 「センターの変更 (Change Center)」パネルで、「変更のアクティブ化 (Activate Changes)」をクリックします。
- 「ロケーション」で、 < application_name>.war ファイルが解凍されたディレクトリーを参照し、 「次へ」をクリックします。
- 「このデプロイメントをアプリケーションとしてインストールする」 を選択し、 「次へ」をクリックします。
- 「ソースのアクセシビリティー (Source accessibility)」で、 「デプロイメントを以下の場所からアクセス可能にする」を選択します。
「場所:」で、その場所が、 < application_name>.war ファイルが解凍されたディレクトリーを指していることを確認します。
- weblogic.xml ファイルを INSTALL_DIR/repository/eardata/platform/descriptors/weblogic/WAR/WEB-INF ディレクトリーから INSTALL_DIR/extensions/smcfs ディレクトリーにコピーします。
- ycpapibundle.properties ファイルおよび ycpapibundle_< 言語>_ < 国名または地域名>.properties (該当する場合) を < インストール・ DIR>/resources ディレクトリーから < インストール・ DIR>/repository/eardata/SMFS/war/yfscommon ディレクトリーにコピーします。
- yscpapibundle.properties ファイルおよび yscpapibundle_< 言語>_ < 国名または地域名>.properties (該当する場合) を < インストール・ DIR>/resources ディレクトリーから < インストール・ DIR>/repository/eardata/SMFS/war/yfscommon ディレクトリーにコピーします。
- extnbundle.properties ファイルおよび extnbundle_< 言語>_ < 国名または地域名>.properties (該当する場合) を < インストール・ DIR>/resources/extn ディレクトリーから < インストール・ DIR>/repository/eardata/SMFS/war/yfscommon ディレクトリーにコピーします。
- (オプション) 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 ファイルをコピーします。
- 行った拡張を < 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 に入れます。
- インストール・プロセス時に行ったのと同様に、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 はビルドされません。
- 以下の war ファイルを smcfs.ear ファイルから解凍します。
- smcfs.war
- sbc.war
- sma.war
smcfsdocs.ear ファイルから smcfsdocs.war ファイルを
解凍します。
次に、これらの war ファイルのそれぞれを希望のディレクトリーに解凍します。
- smcfs.ear ファイルから残りの jar ファイルを解凍し、すべての解凍された jar ファイルを WEB-INF/lib にコピーします。 これにより、
WebLogic からこれらの jar ファイルにアクセスできるようになります。
これらの jar ファイルを WebLogic CLASSPATH に含める必要はありません。
- WebLogic 上の各ディレクトリーを Web アプリケーションとしてデプロイします。
- 以下の 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 ファイルとしてパッケージ化または
デプロイされるためです。 ただし、エクスプロード・モードでは、クラスパスに最初に
追加されるクラスが常に考慮されます。