ヘッダーをスキップ
Oracle® Fusion Middleware Oracle Business Intelligence Discoverer構成ガイド
11g リリース1 (11.1.1)
E51909-01
  目次へ移動
目次
索引へ移動
索引

前
 
次
 

A Oracle BI Discovererの構成ファイル

この付録では、Discovererの構成ファイルに関する参照情報について説明します。この付録の内容は次のとおりです。

A.1 Discovererファイルの場所

この項では、Oracle BI Discovererの構成に使用するファイルの場所のリストを示します。

構成ファイル内の設定の多くは、Fusion Middleware Controlを使用して構成します。可能なかぎり、Fusion Middleware Controlを使用してDiscovererを構成してください。手動による構成ファイルの設定の更新は、このマニュアル内の指示に従う場合のみ行うようにしてください。

表A-1に、UNIXでのDiscoverer構成ファイルの場所を示します。Windowsの場合は、パス内のスラッシュ(/)をバックスラッシュ(\)に置き換えてください。

表A-1 Discovererファイルの場所

ファイル名 説明および場所

applypreferences.sh/.bat

このファイルは、Discovererプリファレンス・コンポーネントを更新します(Windows固有)。

場所: ORACLE_INSTANCE/Discoverer/Discoverer_instance-name/util/

注意: 処理中のエラーに関する情報は、error.txtに格納されます。

checkdiscoverer.sh/.bat

このファイルは、Discoverer中間層の構成をチェックするユーティリティを起動して、中間層コンポーネントの状態をチェックし、障害または異常をレポートします。

場所: ORACLE_INSTANCE/Discoverer/Discoverer_instance-name/util/

注意: \utilディレクトリには、checkdiscovererユーティリティに関するドキュメントがあります。

collectlogs.sh/.bat

このスクリプトは、すべてのDiscovererログを1つのフォルダに収集します。

場所: ORACLE_INSTANCE/Discoverer/Discoverer_instance-name/util/

注意: collectlogsスクリプトの使用の詳細は、第11.5項「Discovererログ・ファイルのコピー方法」を参照してください。

configuration.xml

このファイルには、Discovererの構成設定が格納されています。

場所: DOMAIN_HOME/config/fmwconfig/servers/WLS_DISCO/applications/discoverer_discoverer_version/configuration/

注意: このファイルは手動で編集しないでください。詳細は、付録A「configuration.xml内の構成設定」を参照してください。

convertreg.pl

このスクリプトは、reg_key.dcファイルを変換して整数値の形式を変更します(たとえば、BigEndian形式からLittleEndian形式への変更)。このスクリプトは、あるプラットフォームから別のプラットフォーム(たとえば、WindowsからSolaris)にDiscovererインストールを移行するために使用します。

場所: ORACLE_HOME/perl/bin/

詳細は、第9.8項「Discovererプリファレンスの移行について」を参照してください。

defaults.txt

このファイルには、出荷時のデフォルトのDiscovererプリファレンスが格納されています。pref.txtが破損した場合、defaults.txtを使用してデフォルトのプリファレンスを復元できます。

場所: ORACLE_INSTANCE/config/PreferenceServer/Discoverer_instance-name/

dis51pr.exe/dis51pr

このファイルは、reg_key.dcファイルに格納されているプリファレンスを管理するコマンドライン・ユーティリティを実行します。

場所: ORACLE_HOME/bin/

discenv.sh

このスクリプト・ファイルは、その他のDiscovererスクリプトで使用される環境変数を設定します。

場所: ORACLE_INSTANCE/Discoverer/Discoverer_instance-name/util/

error.txt

このファイルには、applypreferencesスクリプトを使用してDiscovererプリファレンス・コンポーネントを更新するときに収集される処理中のエラーに関する情報が含まれています。error.txtが存在しない場合、エラーは記録されていません。

場所: ORACLE_INSTANCE/config/PreferenceServer/Discoverer_instance-name/

httpd.conf

このファイルには、Oracle BI Discovererで使用されるWebサーバーに関する構成情報(Webサーバーのタイムアウト設定Timeoutなど)が含まれます。

場所: ORACLE_INSTANCE/config/OHSComponent/ohs-comp-name/

mod_osso.conf

このファイルには、Oracleシングル・サインオンの構成設定(Oracleシングル・サインオンを有効および無効に切り替える設定など)が格納されています。

場所: ORACLE_INSTANCE/config/OHSComponent/ohs-comp-name/moduleconf/

