Oracle® Fusion Middlewareドメイン・テンプレート・ビルダーによるドメイン・テンプレートの作成 12c リリース1 (12.1.1) B65937-01 |
|
前 |
この章では、一般的なテンプレート作成タスクについて説明し、タスクの例を示します。
この章の内容は以下のとおりです。
次の例はAvitek Medical Recordsサンプル・ドメインを使用してカスタム・ドメイン・テンプレートを作成する方法について説明します。ドメイン・テンプレートはドメイン内にリソースの完全なセットを定義し、これにはインフラストラクチャ・コンポーネント、アプリケーション、サービス、セキュリティ・オプションや一般環境およびオペレーティング・システム・パラメータが含まれます。いったんサンプル・ドメインを作成すれば、Medical Recordsサンプル・ドメインを作成するうえで構成ウィザードへの入力として、このテンプレートを使用することができます。
注意: この例は、WebLogic Serverをインストールするときに、WebLogic Serverのサンプルをインストールしたという想定に基づいています。 |
ドメイン・テンプレート・ビルダーを起動します。
Windowsの「スタート」メニューから、「スタート」>「プログラム」>Oracle WebLogic>WebLogic Server>「ツール」>「ドメイン・テンプレート・ビルダー」を選択します。
UNIXの場合:
WebLogic Server/common/bin
サブディレクトリへ進みます:
cd
MW_HOME
/wlserver_12.1/common/bin
次のコマンドを入力します。
sh config_builder.sh
「新しいテンプレートの作成」画面で、「ドメイン・テンプレートの作成」を選択し、「次へ」をクリックします。
「テンプレート・ドメイン・ソースの選択」画面で:
「ドメインの選択」タブを選択します。
次のディレクトリに移動します。
MW_HOME
\wlserver_12.1\samples\domains
MW_HOME
はミドルウェア・ホーム・ディレクトリ(デフォルトはC:\Oracle\Middleware\
)です。
medrecドメインを選択します。
「次へ」をクリックします。
「テンプレートの説明」>画面で、各フィールドに入力し「次へ」をクリックします。
この例では、次の情報を入力します。
名前- Avitek Medical Recordsサンプル・ドメイン
バージョン- 10.3.3(または表示されるデフォルトを受け入れます)
作者 - Oracle Corporation
カテゴリ - Oracle
説明- インストールしたキットの外のディレクトリにAvitek Medical Recordsドメインを作成します。Avitek Medical RecordsはWebLogic Serverの統合サンプル・アプリケーションで、Java EEプラットフォームのすべての特徴を簡潔に発揮します。
注意: 作成するテンプレートを新しいテンプレートのソースとして使用する場合、このウィンドウの情報が、「テンプレート・ドメイン・ソースの選択」画面の「テンプレートの選択」セクションに表示されます。 |
ドメイン・テンプレートの名前と場所の入力画面で、次の情報を入力するかデフォルトに設定します。
テンプレートjar名- テンプレートのJARファイルのために使用する名前を入力するか、直前の画面で入力した名前をデフォールトとして受け入れます。
テンプレートの場所- デフォルトの(MW_HOME
\user_templates
)を使用するか、他のディレクトリの場所を入力します。
「アプリケーションの追加または除外」画面で、テンプレートからアプリケーションを除外でき、適用する場合アプリケーションをインポートするディレクトリの相対パスを変更します。デフォルトでは、ドメインのすべてのアプリケーションが選択されて、テンプレートに追加されます。
このドメインのアプリケーションは、WebLogic Serverソフトウェアに含まれます。したがって、インポートするディレクトリの相対パスを変更することはできません。これらのアプリケーションはシステム上に常駐するため、テンプレートにコピーされません。
この例では、すべてのアプリケーションを選択されたままにし、「次へ」をクリックします。
「ファイルの追加」画面で、テンプレートからファイルを追加したり削除することができます。デフォルトで、次のファイルおよびディレクトリがテンプレートに含まれます。
次の拡張子を持つ、ルート・ディレクトリのすべてのファイル: .cmd
、.sh
、.xml
、.properties
および.ini
。
bin
ディレクトリ
lib
ディレクトリ
ドメインの作成時に自動的に作成されないsecurity
ディレクトリ内のすべてのファイル。たとえば、デフォルトでは、DefaultRoleMapperInit.ldift
およびXACMLRoleMapperInit.ldift
は含まれません。
テンプレートの作成時にドメイン・テンプレート・ビルダーにより自動的にインクルードされないconfig
ディレクトリ内のすべてのファイルおよびサブディレクトリ。たとえば、config.xml
およびconfig.xml
で定義されているJDBCとJMSのリソースは、テンプレートの作成時にドメイン・テンプレート・ビルダーにより自動的にテンプレートにインクルードされるので、デフォルトでは「現在のテンプレート・ビュー」ペインに表示されません。
注意: このテンプレートに組み込むアプリケーションは製品のインストールで提供されているため、テンプレートにはコピーされていません。したがって、これらのアプリケーションは「現在のテンプレート・ビュー」ペインの「アプリケーション・ルート・ディレクトリ」リストには含まれません。 |
デプロイしたアプリケーションに必要なその他のファイルがシステムにある場合、このウィンドウで追加できます。
medrecテンプレートは追加ファイルを含んでいません。「次へ」をクリックして続行します。
「SQLスクリプトの追加」画面で、このテンプレートから作成したドメインで使用するデータベースのSQLスクリプトを追加することができます。
Medical Recordsサンプルは、製品のインストールに含まれるデフォルトのDerbyデモ・データベースを使用します。この例ではSQLスクリプトを加える必要はありません。
「次へ」をクリックして続行します。
「管理サーバーの構成」画面で、管理サーバーの構成情報を定義します。詳細は、管理サーバーを構成を参照してください。
この例ではデフォルト値を選択したままに残し、「次へ」をクリックします。
「管理者ユーザー名およびパスワードの構成」画面で、管理サーバーを起動し、接続する時に使用するユーザー名およびパスワードを指定します。
デフォルトで、Medical Recordsドメインのユーザー名/パスワードの組合せはweblogic/welcome1
です。追加のユーザー、グループおよびグローバル・ロールを構成できます。
この例では、デフォルトの設定を受け入れて、「次へ」をクリックします。
「スタート・メニュー・エントリの指定」画面で、Windowsの「スタート」メニューにエントリを作成できます。この例では、Medical Recordsサーバーを開始および停止するためのエントリを作成します。
「スタート」メニューにMedical Recordsサーバー起動用のエントリを作成するには:
「追加」をクリックします。
「ショートカット・リンク名」フィールドに、Medical Recordsサーバーの開始
と入力します。
「プログラム」ドロップダウン・リストから、bin/startWebLogic.cmd(Windows)を選択するか、bin\startWebLogic.sh(UNIX)を選択します。
この例では残りのフィールドに入力する必要はありません。
「スタート」メニューにMedical Recordsサーバーの停止用のエントリを作成するには:
「追加」をクリックします。
「ショートカット・リンク名」フィールドに、Medical Recordsサーバーの停止
と入力します。
「プログラム」ドロップダウン・リストから、bin/stopWebLogic.cmd(Windows)を選択するか、bin\stopWebLogic.sh(UNIX)を選択します。
この例では残りのフィールドに入力する必要はありません。
「次へ」をクリックします。
「置換変数のためのスクリプトおよびファイルの準備」画面で、ドメイン・テンプレート・ビルダーによって更新されていないファイルでのハードコーディングした文字列を置換変数で置き換えることができます。ドメイン・テンプレート・ビルダーは、様々なドメイン設定のハードコーディングした値を置換変数で置き換えることで開始スクリプトのような、テンプレートに含まれている標準スクリプトを自動的に更新します。あとで、構成ウィザードにより、新しいドメインの構成中にこれらの変数を新しいハードコーディングした値で置き換えることができます。
この例では、追加のスクリプトまたはファイルを編集する必要はありません。
「次へ」をクリックします。
テンプレートを作成する前に、「WebLogicドメイン・テンプレートの確認」画面で、新しいのドメイン・テンプレートの設定を確認します。事前に指定した構成の情報を変更する場合、「前へ」をクリックし、該当する構成ウィンドウに戻ります。
「作成」をクリックします。
テンプレート作成処理中は、「テンプレートの作成中」画面に、ステータス・メッセージが表示されます。
「完了」をクリックして、ドメイン・テンプレート・ビルダーを終了します。
次の例では、WebLogic Serverが提供するAvitek Medical Recordsサンプル・ドメイン拡張テンプレートを修正し、カスタム拡張テンプレートを作成する方法について説明します。拡張テンプレートは、既存のドメインを拡張するアプリケーションおよびサービスを定義します。拡張テンプレートを作成するプロセスは、ドメイン・テンプレートを作成するプロセスと類似していますが、管理サーバーの構成、管理者のユーザー名とパスワードの割り当て、あるいは「スタート」メニュー・エントリの指定を(これらのドメイン設定は拡張対象のドメインで定義済みなので)行わない点が異なります。
この例では、追加のMedical RecordsユーザーをサポートするカスタマイズしたMedRec拡張テンプレートを作成します。一度サンプルの拡張テンプレートを作成すると、構成ウィザードで新しい拡張テンプレートを選択して、Medical Recordsサンプル・ドメインで既存のWebLogicドメインを拡張することができます。
カスタム化したMedRec拡張テンプレートを作成するには:
ドメイン・テンプレート・ビルダーを起動します。
Windowsの「スタート」メニューから、「スタート」>「プログラム」>Oracle WebLogic>WebLogic Server>「ツール」>「ドメイン・テンプレート・ビルダー」を選択します。
UNIXの場合:
WebLogic Server/common/bin
サブディレクトリへ進みます:
cd
MW_HOME
/wlserver_12.1/common/bin
次のコマンドを入力します。
sh config_builder.sh
「新しいテンプレートの作成」画面で、「ドメイン・テンプレートの作成」を選択し、「次へ」をクリックします。
「テンプレート・ドメイン・ソースの選択」画面で、既存の拡張テンプレートか、拡張テンプレートを作成するドメインを選択します。この例では、製品インストールに含まれるAvitek Medical Records拡張テンプレートを使用して拡張テンプレートを作成します。
「テンプレートの選択」タブをクリックします。
製品インストールに含まれ事前に定義されている拡張テンプレートのリストが、「テンプレート」ペインに表示されます。
リストからAvitek Medical Recordsサンプル・ドメイン拡張テンプレートを選択します。
「次へ」をクリックします。
新しいテンプレートのソースとして既存のテンプレートを使用しています。Avitek Medical Recordsサンプル・ドメイン拡張テンプレートの情報は、自動的に「テンプレートの説明」画面に表示されます。
この例では説明を変更する必要はありません。
「次へ」をクリックします。
ドメイン・テンプレートの名前と場所の入力画面で、次の情報を入力するかデフォルトを受け入れます。
テンプレートjar名- テンプレートのJARファイルのために使用する名前を入力するか、直前の画面で入力した名前をデフォルトとして受け入れます。
テンプレートの場所- デフォルトの(MW_HOME
\user_templates
)を使用するか、他のディレクトリの場所を入力します。
「アプリケーションの追加または除外」画面で、拡張テンプレートからアプリケーションを除外でき、またアプリケーションがインポートされるディレクトリの相対パスを変更できます。デフォルトでは、ソースに含まれるすべてのアプリケーションが選択され、カスタム・テンプレートに追加されることを示します。
この例ではアプリケーションを追加または削除する必要はありません。
「次へ」をクリックします。
「ファイルの追加」画面で、拡張テンプレートからファイルを追加したり削除することができます。カスタム・テンプレートのソースとして既存のテンプレートを選択した場合、ソース・テンプレートからのすべてのファイルが自動的に含まれます。
この例では、別に定義したアプリケーション・ディレクトリが、Avitek Medical Recordsサンプル・ドメイン拡張テンプレートに含まれています。したがって、テンプレートのアプリケーションは、「現在のテンプレート・ビュー」ペインの「アプリケーション・ルート・ディレクトリ」にリスト表示されます。
「次へ」をクリックします。
「SQLスクリプトの追加」画面で、このテンプレートから作成したドメインで使用するデータベースのSQLスクリプトを追加することができます。
この例ではデータベース・スクリプトを追加する必要はありません。
「次へ」をクリックします。
「セキュリティ構成オプション」画面で、新しい拡張テンプレートのソースとして機能する拡張テンプレートまたは使用中のドメインのどちらかで定義されているセキュリティ設定をカスタマイズすることができます。
この例では、追加のユーザーを定義します。「はい」を選択し、「次へ」をクリックします。
「ユーザー、グループ、およびグローバル・ロールの構成」画面で、認証目的のためにユーザー、グループおよびロールを定義することができます。テンプレートで定義したユーザー、グループおよびロールがリストで表示されます。「ユーザー」、「グループ」または「ロール」タブを選択し、現在の定義を確認できます。
この例では、新しい医師を定義し、医師を既存のグループに割り当てます。
「ユーザー」タブを選択します。
「追加」をクリックします。
以下の値を入力します。
ユーザー名: joe@md.com
ユーザー・パスワード: welcome1
説明: MedRec Physician
デフォルトで、新しいユーザーは「管理者」グループに割り当てられます。次のウィンドウで割当をクリアし、「MedRec Physicians」グループにjoe@md.comを割り当てます。
「次へ」をクリックします。
グループへのユーザーの割当画面で、グループにユーザーを割り当てることができます。グループを管理することで、同時に複数のユーザーを管理できるため、グループにユーザーを追加することをお薦めします。
この例では、「管理者」グループからjoe@md.comを削除し、MedRecPhysiciansグループに追加します。
「グループ」ペインで、「管理者」グループが選択されていることを確認します。
左ペインに、「管理者」グループの現在の割当一覧が表示されます。
左ペインでjoe@md.comを選択解除します。
「グループ」ペインで、MedRecPhysiciansを選択します。
左ペインに、MedRecPhysiciansグループの現在の割当リストが表示されます。
左ペインで、joe@md.comのチェック・ボックスを選択します。joe@md.comに関連するグループのリストが更新され、変更が反映されます。
「次へ」をクリックします。
「グループのグループへの割当」画面で、他のグループのメンバーとして、ひとつのグループを指定します。この例では、デフォルトの割当を変更する必要はありません。
「次へ」をクリックします。
「ユーザーおよびグループのグローバル・ロールへの割当」画面で、WebLogic Serverによって定義されたグローバル・セキュリティ・ロールに対し、ユーザーおよびグループを割り当てることができます。この例では、デフォルトの割当を変更する必要はありません。
「次へ」をクリックします。
「置換変数のためのスクリプトおよびファイルの準備」画面で、ドメイン・テンプレート・ビルダーによって更新されていないファイルでのハードコーディングした文字列を置換変数で置き換えることができます。ドメイン・テンプレート・ビルダーは、様々なドメイン設定のハードコーディングした値を置換変数で置き換えることで開始スクリプトのような、テンプレートに含まれている標準スクリプトを自動的に更新します。あとで、構成ウィザードにより、新しいドメインの構成中にこれらの変数を新しいハードコーディングした値で置き換えることができます。
この例では、追加のスクリプトやファイルを編集する必要はありません。「次へ」をクリックします。
テンプレートを作成する前に、「WebLogicドメイン・テンプレートの確認」画面で、新しい拡張テンプレートの設定を確認します。事前に指定した構成の情報を変更する必要がある場合、「前へ」をクリックし、該当する構成ウィンドウに戻ります。
「作成」をクリックします。
テンプレート作成処理中は、「テンプレートの作成中」画面に、ステータス・メッセージが表示されます。
「完了」をクリックします。