WebLogic Integration サンプルコンフィグレーションファイル

ドキュメントのダウンロード

サイトマップ

用語集

検索

e-docs > WebLogic Integration > WebLogic Integration の起動、停止およびカスタマイズ > WebLogic Integration サンプルコンフィグレーションファイル

WebLogic Integration の起動、停止およびカスタマイズ

WebLogic Integration サンプルコンフィグレーションファイル

この付録では、開発者とシステム管理者向けに、BEA WebLogic Integration のサンプルコンフィグレーションファイルを説明します。このファイルは、インストール時に自動的にカスタマイズされるので、サポートされているコンピュータシステムおよびネットワークで動作します。必要な情報を説明しながら、各サンプルファイルを示していきます。

この付録のトピックは以下のとおりです。

各ファイルには、インストールプログラムによって更新されるパラメータのサンプル値が含まれています。このサンプル値は、太字で強調表示します。

注意: config.xml などのファイルで使用される頭辞語は、旧リリースから引き継がれているものです。WLC は B2B、WLPI は Business Process Management (BPM)、WLAI は Application Integration、WLXT は Data Integration を表しています。

config.xml

サンプルドメインは、インストール時に次に示す一連のタスクのいずれかを実行した場合に作成されます。このドメインで、WebLogic Integration サンプルアプリケーションを実行できます。

標準的なインストールオプションを選択した。
カスタムインストールオプションを選択し、インストールする項目の 1 つに WebLogic Integration サンプルを選んだ。

ドメインのコンフィグレーションは、XML (eXtensible Markup Language) で定義されます。サンプルドメインコンフィグレーションの永続ストレージは、SAMPLES_HOME/samples/integration/config に配置される config.xml によって提供されます。ここで、SAMPLES_HOME は、WebLogic Platform のサンプルディレクトリです。この項では、WebLogic Integration サンプルドメインの config.xml ファイルの内容について説明します。

config.xml で捕捉された設定を WebLogic Server Administration Console で表示および変更できます。WebLogic Server Administration Console の起動の説明に従って WebLogic Server Administration Console を起動すると、サーバのホームページが表示されます。左ペインに表示されたナビゲーションツリーの項目は、config.xml ファイルで定義された要素と属性に対応しています。

config.xml ファイルのルート要素は Domain です。次の図で示すように、ファイルのこのセクションでは、Application Integration DBMS サンプルアダプタ、BEA WebLogic Adapter for Peregrine Power.Enterprise!、およびデフォルトの Web アプリケーションがデプロイされます(デフォルトの Web アプリケーションは、デプロイされる他の Web アプリケーションでは解決できない HTTP 要求に応答します)。

図 A-1 config.xml ファイル : パート 1

以下の 2 つの図で示すように、ファイルの次のセクションでは、WebLogic Integration アプリケーションで必要な EJB と Web アプリケーションをデプロイしています。

WebLogic Server では、WebLogic Integration によりエクスプロードされた EAR ファイルおよび JAR ファイルの位置と、WLI application.xml ファイルおよび weblogic-application.xml ファイルの位置を確認するために、Path 属性が使用されます（application.xml ファイルおよび weblogic-application.xml ファイルは、path¥META-INF ディレクトリにあります）。

WebLogic Integration J2EE コンポーネントは、エクスプロードされた形式を使用してデプロイされます。エクスプロードされた形式を使用した J2EE コンポーネントのデプロイの詳細については、次の URL から BEA WebLogic Server ドキュメント内の『Web アプリケーションのアセンブルとコンフィグレーション』を参照してください。

http://edocs.beasys.co.jp/e-docs/wls/docs70/webapp/basics.html

コンポーネントがエクスプロードされた形式でデプロイされる場合、DeploymentOrder 属性は、指定されません。代わりに、application.xml ファイルでの J2EE コンポーネントの順序によって、デプロイ順が決定されます。WLI アプリケーションのコンポーネントをデプロイしない場合は、application.xml ファイルのコンポーネントの要素を削除しないでください。代わりに、Targets 属性からサーバ名を削除してください（Targets=""）。