シングル・サインオンを有効にする方法の詳細は、第13.8.1.2項「Discovererに対しシングル・サインオンを有効および無効にする方法」を参照してください。

opmn.xml

このファイルには、DiscovererのOPMN構成設定(サーバーのタイムアウト、Discovererセッションの最大数など)が格納されています。

場所: ORACLE_INSTANCE/config/OPMN/opmn-component-name/

opmnctl.sh/.bat

このスクリプト・ファイルは、OPMN処理の管理に使用されます。

場所: ORACLE_INSTANCE/bin/

注意: このスクリプトのオンライン・ヘルプを表示するには、「opmnctl help」と入力します。

pref.txt

このファイルにはDiscoverer中間層のプリファレンスが格納されており、reg_key.dcファイルを生成するために使用されます。インストール時に、defaults.txtファイルの設定が、このファイルに移入されます。pref.txtが破損した場合は、defaults.txtのプリファレンスをpref.txtにコピーすると、デフォルトのプリファレンスを復元できます。

場所: ORACLE_INSTANCE/config/PreferenceServer/Discoverer_instance-name/

注意: このファイルは手動で編集しないでください。詳細は、Oracleサポートに連絡してください。pref.txtファイルを手動で編集する場合は、プリファレンスの変更を適用するためにapplypreferencesスクリプトを実行してから、Discovererプリファレンス・サーバー・コンポーネント停止して再起動する必要があります。詳細は、第4.3項「opmnctlを使用してDiscovererプリファレンス・サーバー・コンポーネントを起動、停止および再起動する方法」を参照してください。

reg_key.dc

このファイルには、ユーザーごとのプリファレンスが、データベースとユーザーIDの一意の組合せとして格納されています。これらの値は、pref.txtで指定されているグローバルなデフォルト値よりも優先されます。

注意: このファイルは手動で編集しないでください。詳細は、Oracleサポートに連絡してください。詳細は、第A.2項「configuration.xml内の構成設定」を参照してください。reg_key.dcは非表示ファイルです。つまり、ファイル名の先頭にはピリオド(.)が付きます。ファイル管理プログラムまたはコマンド・コンソールで非表示ファイルを表示するようにしてください(たとえば、UNIXでは、コンソール・コマンドls -alを使用して非表示ファイルを表示します)。

場所: ORACLE_INSTANCE/config/PreferenceServer/Discoverer_instance-name/

tnsnames.ora

このファイルには、Oracle BI Discovererを使用してアクセスできるすべてのデータベースの名前および別名が含まれています。

場所: ORACLE_INSTANCE/config/

web.xml

このファイルには、Discovererサーブレットのデプロイメント情報が含まれています。

場所: DOMAIN_HOME/servers/WLS_DISCO/tmp/_WL_user/discoverer_discoverer_version/random-directory-name/war/WEB-INF/

注意: このファイルは手動で編集しないでください。


A.2 configuration.xml内の構成設定

configuration.xmlファイルには、Discovererの構成設定が格納されています。表A-2に、configuration.xmlファイルで定義する設定を示します。

注意: このマニュアル内の指示に従っている場合を除き、このファイルを手動で編集しないでください。通常、このファイル内の設定値はFusion Middleware Controlのページを使用して構成します。

Discoverer Portlet Providerの設定を変更するには、Oracle Fusion Middleware Controlの「Discoverer Portlet Provider構成」ページを使用します。詳細は、第4.6.1項「Discovererクライアント層コンポーネントを構成する方法」を参照してください。

表A-2 構成設定

設定 説明

enableAppsSSOConnection

SSO対応のOracle Applicationsデータベースを使用する認証済のOracleシングル・サインオン・ユーザーが、パスワードを入力することなくDiscovererプライベート接続を作成および使用できるようにするかどうかを指定します(詳細は、第14.2.2項「Oracle Applicationsユーザーが、SSO対応Oracle Applicationsデータベースへのプライベート接続を作成または使用できるようにする方法」を参照)。

注意: Oracle Fusion Middleware Controlの「Discoverer管理」ページにある「認証されたOracleシングル・サインオン(SSO)ユーザーがSSO対応Oracle Applicationsデータベースへのプライベート接続を、パスワードを入力せずに作成および使用できるようにします」チェック・ボックスを使用して値を設定します。

/disco:configuration/viewer/pageNavigation

