B 拡張構成リファレンス

この付録では、分析、エージェント、ダッシュボードまたはOracle BIプレゼンテーション・カタログに固有でない、高度なインストール後の構成および管理手順について説明します。これらのOracle Business Intelligenceの各コンポーネントの構成方法は、前の各章で説明されています。ほとんどの管理者は、この付録で説明されている構成設定を変更する必要はありません。

この付録の内容は次のとおりです。

プレゼンテーション・サービスに対する拡張構成の変更

Oracle BIサーバーのプロセスは、ほとんどのWebサーバーのビジネス・ロジックをホストし、ビジネス・インテリジェンス・データをWebクライアントに提示するためのフレームワークとインタフェースを提供します。

Windowsの場合、プロセスはsawserver.exeです。
UNIXの場合、プロセスはsawserverです。

instanceconfig.xmlファイルには、Oracle BIサーバーに影響を与える構成の設定が格納されています。多くの構成の設定はFusion Middleware Controlで使用でき、構成を変更するための優先方法です。特定の設定がFusion Middleware Controlで使用できない場合、instanceconfig.xmlファイルを使用してその設定を変更できます。instanceconfig.xmlファイルを使用して、デプロイメントを様々な面からカスタマイズできます。このファイルで直接変更するのは、Oracle BIプレゼンテーション・カタログの名前などのデフォルト要素を変更する場合、またはキャッシュ関連設定などの内部デフォルト設定をオーバーライドする場合のみです。

instanceconfig.xmlファイルには、Oracle BIプレゼンテーション・カタログへのパスや、Oracle BIサーバーにアクセスするためにプレゼンテーション・サービスによって使用されるOracle Business Intelligenceサーバーのデータソース名など、いくつかのエントリがデフォルトで含まれています。

注意:

以前にWindowsレジストリを変更して構成を変更したことがある場合は、その変更をinstanceconfig.xmlに移行します。WindowsレジストリのCommonキーの下にあるエントリは有効なままです。

次の手順は、ユーザーが実行できる一般的な構成の変更に関する情報を示しています。

次のinstanceconfig.xmlファイルを開いて編集します。

BI_DOMAIN/config/fmwconfig/biconfig/OBIPS
次の表で説明している要素を追加する必要があるセクションを見つけます。

次の例に示すように、必要な要素とその祖先要素を追加します。

<ServerInstance>
  <ClientStorage>
    <Enabled>true</Enabled>
    <LocalStorage>true</LocalStorage>
    <SessionStorage>true</SessionStorage>
  </ClientStorage>
 <Catalog>
  <ServiceInstanceQuota>
   <Enabled>true</Enabled>
   <SizeLimitMB>8192</SizeLimitMB>
  </ServiceInstanceQuota>
 </Catalog>
  <FavoritesSyncUpIdleSeconds>300</FavoritesSyncUpIdleSeconds>
  <BIClientInstallerURL32Bit>http://myhost:7777/my32bitfile</BIClientInstallerURL32Bit>
  <BIClientInstallerURL64Bit>http://myhost:7777/my64bitfile</BIClientInstallerURL64Bit>
 <Security>
    <AllowRememberPassword>false</AllowRememberPassword>
    <CookieDomain>value</CookieDomain>
    <CookiePath>/analytics</CookiePath>
    <InIFrameRenderingMode>prohibit</InIFrameRenderingMode>
   <Cursors>
      <NewCursorWaitSeconds>3</NewCursorWaitSeconds>
    </Cursors>    
  <LogonExpireMinutes>180</LogonExpireMinutes>
  <EnableSavingContentWithHTML>true</EnableSavingContentWithHTML>
  </Security>   
 <ODBC>
   <UnaccessedRunningTimeoutMinutes>5</UnaccessedRunningTimeoutMinutes>
  </ODBC>   
 <UI>
    <MaxSearchResultItemsToReturn>300</MaxSearchResultItemsToReturn> 
  <UserPickerDialogMaxAccounts>300</UserPickerDialogMaxAccounts>
 </UI>
</ServerInstance>

変更内容を保存し、ファイルを閉じます。
Oracle Business Intelligenceを再起動します。