図 A-2 config.xml ファイル : パート 2

次の図に示すように、config.xml ファイルの次のセクションには、Application Integration 機能に関連する要素が記載されます。

図 A-3 config.xml ファイル : パート 3

次の図に示すように、config.xml ファイルの次のセクションでは、WebLogic Integration 用の JDBC 接続プール（wliPool）、JDBC データソース、および JDBC 接続ファクトリを定義しています。

図 A-4 config.xml ファイル : パート 4

次の図に示すように、WebLogic Server Administration Console のナビゲーションツリーで [サービス｜JDBC｜接続プール｜wliPool] を選択することにより、WebLogic Integration JDBC 接続プール（wliPool）の属性を表示したり更新したりすることもできます。

図 A-5 WebLogic Integration JDBC 接続プール

JDBC コンフィグレーション更新の詳細については、ドメインに対する新しいデータベースのコンフィグレーションを参照してください。

また、次の図に示すように、WebLogic Server Administration Console のナビゲーションツリーで [サービス｜JMS｜接続ファクトリ] を選択して、4 つの WebLogic Integration 接続ファクトリを表示することもできます。

図 A-6 WebLogic Integration 接続ファクトリ

警告: WebLogic Integration のマニュアルで指示される場合を除いて、WebLogic Integration 接続ファクトリの属性を変更しないでください。予期しない結果が発生することがあります。たとえば、接続ファクトリの Default Delivery Mode を変更すると、システム障害またはネットワーク障害が発生した場合に WebLogic Integration を復旧できないことがあります。

パフォーマンスを最適なものにするために、JMS JDBC ストアのプレフィックス名をご使用のデータベースに合わせてカスタマイズしてください。プレフィックス名については、次の構文を使用してください。

[[catalog.]schema.]prefix]

JMS ストアプレフィックス名を更新するには、[サービス｜JMS｜ストア｜JMSWLCStore] を選択します。次の図に示す [JMSWLIStore] ページが表示されます。

図 A-7 JMS ストアページ

[プレフィックス名] フィールドに適切なプレフィックス名（使用するデータベースコンフィギュレーションに適合するスキーマプレフィックスとカタログプレフィックスを備えたプレフィックス名）を入力します。使用するデータベースコンフィグレーションに適合するスキーマプレフィックスとカタログプレフィックスを確認するには、DOMAIN_HOME¥dbinfo¥database_type¥setDBVarsExt を参照してください。DOMAIN_HOME は、ドメインのルートへの絶対パス名を示し、database_type は、使用しているデータベース（oracle、sybase、db2、mssql、または pointbase）を意味します。

次の図に示すように、config.xml ファイルの次のセクションでは、WebLogic Integration の JMS Server が定義されます。

図 A-8 config.xml ファイル : パート 5

また、次の図に示すように、WebLogic Server Administration Console のナビゲーションツリーで [サービス｜JMS｜接続ファクトリ] を選択して、WebLogic Integration JMS Server (WLIJMSServer) を表示することもできます。

図 A-9 WebLogic Integration JMS Server

次の図に示すように、config.xml ファイルの次のセクションには、レルム、セキュリティ、および他の要素が記載されます。

図 A-10 config.xml ファイル : パート 6

セキュリティレルムの詳細については、BPM セキュリティモデルについてを参照してください。

次の図で示すように、config.xml ファイルの次のセクションには、Server 要素および属性、ならびに WebLogic Integration B2B シャットダウンクラスが記載されます。

図 A-11 config.xml ファイル : パート 7

ドメイン要素で指定されるドメイン名は、WebLogic Server Administration Console で指定されるドメイン名に対応します。たとえば、コンソールのナビゲーションツリーから [myserver] を選択した場合、次の図に示すようにサーバページが表示されます。

図 A-12 WebLogic Server Administration Console のサーバページ