Discoverer Viewerにページ・ナビゲーション・ツールを表示するかどうかを指定します。有効な値は次のとおりです。

  • TRUE

    この設定値がTRUEに設定されている場合は、ページ・ナビゲーション・ツールがワークシートに表示されます。

    ページ・ナビゲーション・ツールが表示されている場合は、問合せ結果が非増分的に(すべてまとめて)返されます。そのため、初めて、大量のデータ・セットが表示されるときに性能が低下する可能性があります。

  • FALSE

    この設定値がFALSEに設定されている場合は、ページ・ナビゲーション・ツールがワークシートに表示されません。

    ページ・ナビゲーション・ツールが表示されていない場合は、問合せ結果が増分的に(チャンクで)返されます。そのため、大量のデータ・セットが表示される場合でも性能が低下しません。

注意: この値は、Oracle Fusion Middleware ControlのMBeanブラウザを使用して設定します。

GraphAxisAutoScaledFromZero

Discoverer Viewer (マルチディメンション・データ・ソースとともに使用される場合のみ)で、0 (ゼロ)からスケールが始まるグラフを表示するのか、ワークシート・データに基づく値からスケールが始まるグラフを表示するのかを指定します。有効な値は次のとおりです。

  • TRUE

    この設定値がTRUEの場合は、Discoverer Viewerのグラフの軸はすべて0 (ゼロ)からスケールが開始されます。この設定のデフォルト値はTRUEです。

  • FALSE

    この設定値がFALSEの場合は、Discoverer Viewerのグラフの軸は、ワークシートのデータに基づいてスケールが開始されます。

注意: この値は、Oracle Fusion Middleware ControlのSystem MBeanブラウザを使用して設定します。

EnableLevelOffsetBasedTimeCalc

Discoverer Plus OLAPユーザーに提示する計算テンプレートを指定します。デフォルトでは、この設定はTRUEです。そのため、計算の作成時または計算の編集時には、リリース11.1.1で新しくなったレベル・オフセット・ベースのテンプレートがユーザーに表示されます。リリース10.1.2からのカレンダ・ベースのテンプレートを使用して作成された計算を編集するときには、そのテンプレートが表示されます。時間階層がグレゴリオ暦に基づいてモデル化されている場合は、リリース10.1.2テンプレートを使用するようにデフォルトを変更することができます。

この設定を<enablePlus>タグの直後の<plus>タグに追加します。

ExcludeDuplicateRowsDuringExcelExport

Discoverer Plus OLAPからMicrosoft Excelにワークシートをエクスポートするときに、重複行にフィルタを適用するかどうかを指定します。有効な値は次のとおりです。

  • TRUE

    Microsoft Excelレポートに、重複行は表示されません。

  • FALSE

    Microsoft Excelレポートに、重複行が表示されます。

ExcludeDuplicateColumnsDuringExcelExport

Discoverer Plus OLAPからMicrosoft Excelにワークシートをエクスポートするときに、重複列にフィルタを適用するかどうかを指定します。有効な値は次のとおりです。

  • TRUE

    Microsoft Excelレポートに、重複列は表示されません。

  • FALSE

    Microsoft Excelレポートに、重複列は表示されません。

SortMemberStepHierarchically

Discoverer Plus OLAPにおいて、メンバー・ステップが階層的にソートされるかどうかを指定します。このオプションが無効の場合、メンバーは階層順ではなく、追加された順でソートされます。有効な値は次のとおりです。

  • DEFAULT

    常に階層順にメンバーをソートします。「メンバー・ステップの編集」ダイアログに「階層順にメンバーをソート」チェック・ボックスは表示されません。

  • YES

    メンバーを階層順にソートします。「メンバー・ステップの編集」ダイアログに「階層順にメンバーをソート」チェック・ボックスが表示され、デフォルトではこれが選択されています。階層順を使用しない場合は、ユーザーがこのボックスの選択を解除できます。

    Discoverer Plus OLAPの最初のインストール時には、YESがこのパラメータのデフォルト値となっています。

  • NO

    メンバーを選択順にソートします。「メンバー・ステップの編集」ダイアログに「階層順にメンバーをソート」チェック・ボックスが表示され、デフォルトではこの選択は解除されています。階層順を使用する場合は、ユーザーがこのボックスを選択できます。

この設定を<enablePlus>タグの直後の<plus>タグに追加します。

SwitchWorksheetBehaviour

