Domain Template Builder を使用したテンプレートの作成

     前  次    新しいウィンドウで目次を開く     
ここから内容

操作ガイド

この節では、一般的なテンプレート作成タスクについて説明し、タスクの例を示します。

 

操作ガイド : カスタム ドメイン テンプレートの作成

次の例では、Avitek Medical Records Sample Domain を使用してカスタム ドメイン テンプレートを作成する方法を説明します。ドメイン テンプレートは、ドメイン内のすべてのリソースを定義するテンプレートです。これには、インフラストラクチャ コンポーネント、アプリケーション、サービス、セキュリティ オプション、一般的な環境とオペレーティング システムのパラメータが含まれます。このサンプル ドメイン テンプレートを作成し、新しい Medical Records サンプル ドメインを作成するときにコンフィグレーション ウィザードへの入力として使用できます。

注意 : この例は、WebLogic Server をインストールするときに、WebLogic Server のサンプルをインストールしたという想定に基づいています。
  1. Domain Template Builder を起動します。
    • Windows の場合 : [スタート] メニュから [スタート｜プログラム｜Oracle WebLogic｜WebLogic Server｜Tools｜Domain Template Builder] を選択します。
    • UNIX の場合 :

      • 製品のインストール ディレクトリの /common/bin サブディレクトリに移動します。例 : cd $BEAHOME/wlserver_10.0/common/bin

      sh config_builder.sh と入力します。

  2. [新しいテンプレートの作成] ウィンドウで [ドメイン テンプレートの作成] を選択し、[次へ] をクリックします。
  3. [テンプレート ドメイン ソースの選択] ウィンドウで次の操作を行います。
    1. [ドメインを選択] タブを選択します。
    2. 次のディレクトリに移動します。

      3. BEA_HOME\wlserver_10.3\samples\domains

      BEA_HOME は、WebLogic ソフトウェアのインストール ディレクトリを表します (通常は C:\bea\wlserver_10.0)。

    3. [medrec] ドメインを選択します。
    4. [次へ] をクリックします。
  4. [テンプレートの説明] ウィンドウで、テンプレートを表す名前を入力します。
    5. 注意 : 作成するテンプレートを新しいテンプレートのソースとして使用する場合は、このウィンドウで入力した情報が、[テンプレート ドメイン ソースの選択] ウィンドウの [テンプレートを選択] 領域に表示されます。

    この例では、次の情報を入力します。

    • [名前] : Avitek Medical Records Sample Domain
    • [作成者] : Oracle Corporation
    • [カテゴリ] : Oracle
    • [詳細] : Create the Avitek Medical Records domain in a directory outside of the installed kit.The Avitek Medical Records is a WebLogic Server sample application suite that concisely demonstrates all aspects of the Java EE platform.

      • [次へ] をクリックします。

  5. [アプリケーションの追加または削除] ウィンドウでは、必要に応じてテンプレートからアプリケーションを削除し、また必要に応じてアプリケーションのインポート先ディレクトリの相対パスを変更できます。デフォルトでは、ドメインに含まれているすべてのアプリケーションが選択されています。選択されているアプリケーションがテンプレートに追加されます。

    6. このドメインのアプリケーションは WebLogic Server ソフトウェアに組み込まれているので、インポート先ディレクトリの相対パスを変更することはできません。これらのアプリケーションはすでにシステムに存在するため、テンプレートにコピーされません。

    この例では、すべてのアプリケーションを選択したままにして [次へ] をクリックします。

  6. [ファイルの追加] ウィンドウでは、テンプレートのファイルを追加または削除できます。デフォルトでは、以下のファイルとディレクトリがテンプレートに組み込まれます。
    • ルート ディレクトリにある、.cmd、.sh、.xml、.properties、.ini 拡張子を持つすべてのファイル。
    • bin ディレクトリ
    • lib ディレクトリ
    • security ディレクトリにある、ドメイン作成時に自動的に作成されないすべてのファイル。たとえば、XACMLAuthenticatorInit.ldift と XACMLRoleMapperInit.ldift は、デフォルトでは組み込まれません。
    • config ディレクトリにある、テンプレート作成時に Domain Template Builder によって自動的に組み込まれないすべてのファイルおよびサブディレクトリ。たとえば、config.xml と config.xml に定義された JDBC および JMS のリソースは、テンプレート作成時に Domain Template Builder によって自動的にテンプレートに組み込まれるため、デフォルトでは [現在のテンプレート ビュー] ペインに表示されません。
      • 注意 : このテンプレートに組み込むアプリケーションは製品インストール ディレクトリにあるので、テンプレートにはコピーされません。したがって、それらのアプリケーションは [現在のテンプレート ビュー] ペインの [アプリケーション ルート ディレクトリ] に表示されません。

      デプロイされるアプリケーションに必要な他のファイルがシステムに存在する場合は、このウィンドウでそれらのファイルを追加できます。

      この例では、デフォルトでは組み込まれない患者のデータ ファイルを追加します。必要なファイルを追加するには、次の操作を行います。

    1. [ファイル システム ビュー] ペインで次のディレクトリを選択します。

      2. medrec\incoming

    2. [現在のテンプレート ビュー] ペインで [ドメイン ルート ディレクトリ] を選択します。
    3. [追加] をクリックします。

      4. 選択したディレクトリが [ドメイン ルート ディレクトリ] の下に追加されます。

    4. [次へ] をクリックします。
  7. [SQL スクリプトの追加] ウィンドウでは、このテンプレートから作成するドメインで使用する各データベース用の SQL スクリプトを追加できます。

    8. Medical Records のサンプルでは、製品インストール ディレクトリにあるデフォルトの PointBase デモ データベースを使用しています。そのため、この例では SQL スクリプトを追加する必要はありません。

    Oracle や MySQL などの他のデータベースで Medical Records のサンプルを使用することもできます。

    Oracle 用のデータベース ファイルを追加するには、次の手順を実行します。

    1. [データベース タイプおよびバージョン] ペインで、[タイプ] ドロップダウン リストから Oracle を選択し、[バージョン] ドロップダウン リストから Any を選択します。
    2. [SQL ファイルの追加] をクリックします。
    3. [開く] ダイアログ ボックスにおいて次のディレクトリに移動します。

      4. BEA_HOME\wlserver_10.3\samples\server\medrec\setup\db

      このパス名の WL_HOME は、WebLogic Server をインストールしたディレクトリを表します (通常は C:\bea\wlserver_10.3)。

    4. [タイプ] ドロップダウン リストから [すべてのファイル] を選択します。
    5. 〔Shift〕を押しながらクリックして次の 2 つのファイルを選択します。

      6. medrec_oracle.ddl

      medrec_oracle_data.sql

    6. [SQL ファイルの追加] をクリックします。

      7. 追加したファイルの名前が [選択済み SQL ファイル] リストと [選択済みデータベース スクリプト] ペインに表示されます。

      MySQL 用のデータベース ファイルを追加するには、次の手順を実行します。

    7. [データベース タイプおよびバージョン] ペインで、[タイプ] ドロップダウン リストから MySQL を選択し、[バージョン] ドロップダウン リストから Any を選択します。
    8. [SQL ファイルの追加] をクリックします。
    9. [開く] ダイアログ ボックスにおいて次のディレクトリに移動します。

      10. BEA_HOME\wlserver_10.3\samples\server\medrec\setup\db

    10. [タイプ] ドロップダウン リストから [すべてのファイル] を選択します。
    11. 〔Shift〕を押しながらクリックして次の 2 つのファイルを選択します。

      12. medrec_mysql.ddl

      medrec_mysql_data.sql

    12. [SQL ファイルの追加] をクリックします。

      13. 追加したファイルの名前が [選択済み SQL ファイル] リストと [選択済みデータベース スクリプト] ペインに表示されます。

      [次へ] をクリックします。

  8. [管理サーバのコンフィグレーション] ウィンドウでは、管理サーバについて次のコンフィグレーション情報を定義します。詳細については、「管理サーバのコンフィグレーション」を参照してください。

    9. この例でデフォルト値を選択したままにして [次へ] をクリックします。

  9. [管理ユーザ名とパスワードのコンフィグレーション] ウィンドウでは、管理サーバを起動し、管理サーバに接続するために使用する有効なユーザ名とパスワードを指定できます。

    10. デフォルトでは、Medical Records ドメイン用のユーザ名/パスワードの組み合わせは、weblogic/weblogic です。追加のユーザ、グループ、グローバル ロールをコンフィグレーションすることもできます。

    この例では、デフォルトの設定を選択したままにして [次へ] をクリックします。

  10. [スタート メニュー エントリの指定] ウィンドウでは、Windows の [スタート] メニューのエントリを作成できます。この例では、Medical Records サーバの起動と停止のエントリを作成します。

    11. Medical Records サーバを起動するために使用するエントリを [スタート] メニューに作成するには、次の手順に従います。

    1. [追加] をクリックします。
    2. [ショートカット リンク名] フィールドに Start Medical Records Server と入力します。
    3. [プログラム] フィールドのドロップダウン リストから bin/startWebLogic.cmd を選択します。

      4. この例では残りのフィールドに入力する必要はありません。

      Medical Records サーバを停止するために使用するエントリを [スタート] メニューに作成するには、次の手順に従います。

    4. [追加] をクリックします。
    5. [ショートカット リンク名] フィールドに Stop Medical Records Server と入力します。
    6. [プログラム] フィールドのドロップダウン リストから bin/stopWebLogic.cmd を選択します。

      7. この例では残りのフィールドに入力する必要はありません。

      [次へ] をクリックします。

  11. [置換変数を使用したスクリプトおよびファイルの準備] ウィンドウでは、Domain Template Builder で更新されなかったファイル内のハードコード化された文字列を置換変数で置き換えることができます。Domain Template Builder は、ハードコード化されているさまざまなドメイン環境設定の値を置換変数で置き換えて、テンプレートに含まれている起動スクリプトなどの標準スクリプトを自動的に更新します。コンフィグレーション ウィザードは、後で新しいドメインをコンフィグレーションするときに、変数をハードコード化された新しい値に置き換えます。

    12. この例では、追加のスクリプトまたはファイルを編集する必要はありません。

    [次へ] をクリックします。

  12. [WebLogic ドメイン テンプレートの確認] ウインドウでは、作成する前に新しいドメイン テンプレートの設定が確認できます。ここまでに指定したコンフィグレーション情報を変更する必要がある場合は、[前へ] をクリックして必要なコンフィグレーション ウィンドウに戻ります。

    13. [次へ] をクリックします。

  13. [テンプレートの作成] ウィンドウでは、テンプレートの名前を入力し、テンプレート ディレクトリの場所を指定します。

    14. この例では、[テンプレート jar 名] フィールドに my_medrec_template と入力します。

    デフォルトでは、BEA_HOME\user_templates にテンプレートが作成されます。BEA_HOME は、製品がインストールされているディレクトリです。この例ではデフォルトを変更する必要はありません。

    [作成] をクリックします。

  14. [テンプレートを作成しています] ウィンドウに、テンプレート作成プロセスの状況を示すメッセージが表示されます。

    15. [完了] をクリックして Domain Template Builder を閉じます。

 

