D 拡張構成リファレンス
この付録では、分析、エージェント、ダッシュボードまたはカタログに固有でない、高度なインストール後の構成および管理手順について説明します。
これらのコンポーネントの構成方法は、これまでの各章を参照してください。ほとんどの管理者は、この付録で説明されている構成設定を変更する必要はありません。
トピック:
プレゼンテーション・サービスに対する拡張構成の変更
Oracle Analytics Serverプロセスは、Webサーバーのほとんどのビジネス・ロジックをホストし、ビジネス・インテリジェンス・データをWebクライアントに提示するためのフレームワークとインタフェースを提供します。
-
Windowsの場合、プロセスは
sawserver.exe
です。 -
Linuxの場合、プロセスは
sawserver
です。
instanceconfig.xml
ファイルには、Oracle Analytics Serverに影響を与える構成設定が格納されています。多くの構成設定はFusion Middleware Controlで使用でき、構成を変更するための推奨方法です。特定の設定がFusion Middleware Controlで使用できない場合は、instanceconfig.xml
ファイルを使用してその設定を変更できます。instanceconfig.xml
ファイルを使用して、デプロイメントを様々な面からカスタマイズできます。このファイルで直接変更するのは、プレゼンテーション・カタログの名前などのデフォルト要素を変更する場合、またはキャッシュ関連設定などの内部デフォルト設定をオーバーライドする場合のみです。
instanceconfig.xml
ファイルには、Oracle Analytics Serverにアクセスするためにプレゼンテーション・サービスによって使用されるデータソース名を含む、いくつかのエントリがデフォルトで含まれています。
ノート:
以前に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>
<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> </Security> <ODBC> <UnaccessedRunningTimeoutMinutes>5</UnaccessedRunningTimeoutMinutes> </ODBC> <UI> <MaxSearchResultItemsToReturn>300</MaxSearchResultItemsToReturn> <UserPickerDialogMaxAccounts>300</UserPickerDialogMaxAccounts> </UI> </ServerInstance>
-
変更内容を保存し、ファイルを閉じます。
-
システムを再起動します。
プレゼンテーション・サービスの詳細な構成設定
構成設定を使用して、プレゼンテーション・サービスの高度な変更を行うことができます。
この表では、プレゼンテーション・サービスの詳細な構成設定について説明します。
要素 | 説明 | デフォルト値 |
---|---|---|
|
クライアントの状態をセッション間およびセッション内で保持する親要素を指定します。Enabled、LocalStorageおよびSessionStorageの各要素も参照してください。 |
デフォルト値なし |
|
クライアントの状態を、セッションを横断してまたはそのセッション内で保持するかどうかを指定します。状態がブラウザ・セッションをまたいで保持されることはありません。次の項目について状態が保持されます。
LocalStorageおよびSessionStorage要素も参照してください。 |
true |
|
ブラウザのローカル・ストレージを使用して状態を保持するかどうかを指定します。ブラウザがローカル・ストレージをサポートしていない場合、状態は保持されません。 |
true |
|
ブラウザのローカル・ストレージを使用してセッションの状態を保持するかどうかを指定します。ブラウザがローカル・ストレージをサポートしていない場合、状態は保持されません。 |
true |
|
モバイル・アプリケーションのデータとプレゼンテーション・カタログのお気に入りを同期するまでのアイドル時間の秒数を指定します。 |
300 |
|
ユーザーがOracle Analytics Serverの「ホーム」ページからインストーラをダウンロードすることを選択した場合に、インストーラのデフォルトのダウンロード場所をオーバーライドすることを指定します。 64-ビット・インストーラのファイル名はbiee_client_install64.exeです。 |
デフォルト値なし |
|
ブラウザ固有のパスワード管理ソフトウェアを使用して、ブラウザでパスワードの保存を許可するかどうかを指定します。trueに設定すると、ユーザーは以降のサインインのためにパスワードを保存するかどうかを指定するよう求められます。 |
false |
|
ブラウザに送信されるCookieのドメイン情報を指定します。 |
デフォルト値なし |
|
Cookieが適用されるドメイン・パスを指定します。 |
/analytics |
|
詳細は、Oracle Analytics Serverのページの攻撃からの保護を参照してください。 |
sameDomainOnly |
|
ブラウザに検索ページを戻す前に、初期リクエストに対する結果をサーバーが待機する期間を指定します。問合せの大部分が1秒で戻されない場合、大きい値(3秒など)を設定してページ・リフレッシュを回避するのに便利です。 |
デフォルト値なし |
|
未アクセスの分析が取り消されるまでの経過時間を分単位で指定します。未アクセスの分析とは、この設定で指定された時間(分)の間、アクセスされていない分析です。最小値は2です。 この要素は、ユーザーが分析の編集中に、少なくとも一時的に分析の編集を中断して別の場所を参照している場合に対処します。ただし、ユーザーが分析の編集に戻る可能性があるため、この値を小さく設定しすぎないでください。 この要素は、BIサーバーに対して実行されるプレゼンテーション・サービスの問合せにのみ使用します。この要素は、その他のタイプの接続には適用されません。 |
5 |
|
プレゼンテーション・サービスでカタログを一覧表示するディレクトリに表示される項目の最大数を指定します。最小値は0です。ユーザー・インタフェースのパフォーマンスが低下する可能性があるため、この要素に高い値を設定する際は注意してください。 |
300 |
|
指定した検索基準に基づいて選択リストに含めるユーザーおよびロールの最大数を指定します。たとえば、この要素が300に設定され、300を超えるユーザーおよびロールが検索条件に一致する場合、最初の300のみがリストに含まれます。ユーザー・インタフェースのパフォーマンスが低下する可能性があるため、この要素に高い値を設定する際は注意してください。 |
300 |
Oracle Analytics Serverのページの攻撃からの保護
管理者は、クリックジャッキングと呼ばれるセキュリティ上の問題を認識しておく必要があります。クリックジャッキングとは、攻撃者がクリックを悪用し、JavaScriptの使用に関係なくフレーム化できるWebページにユーザーのクリックを送信する技法です。
たとえば、攻撃者がOracle Analytics Serverコンソール・アプリケーションに対してインライン・フレームを使用するWebサイトを開発したとします。このサイトを訪問したユーザーは、気付かないうちにインライン・フレーム上のコンソール・アプリケーションのボタンをクリックしています。攻撃者は、他のOracle Analytics Serverアプリケーションに適用される同一生成元ポリシーの原則によって阻止されないため、この脆弱性は非常に重大です。クリックジャッキングの多数の例を示す文書は、World Wide Webで見つけることができます。
攻撃者によってアプリケーションがインライン・フレームにフレーム化されないようにすることを、フレーム・バスティングと言います。フレーム・バスティングに影響する設定を行うには、instanceconfig.xmlファイルでInIFrameRenderingMode要素を使用します。この要素は、次の3つの値に設定できます。
-
prohibit = プレゼンテーション・サービスのコンテンツがインライン・フレームにレンダリングされることを許可しません。
-
sameDomainOnly = (デフォルト)包含されるページが同じドメインのサーバーによって生成されたものである場合は、そのページのインライン・フレームへのレンダリングを可能にします。デフォルトでは、同じサーバーによって生成されたページには、同じドメインが指定されます。同一生成元ポリシーに関する情報は、World Wide Webを参照してください。
-
allow = プレゼンテーション・サービスのコンテンツがインライン・フレームにレンダリングされることを常に許可します。
プレゼンテーション・サービスに対するJavaHostサービスの使用
Javaライブラリの機能はJavaHostサービスを使用して実現できます。
JavaHostサービスは、プレゼンテーション・サービスがJavaライブラリに用意されている機能を使用して、次のコンポーネントをサポートできるようにします。
-
グラフの生成
-
SVGレンダラ(Apache Batik)
-
Javaアクションが必要なアクション、たとえばWebサービスの呼出しなど
-
PDFへのプリントおよびMicrosoft ExcelおよびPowerPointへのエクスポート
-
拡張レポート
-
別のコンポーネントにHTTPリクエストを発行するURL接続
-
Oracle Analytics ServerがJavaコードの実行のために使用するインテグレーション・サービス・コール
ノート:
JavaHostサービスはOracle Analytics Server Publisherのコア・ライブラリを使用して、分析の内容を、PDF、Microsoft Excel、Microsoft PowerPoint、イメージなどの様々な形式にエクスポートします。Oracle Analytics Server PublisherのライブラリはJavaHostサービス内に埋め込まれており、J2EEコンテナ内で実行されているまたはデプロイされているOracle Analytics Server Publisherに依存しません。JavaHostサービスの構成ファイルでは、Oracle Analytics Server 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スケジューラやOracle Analytics Server Publisherなどのコンポーネントのリストを指定します。 この要素がファイルから欠落している場合、すべてのローダーが有効になります。この要素に空の値が指定されている場合は、すべてのローダーが無効になります。 各コンポーネントには対応するLoader要素があります。ここにリストされているコンポーネントの名前は、対応するLoader/Name要素に指定されている名前と一致している必要があります。 |
Loaders/Loader |
次の要素が含まれます。これらは、特定のコンポーネントの構成情報を指定します。
|
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 |
ファイルが完全に読み取られるまでリクエストの処理を待機するかどうかを指定する、各ローダーに共通の子要素。 組織でエクスポート機能を使用する場合は、この子要素をfalseに設定することをお薦めします。falseに設定すると、データは最初にファイルに保存されるのではなく、JavaHostに徐々にストリームされて処理されるため、エクスポート・パフォーマンスが向上します。 デフォルト: true |
LargeRequestThresholdInKB |
リクエストにディスク領域を使用するまでの最大サイズをKB単位で指定する、各ローダーに共通の子要素。このサイズより大きいリクエストの場合、リクエストされたデータのキャッシュには、メモリーではなくディスク領域が使用されます。この値が大きくなるほど、JavaHostサービスによって使用される可能性のあるメモリーの量も増え、リクエストの処理速度が速くなります。また、この設定によってLogLargeRequests要素のしきい値も設定されます。 デフォルト: 200 |
MessageProcessor |
SocketTimeout要素が含まれます。 |
MessageProcessor/SocketTimeout |
ソケットのアイドル・タイムアウト(ミリ秒単位)を指定します。この時間を経過すると、ソケットがアイドル・ソケット・プールに返されます。JavaHostはソケット・プーリング・メカニズムを使用して、単一スレッド内のすべてのアイドル・ソケット・セットで新規データを待機します。アイドル・プール内の初期メッセージは、Java NIOチャネル経由で処理されます。 デフォルト: 5000 (5秒) |
Listener |
次の要素が含まれます。
|
Listener/PermittedClientList |
JavaHostが受信接続を許可するIPアドレスおよびホスト名のリストを指定します。各クライアントのIPアドレスまたはホスト名は、カンマで区切ります。すべてのクライアント接続を許可するには、この要素をアスタリスク(*)に設定します。 デフォルト: * |
Listener/Port |
JavaHostのTCP/IPリスニング・ポートを識別します。 デフォルト: 9810 |
Listener/Address |
JavaHostがバインドするネットワーク・インタフェースを指定します。この要素に値が指定されていない場合、JavaHostは使用可能なすべてのネットワーク・インタフェースにバインドします。 |
Listener/Secure |
JavaHostサービスに対してSSL暗号化を有効にするかどうかを指定します。
デフォルト: No |
Batik |
InputStreamLimitInKBなどの共通のサブ要素のみが含まれています。これは、それらがラスター化されたイメージ形式へのSVGイメージの変換に関連するためです。 |
Scheduler |
次の要素が含まれます。
|
Scheduler/Enabled |
Javaジョブを実行するためにJavaHostサービスとOracle BIスケジューラの相互作用を有効にするかどうかを指定します。
デフォルト: false |
Scheduler/DefaultUserJarFilePath |
Java拡張機能ユーティリティ用のJARファイルを格納するデフォルト・ディレクトリを指定します。Jarファイルには、実行されるJavaクラスの実装が含まれています。 Oracle BIスケジューラが有効な場合、この要素は必須で、単一パスを受け入れます。 |
Scheduler/DefaultTempFilePath |
Oracle BIスケジューラ・リクエスト用の一時ファイルを格納するデフォルト・ディレクトリを指定します。 デフォルト: システムの一時ディレクトリ |
Scheduler/DefaultPurgingPeriod |
Oracle BIスケジューラ・リクエストが失敗したジョブを削除するまでのデフォルト期間(秒単位)を指定します。 デフォルト: 300 |
XMLP |
Oracle Analytics Server Publisherに関連する |
URLConnect |
SSLに関連する要素が含まれています。これらの要素は変更しないでください。 |
DVT |
デフォルトでは、グラフ生成に関連する共通の |