エンド・ユーザーが現在のワークシートに変更を加えているときに、別のワークシートを開いた場合のDiscoverer Viewerの動作を指定します。有効な値は次のとおりです。

  • always_save

    ワークブック内でワークシートを切り替えると、ワークシートへの変更が保存されます(ワークブック全体が保存されます)。このとき、エンド・ユーザーに確認を求めるプロンプトは表示されません。

  • never_save

    ワークブック内でワークシートを切り替えると、ワークシートへの変更が破棄されます。このとき、エンド・ユーザーに確認を求めるプロンプトは表示されません。

  • prompt

    ワークブック内でワークシートを切り替えると、ワークシートへの変更を保存するか、取り消すか、破棄するかを選択するように求めるプロンプトがユーザーに表示されます。

注意: この設定がファイル内に存在しない場合、Discovererのデフォルトは'prompt'になります。

worksheetSaveBehavior

ユーザーがワークシートに変更を加えた後で、ワークシートから別の場所に移動したときのDiscoverer Viewerの保存動作を指定します。このパラメータは、ワークシート間の切替え時には影響しません。この設定は、configuration.xmlファイルの<viewer>セクションで行います。有効な値は次のとおりです。

  • always_save

    ワークシートから移動すると、そのワークシートへの変更が保存されます。このとき、エンド・ユーザーに確認を求めるプロンプトは表示されません。

  • never_save

    ワークシートから移動すると、そのワークシートへの変更が破棄されます。このとき、エンド・ユーザーに確認を求めるプロンプトは表示されません。

  • prompt

    ワークシートから移動すると、ワークシートへの変更を保存するか、取り消すか、破棄するかを選択するように求めるプロンプトがユーザーに表示されます。

注意: この設定がファイル内に存在しない場合、Discovererのデフォルトは'prompt'になります。

propagateGUIDToVPD

GUIDまたはOracleシングル・サインオン・ユーザー名のどちらを仮想プライベート・データベース(VPD)ポリシーに渡すかを指定します。有効な値は次のとおりです。

  • TRUE

    この設定値がTRUEに設定されている場合は、GUIDがVPDポリシーに渡されます。

  • FALSE

    この設定値がFALSEに設定されている場合は、SSOユーザー名がVPDポリシーに渡されます。

注意: 値の設定には、Oracle Fusion Middleware Controlの「Discoverer管理」ページにある「ユーザーID」フィールドを使用します。

pickerCompatibleVersions

日付ピッカーまたはカラー・ピッカーがPortalで利用できるかどうかを指定します。これらのピッカーを異なるバージョンのPortalで利用できるようにするには、このパラメータを各Portalのバージョンに合せて変更する必要があります。

たとえば、10.1.4のPortalに日付ピッカーまたはカラー・ピッカーを表示するには、pickerCompatibleVersionsの値を"10.1.4"に変更します。

isCurrentPageItemsExportForOLAP

Microsoft ExcelまたはHTMLへのエクスポート時に、Discoverer Viewerでページ・アイテムを含むOLAPデータのワークシートをエクスポートする方法を指定します。有効な値は次のとおりです。

  • TRUE

    現在のページ・アイテムのセットを使用して、OLAPデータのワークシートをMicrosoft ExcelまたはHTMLにエクスポートします。

  • FALSE

    ページ・アイテムの可能なすべての組合せをMicrosoft ExcelまたはHTMLにエクスポートします。

このオプション設定は、configuration.xmlファイルの<viewer>セクションにあり、デフォルト値がFALSEに設定されています。

cacheThreshold

インフラストラクチャ・データベースに維持するキャッシュ・エントリの数を指定し、ユーザーがパラメータ値を変更したときのポートレット・データの表示を向上します。この値は、configuration.xmlファイルの<portlet>セクションで設定できます。

この設定のデフォルト値は"1"です。この場合、Discoverer Portlet Providerは、現在の値の組合せに対する結果に加え、直前のキャッシュ・エントリのみを維持します。

注意: cacheThresholdに1より大きい値を設定すると、インフラストラクチャ・データベースで使用される領域が大きくなり、各ポートレットのリフレッシュに必要な時間が長くなります。たとえば、cacheThreshold="15"の場合、リフレッシュ時に、ポートレットの問合せが15回実行され、結果の保存に必要なDBの領域が15倍大きくなる可能性があります。cacheThresholdは慎重に設定して、ポートレットのリフレッシュが適切な時間内に完了するようにしてください。

viewerURLForPublicUser

パブリック・ポータル・ページの「分析」リンクをクリックしたときの動作を指定します。この設定の値に"normalViewer"を指定すると、「分析」リンクのクリックによりDiscoverer Viewerに移動します。この設定は、configuration.xmlファイルの<portlet>セクションで定義します。

