Avitek Medical Record 開発チュートリアル

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

ドメインおよびサーバのコンフィグレーション

 


チュートリアル 1 : 開発用の WebLogic ドメインおよびサーバ インスタンスの作成

このチュートリアルでは、WebLogic Server コンフィグレーション ウィザードを使用して、MedRec アプリケーションのデプロイおよび実行のためのドメインとサーバを作成します。また、サーバの起動方法も説明します。

コンフィグレーション ウィザードでは、選択したコンフィグレーション テンプレートに基づいて作成するドメインの情報を求められます。次に、入力した情報に基づいて、ドメインの config.xml ファイルと、他の補助的なコンフィグレーション XML ファイルが作成されます。また、ドメインのサーバ インスタンスの起動スクリプト、および新しいドメインとそのサーバを起動および使用するのに役立つ他のヘルパー ファイルとディレクトリも作成されます。これらのスクリプトおよびディレクトリは、後続のチュートリアルで使用します。

チュートリアルの内容は以下のとおりです。

 


前提条件

このチュートリアルを始める前に、以下のことを行ってください。

 


手順

MedRec ドメインと、MedRec をデプロイする WebLogic Server インスタンスを作成するには、次の手順を行います。作成したドメインおよびサーバは、後続のチュートリアルで使用します。

手順 1 : MedRec ドメインおよび MedRec サーバを作成する

MedRec ドメインには、MedRec Administration アプリケーションおよび Patient アプリケーション (どちらも Web アプリケーション) といった MedRec バックエンド サービスをホストする 1 つのサーバが含まれます。

  1. 次の順に選択して、コンフィグレーション ウィザードを起動します。
  2. [スタートArrow symbolすべてのプログラムArrow symbolBEA ProductsArrow symbolToolsArrow symbolConfiguration Wizard]

  3. [ようこそ] ウィンドウで、[新しい WebLogic ドメインの作成] を選択します。
  4. [次へ] をクリックします。
  5. [ドメイン ソースの選択] ウィンドウで、[以下の BEA 製品をサポートするために、自動的にコンフィグレーションされたドメインを生成する] オプションを選択します。
  6. 簡単にするため、他の BEA Products ([Workshop for WebLogic Platform]、[AquaLogic Service Bus]、[Apache Beehive] など) は選択しないでください。

  7. [次へ] をクリックします。
  8. [管理ユーザ名とパスワードのコンフィグレーション] ウィンドウで、以下のように入力します。
    • [User name] に weblogic と入力します。
    • [User password] および [Confirm user password] フィールドに weblogic と入力します。
    • 省略可能な説明
    • サーバを起動して Administration Console にログインするときに、このユーザ名とパスワードを使用します。

      注意: プロダクション環境では、ユーザ名とパスワードは同じ値にしないでください。
  9. [次へ] をクリックします。
  10. [サーバの起動モードおよび JDK のコンフィグレーション] ウィンドウで、次のように選択します。
    • [WebLogic ドメインの起動モード] で [開発モード] を選択します。
    • [JDK の選択] の [BEA 提供の JDK] の下で [Sun SDK 1.5.0_XX @ JDK_location] を選択します。
    • この Sun SDK は開発モードのデフォルト値です。Sun SDK または JRockit SDK のいずれかを選択できます。Sun SDK を使用すると起動時間が短くなり、JRockit SDK は Intel アーキテクチャでの実行時のパフォーマンスに優れています。

  11. [次へ] をクリックします。
  12. [環境とサービスの設定のカスタマイズ] ウィンドウで、[はい] を選択します。
  13. [次へ] をクリックします。
  14. [管理サーバのコンフィグレーション] ウィンドウで、以下のように入力または選択します。
    • [Name] に MedRecServer と入力します。
    • [Listen address] に All Local Addresses と入力します。
    • [Listen port] に 7101 と入力します。
    • このチュートリアルでは、WebLogic Server の一般的なデフォルトのポート番号でもあるサンプル サーバのデフォルトのポート番号 (7011) とは意図的に異なるポート番号を入力するように指示しています。この番号を別の WebLogic Server インスタンスですでにコンフィグレーションしている場合は、ネットワーク通信の衝突を避けるために、別の値を入力してください。このポートを管理サーバ専用の TCP/IP ポートにする必要があります。ポート番号は 1 から 65535 までの任意の整数を使用できます。

    • [SSL enabled] チェック ボックスを選択します。
    • [SSL listen port] に 7102 と入力します。
    • このチュートリアルでは、デフォルトの SSL ポート番号 (7012) とは意図的に異なる SSL ポート番号を入力するように指示しています。この番号を別の WebLogic Server インスタンスの SSL リスン ポートとしてすでにコンフィグレーションしている場合は、ネットワーク通信の衝突を避けるために、別の値を入力してください。このポートを専用の TCP/IP ポートにする必要があります。[Listen port] と同じ値を指定することはできません。ポート番号は 1 から 65535 までの任意の整数を使用できます。

  15. [次へ] をクリックします。
  16. 以下のウィンドウでは、何も変更しないで [次へ] を選択します。
    • [管理対象サーバのコンフィグレーション]
    • [マシンのコンフィグレーション]
  17. [WebLogic ドメインの確認] ウィンドウで、左ペインの [MedRecServer] をクリックし、選択内容を確認して [次へ] をクリックします。
  18. [WebLogic ドメインの作成] ウィンドウで次の操作を行います。
    1. [ドメイン名] に MedRecDomain と入力します。
    2. [作成] をクリックして、[ドメインの場所] テキスト ボックスに表示されたフォルダに MedRec ドメインを作成します。ドメインの作成が完了すると、「ドメインの作成が完了しました。」というメッセージが表示されます。
  19. [完了] をクリックして、コンフィグレーション ウィザードを閉じます。
  20. [管理サーバの起動] はチェックしないでください。