このページの各タブを選択すると、リスンポート、ログファイル名、ログレベルおよび出力などのサーバコンフィグレーションパラメータを更新できます。設定のヘルプについては、右上隅の疑問符をクリックしてオンラインヘルプを表示するか、次の URL にある WebLogic Server マニュアルを参照してください。

http://edocs.beasys.co.jp/e-docs/wls/docs70/index.html

setEnv

この実行ファイルは、WebLogic Integration の環境変数の設定に使用します。このファイルのインスタンスは、WebLogic Integration インストールディレクトリ、およびその下の bin ディレクトリにあります。このファイルは、startWeblogic コマンドファイル、および WebLogic Integration に付属の他のコマンドファイルによって呼び出されます。

次の図に、サンプルドメインの setenv スクリプト（Windows 上で実行する場合は setEnv.cmd、UNIX 上で実行する場合は setenv.sh）の最初のセクションを示します。（このスクリプトは WLI_HOME ディレクトリにあります。ここで、WLI_HOME は、WebLogic Integration をインストールしたディレクトリです。）太字部分は、インストール時にインストール場所を基に設定された値です。

このコマンドとこのコマンドにより設定される環境変数の詳細については、WebLogic Integration コマンドを参照してください。

コードリスト A-1 setEnv コマンド

@echo off
.
.
.
set JAVA_HOME=C:¥bea¥jdk131_03
set PATH=%PATH%;%JAVA_HOME%¥bin
set BEA_HOME=C:¥bea
set WL_HOME=C:¥bea¥weblogic700¥server
set WLI_HOME=C:¥bea¥weblogic700¥integration
set SAMPLES_HOME=C:¥bea¥weblogic700¥samples
set JAVA_OPTIONS="-XX:MaxPermSize=131072k"
REM set DB2_HOME=

:checkJDK
if exist %JAVA_HOME%¥lib¥nul goto setCP
echo.
echo The JDK wasn’t found in directory %JAVA_HOME%.
echo Please edit the setEnv.cmd script so that the JAVA_HOME
echo variable points to the location of your JDK.
goto error

:setCP
REM Set the WLI common Classpath
set WLICOMMONCP=

for %%a in (
      wlicommon.jar,
) do call :wlicmnlib %%a

.
.
.

startWeblogic

この実行コマンドファイルは WebLogic Server を起動します。このコマンドは、config.xml ファイルの内容を使用して、対応するドメインの config.xml ファイルで指定した WebLogic Integration アプリケーションとリソースをデプロイします。このファイルは、各ドメインのディレクトリにインストールされます。たとえば、Windows システムで、新しいドメイン（mydomain）をデフォルト位置に作成する場合、そのドメインの WebLogic Integration startWeblogic.cmd のディレクトリの位置は、次のとおりです。

BEA_HOME/user_projects/mydomain

このパス名の、BEA_HOME は、使用する BEA Home ディレクトリの位置を示します。たとえば、C:¥bea になります。

次のリストに、サンプルドメインの startWeblogic.cmd (Windows) を示します。コンフィグレーション済みのサンプルドメインの startWebLogic.cmd コマンドは、SAMPLES_HOME/integration/config/samples にあります。ここで、SAMPLES_HOME は、WebLogic Platform のサンプルディレクトリを示します。

コードリスト A-2 startWebLogic.cmd コマンド

@echo off
.
.
.
if /I "%WLI_HOME%" == "" call c:¥bea¥weblogic700¥integration¥setEnv.cmd

setlocal

call %SAMPLES_HOME%¥integration¥samples¥bin¥SetSampleData || goto :EOF
if "%DB_TYPE%" == "pointbase" goto pointbase
goto run

:pointbase
REM Invoke ant script to finish up work
set SCRIPT=%WLI_HOME%¥lib¥scripts¥PointbaseChecker.xml

if exist %SCRIPT% goto ant
echo WARNING: No ant script to check for pointbase (%SCRIPT%)
goto finish