要素	説明	デフォルト値
<ClientStorage>	クライアントの状態をセッション間およびセッション内で保持する親要素を指定します。Enabled、LocalStorageおよびSessionStorageの各要素も参照してください。	デフォルト値なし
<ClientStorage> <Enabled> </ClientStorage>	クライアントの状態を、セッションを横断してまたはそのセッション内で保持するかどうかを指定します。状態がブラウザ・セッションを横断して保持されることはありません。次の項目について状態が保持されます。「ダッシュボード」メニュー - メニューが開いているか、または閉じているかを保持します。フォルダ - 「カタログ」ページおよび「開く」ダイアログでフォルダが開いているかどうかを保持します。「お気に入り」メニュー - 最後に開いたアイテムの名前を格納します。カタログ・ページのツールバー - ツールバーの状態について各種詳細を保持します。「タイプ」、「ソート」および「詳細の表示」などのオプションの設定があります。 LocalStorageおよびSessionStorage要素も参照してください。	true
<ClientStorage> <LocalStorage> </ClientStorage>	ブラウザのローカル・ストレージを使用して状態を保持するかどうかを指定します。ブラウザがローカル・ストレージをサポートしていない場合、状態は保持されません。	true
<ClientStorage> <SessionStorage> </ClientStorage>	ブラウザのローカル・ストレージを使用してセッションの状態を保持するかどうかを指定します。ブラウザがローカル・ストレージをサポートしていない場合、状態は保持されません。	true
<FavoritesSyncUpIdleSeconds>	モバイル・アプリケーションのデータとOracle BIプレゼンテーション・カタログのお気に入りを同期するまでのアイドル時間の秒数を指定します。	300
<BIClientInstallerURL64Bit>	ユーザーがOracle BI EEホーム・ページからOracle BIクライアント・インストーラをダウンロードすることを選択した場合に、Oracle BIクライアント・インストーラのデフォルトのダウンロード場所をオーバーライドすることを指定します。 64-ビット・インストーラのファイル名はbiee_client_install64.exeです。	デフォルト値なし
<Catalog> <ServiceInstanceQuota> </Catalog>	カタログのサイズ制限を指定します。 `「サービス・インスタンスの割当て容量を使い切りました。」`のようなエラーが発生した場合は、デフォルト制限の5GBを超過しています。このパラメータを使用して、サイズ制限を無効にするか、または増やすことができます。サイズ制限のない11gから移行している場合、プレゼンテーション・サーバー・ログに`「サービス・インスタンスのハード割当て容量を使い切りました」`のようなエラー・メッセージが記録されることがあります。サイズ制限を増やすか、このパラメータを無効にした後、My Oracle Support (https://support.oracle.com)のサポート・ノート2079953.1の説明に従って、再度カタログを移行します。	デフォルト値なし
<Catalog> <ServiceInstanceQuota> <Enabled> </ServiceInstanceQuota> </Catalog>	カタログのサイズ制限を有効にすることを指定します。このパラメータをfalseに設定した場合、割当て制限が削除されます。	true
<Catalog> <ServiceInstanceQuota> <SizeLimitMB> </ServiceInstanceQuota> </Catalog>	カタログの新しいサイズ制限をMB単位で指定します。	5000
<Security> <AllowRememberPassword> </Security>	ブラウザ固有のパスワード管理ソフトウェアを使用して、ブラウザでパスワードの保存を許可するかどうかを指定します。trueに設定すると、ユーザーは以降のサインインのためにパスワードを保存するかどうかを指定するよう求められます。	false
<Security> <CookieDomain> </Security>	ブラウザに送信されるCookieのドメイン情報を指定します。	デフォルト値なし
<Security> <CookiePath> </Security>	Cookieが適用されるドメイン・パスを指定します。	/analytics
<Security> <InIFrameRenderingMode> </Security>	詳細は、「Oracle BI EEのページの攻撃からの保護」を参照してください。	sameDomainOnly
<Security> <LogonExpireMinutes> </Security>	非アクティブ・ユーザーが自動的にログオフされるまでの時間(分)を指定します。	180
<Security> <EnableSavingContentWithHTML> </Security>	これをtrueに設定すると、「HTMLマークアップを含みます」オプションが、プレゼンテーション・サービスの複数のダイアログおよびエディタに表示されるようになります。また、EnableSavingContentWithHTMLに関する項の説明に従って、「権限の管理」ページで対応する権限を有効にする必要もあります。	false
<Security> <cursors> <NewCursorWaitSeconds> </cursors> </Security>	ブラウザに検索ページを戻す前に、初期リクエストに対する結果をサーバーが待機する期間を指定します。問合せの大部分が1秒で戻されない場合、大きい値(3秒など)を設定してページ・リフレッシュを回避するのに便利です。	デフォルト値なし
<ODBC> <UnaccessedRunningTimeoutMinutes> </ODBC>	未アクセスの分析が取り消されるまでの経過時間を分単位で指定します。未アクセスの分析とは、この設定で指定された時間(分)の間、アクセスされていない分析です。最小値は2です。この要素は、ユーザーが分析の編集中に、少なくとも一時的に分析の編集を中断して別の場所を参照している場合に対処します。ただし、ユーザーが分析の編集に戻る可能性があるため、この値を小さく設定しすぎないようにしてください。この要素は、BIサーバーに対して実行されるプレゼンテーション・サービスの問合せにのみ使用します。この要素は、その他のタイプの接続には適用されません。	5
<UI> <MaxSearchResultItemsToReturn> </UI>	プレゼンテーション・サービスでカタログを一覧表示するディレクトリに表示される項目の最大数を指定します。最小値は0です。ユーザー・インタフェースのパフォーマンスが低下する可能性があるため、この要素に高い値を設定する際は注意してください。	300
<UI> <UserPickerDialogMaxAccounts> </UI>	プレゼンテーション・サービスでカタログを一覧表示するディレクトリ内の左ピッカーに表示される項目の最大数を指定します。たとえば、項目が300を超えるカタログ・フォルダでは、この値を300より大きくしないかぎり、すべての項目を表示できません。最小値は0です。ユーザー・インタフェースのパフォーマンスが低下する可能性があるため、この要素に高い値を設定する際は注意してください。	300

Oracle BI EEのページの攻撃からの保護

管理者は、クリックジャッキングと呼ばれるセキュリティ上の問題を認識しておく必要があります。クリックジャッキングとは、攻撃者がクリックを悪用し、JavaScriptの使用に関係なくフレーム化できるWebページに被害者のクリックを送信する技法です。

たとえば、攻撃者がOracle Business Intelligence Consoleアプリケーションに対してインライン・フレームを使用するWebサイトを開発したとします。このサイトを訪問したユーザーは、気付かないうちにインライン・フレーム上のConsoleアプリケーションのボタンをクリックしています。攻撃者は、他のOracle Business Intelligenceアプリケーションに適用される同一生成元ポリシーの原則によって阻止されないため、この脆弱性は非常に重大です。クリックジャッキングの多数の例を示す文書は、World Wide Webで見つけることができます。

攻撃者によってアプリケーションがインライン・フレームにフレーム化されないようにすることを、フレーム・バスティングと言います。フレーム・バスティングに影響する設定を行うには、instanceconfig.xmlファイルでInIFrameRenderingMode要素を使用します。この要素は、次の3つの値に設定できます。

prohibit: Oracle BIプレゼンテーション・サービスのコンテンツがインライン・フレームにレンダリングされることを許可しません。
sameDomainOnly: (デフォルト)包含されるページが同じドメインのサーバーによって生成されたものである場合は、そのページのインライン・フレームへのレンダリングを可能にします。デフォルトでは、同じサーバーによって生成されたページには、同じドメインが指定されます。同一生成元ポリシーに関する情報は、World Wide Webを参照してください。
allow: Oracle BIプレゼンテーション・サービスのコンテンツがインライン・フレームにレンダリングされることを許可します。

Oracle BIプレゼンテーション・サービスに対するJavaHostサービスの使用

Javaライブラリの機能はJavaHostサービスを使用して実現できます。

JavaHostサービスは、プレゼンテーション・サービスがJavaライブラリに用意されている機能を使用して、次のコンポーネントをサポートできるようにします。

グラフの生成
SVGレンダラ(Apache Batik)
Javaアクションが必要なアクション、たとえばWebサービスの呼出しなど
PDFへのプリントおよびMicrosoft ExcelおよびPowerPointへのエクスポート
拡張レポート
別のコンポーネントにHTTPリクエストを発行するURL接続
Oracle BIサーバーがJavaコードの実行のために使用するインテグレーション・サービス・コール

注意:

JavaHostサービスはBI Publisherのコア・ライブラリを使用して、分析の内容を、PDF、Microsoft ExcelとPowerPoint、イメージなどの様々な形式にエクスポートします。BI PublisherのライブラリはJavaHostサービス内に埋め込まれており、J2EEコンテナにデプロイされているまたは実行されているBI Publisherに依存しません。

JavaHostサービスの構成ファイルでは、BI Publisherのライブラリに関連する要素は、XMLP要素内にあります。

JavaHostサービスを構成するには、BI_DOMAIN/config/fmwconfig/biconfig/OBIJHディレクトリにある構成ファイル(config.xml)でサービスの構成要素を手動で編集します。各要素の説明は、次の表を参照してください。要素は、JavaHost要素で始まる相対パスによって識別されます。

InputStreamLimitInKBなどの共通のサブ要素は、MessageProcessor、ListenerまたはSSLローダーには適用されません。

要素	説明
Loaders	ListOfEnabledLoaders要素とLoader要素が含まれます。これらの要素は、JavaHostサービスに対してコンポーネントを指定します。Loadersセクションでこれらの要素を編集することは避けてください。
Loaders/ListOfEnabledLoaders	有効にするOracle BIスケジューラおよびBI Publisherなどのコンポーネントのリストを指定します。この要素がファイルから欠落している場合、すべてのローダーが有効になります。この要素に空の値が指定されている場合は、すべてのローダーが無効になります。各コンポーネントには対応するLoader要素があります。ここにリストされているコンポーネントの名前は、対応するLoader/Name要素に指定されている名前と一致している必要があります。
Loaders/Loader	次の要素が含まれます。これらは、特定のコンポーネントの構成情報を指定します。名前 Class ConfigNodePath ClassPath
Loaders/Loader/Name	コンポーネントの一意の名前を指定します。この名前は、ListOfEnabledLoaders要素で使用します。
Loaders/Loader/Class	コンポーネントのメイン・クラスを指定します。
Loaders/Loader/ConfigNodePath	Loaderの構成情報のXPath(JavaHost要素から始まる)を指定します。
Loaders/Loader/ClassPath	JavaHostサービスによって使用されるライブラリのJARファイルに対するパスを指定します。
InputStreamLimitInKB	JavaHostに送信されるリクエストの最大入力サイズをKB単位で指定する、各ローダーに共通の子要素。値ゼロは、この制限を無効にします。最大サイズを超えると、エラー・メッセージが表示されます。デフォルト: 8192 InputStreamLimitInKB値は、テストの場合のみゼロに設定します(値は無制限になります)。この値を高く構成しすぎると、JavaHostへの個別のリクエストに必要なリソースよりも多くのリソースが割り当てられる、または消費されるため、JavaHostが不安定になったりクラッシュが発生します。この値の構成は、グラフやエクスポート操作など、すべてのJavaHostリクエストのコンテキストに適合している必要があります。この要素は、大規模なデータセットを正常に処理する適切な値に設定してください。デフォルト値は8192 (8MB)ですが、増分で16384 (16MB)、32768 (32MB)などの値に変更してください。
RequestResponseLogDirectory	リクエストのレスポンス・ファイルのディレクトリ名を指定する、各ローダーに共通の子要素。デフォルト: デフォルトの一時ディレクトリ
LogLargeRequests	大きいリクエストの処理時にレスポンス・ファイルを作成するかどうかを指定する、各ローダーに共通の子要素。デフォルト: true
ReadRequestBeforeProcessing	ファイルが完全に読み取られるまでリクエストの処理を待機するかどうかを指定する、各ローダーに共通の子要素。組織でOracle BI EEのエクスポート機能を使用する場合は、この子要素をfalseに設定することをお薦めします。falseに設定すると、データは最初にファイルに保存されるのではなく、JavaHostに徐々にストリームされて処理されるため、エクスポート・パフォーマンスが向上します。デフォルト: true
LargeRequestThresholdInKB	リクエストにディスク領域を使用するまでの最大サイズをKB単位で指定する、各ローダーに共通の子要素。このサイズより大きいリクエストの場合、リクエストされたデータのキャッシュには、メモリーではなくディスク領域が使用されます。この値が大きくなるほど、JavaHostサービスによって使用される可能性のあるメモリーの量も増え、リクエストの処理速度が速くなります。また、この設定によってLogLargeRequests要素のしきい値も設定されます。デフォルト: 200
MessageProcessor	SocketTimeout要素が含まれます。
MessageProcessor/SocketTimeout	ソケットのアイドル・タイムアウト(ミリ秒単位)を指定します。この時間を経過すると、ソケットがアイドル・ソケット・プールに返されます。JavaHostはソケット・プーリング・メカニズムを使用して、単一スレッド内のすべてのアイドル・ソケット・セットで新規データを待機します。アイドル・プール内の初期メッセージは、Java NIOチャネル経由で処理されます。デフォルト: 5000 (5秒)
Listener	次の要素が含まれます。 PermittedClientList ポート Address Secure
Listener/PermittedClientList	JavaHostが受信接続を許可するIPアドレスおよびホスト名のリストを指定します。各クライアントのIPアドレスまたはホスト名は、カンマで区切ります。すべてのクライアント接続を許可するには、この要素をアスタリスク()に設定します。デフォルト:
Listener/Port	JavaHostのTCP/IPリスニング・ポートを識別します。デフォルト: 9810
Listener/Address	JavaHostがバインドするネットワーク・インタフェースを指定します。この要素に値が指定されていない場合、JavaHostは使用可能なすべてのネットワーク・インタフェースにバインドします。
Listener/Secure	JavaHostサービスに対してSSL暗号化を有効にするかどうかを指定します。 Yes: SSL暗号化を有効にします。 No: SSL暗号化を無効にします。デフォルト: No SSLの詳細は、Oracle Business Intelligence Enterprise Editionセキュリティ・ガイドを参照してください。
Batik	InputStreamLimitInKBなどの共通のサブ要素のみが含まれています。これは、それらがラスター化されたイメージ形式へのSVGイメージの変換に関連するためです。
Scheduler	次の要素が含まれます。 Enabled DefaultUserJarFilePath DefaultTempFilePath DefaultPurgingPeriod
Scheduler/Enabled	Javaジョブを実行するためにJavaHostサービスとOracle BIスケジューラの相互作用を有効にするかどうかを指定します。 true: Oracle BIスケジューラとの相互作用を有効にします。 false: Oracle BIスケジューラとの相互作用を無効にします。デフォルト: false
Scheduler/DefaultUserJarFilePath	Java拡張機能ユーティリティ用のJARファイルを格納するデフォルト・ディレクトリを指定します。Jarファイルには、実行されるJavaクラスの実装が含まれています。 Oracle BIスケジューラが有効な場合、この要素は必須で、単一パスを受け入れます。
Scheduler/DefaultTempFilePath	Oracle BIスケジューラ・リクエスト用の一時ファイルを格納するデフォルト・ディレクトリを指定します。デフォルト: システムの一時ディレクトリ
Scheduler/DefaultPurgingPeriod	Oracle BIスケジューラ・リクエストが失敗したジョブを削除するまでのデフォルト期間(秒単位)を指定します。デフォルト: 300
XMLP	Oracle BI Publisherに関連する`InputStreamLimitInKB`および`ReadRequestBeforeProcessing`などの共通のサブ要素のみが含まれています。
URLConnect	SSLに関連する要素が含まれています。これらの要素は変更しないでください。
DVT	デフォルトでは、グラフ生成に関連する共通の`InputStreamLimitInKB`子要素のみが含まれています。必要に応じて、他の共通の子要素を追加できます。