操作ガイド : カスタム拡張テンプレートの作成

次の例では、製品インストール ディレクトリにある Avitek Medical Records Sample Domain 拡張テンプレートを変更してカスタム拡張テンプレートを作成する方法を説明します。拡張テンプレートでは、既存のドメインの拡張に使用できるアプリケーションとサービスが定義されます。拡張テンプレートを作成するプロセスは、ドメイン テンプレートを作成するプロセスとほぼ同じです。異なる点として、拡張テンプレートの作成では、管理サーバのコンフィグレーション、管理ユーザ名とパスワードの割り当て、[スタート] メニュー エントリの指定を行いません。これらのドメイン設定は、拡張するドメインですでに定義されています。

この例では、カスタマイズした MedRec 拡張テンプレートを作成し、他の Medical Records ユーザに対するサポートを追加します。サンプル拡張テンプレートを作成したら、この新しい拡張テンプレートをコンフィグレーション ウィザードへの入力として指定することにより、Medical Records サンプル ドメインを追加して既存の WebLogic ドメインを拡張できます。

カスタマイズした MedRec 拡張テンプレートを作成するには、次の手順を実行します。

  1. Domain Template Builder を起動します。
    • Windows の場合、[スタート] メニュから [スタート｜プログラム｜Oracle WebLogic｜WebLogic Server｜Tools｜Domain Template Builder] を選択します。
    • UNIX の場合 :

      • 製品のインストール ディレクトリの /common/bin サブディレクトリに移動します。例 : cd $BEAHOME/wlserver_10.0/common/bin

      sh config_builder.sh と入力します。

  2. [新しいテンプレートの作成] ウィンドウで [拡張テンプレートの作成] を選択し、[次へ] をクリックします。
  3. [テンプレート ドメイン ソースの選択] ウィンドウでは、既存の拡張テンプレートまたは新しく作成するドメイン テンプレートの基になるドメインを選択します。この例では、製品インストール ディレクトリにある Avitek Medical Records 拡張テンプレートを使用して独自の拡張テンプレートを作成します。
    1. [テンプレートを選択] タブを選択します。

      2. [テンプレート] ペインの製品インストール ディレクトリにある事前定義済みの拡張テンプレートのリストが表示されます。

    2. リストから [Avitek Medical Records Sample Domain] 拡張テンプレートを選択します。
    3. [次へ] をクリックします。
  4. 既存のテンプレートを新しいテンプレートのソースとして使用しているため、Avitek Medical Records Sample Domain 拡張テンプレートの情報が [テンプレートの説明] ウィンドウに表示されています。

    5. この例では説明を変更する必要はありません。

    [次へ] をクリックします。

  5. [アプリケーションの追加または削除] ウィンドウでは、拡張テンプレートからアプリケーションを削除し、またはアプリケーションのインポート先ディレクトリの相対パスを変更できます。デフォルトでは、ソースに含まれているすべてのアプリケーションが選択されています。選択されているアプリケーションがカスタム テンプレートに追加されます。

    6. この例ではアプリケーションを追加または削除する必要はありません。

    [次へ] をクリックします。

  6. [ファイルの追加] ウィンドウでは、拡張テンプレートのファイルを追加または削除できます。カスタム テンプレートのソースとして既存のテンプレートを選択したので、ソース テンプレートのすべてのファイルも自動的に組み込まれます。

    7. この例では、別に定義されたアプリケーション ディレクトリが Avitek Medical Records Sample Domain 拡張テンプレートに組み込まれています。そのため、テンプレートにリストされているアプリケーションが [現在のテンプレート ビュー] ペインの [アプリケーション ルート ディレクトリ] に表示されます。

    [次へ] をクリックします。

  7. [SQL スクリプトの追加] ウィンドウでは、このテンプレートから作成するドメインで使用する各データベース用の SQL スクリプトを追加できます。PointBase、Oracle、および MySQL 用のデータベース スクリプトが、デフォルトでテンプレートに組み込まれます。

    8. この例ではデータベース スクリプトを追加する必要はありません。

    [次へ] をクリックします。

  8. [セキュリティ コンフィグレーション オプション] ウィンドウでは、ドメインに、または新しい拡張テンプレートのソースとして使用する拡張テンプレートにすでに定義されている任意のセキュリティ設定をカスタマイズできます。

    9. この例では追加のユーザを定義するので、[はい] を選択して [次へ] をクリックします。

  9. [ユーザ、グループ、およびグローバル ロールのコンフィグレーション] ウィンドウでは、認証のためのユーザ、グループ、ロールを定義します。テンプレートでのユーザ、グループ、ロールの定義は以下のとおりです。[ユーザ]、[グループ]、[ロール] の各タブを選択して現在の定義を表示できます。

    10. この例では、新しい医師を定義して既存のグループに割り当てます。

    1. [ユーザ] タブが選択されていることを確認します。
    2. [追加] をクリックします。
    3. 以下の値を入力します。

      4. [User name] : joe@md.com

      [User password] : weblogic

      [Description] : MedRec Physician

      デフォルトでは、新しいユーザは Administrators グループに割り当てられます。次のウィンドウでこの割り当てを解除し、joe@md.com を MedRec Physicians グループに割り当てます。

    4. [次へ] をクリックします。
  10. [ユーザのグループへの割り当て] ウィンドウでは、ユーザをグループに割り当てます。グループを管理することで複数のユーザを同時に管理できるため、ユーザをグループに追加することをお勧めします。

    11. この例では、joe@md.com を Administrators グループから削除し、MedRecPhysiciansグループに割り当てます。

    1. [グループ] ペインで Administrators グループが選択されていることを確認します。

      2. Administrators グループの現在の割り当ての一覧が左ペインに表示されます。

    2. 左ペインで、joe@md.com のチェック ボックスのチェックをはずします。
    3. [グループ] ペインで、MedRecPhysicians グループを選択します。

      4. MedRec Physicians グループの現在の割り当ての一覧が左ペインに表示されます。

    4. 左ペインで、joe@md.com のチェック ボックスをチェックします。joe@md.com に関連付けられているグループのリストが更新され、変更が反映されます。
    5. [次へ] をクリックします。
  11. [グループのグループへの割り当て] ウィンドウでは、グループを別のグループのメンバーとして指定できます。この例ではデフォルトの割り当てを変更する必要はありません。

    12. [次へ] をクリックします。

  12. [ユーザおよびグループのグローバル ロールへの割り当て] ウィンドウでは、ユーザおよびグループを事前に定義された WebLogic Server グローバル セキュリティ ロールに割り当てることができます。この例ではデフォルトの割り当てを変更する必要はありません。

    13. [次へ] をクリックします。

  13. [置換変数を使用したスクリプトおよびファイルの準備] ウィンドウでは、Domain Template Builder で更新されなかったファイル内のハードコード化された文字列を置換変数で置き換えることができます。Domain Template Builder は、ハードコード化されているさまざまなドメイン環境設定の値を置換変数で置き換えて、テンプレートに含まれている起動スクリプトなどの標準スクリプトを自動的に更新します。コンフィグレーション ウィザードは、後で新しいドメインをコンフィグレーションするときに、変数をハードコード化された新しい値に置き換えます。

    14. この例では、追加のスクリプトまたはファイルを編集する必要はありません。[次へ] をクリックします。

  14. [WebLogic ドメイン テンプレートの確認] ウインドウでは、作成する前に新しい拡張テンプレートの設定が確認できます。前のウィンドウで定義した情報を修正する必要がある場合は、[前へ] を選択して必要なコンフィグレーション ウィンドウに戻ります。

    15. [次へ] をクリックします。

  15. [拡張テンプレートの作成] ウィンドウでは、拡張テンプレートの名前を入力し、テンプレート ディレクトリの場所を指定します。

    16. この例では、[テンプレート jar 名] フィールドに my_medrec_ext_template と入力します。

    デフォルトでは、BEA_HOME\user_templates にテンプレートが作成されます。BEA_HOME は、製品がインストールされているディレクトリです。この例ではデフォルトを変更する必要はありません。

    [作成] をクリックします。

  16. [テンプレートを作成しています] ウィンドウに、テンプレート作成プロセスの状況を示すメッセージが表示されます。

    17. [完了] をクリックします。


  ページの先頭       前  次