:ant
%JAVA_HOME%¥bin¥java -classpath %WLICP% -Xmx256m org.apache.tools.ant.Main ¥
-buildfile %SCRIPT% || goto error

:run
REM Remove old logs.
del /f /q %WLI_SAMPLES_HOME%¥*.log* > nul 2>&1
del /f /q %WLI_SAMPLES_HOME%¥logs¥* > nul 2>&1

REM Change directory to where DTD files are located
cd /d %WLI_SAMPLES_HOME%

REM WLIS data directory
if not exist %WLI_SAMPLES_HOME%¥data mkdir %WLI_SAMPLES_HOME%¥data || goto finish

REM Start weblogic
%JAVA_HOME%¥bin¥java %JAVA_OPTIONS% %DB_JVMARGS% -Xmx256m -classpath %SVRCP% ¥
 -Dbea.home=%BEA_HOME% -Dweblogic.home=%WL_HOME% ¥
 -Dweblogic.system.home=%SAMPLES_HOME%¥integration -Dweblogic.Domain=samples ¥
 -Dweblogic.management.username=system -Dweblogic.management.password=security ¥
 -Dweblogic.Name=myserver -Dweblogic.RootDirectory=%SAMPLES_HOME%¥integration ¥
 -Djava.security.policy=%WL_HOME%¥lib¥weblogic.policy ¥
 -Dweblogic.management.discover=false ¥
 -Dweblogic.SystemDataStoreConfigDirectory=%WLI_HOME%¥lib ¥
 -Dweblogic.servlet.ClasspathServlet.disableStrictCheck=true weblogic.Server

:finish
endlocal

WebLogic Server を起動する java コマンドの [-Dweblogic.management.password=security] オプションは、パスワードを提供します。このオプションを削除した場合は、パスワードを入力するよう要求されます。このパスワードを変更する場合は、このオプションを削除するかまたは更新しなければなりません。

fileRealm.properties

このプロパティファイルは、WebLogic Server の起動時に作成される User、Group、および ACL オブジェクトを制御します。

次のリストでは、サンプルドメインの fileRealm.properties ファイルを示します。

コードリスト A-3 fileRealm.properties ファイル