ユーザーがポータルまたはSSOにログインすると、configuration.xmlファイルの設定に関係なく、常に、「分析」リンクでSingle Worksheet Viewerが開きます。

enableDataSelection

Discoverer Viewerで表内のデータを選択して、そのデータをHTMLページとしてクリップボードにコピーできるようにするかどうかを指定します。有効な値は次のとおりです。

  • TRUE

    表内の列選択を有効にして、クリップボードにコピーするためのデータ選択を無効にします。

  • FALSE

    表内の列選択を無効にして、データを選択してクリップボードにコピーできるようにします。

このオプション設定は、configuration.xmlファイルの<viewer>セクションにあり、デフォルト値がTRUEに設定されています。

numberOfLOVsToBeDisplayed

パラメータ検索ダイアログのリスト・ボックスに表示する値の数を指定します。

このオプション設定は、configuration.xmlファイルの<viewer>セクションにあります。この設定のデフォルト値は25です。

numColsForLOW

「ワークシートのリスト」ポートレットがSingle Worksheet Viewerで開かれたときに、そのポートレットに表示する列の数を指定します。

このオプション設定は、configuration.xmlファイルの<portlet>セクションにあります。デフォルト値は6です。この設定の値に'0'を指定すると、ワークシートのすべての列が表示されます。

numRowsForLOW

「ワークシートのリスト」ポートレットがSingle Worksheet Viewerで開かれたときに、そのポートレットに表示する行の数を指定します。

このオプション設定は、configuration.xmlファイルの<portlet>セクションにあります。デフォルト値は25です。この設定の値に'0'を指定すると、ワークシートのすべての行が表示されます。

peekSleepIntervalSec

リフレッシュするスケジュール済ポートレットを取得するためのスリープ間隔を指定します。このパラメータのデフォルト値は2秒です。

注意: 複数の中間層が存在する場合、スケジュール済ポートレットのロード・バランシングのために、このパラメータには各中間層に異なる値を設定してください。これにより、スケジュール済のリフレッシュは各中間層に均等に分散されるようになります。


A.3 opmn.xml内の構成設定

opmn.xmlファイルには、DiscovererのOPMN設定が格納されています。表A-3に、opmn.xmlの設定を示します。デフォルトのDiscoverer構成を変更する必要がある場合に、この設定を変更します。

表A-3 opmn.xml内の構成設定

設定 説明

FND_SECURE

保護モードでOracle Applicationsデータベースに接続する際にDiscovererで使用されるDBCファイルが格納されたディレクトリを指定します。

Discovererは、まず、ファイル名がデータベース名.dbcのDBCファイルを検索します。見つからない場合は、ファイル名がホスト名_SID.dbcのファイルの使用が試行されます。

この値が設定されていない場合、DiscovererではFND_TOPで指定された値の使用が試みられます。

FND_TOP

保護モードでOracle Applicationsデータベースに接続する際にDiscovererで使用されるDBCファイルが格納された、保護ディレクトリのパス($<FND_TOP>/secure)を指定します。

この変数は下位互換性のために含まれています。最初にDiscovererでは、FND_SECUREで指定された値の使用が試みられます。

ORBDebug

DiscovererからORBに対し、サーバー・コンフィギュレータ・ネットワークからのデバッグ・メッセージを出力するように指示するかどうかを指定します。このオプションには値を設定しませんが、デバッグ・メッセージの有効/無効の切替えに使用します。

ORBDebugLevel=<level>

ORBのデバッグ・レベルを指定します。1 (最小量のデバッグ情報)から10 (最大量のデバッグ情報)までの範囲です。

ORBLogFile=<name of log file>

ACE_DEBUGおよびACE_ERRORのすべてのメッセージが、指定されたファイルにリダイレクトされるように指定します。パスを指定しない場合、ファイルは、サーバーが実行されているディレクトリ($ORACLE_HOMEなど)に作成されます。

ORBObjRefStyle=[IOE|URL]

ユーザーに表示されるオブジェクト参照のスタイルを指定します。IORスタイル(デフォルト)は従来のCORBAオブジェクト参照ですが、URLスタイルはURLに似ています。

ORBVerboseLogginglevel=[0|1|2]

デバッグ・ログの各行に出力するステータスのデータ量を指定します。大きい値を指定すると生成される出力量が増えます。


注意: ORB要素は、デフォルトでは組み込まれていません。TAOのORBをカスタマイズする場合は、ORB要素および表A-2で説明した属性を追加します。詳細は、TAOのドキュメントを参照してください。