Oracle® Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suiteインストレーション・ガイド 11g リリース1(11.1.1.7.0) B55901-05 |
|
![]() 前 |
![]() 次 |
この付録では、Oracle SOA Suiteのインストール時に発生する可能性のある一般的な問題の解決策を説明します。構成は次のとおりです。
インストール時にエラーが発生した場合、次の手順を実行してください。
最新の更新については、『Oracle Fusion Middlewareリリース・ノート』を参照してください。リリース・ノートの最新バージョンは、Oracle Technology Network (http://www.oracle.com/technology/documentation
)で入手できます。
システムおよび構成が動作保証されていることを確認します。Fusion Middlewareの動作保証情報のドキュメントを参照してください。
http://www.oracle.com/technology/software/products/ias/files/fusion_certification.html
システムが最小システム要件を満たしていることを確認します。システム要件と仕様のドキュメントを参照してください。
http://www.oracle.com/technology/software/products/ias/files/fusion_requirements.htm
いずれかのインストール画面で誤った情報を入力した場合、「戻る」をクリックしてその画面まで戻ります。
インストーラによるファイルのコピーまたはリンク中にエラーが発生した場合は、次の手順を実行してください。
エラーを記録し、インストール・ログ・ファイルを確認します。
第4章「Oracle SOA SuiteおよびOracle Business Process Management Suiteのアンインストール」の手順に従い、障害の発生したインストールを削除します。
エラーの原因となった問題を修正します。
インストールを再開します。
この項には、Oracle SOA SuiteインストーラおよびOracle Fusion Middleware構成ウィザードの実行時に作成されるログ・ファイルの情報が含まれます。ログ・ファイルに含まれる情報は、インストールまたは構成での問題を解決するのに役立ちます。
インストーラによって、Oracle_Inventory_Location
/log
ディレクトリ(UNIXオペレーティング・システムの場合)またはOracle_Inventory_Location
\logs
ディレクトリ(Windowsオペレーティング・システムの場合)にログ・ファイルが書き込まれます。UNIXオペレーティング・システムでは、Oracle Inventoryディレクトリの場所が不明な場合は、次のディレクトリ(デフォルトの場所)に格納されているoraInst.loc
ファイルでその場所を検索できます。
Linuxの場合: /etc/oraInst.loc
HP-UXおよびSolarisの場合: /var/opt/oracle/oraInst.loc
Windowsオペレーティング・システムの場合、インベントリ・ディレクトリの場所はC:\Program Files\Oracle\Inventory\logs
です。64ビットWindowsマシンで32ビットのインストーラを使用する場合、インベントリ・ディレクトリの場所はC:\Program Files (x86)\Oracle\Inventory\logs
です。
次のインストール・ログ・ファイルがログ・ディレクトリに書き込まれます。
install
date-time-stamp
.log
これはメインのログ・ファイルです。
install
date-time-stamp
.out
このログ・ファイルには、インストール時の出力およびエラー・ストリームが含まれます。
installActions
date-time-stamp
.log
このファイルは、インストーラGUIによって内部情報の追跡に使用されます。
installProfile
date-time-stamp
.log
このログ・ファイルには、構成、メモリーおよびCPUの詳細だけでなく、インストール完了までの時間など、全体的な統計が含まれます。
oraInstall
date-time-stamp
.log
このログ・ファイルには、コピー・セッションの出力ストリームが含まれます。
-printtime
パラメータを指定してインストーラを実行した場合は、同じディレクトリにtimeTaken
date-time-stamp
.log
およびtime
date-time-stamp
.log
ファイルが作成されます。
timeTaken
date-time-stamp
.log
このファイルには、画面間の移動にかかる時間に関する情報が含まれます(GUIインストールにのみ該当)。
time
date-time-stamp
.log
このファイルには、コピー・セッションの時間情報が含まれます。
-printmemory
パラメータを指定してインストーラを実行した場合は、memory
date-time-stamp
.log
ファイルが作成されます。このファイルには、コピー・セッションのメモリー使用情報が含まれます。
構成セッションのログ・ファイルを作成するには、次のように-log
オプションを指定して構成ウィザードを実行します。
UNIXオペレーティング・システムの場合
./config.sh -log=log_filename -log_priority=log_level
Windowsオペレーティング・システムの場合
config.cmd -log=log_filename -log_priority=log_level
-log
および-log_priority
オプションの詳細は、表D-1を参照してください。
表D-1 構成ウィザードのログ・ファイル・オプション
パラメータ | 説明 |
---|---|
|
ログ・ファイルの場所を指定します。
|
|
ログの内容の詳細レベルを指定します。 次に、許容値を詳細度の高い順に示します。
|
インストーラで使用されるJREの場所は、SOA_ORACLE_HOME
/oui/oraparam.ini
ファイル(UNIXオペレーティング・システムの場合)またはSOA_ORACLE_HOME
\oui\oraparam.ini
ファイル(Windowsオペレーティング・システムの場合)に保存されます。このファイルは、OPatchおよびOracle Universal Installer (OUI)で優先JREの場所の判別に使用されます。
JREの場所を変更できます(たとえば、JREディレクトリをMiddlewareホームの外に移動します)。この場合、OPatchまたはOUIを実行しようとすると、JREの場所が見つからないためエラー・メッセージが表示されます。この場合は、次のいずれかを実行できます。
SOA_ORACLE_HOME
/oui/oraparam.ini
ファイル(UNIXオペレーティング・システムの場合)またはSOA_ORACLE_HOME
\oui\oraparam.ini
ファイル(Windowsオペレーティング・システムの場合)を編集し、JREの新しい場所を指し示すようにします。
-jreLoc
コマンドライン・オプションを使用して、JREの新しい場所を指し示すようにします。詳細は、第2.2.2項「インストーラの実行」を参照してください。
カスタムの信頼キー・ストアを使用するようにOracle WebLogic Serverを構成した場合は、setDomainEnv.cmd
ファイル(Windowsオペレーティング・システムの場合)またはsetDomainEnv.sh
ファイル(UNIXオペレーティング・システムの場合)を手動で編集し、Djavax.net.ssl.trustStore
パラメータがカスタムの信頼キー・ストア・ファイルを指し示すようにする必要があります。次に例を示します。
Djavax.net.ssl.trustStore=/myfolder/mystore/mytrustkeystore.jks
SSLが有効のデータベースを使用する場合は、次の手順に従って、データ・ソースがSSL接続に対応するようにする必要があります。
信頼ストアを作成し、keytoolを使用して、./root/b64certificate.txt
を信頼できる証明書として信頼ストアに追加します。
keytool -importcert -trustcacerts -alias dbroot -keystore ./truststore -storepass welcome1 -file ./b64certificate.txt
WebLogic Serverコンソールで、使用するデータ・ソースの「接続プール」タブに移動します。次のプロパティを適宜変更します。
認証が必要:
javax.net.ssl.keyStore=keystore_password javax.net.ssl.keyStoreType=JKS javax.net.ssl.keyStorePassword=keystore_password javax.net.ssl.trustStore=truststore_location javax.net.ssl.trustStoreType=JKS javax.net.ssl.trustStorePassword=truststore_password
認証が不要:
javax.net.ssl.trustStore=truststore_location javax.net.ssl.trustStoreType=JKS javax.net.ssl.trustStorePassword=truststore_password
URLフィールドに次のように入力します。
jdbc:oracle:thin:@( DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCPS)(HOST=database_host)(PORT=database_port))) (CONNECT_DATA=(SERVICE_NAME=service_name)) (SECURITY=(SSL_SERVER_CERT_DN="distinguished_name")) )
JDBCデータ・ソース・ファイルで、<property>
パラメータを次のように変更します。
<property>
<name>javax.net.ssl.trustStorePassword</name>
<value>truststore_password</value>
</property>
Oracle Identity Managementをインストールしてドメインを作成し、Oracle SOA Suiteをインストールしてそのドメインを拡張した場合、Oracle SOAインストーラによりORACLE_HOME
環境変数が変更されます。これにより、Oracle Identity Federation (OIF) WebLogic Scripting Tool (WLST)環境が壊れてしまいます。この環境は、Identity Managementのインストールで設定されたORACLE_HOME
の値に依存しています。
この問題を回避するには、次の手順を実行します。
Oracle Fusion Middleware Oracle Identity Federation管理者ガイドのWLST環境の設定に関する項 の手順に従ってください。
OIF_ORACLE_HOME
/fed/script
ディレクトリ(UNIXオペレーティング・システムの場合)またはOIF_ORACLE_HOME
\fed\script
ディレクトリ(Windowsオペレーティング・システムの場合)にあるすべての.py
ファイルを、WebLogic_Home
/common/wlst
ディレクトリ(UNIXオペレーティング・システムの場合)またはWebLogic_Home
\common\wlst
ディレクトリ(Windowsオペレーティング・システムの場合)にコピーします。
OIF_ORACLE_HOME
/fed/script
ディレクトリ(UNIXオペレーティング・システムの場合)またはOIF_ORACLE_HOME
\fed\script
ディレクトリ(Windowsオペレーティング・システムの場合)を、システムのCLASSPATH
環境変数に追加します。
ドメイン作成時にSOAインフラストラクチャ接続をテストして、SOAインフラストラクチャを正常に起動するには、Microsoft SQL ServerデータベースおよびMicrosoftオペレーティング・システムの両方でXAサポートを構成する必要があります。
Oracle WebLogic Serverをインストールします。
Microsoft SQL Server JDBC XAプロシージャをインストールします。これらのプロシージャでは、JTAによるJDBC分散トランザクションを使用できます。このプロシージャは、MS SQL Serverのインストールごとに繰り返して分散トランザクションに含める必要があります。
プラットフォームに適した.dll
ファイルおよびinstjdbc.sql
ファイルを、WebLogic_Home
\server\bin
ディレクトリからSQL Serverのバージョンに適したディレクトリにコピーします。
注意: XAサポートをすでに構成してあり、最新のOracle SOA Suiteパッチ・セットを適用済の環境がある場合、最新のWebLogic Serverホーム・ディレクトリから |
データベース | コピーするファイル... | コピー先のディレクトリ... |
---|---|---|
SQL Server 2005 |
|
C:\Program Files\Microsoft SQL Server\MSSQL.1\MSSQL\Binn |
SQL Server 2008 |
|
C:\Program Files\Microsoft SQL
Server\MSSQL10.INSTANCE_NAME\MSSQL\Binn
|
注意:
|
データベース・サーバーから、ISQL
ユーティリティを使用して、SQL Serverのバージョンに対応したinstjdbc.sql
スクリプトを実行します。万が一に備えて、instjdbc.sql
を実行する前にマスター・データベースのバックアップを作成します。
Microsoft SQL Server 2005の場合、次のコマンドを実行します。
C:\Program Files\Microsoft SQL Server\90\Tools\Binn\SQLCMD.EXE -S "DB_HOST\INSTANCE_NAME" -U SA -P SA_PASSWORD -i instjdbc.sql -o LOG_FILE
Microsoft SQL Server 2008の場合、次のコマンドを実行します。
C:\program files\Microsoft SQL Server\100\Tools\Binn\SQLCMD.EXE -S "DB_HOST\INSTANCE_NAME" -U SA -P SA_PASSWORD -i instjdbc.sql -o LOG_FILE
どちらのコマンドの場合も、DB_HOST
はSQL Serverがインストールされているホストの名前、INSTANCE_NAME
はSQL Serverインスタンスの名前、SA_PASSWORD
はシステム管理者のパスワードです。
instjdbc.sql
スクリプトにより多くのメッセージが生成されますが、次のようなメッセージは無視しても問題ありません。
Msg 156, Level 15, State 1, Server STANA17-1\SQLSERVER123, Line 1 Incorrect syntax near the keyword 'tran'. Msg 319, Level 15, State 1, Server STANA17-1\SQLSERVER123, Line 1 Incorrect syntax near the keyword 'with'. If this statement is a common table expression, an xmlnamespaces clause or a change tracking context clause, the previous statement must be terminated with a semicolon.
実行エラーを示す可能性のあるメッセージの出力全体を確認する必要があります。最後のメッセージは、instjdbc.sql
が正常に実行されたことを示す必要があります。JDBC XAプロシージャの格納または既存のプロシージャに対する変更の記録を行うために十分な領域がマスター・データベースにない場合、スクリプトが失敗します。
Microsoftオペレーティング・システム用にMicrosoft分散トランザクション・コーディネータ(DTC)を構成します。
「スタート」メニューから、「コントロール パネル」→「管理ツール」→「コンポーネント サービス」アイコン→「コンポーネント サービス」(「コンソール ルート」の下のナビゲータ内)→「コンピュータ」→「マイ コンピュータ」を選択します。
「マイ コンピュータ」を右クリックし、「プロパティ」→「MSDTC」→「セキュリティの構成...」を選択します。
「セキュリティの構成」ダイアログが表示されます。
「セキュリティ設定」セクションで、「ネットワーク DTC アクセス」チェック・ボックスを選択します。
「クライアントおよび管理」セクションで、「リモート クライアントを許可する」チェック・ボックスを選択します。
「トランザクション マネージャ通信」セクションで、「受信を許可する」、「送信を許可する」、「認証を必要としない」および「トランザクション インターネット プロトコル (TIP) を有効にする」チェック・ボックスを選択します。
「セキュリティ設定」セクションで、「XA トランザクションを有効にする」チェック・ボックスを選択します。
「セキュリティの構成」ダイアログで「OK」をクリックします。
「マイ コンピュータのプロパティ」ダイアログで「OK」をクリックします。
Microsoft SQL Serverを再起動します。
Microsoft SQL Serverデータベースを再起動しないと、XAドライバはドメイン構成中に正常に接続しません。
この付録で問題が解決されない場合は、My Oracle Support (以前のOracleMetaLink)で解決策を検索してみてください。
https://support.oracle.com/
Oracle SOA Suiteのトラブルシューティングに関する追加情報については、Note 1292813.1「Troubleshooting SOA Suite 11gR1 Installation for Versions 11.1.1.0 and higher」を参照してください。
問題の解決策が見つからない場合は、サービス・リクエストをオープンしてください。