手順 2 : アプリケーション メッセージのロギング用に log4j を有効にする

MedRec アプリケーション スイートでは、アプリケーション メッセージのロギングに log4j を使用します。コンフィグレーション済みの MedRec ドメインの log4j プロパティ ファイルをコピーし、起動オプションを使用して MedRecServer 起動スクリプトにこのファイルを指定する必要があります。また、log4j jar ファイルを MedRec ドメインの lib ディレクトリにコピーする必要があります。これらの操作を行うには、次の手順に従います。

  1. (メインの WebLogic Server インストール ディレクトリの下にある) コンフィグレーション済みの MedRec ドメインから、新しく作成したドメインに、log4j プロパティ ファイルをコピーします。
  2. たとえば、WebLogic Server を c:\bea ディレクトリにインストールした場合は、コマンドライン シェルで以下のように入力します。

    prompt> copy c:\bea\weblogic92\samples\domains\medrec\log4jConfig.xml c:\bea\user_projects\domains\MedRecDomain
  3. 新しいドメインの setDomainEnv.cmd スクリプト (新しく作成したドメイン ディレクトリの bin ディレクトリ内) をテキスト エディタで開きます。次に例を示します。
  4. prompt> notepad c:\bea\user_projects\domains\MedRecDomain\bin\setDomainEnv.cmd
  5. setDomainEnv.cmd スクリプトで次の行を探します。
  6. if NOT "%LOG4J_CONFIG_FILE%"=="" (
  7. 前の手順で示した行の直前に、次の 2 行を追加します。
  8. set LOG4J_CONFIG_FILE=c:\bea\user_projects\domains\MedRecDomain\log4jConfig.xml
    for %%i in ("%LOG4J_CONFIG_FILE%") do set LOG4J_CONFIG_FILE=%%~fsi

    上記のテキストでは、MedRecDomain ディレクトリが c:\bea\user_projects\domains\MedRecDomain であることを前提としています。ディレクトリが異なる場合は、正確なドメイン ディレクトリを入力してください。

  9. ファイルを保存してテキスト エディタを終了します。
  10. コンフィグレーション済みの MedRec ドメインの lib ディレクトリから、新しく作成したドメインの lib ディレクトリに、log4j JAR ファイルをコピーします。
  11. prompt> copy c:\bea\weblogic92\samples\domains\medrec\lib\*.jar c:\bea\user_projects\domains\MedRecDomain\lib 

    ドメイン ディレクトリの lib サブディレクトリにあるすべての JAR ファイルは、ドメインのサーバの起動時に WebLogic Server のシステム CLASSPATH に自動的に追加されます。

手順 3 : MedRecDBMSPlugin.jar をサーバの CLASSPATH に追加する

MedRec アプリケーション スイートでは、カスタム DBMS 認証プロバイダを使用して、コンフィグレーション済みの PointBase RDBMS から、指定されたユーザ名のログイン資格を取得します。この認証プロバイダを実装する Java クラスは、インストール済みの MedRec ドメインにある MedRecDBMSPlugin.jar ファイルの中にあります。Administration Console を使用してカスタム認証プロバイダをコンフィグレーションできるように (「チュートリアル 3 : Administration Console での WebLogic Server リソースのコンフィグレーション」を参照)、この JAR ファイルを MedRecServer の CLASSPATH に追加する必要があります。

  1. 新しいドメインの setDomainEnv.cmd スクリプト (ドメイン ディレクトリの bin ディレクトリ内) をテキスト エディタで開きます。次に例を示します。
  2. prompt> notepad c:\bea\user_projects\domains\MedRecDomain\bin\setDomainEnv.cmd
  3. setDomainEnv.cmd スクリプトで次の行を探します。
  4. set PRE_CLASSPATH=
  5. MedRecDBMSPlug.jar ファイル (WL_HOME\samples\domains\medrec\security ディレクトリ内) の絶対パス名を追加して PRE_CLASSPATH を更新します。WL_HOME は WebLogic Server のルート ディレクトリです (デフォルトは c:\bea\weblogic92)。次に例を示します。
  6. set PRE_CLASSPATH=c:\bea\weblogic92\samples\domains\medrec\security\MedRecDBMSPlugin.jar
  7. ファイルを保存してテキスト エディタを終了します。

手順 4 : MedRec 管理サーバを起動する

次のいずれかの方法で MedRec 管理サーバを起動します。

[スタート] メニューから起動する場合

[スタートArrow symbolすべてのプログラムArrow symbolBEA ProductsArrow symbolUser ProjectsArrow symbolMedRecDomainArrow symbolStart Admin Server for WebLogic Server Domain]

スクリプトから起動する場合

  1. コマンドライン シェルで、MedRec ドメインのルート ディレクトリ (通常は c:\bea\user_projects\domains\MedRecDomain) に移動します。たとえば、コマンド プロンプトから次のように入力します。
  2. prompt> cd c:\bea\user_projects\domains\MedRecDomain
  3. startWebLogic.cmd スクリプトを呼び出して MedRec サーバを起動します。
  4. (Windows) prompt> startWebLogic.cmd

    (UNIX) prompt> ./startWeblogic.sh

起動中、サーバが使用できる状態になったら、次のようなメッセージが表示されます。

<Jul 24, 2006 2:03:56 PM PDT> <Notice> <WebLogicServer> <BEA-000360> <Server started in RUNNING mode>

 


ベスト プラクティス

 


全体像

このチュートリアルは開発環境の設定の基礎です。アプリケーションをサーバにデプロイするには、まずアプリケーションをデプロイするドメインとサーバをコンフィグレーションする必要があります。このチュートリアルでは、MedRec アプリケーションをホストする 1 つのサーバを含む MedRec ドメインを作成しました。ほとんどのチュートリアルでこのドメインを使用します。

 


関連情報


  ページの先頭       前  次