#Fri Apr 12 22:21:45 BST 2002
acl.access.weblogic.admin.mbean.MBeanHome=wlcSamplesUser,everyone,guest
acl.boot.weblogic.server=system,everyone
acl.create.weblogic.jms.ServerSessionPool=everyone
acl.enablermonitor.WLCAdmin=admin
acl.execute.weblogic.servlet.AdminClients=system
acl.execute.weblogic.servlet.AdminConnections=system
acl.execute.weblogic.servlet.AdminEvents=system
acl.execute.weblogic.servlet.AdminJDBC=system
acl.execute.weblogic.servlet.AdminLicense=system
acl.execute.weblogic.servlet.AdminMain=system
acl.execute.weblogic.servlet.AdminProps=system
acl.execute.weblogic.servlet.AdminRealm=system
acl.execute.weblogic.servlet.AdminThreads=system
acl.execute.weblogic.servlet.AdminVersion=system
acl.execute.weblogic.servlet.Certificate=system
acl.execute.weblogic.servlet.ConsoleHelp=everyone
acl.execute.weblogic.servlet.T3AdminMain=system
acl.execute.weblogic.servlet.classes=everyone
acl.execute.weblogic.servlet.containerManaged=everyone
acl.execute.weblogic.servlet=system,everyone
acl.hubconfig.WLCAdmin=admin
acl.list.weblogic.jndi.weblogic.ejb=system,everyone
acl.list.weblogic.jndi.weblogic.fileSystem=everyone
acl.list.weblogic.jndi.weblogic.rmi=everyone
acl.list.weblogic.jndi.weblogic=system,everyone
acl.list.weblogic.jndi=everyone
acl.lockServer.weblogic.admin=system
acl.lookup.weblogic.admin.mbean.MBeanHome=wlcSamplesUser,everyone,guest
acl.lookup.weblogic.jndi.weblogic.ejb=system,everyone,guest
acl.lookup.weblogic.jndi.weblogic.fileSystem=everyone
acl.lookup.weblogic.jndi.weblogic.rmi=everyone
acl.lookup.weblogic.jndi.weblogic=everyone
acl.lookup.weblogic.jndi=everyone
acl.modify.weblogic.admin.acl=system
acl.modify.weblogic.jndi.weblogic.ejb=system,everyone,guest
acl.modify.weblogic.jndi.weblogic.fileSystem=everyone
acl.modify.weblogic.jndi.weblogic.rmi=everyone
acl.modify.weblogic.jndi.weblogic=system,everyone,guest
acl.modify.weblogic.jndi=everyone
acl.read.managedObject=system
acl.read.weblogic.workspace=system,everyone
acl.receive.weblogic.jms=everyone
acl.reserve.weblogic.jdbc.connectionPool.wliPool=wlisystem,everyone
acl.reserve.weblogic.jdbc.connectionPool=system
acl.reset.weblogic.jdbc.connectionPool.examplesPool=wlcSamplesUser,admin,guest
acl.reset.weblogic.jdbc.connectionPool.wliPool=wlcSamplesUser,wlisystem,admin,¥
guest
acl.reset.weblogic.jdbc.connectionPool.wlpiPool=wlisystem,admin,guest
acl.reset.weblogic.jdbc.connectionPool=system
acl.send.weblogic.jms=everyone
acl.shrink.weblogic.jdbc.connectionPool.examplesPool=everyone
acl.shrink.weblogic.jdbc.connectionPool.wliPool=wlcSamplesUser,wlisystem,¥
admin.guest
acl.shrink.weblogic.jdbc.connectionPool.wlpiPool=wlisystem,admin,guest
acl.shutdown.weblogic.admin=system
acl.unlockServer.weblogic.admin=system
acl.write.managedObject=system
acl.write.weblogic.workspace=system,everyone

group.AccountingCDE=admin,joe
group.AdministerUser=admin,joe,mary,guest,wlisystem
group.Administrators=ConfigureComponents,system
group.ConfigureComponents=admin,joe,wlisystem,mary,guest
group.ConfigureSystem=admin,joe,mary,guest,wlisystem
group.CreateTemplate=admin,joe,wlisystem,mary,guest
group.CustomerServiceCDE=admin
group.DeleteTemplate=admin,joe,wlisystem,mary,guest
group.Deployers=Administrators
group.ExecuteTemplate=admin,joe,wlisystem,mary,guest
group.MonitorInstance=admin,joe,wlisystem,mary,guest
group.Monitors=Administrators
group.Operators=Administrators
group.Role1Org1=admin,joe,mary
group.Role1Org2=admin,joe,mary
group.Role2Org1=admin,joe,mary
group.Role2Org2=admin,joe,mary
group.ShippingCDE=admin,mary
group.UpdateTemplate=admin,joe,mary,guest,wlisystem
group.adapter=admin,wlcSamplesUser,joe,hub,system,mary,guest,wlisystem
group.adminGroup=admin,joe,mary
group.wlcSamplesGroup=wlcSamplesUser,guest,wlisystem

group.wlpiAdministrators=admin,wlcSamplesUser,joe,wlisystem,system,mary,guest
group.wlpiUsers=admin,joe,wlisystem,system,mary,guest

user.admin=0xab3a488db0652704287970cdf97854812feea77b
user.hub=0x6e4b0d35e609e96e749330f5086bb21f08a013d5
user.joe=0xa078cb45e6f6c4eefdd1f14495ff739b5536904c
user.mary=0xa078cb45e6f6c4eefdd1f14495ff739b5536904c
user.system=0xab3a488db0652704287970cdf97854812feea77b
user.wlcSamplesUser=0x010e807f5525398753170a0fd0cf8694241286bc
user.wlisystem=0x8510e22f04b4a7ebde6837902aa590a31e234be2