ヘッダーをスキップ
Oracle® Fusion Middleware Oracle WebCenter Portal管理者ガイド
11g リリース1(11.1.1.6.0)
B72085-01
  ドキュメント・ライブラリへ移動
ライブラリ
製品リストへ移動
製品
目次へ移動
目次
索引へ移動
索引

前
 
次
 

22 WebCenter PortalでのOracle SES検索の管理

この章では、ほとんどのWebCenter Portalオブジェクトを索引付けおよび検索するようにOracle Secure Enterprise Search (SES)アダプタを構成する方法について説明します。Oracle SES検索には、次の利点があります。

WebCenter Portal: Frameworkアプリケーションで、Oracle SESはデフォルトおよび優先される検索プラットフォームとして設定されています。構成手順の詳細は、第22.5項「Frameworkアプリケーションを検索するためのOracle SESの構成」を参照してください。

WebCenter Portal: Spacesアプリケーションで、WebCenter Portalの内部検索サービス・アダプタは、デフォルトの検索プラットフォームとして設定されています。ただし、大規模な実装では最適なパフォーマンスのためにOracle SESを使用するよう構成する必要があります。構成手順の詳細は、第22.6項「Spacesアプリケーションを検索するためのOracle SESの構成」を参照してください。

WebCenter Portalの元の検索サービス・アダプタを使用するよう選択した場合は、この章の情報は必要ありません

WebCenter Portalアプリケーションのバックエンド・サービスを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンドライン・ツールを使用してください。デプロイ後にアプリケーションに加えた変更は、MDSメタデータにカスタマイズとして格納されます。第1.3.5項「WebCenter Portalの構成に関する考慮事項」を参照してください。


注意:

Fusion Middleware ControlまたはWLSTを使用して実行する検索構成の変更の多くは、動的ではありません。変更を有効にするには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。


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

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminまたはOperatorロールを付与されたユーザー)を対象としています。第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

22.1 Oracle SESでのWebCenter Portalの検索に関する必要な知識

最適なパフォーマンスのためには、Oracle SES検索を使用することをお薦めします。WebCenter Portalアプリケーションで次のリソースを検索するようOracle SESを構成できます。


注意:

WebCenter Portal: Spacesには、Spaces内のスペース、リスト、ページおよび人のリソースを索引付けする追加のOracle SESクローラが含まれています。このクローラは、Frameworkアプリケーションではサポートされていません。


すべてのソースの結果が合わせてリストされ、最も関連性の高いアイテムが最初に表示されます。たとえば、ユーザー名の検索を実行する場合、そのユーザーが作成したドキュメントではなく、そのユーザーの連絡先情報(つまり、ピープル・コネクション・サービス内の正確なユーザー名)を探している可能性が高いと考えられます。Oracle SESの統合ランキング結果を使用すると、検索プリファレンスを構成しなくても、すべての異なるタイプの検索間で最も関連性の高い結果を表示することができます。

Oracle SESがWebCenter Portalを検索するよう構成されている場合、その他のクロールされていないリソース(ノート、イベントなど)は検索結果に返されません。

WebCenter Portalリソースを索引付けするOracle SESクローラには、次の3つのタイプがあります。


注意:

Oracle SESでは、ソースとして収集された情報をクロールします。各ソースには、データベースやコンテンツ・リポジトリなど、情報が格納される場所を特定するタイプがあります。


Oracle SESでWebCenter Portalを検索するよう構成する場合は、すべての利用可能なOracle SESクローラを有効にする必要があります。これらのOracle SESクローラのいずれかを有効にし、その他は無効にすることはお薦めできません。たとえば、Oracle SESでFrameworkアプリケーションを検索するよう構成する場合、ドキュメントをクロールしてディスカッションはクロールしないようにすることはできません。

22.2 WebCenter PortalでのOracle SESの構成ロードマップ

この項では、ロードマップを構成プロセスにおける管理者のガイドとして使用します。

22.3 Oracle SESを使用するための前提条件

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

22.3.1 Oracle SES: インストール

サポートされるOracle SESのバージョンは、10.1.8.4.x以降です。Oracle SESリリース11.1.2.2を使用することを強くお薦めします。Oracle SESのインストール手順の詳細は、Oracle Fusion Middleware Oracle WebCenter Portalインストール・ガイドの検索サービスのバックエンド要件に関する項を参照してください。


関連項目:

Oracle SESに必要なすべてのパッチをインストール済であることを確認することは重要です。必要なパッチの最新情報は、リリース・ノートを確認してください。


この章では、サポートされている最新の製品であるOracle SES 11.1.2.2およびOracle WebCenter Content: Content Server 11.1.1.5を実行していることを前提としています。ただし、次のシナリオもサポートされます。

WebCenter Portal: Frameworkバージョン11.1.1.3および11.1.1.4は次のインストールでサポートされます。

  • Oracle SES 11.1.2およびOracle Content Server 11.1.1.3+

  • Oracle SES 10.1.8.4およびOracle Content Server 11.1.1.3+

  • Oracle SES 10.1.8.4およびOracle Content Server 10.1.3.5.1 (11.1.1.1から11.1.1.3を含むバージョン)

WebCenter Portal: Spacesバージョン11.1.1.3および11.1.1.4は次のインストールでサポートされます。

  • Oracle SES 11.1.2およびOracle Content Server 11.1.1.3+

  • Oracle SES 10.1.8.4およびOracle Content Server 11.1.1.3

22.3.2 Oracle SES: 構成

  1. Oracle SESは、ユーザーを検証および認証するためにアイデンティティ管理システムとともに構成する必要があります。これはセキュアな検索のために必要です。そうすることで、検索時に、アクセス権限に基づいてユーザーが表示することを許可される結果のみが返されるようになります。

    WebCenter PortalはOracle SESとの通信時にアイデンティティ伝播を使用するため、WebCenter Portalのユーザー・ベースはOracle SESのユーザー・ベースと一致している必要があります。そうするための1つの方法は、WebCenter PortalとOracle SESを、Oracle Internet Directoryなどの同じアイデンティティ管理システムに対して構成することです。


    注意:

    サポートされているすべてのアイデンティティ管理システムについては、第28.2.3項「デフォルトのアイデンティティ・ストアおよびポリシー・ストア」を参照してください。

    各Oracle SESインスタンスに対して、1つのアイデンティティ・プラグインのみを設定できます。すべてのリポジトリ(Oracle WebCenter Content: Content Server、Oracle WebCenter Portal Discussions Server、およびOracle WebCenter Portal: Spaces)は、Oracle SESと同じユーザー・ベースを共有する必要があります。

    Oracle SESには、Oracle Internet Directory、Oracle Content Server、Microsoft Active Directoryなどのアイデンティティ管理システムのための多数のアイデンティティ・プラグインが含まれています。詳細は、製品に含まれるOracle SESドキュメントを参照してください。(これらは、Oracle Fusion Middlewareドキュメント・ライブラリのWebCenter Portal製品の領域にリストされています。)


    次の例では、Oracle Internet Directory用のアイデンティティ・プラグインを設定します。

    1. Oracle SES管理ツールで、「グローバル設定」→「アイデンティティ管理設定」ページに移動し、利用可能なアイデンティティ・プラグインから「Oracle Internet Directory」を選択し、「アクティブ化」をクリックします。

    2. 次の値を入力します。

      ホスト名: Oracle Internet Directoryが実行されているコンピュータのホスト名

      ポート: Oracle Internet Directoryのポート番号

      SSLの使用: プリファレンスに基づき、trueまたはfalse

      レルム: dc=us,dc=oracle,dc=comなどのOracle Internet Directoryレルム

      ユーザー名: cn=orcladminなどのOracle Internet Directory管理ユーザー名

      パスワード: 管理ユーザーのパスワード

    3. 「送信」をクリックします。

  2. WebCenter Portalエンド・ユーザーが検索時にセキュアに伝播されるようにするため、各Oracle SESインスタンスには1つの信頼できるエンティティが必要です。(信頼できるエンティティにより、Oracle SES上で問合せを実行する際にWebCenter Portalアプリケーションが自身をOracle SESに対して認証し、ユーザーをアサートできるようになります。)この信頼できるエンティティは、Oracle SESの背後のアイデンティティ管理サーバーに存在するユーザーにすることも、Oracle SESで内部的に作成されるユーザーにすることもできます。

    これはWLSTまたはOracle SESのどちらでも実行できます。


    注意:

    この信頼できるエンティティ名とパスワードは、後でWLSTコマンドcreateSESConnectionにおけるappUserおよびappPasswordプロパティとして必要になります。


    これをWLSTで実行するには、createFederationTrustedEntityコマンド(例22-1)を使用します。

    例22-1 createFederationTrustedEntityコマンド

    createFederationTrustedEntity(
    'webcenter', 'http://ses-host:ses-port/search/api/admin/AdminService',
     'ses-admin-pw', 'webcenter-proxy-user', 'webcenter-proxy-user-pw', 
    'Trusted entity for WebCenter');
     
    

    各要素の意味は次のとおりです。

    • ses-host = Oracle SESホスト名

    • ses-port = Oracle SESポート番号

    • ses-admin-pw = Oracle SES管理ユーザー・パスワード

    • webcenter-proxy-user = WebCenter Portalエンド・ユーザーをログオンするためのプロキシ・ユーザー

    • webcenter-proxy-user-pw = WebCenter Portalエンド・ユーザーをログオンするためのプロキシ・ユーザーのパスワード

    コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のcreateFederationTrustedEntityに関する項を参照してください。

    これをOracle SESで実行するには、次の手順に従ってください。

    1. Oracle SES管理ツールで、「グローバル設定」→「フェデレーション・トラステッド・エンティティ」ページに移動します。

    2. 信頼できるエンティティの名前を入力します。これは、WebCenter Portalが検索時に(エンド・ユーザー・アイデンティティをOracle SESに伝播する前に)自身をOracle SESに対して認証するために使用する名前です。

      エンティティがアクティブなアイデンティティ・プラグインによって認証されるようにするには:

      - エンティティ名がアイデンティティ管理システム内に存在するユーザーの名前であることを確認します。

      - パスワード・フィールドを空白のままにします。

      - 「アイデンティティ・プラグインを認証に使用」チェック・ボックスを選択します。

      - アクティブなアイデンティティ・プラグインの「認証属性」に対応する認証の属性値を入力します。

      エンティティがOracle SESによって認証されるようにするには:

      - 任意のユーザー名(例: wcsearch)とパスワード(例: welcome1)を入力します。

      - 「アイデンティティ・プラグインを認証に使用」チェック・ボックスは選択しないでください。

      詳細は、Oracle SESの「フェデレーション・トラステッド・エンティティ」ページのオンライン・ヘルプを参照してください。


注意:

参考までに、この章では次のサンプル・ユーザー名が使用されています。

  • wcsearch: Oracle SESフェデレーション・トラステッド・エンティティのユーザー

  • mycrawladmin: リスト、ページ、スペース、ピープル・コネクション・プロファイルなどの特定のSpacesオブジェクトをクロールするための、Spacesおよびアイデンティティ管理システム内のクロール管理ユーザー

  • sescrawer (または管理ユーザー): sescrawlerrole (またはadmin)ロールを持つOracle WebCenter Content Serverのクロール管理ユーザー


22.3.3 Oracle SES: セキュリティ

ほとんどのエンタープライズ・デプロイメントでは、セキュアなHTTP接続が必要です。Secure Socket Layer (SSL)は、インターネット上で機密のコンテンツを安全に送信するための暗号化プロトコルです。パスワードやその他のセキュアなデータをネットワーク上で送信する際には、SSL保護されたチャネルを使用することを強くお薦めします。

手順の詳細は、第33.10項「SSLを使用したOracle SESへの接続の保護」を参照してください。

22.4 Oracle SES接続の設定

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

22.4.1 Oracle Secure Enterprise Searchサーバーの登録

WebCenter Portalアプリケーションには複数のOracle SES接続を登録できますが、一度にアクティブにできる接続はそのうち1つのみです。

Fusion Middleware ControlまたはWLSTを使用してOracle SES接続を登録できます。この項の内容は次のとおりです。

22.4.1.1 Fusion Middleware Controlを使用したOracle SES検索接続の登録

WebCenter PortalアプリケーションにOracle SESインスタンスを登録する手順は次のとおりです。

  1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

  2. 次のいずれかを実行します。

    • Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」「サービス構成」を選択します。

    • Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」「サービス構成」を選択します。

  3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「検索」を選択します。

  4. 新規のOracle SESインスタンスに接続するには、「追加」をクリックします(図22-3)。

    図22-3 Oracle Secure Searchサービスの構成

    Oracle Secure Searchサービスの構成
    「図22-3 Oracle Secure Searchサービスの構成」の説明

  5. 「Secure Enterprise Search接続の追加」ページで、この接続の一意の名前を入力し、この接続をアプリケーションのアクティブな(またはデフォルトの)接続にするかどうかを指定します(図22-4)。

    図22-4 Secure Enterprise Search接続の追加

    SES接続ページの追加

    表22-3に、接続パラメータを示します。

    表22-3 検索接続: 名前

    フィールド 説明

    接続名

    接続の一意の名前を入力します。名前は、WebCenter Portalアプリケーションのすべての接続タイプにおいて一意である必要があります。

    アクティブな接続

    これを選択すると、この接続に定義されているOracle SESインスタンスを使用してWebCenter Portalアプリケーション外部のリポジトリが検索され、結果セットにOracle SES検索結果が含まれるようになります。

    1つのアプリケーションに対して複数の検索接続を登録できますが、検索サービスで使用される接続はデフォルトの(またはアクティブな)接続1つのみです。


  6. Oracle SESインスタンスの接続の詳細を入力します(表22-4)。

    表22-4 Oracle Secure Enterprise Search: 接続の詳細

    フィールド 説明

    SOAP URL

    Oracle SESが検索リクエストを有効化するために公開するWebサービスURLを入力します。

    次の形式を使用します。

    http://host:port/search/query/OracleSearch
    

    次に例を示します。

    http://myHost:7777/search/query/OracleSearch
    

    フェデレーション・トラステッド・エンティティ名

    第22.3.2項「Oracle SES: 構成」で作成したOracle SESフェデレーション・トラステッド・エンティティのユーザー名を入力します。

    ヒント: このユーザーは、Oracle SES管理ツールの「グローバル設定」→「フェデレーション・トラステッド・エンティティ」ページで構成されます。

    WebCenter Portalアプリケーションは、WebCenter Portalユーザーにかわって検索を実行できるように、Oracle SESに対して信頼できるアプリケーションとして自身を認証する必要があります。

    この章の例では、この値にwcsearchを使用しています。

    フェデレーション・トラステッド・エンティティ・パスワード

    フェデレーション・トラステッド・エンティティのパスワードを入力します。


  7. 「OK」をクリックして、この接続を保存します。


注意:

新しい(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。


22.4.1.2 WLSTを使用したOracle SES接続の登録

  1. WLSTコマンドのcreateSESConnectionを使用して、Oracle SESへの接続を作成します。次に例を示します。

    createSESConnection(appName='webcenter',
                       name='MySesConnection',
                       url='http://myhost.com:7777/search/query/OracleSearch',              
                       appUser='wcsearch',
                       appPassword='welcome1',
                       default=true)
    

    ここで、appUser第22.3.2項「Oracle SES: 構成」で作成したOracle SESフェデレーション・トラステッド・エンティティのユーザー名です。

コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のcreateSESConnectionに関する項を参照してください。

新規のOracle SES接続をアクティブに使用するように検索サービスを構成するには、default=trueを設定します。詳細は、第22.4.2.2項「WLSTを使用したアクティブなOracle SES接続の選択」を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。


注意:

新しい(アクティブな)接続または設定の使用を開始するには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。


22.4.2 アクティブなOracle SES接続の選択

WebCenter Portalアプリケーションには複数のOracle SES接続を登録できますが、一度にアクティブにできる接続はそのうち1つのみです。


注意:

第22.4.1項「Oracle Secure Enterprise Searchサーバーの登録」でアクティブな接続を選択している場合は、この項でそのための手順を実行する必要はありません。


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

22.4.2.1 Fusion Middleware Controlを使用したアクティブなOracle SES接続の選択

アクティブな接続を変更する手順は、次のとおりです。

  1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

  2. 次のいずれかを実行します。

    • Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」「サービス構成」を選択します。

    • Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」「サービス構成」を選択します。

  3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「検索」を選択します。

    「セキュアなEnterprise Search接続の管理」表に、現在のアクティブな接続(ある場合)が示されます。

  4. アクティブな(またはデフォルトの)接続にする接続を選択し、「編集」(図22-5)をクリックします。

    図22-5「編集」アイコン

    「編集」アイコン
  5. 「アクティブな接続」チェック・ボックス(図22-6)を選択します。

    図22-6「アクティブな接続」チェック・ボックス

    「アクティブな接続」チェック・ボックス
  6. 「OK」をクリックして、接続を更新します。


注意:

新しい(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。


22.4.2.2 WLSTを使用したアクティブなOracle SES接続の選択

WLSTコマンドのsetSESConnectiondefault=trueで使用して、既存のOracle SES接続をアクティブ化します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetSESConnectionに関する項を参照してください。

後からOracle SES接続を無効化するには、同じWLSTコマンドをdefault=falseとともに実行します。接続の詳細は保持されますが、この接続はアクティブな接続として示されなくなります。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。


注意:

アクティブな接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。


22.4.3 Oracle SES接続の詳細の変更

Oracle SES接続の詳細はいつでも変更できます。

更新した(アクティブな)接続の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。


注意:

この項の手順は、第22.4.1項「Oracle Secure Enterprise Searchサーバーの登録」で構成された詳細を変更する場合にのみ必要になります。


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

22.4.3.1 Fusion Middleware Controlを使用したOracle SES接続の詳細の変更

Oracle SESインスタンスの接続の詳細を更新する手順は次のとおりです。

  1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

  2. 次のいずれかを実行します。

    • Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」「サービス構成」を選択します。

    • Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」「サービス構成」を選択します。

  3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「検索」を選択します。

  4. 接続名を選択し、「編集」をクリックします。

  5. 必要に応じて接続の詳細を編集します。パラメータ情報の詳細は、表22-4を参照してください。

  6. 「OK」をクリックして、変更を保存します。


注意:

更新後の(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。


22.4.3.2 WLSTを使用したOracle SES接続の詳細の変更

WLSTコマンドのsetSESConnectionを使用して、既存のOracle SES検索接続を変更します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetSESConnectionに関する項を参照してください。


注意:

更新された(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。


22.4.4 Oracle SES接続の削除

Oracle SES接続はいつでも削除できますが、アクティブな接続を削除する際は注意が必要です。アクティブな接続を削除すると、ユーザーは外部リポジトリのコンテンツを検索できなくなります。

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

22.4.4.1 Fusion Middleware Controlを使用した検索接続の削除

Oracle SESサーバー接続を削除する手順は次のとおりです。

  1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

  2. 次のいずれかを実行します。

    • Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」「サービス構成」を選択します。

    • Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」「サービス構成」を選択します。

  3. 「サービス接続」ドロップダウンから、「検索」を選択します。

  4. 接続名を選択し、「削除」をクリックします。

    図22-7 接続削除アイコン

    「削除」アイコン

注意:

この変更を有効にするには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。


22.4.4.2 WLSTを使用した検索接続の削除

WLSTコマンドのdeleteConnectionを使用して、検索接続を削除します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のdeleteConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。


注意:

この変更を反映させるには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。


22.4.5 Oracle SES接続のテスト

ブラウザに次のOracle SES Webサービス操作のURLを入力して、Oracle SES接続を確認します。

http://host:port/search/query/

このURLアドレスがブラウザで表示されない場合、Oracle SESサーバーのホストまたはポートのどちらかが間違っているか、またはOracle SESが起動されていません。

22.5 Frameworkアプリケーションを検索するためのOracle SESの構成

WebCenter Portal: Frameworkアプリケーションで、Oracle SESはデフォルトおよび優先される検索プラットフォームとして設定されています。Frameworkアプリケーションを検索するようOracle SESを構成するには、Spacesアプリケーションを検索するようOracle SESを構成するのと同様の手順を実行する必要がありますが、Frameworkアプリケーションではスペース・クローラがサポートされません。


注意:

Oracle SESをFrameworkアプリケーションの検索エンジンとして有効化するために実行する必要のあるタスクの概要は、第22.2項「WebCenter PortalでのOracle SESの構成ロードマップ」を参照してください。必要なタスクを実行するためにふさわしい方法や順序が多数ある場合もあります。


この項では、Frameworkアプリケーションを検索するようOracle SESを設定する手順について説明します。

22.5.1 Oracle SES検索のためのOracle WebCenter Portal: Content Serverの設定

この項では、Oracle SESによりクロール可能となるようにOracle WebCenter Content: Content Server(特に、WebCenter Portalがドキュメントの格納に使用するContent Server)を構成する方法について説明します。

次の手順はContent Server内で実行する必要があります。

  1. sescrawlerroleロールを作成します。

  2. ユーザーsescrawlerを作成し、これにadminロールとsescrawlerroleロールを割り当てます。このユーザーがOracle SES内にContent Serverを作成します。

  3. sceCrawlerRole=sescrawlerroleconfig.cfgに追加します。

  4. Content Serverを再起動します。

  5. Content Serverコンソールで、SESCrawlerExportコンポーネントをコンテンツ・サーバーにインストールします(まだインストールされていない場合)。

    1. システム管理者としてContent Serverにログオンします。例: http://host:port/cs

    2. 「管理」ドロップダウン・メニューから、「管理サーバー」(図22-8)を選択します。

      図22-8 Content Serverの管理

      図22-8の説明が続きます
      「図22-8 Content Serverの管理」の説明

    3. インスタンス名のボタンをクリックします。

    4. 左側のペインのメニュー・リストから「コンポーネント・マネージャ」をクリックします(図22-9)。

      図22-9 Content Serverの「コンポーネント・マネージャ」

      図22-9の説明が続きます
      「図22-9 Content Serverの「コンポーネント・マネージャ」」の説明

    5. 「統合」の下の「SESCrawlerExport」を選択し、「更新」をクリックします。

    6. 構成パラメータを入力します。(構成パラメータは、インストール後に変更することもできます。)

      SESCrawlerExportにより提供される認証および認可APIのセキュリティを無効にします。つまり、「Secure APIの無効化」falseに設定します。これにより、SESCrawlerExportによって提供されるセキュリティが、Content Serverによってではなく内部的に実行されるようになります。

      さらに、クラスタ環境の場合のみ、feedLocパラメータで、コンテンツ・サーバーのノードによりアクセスされる共有ディスク上の場所を指定する必要があります。また、これらの各ノードは同じようにこの場所を参照する必要があります(例: sharedDrive/dir1/dir2)。これは指定されたデフォルトの場所(相対パス)ではないことに注意してください。

    7. Content Serverを再起動します。

  6. Content Serverリポジトリのスナップショットを撮ります。

    1. システム管理者としてContent Serverにログオンします。例: http://host:port/cs

    2. 「管理」ドロップダウン・メニューから、「SESCrawlerExport」を選択します。

    3. 「すべてのソース」を選択し、「スナップショットの取得」 (図22-10)をクリックします。

      図22-10 Content Serverのスナップショット

      図22-10の説明が続きます
      「図22-10 Content Serverのスナップショット」の説明

      ソースの最初のクロールまたはその後のフル・クロールの前にスナップショットを撮ることは重要です。

      スナップショットにより、コンポーネントのインストール時に指定された場所にconfigFile.xmlが生成され、feedLocの下のソース名のサブディレクトリにフィードが作成されます。

  7. Content ServerがWebレンディション用に構成されている場合、Content Server内のアイテムはPDF形式でレンダリングされます。コンテンツ・アイテムのネイティブMIMEタイプのレンディションは上書きされます。たとえば、Microsoft Office WordドキュメントのMIMEタイプはapplication/mswordですが、Content ServerでWebレンディションを使用すると、MIMEタイプはapplication/pdfになります。Mimetypeパラメータをapplication/mswordに設定して検索問合せを実行しても、Wordドキュメントは返されません。

    Content ServerがWebレンディションを使用するように構成されている場合、Content Serverメタデータ・リストにdFormat値が含まれるように構成し、必要なMIMEタイプがOracle SESにエクスポートされるようにする必要があります。これは、MIMEタイプで検索を絞り込めるようにするために必要です。

    1. 「SESCrawlerExport管理」ページに戻り、「SESCrawlerExportの構成」(図22-11)をクリックします。

      図22-11 Content Serverのスナップショット

      図22-11の説明が続きます
      「図22-11 Content Serverのスナップショット」の説明

    2. デフォルトでは、「メタデータ・リスト」フィールドは空白です(図22-12)。

      図22-12 Content Serverの「メタデータ・リスト」

      図22-12の説明が続きます
      「図22-12 Content Serverの「メタデータ・リスト」」の説明

      空白のままにすると、Oracle SESにエクスポートされるメタデータの値のリストは、次(および「x」で始まる任意のカスタム・メタデータ・フィールド)で構成されます。

      dID,dDocName,dRevLabel,dDocType,dDocAccount,dSecurityGroup,dOriginalName,dReleaseDate,dOutDate

      ただし、dFormatをこのリストに追加する必要があります。

      空白の場合のデフォルト値を変更すると、そのデフォルト値は削除されるため、これらは再度追加する必要があります。標準の属性にdFormatを含めるには、「メタデータ・リスト」に次の値を入力します。

      dFormat,dID,dDocName,dRevLabel,dDocType,dDocAccount, dSecurityGroup,dOriginalName,dReleaseDate,dOutDate

    3. オプションで、必要な任意のカスタム・メタデータ値(xで始まる)をこのリストに追加します。

      たとえば、「メタデータ・リスト」の次のエントリには、カスタム属性が含まれています。

      dFormat,dID,dDocName,dDocType,dDocAccount,dSecurityGroup,dOriginalName,dReleaseDate,dDocAuthor,dDocCreator,dDocCreatedDate,dOutDate,xCollectionID,xWCTags,xComments,xRegionDefinition


    関連項目:

    • 検索結果におけるMIMEタイプの表示については、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドの属性および絞込み機能による検索結果のカスタマイズに関する項を参照してください。

    • Content Server構成の詳細は、製品に付属のDeployment Guide.pdfを参照してください。


22.5.2 Oracle SES検索のためのOracle WebCenter Portalのディスカッション・サーバーの設定

この項では、Oracle SESによりクロール可能となるようにOracle WebCenter Portalのディスカッション・サーバー(特に、WebCenter Portalがディスカッションおよびお知らせの格納に使用するディスカッション・サーバー)を構成する方法について説明します。


注意:

WebCenter Portal (Oracleデータベースを含む)およびOracle WebCenter Portalのディスカッション・サーバーの新しいインストールがある場合は、この手順は必要ありません。この手順は、アップグレードされた(パッチが適用された)インスタンスを使用している場合にのみ必要となります。

該当するデータ・ソースのデータベース・スキーマの詳細は、Oracle WebLogic Serverコンソールから検索できます。


  1. リポジトリ作成ユーティリティ(RCU)を実行して、ディスカッション・クローラのWebCenter Portalコンポーネントがシステムにインストールされていることを確認します。

    • Oracleデータベース:

      MyPrefix_DISCUSSIONSユーザーがRCUにインストールされていることを確認することによって、Oracle WebCenter Portalのディスカッション・サーバーのバック・エンドが適切に構成されていることを検証します。

      MyPrefix_DISCUSSIONS_CRAWLERユーザーがRCUにインストールされていることを確認することによって、ディスカッション・クローラが適切に混成されていることを検証します。

    • Microsoft SQL Serverデータベース:

      MyPrefix_DISCUSSIONSユーザーがRCUにインストールされていることを確認することによって、Oracle WebCenter Portalのディスカッション・サーバーのバック・エンドが適切に構成されていることを検証します。

      MyPrefix_DISCUSSIONS_CRAWLERユーザーがRCUにインストールされていることを確認することによって、ディスカッション・クローラが適切に混成されていることを検証します。

    • IBM DB2データベース:

      MyPrefix_DSユーザーがRCUにインストールされていることを確認することによって、Oracle WebCenter Portalのディスカッション・サーバーのバック・エンドが適切に構成されていることを検証します。

      MyPrefix_DCユーザーがRCUにインストールされていることを確認することによって、ディスカッション・クローラが適切に混成されていることを検証します。


      注意:

      IBM DB2データベースの場合、MyPrefixは5文字に制限されます。IBM DB2では、認証にオペレーティング・システム・ユーザーが使用されます(つまり、データベース・ユーザーは実質的にはオペレーティング・システム・ユーザーです)。オペレーティング・システムによっては、ユーザー名に8文字の制限があるため、これは8文字のユーザー名にする必要があります。


    ディスカッション・クローラ・コンポーネントがインストールされていない場合、RCUを使用してこれをインストールする必要があります。このとき、接頭辞は、Oracle WebCenter Portalのディスカッション・サーバー・コンポーネントと同じものを選択します。また、RCUでのテーブルスペースの指定手順で、デフォルトのテーブルスペースとしてPrefix_IAS_DISCUSSIONSを選択します。これにより、Oracle SESのユーザーがインストールされます。

    詳細は、第7章「WebCenter Portal: Frameworkアプリケーションのデプロイ」を参照してください。

  2. 次のツールを実行して(まだ実行していない場合)、Oracle WebCenter Portalのディスカッション・サーバー・データベース・スキーマ内のデータをアップグレードします。

    java -jar \
    $MW_HOME/discussionserver/discussionserver-upgradeforses.jar \
    <command_line_parameters>
    

    ここでcommand_line_parametersは、次のMDSスキーマの詳細とディスカッション・データベース・スキーマの詳細です。

    -mds_jdbc_user user_id \ 
    -mds_jdbc_password password \
    -mds_jdbc_url url \
    -discussions_jdbc_user user_id \
    -discussions_jdbc_password password \
    -discussions_jdbc_url url
    

    ここでmds_jdbc_usermds_jdbc_passwordおよびmds_jdbc_urlは、MDSスキーマにログインするための値で、discussions_jdbc_userdiscussions_jdbc_passwordおよびdiscussions_jdbc_urlは、ディスカッション・データベース・スキーマにログインするための値です。

    次に例を示します。

    java -jar $MW_HOME/as11r1wc/discussionserver/discussionserver-upgradeforses.jar\
    -mds_jdbc_user foo \ 
    -mds_jdbc_password welcome1 \ 
    -mds_jdbc_url jdbc:oracle:thin:@host:port:SID \
    -discussions_jdbc_user foo \ 
    -discussions_jdbc_password welcome1 \ 
    -discussions_jdbc_url jdbc:oracle:thin:@host:port:SID
    

22.5.3 WebCenter Portalを検索するためのOracle SESの設定

この項の手順は、Oracle SES管理ツールで実行する必要があります。

次の手順が必要です。

  1. 第22.5.3.1項「Oracle SES管理ツールへのログオン」

  2. 第22.5.3.2項「ドキュメントを検索するためのOracle SESの設定」

  3. 第22.5.3.3項「ディスカッションおよびお知らせを検索するためのOracle SESの設定」

  4. 第22.5.3.4項「追加のOracle SES構成」


関連項目:

Oracle SESに必要なすべてのパッチがインストールされていることを確認します。必要なパッチの最新情報は、Oracle Fusion Middleware Oracle WebCenter Portalインストール・ガイドの検索サービスのバックエンド要件に関する項およびリリース・ノードを参照してください。

Oracle SES構成の詳細は、製品に付属のOracle SESドキュメントを参照してください。(これらは、Oracle Fusion Middlewareドキュメント・ライブラリのWebCenter Portal製品の領域にリストされています。)


22.5.3.1 Oracle SES管理ツールへのログオン

Oracle SES管理ツールを開きます。

  1. ブラウザを開き、インストール後に指定されたURLを入力します。(これは、http://host:port/search/admin/index.jspの形式となります。)

  2. Oracle SES管理ユーザー名eqsysとインストール時に指定されたパスワードでログオンします。

22.5.3.2 ドキュメントを検索するためのOracle SESの設定

Oracle SESを使用してWebCenter Portalドキュメントを検索するには、まずドキュメント・サービス・マネージャを(ドキュメント・サービス・インスタンスおよびドキュメント・サービス・パイプラインとともに)設定してから、Content Serverソースを作成する必要があります。

  1. ドキュメント・サービス・マネージャを構成します(Oracle SESインスタンスごとに1回)。


    注意:

    ドキュメント・サービスは、ドキュメントがクロールされる際のドキュメントの処理に関与するプラグインです。ドキュメント・サービスにより、アプリケーションで使用されるドキュメントに索引付け可能な属性をWebCenter Portalで追加できるようになります。

    検索属性名は一意である必要があります。2つの属性に同じ名前を使用することはできません。たとえば、属性が文字列のデータ型で存在する場合に、名前が同じで異なるデータ型の別の属性がクローラにより検出されると、そのクローラは2番目の属性を無視します。新しい属性を作成する前に、Oracle SESドキュメント内のOracle SES属性名とタイプのリストを必ず確認してください。


    1. 「グローバル設定」→「ドキュメント・サービス」ページで、「作成」をクリックします。「新規マネージャの作成」を選択し、「次へ」をクリックして次のパラメータを入力します。

      マネージャ・クラス名: oracle.webcenter.search.crawl.ucm.ses.WcUcmDsManager

      マネージャJARファイル名: search-crawl-ucm.jar


      注意:

      webcenter_search_ses_plugins.zipファイルによりOracle_Home/search/lib/plugins/doc/search-crawl-ucm.jarがインストールされます。


      「次へ」をクリックして、「終了」をクリックします(図22-13)。

      図22-13 Oracle SESでのドキュメント・サービス・マネージャの作成

      図22-13の説明が続きます
      「図22-13 Oracle SESでのドキュメント・サービス・マネージャの作成」の説明

    2. ドキュメント・サービス・インスタンスを作成します。

      再度、「グローバル設定」→「ドキュメント・サービス」ページで、「作成」をクリックします。今回は、「利用可能なマネージャから選択」「Secure Enterprise Search WebCenter UCMプラグイン」を選択し、「次へ」をクリックします(図22-14)。

      図22-14 ドキュメント・サービスの作成

      図22-14の説明が続きます
      「図22-14 ドキュメント・サービスの作成」の説明

      インスタンス名の入力に加えて、次のパラメータも入力します。

      WebCenterアプリケーション名: これは空白のままにする必要があります。

      接続名: WebCenter PortalアプリケーションのContent Server接続名です。

      WebCenter URL接頭辞: WebCenter Portalアプリケーションがデプロイされるホストおよびポート、並びにコンテキスト・ルート。例: http://myhost:8888/DocumentServer。ここで、DocumentServerはアプリケーションのコンテキスト・ルートです。

    3. ドキュメント・サービス・パイプラインを作成します。これによりドキュメント・サービス・インスタンスが呼び出されます。

      再度、「グローバル設定」→「ドキュメント・サービス」ページで、「ドキュメント・サービス・パイプライン」セクションの下の「作成」をクリックします。

      名前を入力して前の手順で作成したインスタンスを選択します。

  2. ドキュメントのContent Serverソースを作成します。

    1. 「ホーム」→「ソース」に移動します。

    2. 「ソース・タイプ」ドロップダウン・リストで、「Oracle Content Server」を選択し、「作成」(図22-15)をクリックします。

      図22-15 Oracle Content Serverソースの作成

      図22-15の説明が続きます
      「図22-15 Oracle Content Serverソースの作成」の説明

    3. 次のパラメータを入力します。

      ソース名: unique_name

      構成URL: Content_Server_SES_Crawler_Export_endpoint (例: http://host:port/cs/idcplg?IdcService=SES_CRAWLER_DOWNLOAD_CONFIG&source=default)


      注意:

      source=defaultパラメータは、SESクローラ・エクスポートの構成で作成されたソースの名前を示します。デフォルトのソースが作成され、自動的にdefaultと名付けられます。


      認証タイプ:

      Content ServerがSSOで保護されない場合、NATIVEと入力します。

      Content ServerがOracle SSOで保護される場合、ORASSOと入力します。

      ユーザーID: Content Serverをクロールするユーザーには、sceCrawlerRoleロールが定義される必要があります。sceCrawlerRoleは、SESCrawlerExport内の構成パラメータです。一般には、管理者が特別のロールを作成し、これにはコンテンツを表示する権限を割り当てず、このロールを持つユーザー・アカウントを作成します。

      特定のsceCrawlerRoleを設定しない場合、クロールには管理資格証明が必要です。sysadminユーザーIDはデフォルトで機能します。

      認証タイプがORASSOの場合、Oracle SSOが前面に来るアイデンティティ管理サーバー内のユーザーのID (およびパスワード)を入力します。このユーザーには、sysadminと同じ権限が付与される必要があります。これらの権限を付与できない場合は、このユーザーに対応するContent Server内のリモート・ユーザーを削除し、Content Server内で(同じ名前の)ローカル・バージョンのユーザーを作成します。

      パスワード: このContent Serverユーザーのパスワード。

      レルム:

      認証タイプがNATIVEの場合、Idc Security /cs/idcplgと入力します。ここで/cs/は、Content Serverのインストール時に指定したコンテキスト・ルートです。

      認証タイプがORASSOの場合、このパラメータは空白のままにします。

      スクラッチ・ディレクトリ: オプション。Oracle SESインスタンスが配置されるシステム上のディレクトリを指定します。

      Oracle SSOログインURL:

      認証タイプがORASSOの場合、Oracle SSOの値を指定します。例: https://login.oracle.com/mysso/signon.jsp?site2pstoretoken=

      認証タイプがNATIVEの場合、このフィールドは空白のままにします。

      Oracle SSOアクションURL:

      認証タイプがORASSOの場合、Oracle SSOの値を指定します。例: https://login.oracle.com/sso/auth

      認証タイプがNATIVEの場合、このフィールドは空白のままにします。

      「次へ」をクリックします(図22-16)。

      図22-16 Oracle Content Serverソースのパラメータ

      図22-16の説明が続きます
      「図22-16 Oracle Content Serverソースのパラメータ」の説明

    4. 「ユーザー定義ソースの作成 : ステップ2 : 認可」ページの「認可マネージャ」セクションで次のパラメータを入力します(デフォルトで入力されていない場合)。

      プラグイン・クラス名: oracle.search.plugin.security.auth.stellent.StellentAuthManager

      Jarファイル名: oracleapplications/StellentCrawler.jar

      認可用HTTPエンドポイント: 例: http://host:port/cs/idcplg

      表示URL接頭辞: 例: http://host:port/cs

      認証タイプ: NATIVEまたはORASSO

      管理者ユーザー: Content Serverをクロールするユーザーには、sceCrawlerRoleロールが定義される必要があります。sceCrawlerRoleは、SESCrawlerExport内の構成パラメータです。一般には、管理者が特別のロールを作成し、これにはコンテンツを表示する権限を割り当てず、このロールを持つユーザー・アカウントを作成します。特定のsceCrawlerRoleを設定しない場合、クロールには管理資格証明が必要です。sysadminユーザーIDはデフォルトで機能します。

      認証タイプがORASSOの場合、Oracle SSOが前面に来るアイデンティティ管理サーバー内のユーザーのID (およびパスワード)を入力します。このユーザーには、sysadminと同じ権限が付与される必要があります。これらの権限を付与できない場合は、このユーザーに対応するContent Server内のリモート・ユーザーを削除し、Content Server内で(同じ名前の)ローカル・バージョンのユーザーを作成します。

      管理者のパスワード: クロール管理ユーザーのパスワード

      認可ユーザーID形式: アクティブなアイデンティティ・プラグインで使用される認証属性。この値を参照するには、Oracle SESの「グローバル設定」→「アイデンティティ管理設定」ページに進みます。「アクティブ・プラグイン」の下の「認証属性」の値を入力します(例: nicknameusernameなど)。Oracle E-Business Suite R12アイデンティティ・プラグインを使用している場合は、このパラメータは空白のままにします。

      レルム:

      認証タイプがNATIVEの場合、Idc Security /cs/idcplgと入力します。ここで/cs/は、Content Serverのインストール時に指定したコンテキスト・ルートです。

      認証タイプがORASSOの場合、このフィールドは空白のままにします。

    5. 「作成およびカスタマイズ」をクリックして(または作成したソースを編集して)、その他のソース・パラメータを参照します。「クロール・パラメータ」タブで、Document Service Pipelineと入力します。

    6. 「有効化」をクリックして作成したパイプラインを選択します。

22.5.3.3 ディスカッションおよびお知らせを検索するためのOracle SESの設定

Oracle SESを使用してWebCenter Portalのディスカッションとお知らせを検索するには、まず、ディスカッション用とお知らせ用の2つのOracle SESデータベース・ソースを設定する必要があります。たとえば、ディスカッションのソースには、ソース名GS_DiscussionsおよびFORUMCRAWLER_VWのビューが設定され、お知らせのソースには、ソース名GS_AnnouncementsおよびANNOUNCEMENTS_VWのビューが設定されます。


注意:

Oracle、Microsoft SQL ServerおよびIBM DB2データベースでは、手順が多少異なります。


  1. JDBCドライバを構成します。

    1. Microsoft SQL ServerまたはIBM DB2データベースをクロールするには、適切なJDBCドライバjarファイルをOracle SESのORACLE_HOME/search/lib/plugins/oracleapplicationsディレクトリにダウンロードします。


      注意:

      • Microsoft SQL Serverの場合: Microsoft JDBCドライバ・ファイル、sqljdbc.jarおよびsqljdbc4.jarをコピーします。

      • IMB DB2の場合: IBMドライバ・ファイル、db2jcc.jarおよびdb2jcc_license_cu.jarをコピーします(IBM DB2 UDBクライアントから取得可能)。


      JDBCドライバがJRE 1.5用とJRE 1.6用で異なる場合(たとえば、JRE 1.5ではsqljdbc.jar、JRE 1.6ではsqljdbc4.jarなど)、次の手順を実行します。

      - 両方のドライバJarをOracle SESのORACLE_HOME/search/lib/plugins/oracleapplicationsディレクトリにダウンロードします。

      - JRE 1.6バージョンのドライバJar (SQLServerの場合sqljdbc4.jar)のエントリを、ORACLE_HOME/search/config/searchctl.confCLASSPATH要素に追加します。

      - 中間層を再起動します。

    2. drivers.propertiesファイルをDatabaseName:DriverClassNameの情報を使用して更新します。

    3. JRE 1.5 JDBCドライバJarファイル名を、appsjdbc.jarおよびDBCrawler.jarMETA-INF/MANIFEST.MF内のクラスパスに追加します。

      例: 変更前

      Class-Path:  sqljdbc.jar rsscrawler.jar  ../../pluginmessages.jar
      

      変更後

      Class-Path:  db2jcc.jar sqljdbc.jar rsscrawler.jar  ../../pluginmessages.jar
      

      変更前

      Class-Path: appsjdbc.jar
      

      変更後

      Class-Path: db2jcc.jar appsjdbc.jar
      

    KEYという名前が付けられていないkey属性の場合、drivers.propertiesファイル内のJDBCドライバ情報を変更して、database_name: driver_class_name, key_attribute_nameのようにキー属性名を指定します。

    たとえば、IDという名前のキー属性の場合、次のようになります。

    oracle : oracle.jdbc.driver.OracleDriver, ID
    

    クロール問合せでは、キー値列名の別名としてkey_attribute_nameを使用します。この例で、IDKEYVALの別名です。

    SELECT keyval id, content, url, lastmodifieddate, lang FROM sales_only
    

    OracleおよびSQL Serverデータベース: drivers.propertiesになにも指定されていない場合、次のデフォルト・ドライバが使用されます。

    • Oracle: oracle.jdbc.driver.OracleDriver

    • SQL Server: com.microsoft.sqlserver.jdbc.SQLServerDriver

  2. IBM DB2データベースの場合のみ、次の手順が必要となります。

    1. データベース・クローラ・ソースを使用するクローラが実行されていないことを確認します。Oracle SES管理ツールの「ホーム」→「スケジュール」ページで、クローラの進捗状況とステータスを確認します。(「ステータスのリフレッシュ」をクリックします。)

    2. appsjdbc.jarファイルとDBCrawler.jarファイルを再作成します。META-INF/MANIFEST.MFが正しく更新されたことを確認してください。正しく更新されない場合、クローラは失敗し、クローラのログ・ファイルに次のエラーが記録されます。

      EQP-80406: Loading JDBC driver failed
      
    3. Oracle_Home/search/lib/plugins/oracleapplications/drivers.propertiesファイルを変更して次の行を追加します。

      db2: com.ibm.db2.jcc.DB2Driver
      
    4. ORACLE_HOME/search/config/searchctl.confCLASSPATH要素にドライバJar (db2jcc.jar)を追加します。次に例を示します。

      #CLASS PATH
      CLASSPATH=ORACLE_HOME/search/webapp/config:ORACLE_HOME/search/webapp/
      SESAuthenticator.jar:ORACLE_HOME/search/lib/plugins/commons-plugins-
      stubs.jar :ORACLE_HOME /search/lib/plugins/oracleapplications/db2jcc.jar
      
    5. $ORACLE_HOME/search/config/searchctl.confファイルのJVM_OPTIONSを編集して、システム・プロパティ"-Doracle.home=ORACLE_HOME/search"を追加します。次に例を示します。

      JVM_OPTIONS= -Djava.awt.headless=true
      -Dweblogic.RootDirectory=ORACLE_HOME/search/base_domain
      -Doracle.home=ORACLE_HOME/search
      
    6. $ORACLE_HOME/search/lib/plugins/oracleapplications/pluginmessages.jarファイルを$ORACLE_HOME/search/libディレクトリにコピーします。

    7. データベース・ソースを作成します。正しい認可問合せを入力し、「セキュリティ属性の付与」で使用した属性名が認可問合せで使用する属性名と一致していることを確認します。一致していない場合、ドキュメントの検索の際、ユーザーは結果を得ることができません。

  3. ディスカッション・ソースまたはお知らせソースを作成します。

    1. Oracle SESで、「ホーム」→「ソース」に進みます。

    2. 「ソース・タイプ」ドロップダウン・リストで、「データベース」を選択し、「作成」(図22-17)をクリックします。

      図22-17 データベース・ソースの作成

      図22-17の説明が続きます
      「図22-17 データベース・ソースの作成」の説明

    3. 次のパラメータを入力します。

      ソース名: unique_name。たとえば、ディスカッションをクロールする場合、GS_Discussions(お知らせをクロールする場合は、GS_Announcements)。

      データベース接続文字列: 次のいずれかを入力します。

      - Oracleデータベース: 次のいずれかを入力します。

      jdbc:oracle:thin:@host:port:sid

      jdbc:oracle:thin@host:port/serviceId

      - IBM DB2データベース: jdbc:db2://host:port/database_nameと入力します。

      - Microsoft SQL Serverデータベース: jdbc:sqlserver://host_or_IP_address:port;database_nameと入力します。

      ユーザーID: 次のいずれかを入力します。

      - Oracleデータベース: Oracle WebCenter Portalのディスカッション・サーバーのインストール時に作成されたユーザーMyPrefix_DISCUSSIONS_CRAWLER

      - Microsoft SQL Serverデータベース: Oracle WebCenter Portalのディスカッション・サーバーのインストール時に作成されたユーザーMyPrefix_DISCUSSIONS_CRAWLER

      - IBM DB2データベース: Oracle WebCenter Portalのディスカッション・サーバーのインストール時に作成されたユーザーMyPrefix_DC(MyPrefixは5文字)

      パスワード: このユーザーのパスワード。

      問合せ: 次のいずれかの問合せを入力します。

      SELECT * FROM FORUMCRAWLER_VW
      SELECT * FROM ANNOUNCECRAWLER_VW
      

      ソース・クロール・ディスカッション・フォーラムには、FORUMCRAWLER_VWを使用します。

      ソース・クロールお知らせには、ANNOUNCECRAWLER_VWを使用します。

      URL接頭辞: ホスト、ポートおよびアプリケーション名を含むWebCenter PortalアプリケーションのURL接頭辞。たとえば、http://host:port/webcenterのようになります。

      「セキュリティ属性の付与」: WCSECATTR


      注意:

      以前のリリースのContent Serverでは、「セキュリティ属性の付与」FORUMIDが使用されていました。


    4. 「次へ」をクリックします。

    5. 「ユーザー定義ソースの作成 : ステップ2 : 認可」ページの「認可マネージャ」セクションで次のパラメータを入力します(事前に移入されていない場合)。

      プラグイン・クラス名: oracle.search.plugin.security.auth.db.DBAuthManager

      Jarファイル名: oracleapplications/DBCrawler.jar

      認可データベース接続文字列: 次のいずれかを入力します。

      - Oracleデータベース: 次のいずれかを入力します。

      jdbc:oracle:thin:@host:port:sid

      jdbc:oracle:thin@host:port/serviceId

      - IBM DB2データベース: jdbc:db2://host:port/database_nameと入力します。

      - Microsoft SQL Serverデータベース: jdbc:sqlserver://host_or_IP_address:port;database_nameと入力します。

      ユーザーID: 次のいずれかを入力します。

      - Oracleデータベース: ユーザーMyPrefix_DISCUSSIONS_CRAWLERを入力します。

      - Microsoft SQL Serverデータベース: ユーザーMyPrefix_DISCUSSIONS_CRAWLERを入力します。

      - IBM DB2データベース: ユーザーMyPrefix_DC (MyPrefixは5文字)を入力します。

      パスワード: このユーザーのパスワード

      単一レコード問合せ: false

      認可問合せ: (1行で)次を入力します。

      SELECT DISTINCT forumID as WCSECATTR 
      FROM AUTHCRAWLER_FORUM_VW 
      WHERE username = ? UNION SELECT DISTINCT -1 as WCSECATTR 
      FROM AUTHCRAWLER_FORUM_VW
      

      注意:

      以前のリリースのContent Serverでは、次の認可問合せが使用されていました。

      SELECT forumID 
      FROM AUTHCRAWLER_FORUM_VW 
      WHERE (username = ? or userID=-1) 
      UNION SELECT f.forumID 
      FROM jiveForum f, AUTHCRAWLER_CATEGORY_VW c 
      WHERE f.categoryID = c.categoryID AND (c.username =  ? or userID=-1) 
      

      認可ユーザーID形式: アクティブなアイデンティティ・プラグインで使用される認証属性。この値を参照するには、Oracle SESの「グローバル設定」→「アイデンティティ管理設定」ページに進みます。「アクティブ・プラグイン」の下の「認証属性」の値を入力します(例: nicknameusernameなど)。

      Oracle E-Business Suite R12アイデンティティ・プラグインを使用している場合は、このパラメータは空白のままにします。

    6. 「作成」をクリックしてソースの作成を完了します。

22.5.3.4 追加のOracle SES構成

この項では、Oracle SES管理ツールで必要な手順について説明します。

  1. Content Server、ディスカッション、お知らせおよびWebCenter Portalサービスの作成したソースの名前を含む、ソースグループを作成します。

    1. 「検索」→「ソース・グループ」に進み、「作成」をクリックします。

    2. 第22.5.4項「Oracle SES検索のためのWebCenter Portal: Frameworkの設定」で入力したのと同じソース・グループ名を入力します。

    3. 「ソース・タイプの選択」ドロップダウン・リストから、各ソース・タイプ(Database、Oracle Content Server、Oracle WebCenter)を選択し、各ソース・タイプに対してリストされた「使用可能なソース」から、そのソース・タイプに対して作成したソースを「割り当てられたソース」リストに移動します。

    4. 「完了」をクリックします。

  2. 必要に応じてセキュリティ・フィルタ有効期間を構成します。これにより、システム内のユーザーの認可ポリシーがリフレッシュされます。ユーザー・ポリシーが頻繁に変更される場合は、有効期間を短くすることをお薦めします。(この章では、例としてOracle Internet Directoryアイデンティティ・プラグインを使用します。)

    たとえば、「グローバル設定」→「問合せ構成」ページの「セキュア検索の構成」の下で、「セキュリティ・フィルタ有効期間(分)」0を入力します。

    セキュリティ・フィルタ有効期間の有効な値は、0分(キャッシュなし)から526500分(1年間のキャッシュ)です。

  3. すべてを索引付けするには、各ソースに対してフル・クロールを強制する必要があります。つまり、各ソースの既存の増分クロール・スケジュールを、まずすべてのドキュメントを処理するように変更する必要があります。

    この手順は非常に重要で、これで、コンテンツが最初に完全に索引付けされるまで、検索が機能しなくなります。

    「ホーム」→「スケジュール」ページに進み、ソース・スケジュールを選択して「編集」をクリックし、フル・クロールを強制します。

    各ソースのクロールが完了したら、同じページに戻り、クロール・ポリシーを増分(前回のクロール以降に変更されたドキュメントを索引付けする)に戻します。また、このページの「頻度」セクションで、増分クロールの実行に手動以外のタイプ(毎週、毎日など)を選択します。


    注意:

    Content Serverの最初のクロールの前に、Content Serverの「管理」ページに進み、「SESクローラ・エクスポート」を選択してスナップショットを撮ることを忘れないでください。詳細は、第22.5.1項「Oracle SES検索のためのOracle WebCenter Portal: Content Serverの設定」を参照してください。


22.5.4 Oracle SES検索のためのWebCenter Portal: Frameworkの設定

この項では、Oracle SESと連動するようWebCenter Portal: Frameworkを構成する方法について説明します。

フェデレーション・トラステッド・エンティティを指定し、オプションとしてソース・グループを指定して、WebCenter PortalとOracle SES間の接続を作成および構成済であることを確認してください。

Oracle SESクローラは、Frameworkアプリケーションでデフォルトで有効にされています。


関連項目:

『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』の検索サービスの接続の設定に関する項


22.5.4.1 デプロイ後のFrameworkアプリケーションの構成

FrameworkアプリケーションがOracle WebLogic管理対象サーバーにデプロイされたら、WLSTまたはFusion Middleware Controlを使用してそれを構成できます。この項の内容は次のとおりです。

22.5.4.1.1 WLSTを使用した検索パラメータの変更

WLSTコマンドのsetSearchConfigを使用して、デプロイ後に検索パラメータを変更します。

例22-2は、Oracle SESを検索するデータ・グループ(ソース・グループとも呼ばれる)を指定する方法を示しています。

例22-2 ソース・グループの設定

setSearchSESConfig(appName='webcenter',
                   dataGroup='MySources')

ここで、dataGroupは、第22.5.3.4項「追加のOracle SES構成」(Frameworkアプリケーション用)または第22.6.4.6項「追加のOracle SES構成」(Spacesアプリケーション用)で作成するソース・グループです。

例22-3は、表示される検索結果数を増加させる方法を示しています。Oracle SESの結果で表示される検索結果数のデフォルトの設定は5ですが、一般的に設定される結果数は5より大きくなります。

例22-3 表示される検索結果数の増加

setSearchConfig(appName='webcenter',
                numResultsMain=10)

例22-4は、サービスが検索を実行するために許可される最大時間(ミリ秒)を構成する方法を示しています。サービスがいつタイムアウトするかは、主にシステムの負荷に依存します。常にタイムアウト・エラーが生じる場合は、このパラメータを調整してください。

例22-4 WebCenterで検索結果を待機する最大時間の構成

setSearchConfig(appName='webcenter',
                executionTimeout=10000)

コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetSearchConfigに関する項を参照してください。

22.5.4.1.2 WLSTを使用した検索クローラの構成

WLSTコマンドを使用して、デプロイ後にクローラを作成したり、クローラのスケジュールを開始、停止および削除できます。これらのコマンドでは、Oracle SES内の新しいデータをクロールしたり、構成データが変更されると古いクローラを削除できます。

例22-5例22-6は、これらのコマンドの一部を示しています。詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』の検索: Oracle SES検索クローラに関する項を参照してください。

例22-5 WLSTでのドキュメント・クローラの作成

createDocumentsCrawler(
'portal', 'portal_host', 'portal_port',
'http://ses-host:ses-port/search/api/admin/AdminService', 'ses-admin-pw',
'http://ucm-host:ucm-port/cs/idcplg?IdcService=
SES_CRAWLER_DOWNLOAD_CONFIG&source=default', 'ucm-crawl-user',
'ucm-crawl-user-pw', '/tmp',
'http://ucm-host:ucm-port/cs/idcplg', 'http://ucm-host:ucm-port/cs',
'Idc Security /cs/idcplg', 'authentication-id-format', 'Document-pipeline',
'ACCEPT_ALL', 'PROCESS_CHANGED', 'MANUAL', 1, 1, 'MONDAY', 1, 1, 1, 1)

各要素の意味は次のとおりです。

  • portal = この操作を実行するFrameworkアプリケーションの名前

  • portal_host = Frameworkアプリケーションを実行するシステムのホスト名

  • portal_port = Frameworkアプリケーションにアクセスするために使用されるポート番号

  • ses-host = Oracle SESホスト名

  • ses-port = Oracle SESポート番号

  • ses-admin-pw = Oracle SES管理ユーザー・パスワード

  • ucm-host = Content Serverホスト名

  • ucm-port = Content Serverポート番号

  • ucm-crawl-user = Content Serverクロール・ユーザー名

  • ucm-crawl-user-pw = Content Serverクロール・ユーザー・パスワード

  • authentication-id-format = Oracle SES上のアイデンティティ管理プラグインがOracle Internet Directoryに設定されている場合は、ニックネームを使用します。それ以外の場合は、Oracle SES上のアイデンティティ管理プラグインの「認証属性」パラメータの値を使用します。

  • Document-pipeline = このFrameworkインスタンスのために作成されたOracle SES上のドキュメント・パイプライン

例22-6 WLSTでのディスカッション・クローラの作成

createDiscussionsCrawler(
'webcenter','webcenter_host','webcenter_port',
'http://ses-host:ses-port/search/api/admin/AdminService', 'ses-admin-pw',
'jdbc:oracle:thin:@database-host:database-port:database-sid',
'Jive-crawler-schema','Jive-crawler-schema-pw', 'authentication-id-format',
'ACCEPT_ALL', 'PROCESS_ALL', 'MANUAL', 1, 1, 'MONDAY', 1, 1, 1, 1)

各要素の意味は次のとおりです。

  • webcenter_host = Frameworkアプリケーションのホスト名

  • webcenter_port = Frameworkアプリケーションのポート番号

  • ses-host = Oracle SESホスト名

  • ses-port = Oracle SESポート番号

  • ses-admin-pw = Oracle SES管理ユーザー・パスワード

  • database-host = ディスカッション・サーバー・データベースのホスト名

  • database-port = ディスカッション・サーバー・データベースのポート番号

  • database-sid = ディスカッション・サーバー・データベース名またはSID

  • Jive-crawler-schema = ディスカッション・サーバー・クローラのスキーマ名。RCUから接頭辞を決定し、rcu-prefix_DISCUSSION_CRAWLERを使用します。

  • Jive-crawler-schema-pw = ディスカッション・サーバー・クローラのスキーマ・パスワード

  • authentication-id-format = Oracle SES上のアイデンティティ管理プラグインがOracle Internet Directoryに設定されている場合は、ニックネームを使用します。それ以外の場合は、Oracle SES上のアイデンティティ管理プラグインの「認証属性」パラメータの値を使用します。


注意:

WLSTの変更を反映させるには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。


22.5.4.1.3 Fusion Middleware Controlを使用した検索パラメータとクローラの構成

Fusion Middleware Controlを使用して、Oracle SES検索を有効化または無効化したり、検索設定を構成できます。

  1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、第6.2項「スペース・アプリケーションのホームページへの移動」または第6.3項「Frameworkアプリケーションのホームページへの移動」を参照してください。

  2. 「WebCenterポータル」メニューから、「設定」「アプリケーション構成」を選択します。

  3. Oracle SESアダプタまたはデフォルトのWebCenter Portalアダプタを有効にするよう選択し、「適用」をクリックします(図22-18)。

    必要に応じて検索パラメータを構成できます。

    • Oracle Secure Enterprise Searchデータ・グループ: 検索するOracle SESソース・グループを指定します。値を指定しない場合、Oracle SESインスタンス内のすべてが検索されます。

    • 実行タイムアウト: サービスが検索を実行できる最大時間(ミリ秒単位)を入力します。

    • 実行者の準備タイムアウト: サービスが検索を初期化できる最大時間(ミリ秒単位)を入力します。

    • サービス当たりの結果数 - 保存済検索タスク・フロー: 保存済検索タスク・フローに表示される、サービス当たりの検索結果数を入力します。

    • サービス当たりの結果数 - 検索ページ: メインの検索ページから送信された検索に対して、サービスごとに表示する検索結果の数を入力します。すべての結果を表示する場合、ユーザーは「すべて表示」をクリックできます。

    • 検索ページの保存済の検索の数: 「保存済検索」リスト(メインの検索ページ上)に表示する保存済検索の数を入力します。

    Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要はありません

    図22-18 Oracle検索のアプリケーション設定

    図22-18の説明が続きます
    「図22-18 Oracle検索のアプリケーション設定」の説明

22.6 Spacesアプリケーションを検索するためのOracle SESの構成

Spacesアプリケーションで、WebCenter Portal内部のライブ検索アダプタは、デフォルトの検索プラットフォームとして設定されています。ただし、大規模な実装では最適なパフォーマンスのためにOracle SESを使用するよう構成する必要があります。


注意:

Oracle SESをSpacesアプリケーションの検索エンジンとして有効化するために実行する必要のあるタスクの概要は、第22.2項「WebCenter PortalでのOracle SESの構成ロードマップ」を参照してください。必要なタスクを実行するためにふさわしい方法や順序が多数ある場合もあります。


この項では、Spacesを検索するようOracle SESを設定する手順について説明します。

22.6.1 Oracle SES検索のためのWebCenter Portal: Spacesの設定

この項では、Oracle SESと連動するようWebCenter Portal: Spacesを構成する方法について説明します。

  1. SpacesとOracle SES間の接続を作成および構成し、オプションとしてソース・グループを指定します。

  2. Oracle SESを使用してスペース、リストまたはページを検索するには、まずWebCenter Portal: Spacesおよびバックエンドのアイデンティティ管理サーバー(mycrawladminなど)で、クロール管理ユーザーを作成する必要があります。クロール管理ユーザーは一度だけ作成する必要があります。


    注意:

    ユーザーの作成方法の詳細は、ご使用のアイデンティティ管理システムのドキュメントを参照してください。


    次の例では、Oracle Directory Services Managerを使用してmycrawladminユーザーを作成します。

    1. 「データ・ブラウザ」タブで、ターゲットcnに移動し、「作成」をクリックします。この例では、「dc=com,dc=oracle,dc=us,cn=Users」に移動します。「オブジェクト・クラスの追加」ダイアログで、該当するオブジェクト・クラスを選択し、「OK」をクリックします(図22-19)。

      図22-19 Oracle Directory Services Manager - 「オブジェクト・クラスの追加」

      図22-19の説明が続きます
      「図22-19 Oracle Directory Services Manager - 「オブジェクト・クラスの追加」」の説明

    2. 識別名(DN)パスを見つけて、「選択」(図22-20)をクリックします。この例では、「dc=com,dc=oracle,dc=us,cn=Users」を選択します。

      図22-20 Oracle Directory Services Manager - DNパスの選択

      図22-20の説明が続きます
      「図22-20 Oracle Directory Services Manager - DNパスの選択」の説明

    3. 「新規エントリの作成」ダイアログで、プロパティを入力し、「次へ」をクリックします(図22-21)。

      図22-21 Oracle Directory Services Manager - 「新規エントリの作成」

      図22-21の説明が続きます
      「図22-21 Oracle Directory Services Manager - 「新規エントリの作成」」の説明

    4. 新規エントリが正常に作成されたことを確認したら、「終了」をクリックします(図22-22)。

      図22-22 Oracle Directory Services Manager - 「ステータス」

      図22-22の説明が続きます
      「図22-22 Oracle Directory Services Manager - 「ステータス」」の説明

  3. WebCenter Portal: Spacesのクロール・アプリケーション・ロールを作成します。

    1. 次のコマンドを使用して、クロール・アプリケーション・ロールが存在するかどうかを確認します。

      listAppRoles(appStripe='webcenter')
      

      コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のlistAppRolesに関する項を参照してください。

      リストは非常に長くなる場合があります。結果内でプリンシパル名としてwebcenter#-#defaultcrawlを検索してください。次に例を示します。

        [ [Principal Clz Name : 
      oracle.security.jps.internal.core.principals.JpsApplicationRoleImpl, 
      Principal Name :webcenter#-#defaultcrawl, Type : APP_ROLE], Display Name : 
      Crawl Role. This role never gets updated by webcenter UIs., Description : 
      null, Guid : DA91B6572AF911DFBF70237926348A3B]
      

      webcenter#-#defaultcrawlが存在しない場合、次のWLSTコマンドを使用してクロール・アプリケーション・ロールを作成する必要があります。

      createAppRole(appStripe='webcenter', 
                    appRoleName='webcenter#-#defaultcrawl');
      

      コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のcreateAppRoleに関する項を参照してください。

      その後Spacesコンテンツにview権限を付与します。

      grantPermission(appStripe="webcenter",
      principalClass="oracle.security.jps.service.policystore.ApplicationRole",
      principalName="webcenter#-#defaultcrawl",
      permClass="oracle.webcenter.community.model.security.CommunityPermission",
      permTarget="*", 
      permActions="view")
       
      grantPermission(appStripe="webcenter",
      principalClass="oracle.security.jps.service.policystore.ApplicationRole",
      principalName="webcenter#-#defaultcrawl",
      permClass="oracle.webcenter.relationship.model.security.RelationshipPermission", 
      permTarget="*",
      permActions="view")
       
      grantPermission(appStripe="webcenter",
      principalClass="oracle.security.jps.service.policystore.ApplicationRole",
      principalName="webcenter#-#defaultcrawl",
      permClass="oracle.webcenter.list.model.security.ListPermission",
      permTarget="*", 
      permActions="view")
       
      grantPermission(appStripe="webcenter",
      principalClass="oracle.security.jps.service.policystore.ApplicationRole",
      principalName="webcenter#-#defaultcrawl",
      permClass="oracle.webcenter.page.model.security.CustomPagePermission",
      permTarget="*", 
      permActions="view")
       
      grantPermission(appStripe="webcenter",
      principalClass="oracle.security.jps.service.policystore.ApplicationRole",
      principalName="webcenter#-#defaultcrawl",
      permClass="oracle.webcenter.page.model.security.PagePermission",
      permTarget="*", 
      permActions="view")
       
      grantPermission(appStripe="webcenter",
      principalClass="oracle.security.jps.service.policystore.ApplicationRole",
      principalName="webcenter#-#defaultcrawl",
      permClass="oracle.webcenter.note.model.security.NotePermission",
      permTarget="*",
      permActions="view")
       
      grantPermission(appStripe="webcenter",
      principalClass="oracle.security.jps.service.policystore.ApplicationRole",
      principalName="webcenter#-#defaultcrawl",
      permClass="oracle.webcenter.collab.calendar.model.security.EventPermission", 
      permTarget="*", 
      permActions="view")
      

      コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のgrantPermissionに関する項を参照してください。

    2. 第22.3.2項「Oracle SES: 構成」で作成したクロール管理ユーザーにクロール・アプリケーション・ロールを付与します。次に例を示します。

      grantAppRole(appStripe="webcenter",
                   appRoleName="webcenter#-#defaultcrawl",
                   principalClass="weblogic.security.principal.WLSUserImpl",
                   principalName="mycrawladmin");
      

      コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のgrantAppRoleに関する項を参照してください。


      注意:

      WLSTの変更を反映させるには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。


  4. WebCenter PortalでOracle SESクローラを有効にします。

    同じWLSTコマンドを使用して、クローラ・プロパティを設定して(つまり、クローラを有効/無効にして)、Spacesクローラのフル・クロールの間隔を指定できます。デフォルトでは、Spacesクローラのフル・クロールは7日ごとに発生しますが、別の頻度を指定することもできます。(増分クロールはOracle SESで設定されたスケジュールによって開始されます。)

    次に例を示します。

    setSpacesCrawlProperties(appName='webcenter', 
                             fullCrawlIntervalInHours=168, 
                             spacesCrawlEnabled = true, 
                             documentCrawlEnabled=true,          
                             discussionsCrawlEnabled=true)
    

    ノート:

    Oracle SES検索を有効にするには、spacesCrawlEnableddocumentCrawlEnabledおよびdiscussionsCrawlEnabledパラメータは、すべてtrueに設定する必要があります。

    クラスタ化されたインスタンスでは、serverパラメータが追加で必要です。たとえば、server="WC_Spaces1"のようになります。


    次の例は、Spacesが8日ごとにSpacesクローラによりフル・クロールを実行するように指定します。

    setSpacesCrawlProperties(appName='webcenter',fullCrawlIntervalInHours=192)
    

    またWLSTを使用して、フル・クロールの間隔(Spacesクローラ)など、WebCenter Portalの現在のクロール設定を返すようにすることもできます。たとえば、次のコマンドはSpacesの現在のクロール設定を返します。

    getSpacesCrawlProperties(appName='webcenter')
    
    WebCenter Spaces Crawl Properties:
    -----------------
    fullCrawlIntervalInHours: 124
    spacesCrawlEnabled:       true
    documentCrawlEnabled:     true
    discussionsCrawlEnabled:  true
    
  5. listDocumentsSpacesPropertiesコマンドを使用して、バックエンドContent ServerがこのWebCenter Portalアプリケーションを識別するために使用する一意の名前と、WebCenter Portalがドキュメントを保存するために使用するプライマリContent Serverの接続名を特定します。次に例を示します。

    listDocumentsSpacesProperties(appName='webcenter')
    

    レスポンスは次のようになります。

    The Documents Spaces container is "/WebCenter1109"
    The Documents repository administrator is "sysadmin"
    The Documents application name is "WC1109"
    The Documents primary connection is "stxxl18-ucm11g"
    

    注意:

    返されるアプリケーション名とプライマリ接続を記録してください。これらの値は、後で(第22.6.4.2項「ドキュメントを検索するためのOracle SESの設定」で)Oracle SESでドキュメントをクロールするよう設定する際に必要になります。



    注意:

    WLSTの変更を反映させるには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。


22.6.1.1 WLSTを使用した検索パラメータの構成

WLSTコマンドのsetSearchConfigを使用して、検索パラメータを変更します。

例22-7は、Oracle SESを検索するデータ・グループ(ソース・グループとも呼ばれる)を指定する方法を示しています。

例22-7 ソース・グループの設定

setSearchSESConfig(appName='webcenter',
                   dataGroup='MySources')

ここで、dataGroupは、第22.5.3.4項「追加のOracle SES構成」(Frameworkアプリケーション用)または第22.6.4.6項「追加のOracle SES構成」(Spacesアプリケーション用)で作成するソース・グループです。

例22-8は、表示される検索結果数を増加させる方法を示しています。Oracle SESの結果で表示される検索結果数のデフォルトの設定は5ですが、一般的に設定される結果数は5より大きくなります。

例22-8 表示される検索結果数の増加

setSearchConfig(appName='webcenter',
                numResultsMain=10)

例22-9は、サービスが検索を実行するために許可される最大時間(ミリ秒)を構成する方法を示しています。サービスがいつタイムアウトするかは、主にシステムの負荷に依存します。常にタイムアウト・エラーが生じる場合は、このパラメータを調整してください。

例22-9 WebCenter Portalで検索結果を待機する最大時間の構成

setSearchConfig(appName='webcenter',
                executionTimeout=10000)

コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetSearchConfigに関する項を参照してください。

22.6.1.2 Fusion Middleware Controlを使用した検索パラメータとクローラの構成

Fusion Middleware Controlを使用して、Oracle SES検索を有効化または無効化したり、検索設定を構成できます。

  1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、第6.2項「スペース・アプリケーションのホームページへの移動」または第6.3項「Frameworkアプリケーションのホームページへの移動」を参照してください。

  2. 「WebCenterポータル」メニューから、「設定」「アプリケーション構成」を選択します。

  3. Oracle SESアダプタまたはデフォルトのWebCenter Portalアダプタを有効にするよう選択し、「適用」をクリックします(図22-23)。

    Spacesクローラのフル・クロール間の間隔を指定できます。デフォルトでは、Spacesクローラのフル・クロールは7日ごとに発生しますが、別の頻度を指定することもできます。(3つのクローラすべてにおいて、増分クロールはOracle SESで設定されたスケジュールによって開始されます。)

    必要に応じて検索パラメータを構成できます。

    • Oracle Secure Enterprise Searchデータ・グループ: 検索するOracle SESソース・グループを指定します。値を指定しない場合、Oracle SESインスタンス内のすべてが検索されます。

    • 実行タイムアウト: サービスが検索を実行できる最大時間(ミリ秒単位)を入力します。

    • 実行者の準備タイムアウト: サービスが検索を初期化できる最大時間(ミリ秒単位)を入力します。

    • サービス当たりの結果数 - 保存済検索タスク・フロー: 保存済検索タスク・フローに表示される、サービス当たりの検索結果数を入力します。

    • サービス当たりの結果数 - 検索ページ: メインの検索ページから送信された検索に対して、サービスごとに表示する検索結果の数を入力します。すべての結果を表示する場合、ユーザーは「すべて表示」をクリックできます。

    • 検索ページの保存済の検索の数: 「保存済検索」リスト(メインの検索ページ上)に表示する保存済検索の数を入力します。

    WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要はありません

    図22-23 WebCenter Portal検索のアプリケーション設定

    検索クローラ
    「図22-23 WebCenter Portal検索のアプリケーション設定」の説明

22.6.2 Oracle SES検索のためのOracle WebCenter Portal: Content Serverの設定

この項では、Oracle SESによりクロール可能となるようにOracle WebCenter Content: Content Server(特に、WebCenter Portalがドキュメントの格納に使用するContent Server)を構成する方法について説明します。

次の手順はContent Server内で実行する必要があります。

  1. sescrawlerroleロールを作成します。

  2. ユーザーsescrawlerを作成し、これにadminロールとsescrawlerroleロールを割り当てます。このユーザーがOracle SES内にContent Serverを作成します。

  3. sceCrawlerRole=sescrawlerroleconfig.cfgに追加します。

  4. Content Serverを再起動します。

  5. Content Serverコンソールで、SESCrawlerExportコンポーネントをコンテンツ・サーバーにインストールします(まだインストールされていない場合)。

    1. システム管理者としてContent Serverにログオンします。例: http://host:port/cs

    2. 「管理」ドロップダウン・メニューから、「管理サーバー」(図22-24)を選択します。

      図22-24 Content Serverの管理

      図22-24の説明が続きます
      「図22-24 Content Serverの管理」の説明

    3. インスタンス名のボタンをクリックします。

    4. 左側のペインのメニュー・リストから「コンポーネント・マネージャ」をクリックします(図22-25)。

      図22-25 Content Serverの「コンポーネント・マネージャ」

      図22-25の説明が続きます
      「図22-25 Content Serverの「コンポーネント・マネージャ」」の説明

    5. 「統合」の下の「SESCrawlerExport」を選択し、「更新」をクリックします。

    6. 構成パラメータを入力します。(構成パラメータは、インストール後に変更することもできます。)

      SESCrawlerExportにより提供される認証および認可APIのセキュリティを無効にします。つまり、「Secure APIの無効化」falseに設定します。これにより、SESCrawlerExportによって提供されるセキュリティが、Content Serverによってではなく内部的に実行されるようになります。

      さらに、クラスタ環境の場合のみ、feedLocパラメータで、コンテンツ・サーバーのノードによりアクセスされる共有ディスク上の場所を指定する必要があります。また、これらの各ノードは同じようにこの場所を参照する必要があります(例: sharedDrive/dir1/dir2)。これは指定されたデフォルトの場所(相対パス)ではないことに注意してください。

    7. Content Serverを再起動します。

  6. Content Serverリポジトリのスナップショットを撮ります。

    1. システム管理者としてContent Serverにログオンします。例: http://host:port/cs

    2. 「管理」ドロップダウン・メニューから、「SESCrawlerExport」を選択します。

    3. 「すべてのソース」を選択し、「スナップショットの取得」 (図22-26)をクリックします。

      図22-26 Content Serverのスナップショット

      図22-26の説明が続きます
      「図22-26 Content Serverのスナップショット」の説明

      ソースの最初のクロールまたはその後のフル・クロールの前にスナップショットを撮ることは重要です。

      スナップショットにより、コンポーネントのインストール時に指定された場所にconfigFile.xmlが生成され、feedLocの下のソース名のサブディレクトリにフィードが作成されます。

  7. Content ServerがWebレンディション用に構成されている場合、Content Server内のアイテムはPDF形式でレンダリングされます。コンテンツ・アイテムのネイティブMIMEタイプのレンディションは上書きされます。たとえば、Microsoft Office WordドキュメントのMIMEタイプはapplication/mswordですが、Content ServerでWebレンディションを使用すると、MIMEタイプはapplication/pdfになります。Mimetypeパラメータをapplication/mswordに設定して検索問合せを実行しても、Wordドキュメントは返されません。

    Content ServerがWebレンディションを使用するように構成されている場合、Content Serverメタデータ・リストにdFormat値が含まれるように構成し、必要なMIMEタイプがOracle SESにエクスポートされるようにする必要があります。これは、MIMEタイプで検索を絞り込めるようにするために必要です。

    1. 「SESCrawlerExport管理」ページに戻り、「SESCrawlerExportの構成」(図22-11)をクリックします。

      図22-27 Content Serverのスナップショット

      図22-27の説明が続きます
      「図22-27 Content Serverのスナップショット」の説明

    2. デフォルトでは、「メタデータ・リスト」フィールドは空白です(図22-28)。

      図22-28 Content Serverの「メタデータ・リスト」

      図22-28の説明が続きます
      「図22-28 Content Serverの「メタデータ・リスト」」の説明

      空白のままにすると、Oracle SESにエクスポートされるメタデータの値のリストは、次(および「x」で始まる任意のカスタム・メタデータ・フィールド)で構成されます。dID,dDocName,dRevLabel,dDocType,dDocAccount,dSecurityGroup,dOriginalName,dReleaseDate,dOutDate

      ただし、dFormatをこのリストに追加する必要があります。

      空白の場合のデフォルト値を変更すると、そのデフォルト値は削除されるため、これらは再度追加する必要があります。「メタデータ・リスト」の値を次のように入力します。dFormat,dID,dDocName,dRevLabel,dDocType,dDocAccount, dSecurityGroup,dOriginalName,dReleaseDate,dOutDate

    3. オプションで、必要な任意のカスタム・メタデータ値(xで始まる)をこのリストに追加します。

      たとえば、「メタデータ・リスト」の次のエントリには、カスタム属性が含まれています。

      dFormat,dID,dDocName,dDocType,dDocAccount,dSecurityGroup,dOriginalName,dReleaseDate,dDocAuthor,dDocCreator,dDocCreatedDate,dOutDate,xCollectionID,xWCTags,xComments,xRegionDefinition


関連項目:

  • 検索結果におけるMIMEタイプの表示については、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドの属性および絞込み機能による検索結果のカスタマイズに関する項を参照してください。

  • Content Server構成の詳細は、製品に付属のDeployment Guide.pdfを参照してください。


22.6.3 Oracle SES検索のためのOracle WebCenter Portalディスカッション・サーバーの設定

この項では、Oracle SESによりクロール可能となるようにOracle WebCenter Portalのディスカッション・サーバー(特に、WebCenter Portalがディスカッションおよびお知らせの格納に使用するディスカッション・サーバー)を構成する方法について説明します。


注意:

WebCenter Portal (Oracleデータベースを含む)およびOracle WebCenter Portalのディスカッション・サーバーの新しいインストールがある場合は、この手順は必要ありません。この手順は、アップグレードされた(パッチが適用された)インスタンスを使用している場合にのみ必要となります。

該当するデータ・ソースのデータベース・スキーマの詳細は、Oracle WebLogic Serverコンソールから検索できます。


  1. リポジトリ作成ユーティリティ(RCU)を実行して、ディスカッション・クローラのWebCenter Portalコンポーネントがシステムにインストールされていることを確認します。

    • OracleデータベースおよびMicrosoft SQL Serverデータベース:

      MyPrefix_DISCUSSIONSユーザーがRCUにインストールされていることを確認することによって、Oracle WebCenter Portalのディスカッション・サーバーのバック・エンドが適切に構成されていることを検証します。

      MyPrefix_DISCUSSIONS_CRAWLERユーザーがRCUにインストールされていることを確認することによって、ディスカッション・クローラが適切に混成されていることを検証します。

    • IBM DB2データベース:

      MyPrefix_DSユーザーがRCUにインストールされていることを確認することによって、Oracle WebCenter Portalのディスカッション・サーバーのバック・エンドが適切に構成されていることを検証します。

      MyPrefix_DCユーザーがRCUにインストールされていることを確認することによって、ディスカッション・クローラが適切に混成されていることを検証します。


      注意:

      IBM DB2データベースの場合、MyPrefixは5文字に制限されます。IBM DB2では、認証にオペレーティング・システム・ユーザーが使用されます(つまり、データベース・ユーザーは実質的にはオペレーティング・システム・ユーザーです)。オペレーティング・システムによっては、ユーザー名に8文字の制限があるため、これは8文字のユーザー名にする必要があります。


    ディスカッション・クローラ・コンポーネントがインストールされていない場合、RCUを使用してこれをインストールする必要があります。このとき、接頭辞は、Oracle WebCenter Portalのディスカッション・サーバー・コンポーネントと同じものを選択します。また、RCUでのテーブルスペースの指定手順で、デフォルトのテーブルスペースとしてPrefix_IAS_DISCUSSIONSを選択します。これにより、Oracle SESのユーザーがインストールされます。

    詳細は、第7章「WebCenter Portal: Frameworkアプリケーションのデプロイ」を参照してください。

  2. 次のツールを実行して(まだ実行していない場合)、ディスカッション・サーバー・データベース・スキーマ内のデータをアップグレードします。

    java -jar \
    $MW_HOME/discussionserver/discussionserver-upgradeforses.jar \
    <command_line_parameters>
    

    ここでcommand_line_parametersは、次のMDSスキーマの詳細とディスカッション・データベース・スキーマの詳細です。

    -mds_jdbc_user user_id \ 
    -mds_jdbc_password password \
    -mds_jdbc_url url \
    -discussions_jdbc_user user_id \
    -discussions_jdbc_password password \
    -discussions_jdbc_url url
    

    ここでmds_jdbc_usermds_jdbc_passwordおよびmds_jdbc_urlは、MDSスキーマにログインするための値で、discussions_jdbc_userdiscussions_jdbc_passwordおよびdiscussions_jdbc_urlは、ディスカッション・データベース・スキーマにログインするための値です。

    次に例を示します。

    java -jar $MW_HOME/as11r1wc/discussionserver/discussionserver-upgradeforses.jar\
    -mds_jdbc_user foo \ 
    -mds_jdbc_password welcome1 \ 
    -mds_jdbc_url jdbc:oracle:thin:@host:port:SID \
    -discussions_jdbc_user foo \ 
    -discussions_jdbc_password welcome1 \ 
    -discussions_jdbc_url jdbc:oracle:thin:@host:port:SID
    

22.6.4 WebCenter Portalを検索するためのOracle SESの設定

この項の手順は、Oracle SES管理ツールで実行する必要があります。

次の手順が必要です。

  1. 第22.6.4.1項「Oracle SES管理ツールへのログオン」

  2. 第22.6.4.2項「ドキュメントを検索するためのOracle SESの設定」

  3. 第22.6.4.3項「ディスカッションおよびお知らせを検索するためのOracle SESの設定」

  4. 第22.6.4.4項「スペース、リスト、ページおよび人を検索するためのOracle SESの設定」

  5. 第22.6.4.6項「追加のOracle SES構成」


関連項目:

Oracle SESに必要なすべてのパッチがインストールされていることを確認します。必要なパッチの最新情報は、Oracle Fusion Middleware Oracle WebCenter Portalインストール・ガイドの検索サービスのバックエンド要件に関する項およびリリース・ノードを参照してください。

Oracle SES構成の詳細は、製品に付属のOracle SESドキュメントを参照してください。(これらは、Oracle Fusion Middlewareドキュメント・ライブラリのWebCenter Portal製品の領域にリストされています。)


22.6.4.1 Oracle SES管理ツールへのログオン

Oracle SES管理ツールを開きます。

  1. ブラウザを開き、インストール後に指定されたURLを入力します。(これは、http://host:port/search/admin/index.jspの形式となります。)

  2. Oracle SES管理ユーザー名eqsysとインストール時に指定されたパスワードでログオンします。

22.6.4.2 ドキュメントを検索するためのOracle SESの設定

Oracle SESを使用してWebCenter Portalドキュメントを検索するには、まずドキュメント・サービス・マネージャを(ドキュメント・サービス・インスタンスおよびドキュメント・サービス・パイプラインとともに)設定してから、Content Serverソースを作成する必要があります。

  1. ドキュメント・サービス・マネージャを構成します(Oracle SESインスタンスごとに1回)。


    注意:

    ドキュメント・サービスは、ドキュメントがクロールされる際のドキュメントの処理に関与するプラグインです。ドキュメント・サービスにより、WebCenter Portalアプリケーションで使用されるドキュメントに索引付け可能な属性をWebCenter Portalで追加できるようになります。

    検索属性名は一意である必要があります。2つの属性に同じ名前を使用することはできません。たとえば、属性が文字列のデータ型で存在する場合に、名前が同じで異なるデータ型の別の属性がクローラにより検出されると、そのクローラは2番目の属性を無視します。新しい属性を作成する前に、Oracle SESドキュメント内のOracle SES属性名とタイプのリストを必ず確認してください。


    1. 「グローバル設定」→「ドキュメント・サービス」ページで、「作成」をクリックします。「新規マネージャの作成」を選択し、「次へ」をクリックして次のパラメータを入力します。

      マネージャ・クラス名: oracle.webcenter.search.crawl.ucm.ses.WcUcmDsManager

      マネージャJARファイル名: search-crawl-ucm.jar


      注意:

      webcenter_search_ses_plugins.zipファイルによりOracle_Home/search/lib/plugins/doc/search-crawl-ucm.jarがインストールされます。


      「次へ」をクリックして、「終了」をクリックします(図22-29)。

      図22-29 Oracle SESでのドキュメント・サービス・マネージャの作成

      図22-29の説明が続きます
      「図22-29 Oracle SESでのドキュメント・サービス・マネージャの作成」の説明

    2. ドキュメント・サービス・インスタンスを作成します。

      再度、「グローバル設定」→「ドキュメント・サービス」ページで、「作成」をクリックします。今回は、「利用可能なマネージャから選択」「Secure Enterprise Search WebCenter UCMプラグイン」を選択し、「次へ」をクリックします(図22-30)。

      図22-30 ドキュメント・サービスの作成

      図22-30の説明が続きます
      「図22-30 ドキュメント・サービスの作成」の説明

      インスタンス名の入力に加えて、次のパラメータも入力します。

      WebCenterアプリケーション名: バックエンドContent ServerでこのWebCenter Portalアプリケーションを識別するために使用される一意の名前。

      接続名: WebCenter PortalがSpaceドキュメントの保存に使用するプライマリContent Server接続の名前です。

      WebCenter URL接頭辞: WebCenter Portalアプリケーションがデプロイされるホストおよびポート。例: http://myhost:8888


      注意:

      listDocumentsSpacesPropertiesコマンドを使用して、第22.6.1項「Oracle SES検索のためのWebCenter Portal: Spacesの設定」の説明に従って、Spacesのアプリケーション名と接続名を特定してください。


    3. ドキュメント・サービス・パイプラインを作成します。これによりドキュメント・サービス・インスタンスが呼び出されます。再度、「グローバル設定」→「ドキュメント・サービス」ページで、「ドキュメント・サービス・パイプライン」セクションの下の「作成」をクリックします。

      名前を入力して前の手順で作成したインスタンスを選択します。

  2. ドキュメントのContent Serverソースを作成します。


    関連項目:

    Content Serverソースを作成する別の方法は、第22.6.5項「WLSTを使用した検索クローラの構成」を参照してください。


    1. 「ホーム」→「ソース」に移動します。

    2. 「ソース・タイプ」ドロップダウン・リストで、「Oracle Content Server」を選択し、「作成」(図22-31)をクリックします。

      図22-31 Oracle Content Serverソースの作成

      図22-31の説明が続きます
      「図22-31 Oracle Content Serverソースの作成」の説明

    3. 次のパラメータを入力します。

      ソース名: unique_name

      構成URL: Content_Server_SES_Crawler_Export_endpoint (例: http://host:port/cs/idcplg?IdcService=SES_CRAWLER_DOWNLOAD_CONFIG&source=default)


      注意:

      source=defaultパラメータは、SESクローラ・エクスポートの構成で作成されたソースの名前を示します。デフォルトのソースが作成され、自動的にdefaultと名付けられます。


      認証タイプ:

      Content ServerがSSOで保護されない場合、NATIVEと入力します。

      Content ServerがOracle SSOで保護される場合、ORASSOと入力します。

      ユーザーID: Content Serverをクロールするユーザーには、sceCrawlerRoleロールが定義される必要があります。sceCrawlerRoleは、SESCrawlerExport内の構成パラメータです。一般には、管理者が特別のロールを作成し、これにはコンテンツを表示する権限を割り当てず、このロールを持つユーザー・アカウントを作成します。

      特定のsceCrawlerRoleを設定しない場合、クロールには管理資格証明が必要です。sysadminユーザーIDはデフォルトで機能します。

      認証タイプがORASSOの場合、Oracle SSOが前面に来るアイデンティティ管理サーバー内のユーザーのID (およびパスワード)を入力します。このユーザーには、sysadminと同じ権限が付与される必要があります。これらの権限を付与できない場合は、このユーザーに対応するContent Server内のリモート・ユーザーを削除し、Content Server内で(同じ名前の)ローカル・バージョンのユーザーを作成します。

      パスワード: このContent Serverユーザーのパスワード。

      レルム:

      認証タイプがNATIVEの場合、Idc Security /cs/idcplgと入力します。ここで/cs/は、Content Serverのインストール時に指定したコンテキスト・ルートです。

      認証タイプがORASSOの場合、このパラメータは空白のままにします。

      スクラッチ・ディレクトリ: オプション。Oracle SESインスタンスが配置されるシステム上のディレクトリを指定します。

      Oracle SSOログインURL:

      認証タイプがORASSOの場合、Oracle SSOの値を指定します。例: https://login.oracle.com/mysso/signon.jsp?site2pstoretoken=

      認証タイプがNATIVEの場合、このフィールドは空白のままにします。

      Oracle SSOアクションURL:

      認証タイプがORASSOの場合、Oracle SSOの値を指定します。例: https://login.oracle.com/sso/auth

      認証タイプがNATIVEの場合、このフィールドは空白のままにします。

      「次へ」をクリックします(図22-32)。

      図22-32 Oracle Content Serverソースのパラメータ

      図22-32の説明が続きます
      「図22-32 Oracle Content Serverソースのパラメータ」の説明

    4. 「ユーザー定義ソースの作成 : ステップ2 : 認可」ページの「認可マネージャ」セクションで次のパラメータを入力します(デフォルトで入力されていない場合)。

      プラグイン・クラス名: oracle.search.plugin.security.auth.stellent.StellentAuthManager

      Jarファイル名: oracleapplications/StellentCrawler.jar

      認可用HTTPエンドポイント: 例: http://host:port/cs/idcplg

      表示URL接頭辞: 例: http://host:port/cs

      認証タイプ: NATIVEまたはORASSO

      管理者ユーザー: Content Serverをクロールするユーザーには、sceCrawlerRoleロールが定義される必要があります。sceCrawlerRoleは、SESCrawlerExport内の構成パラメータです。一般には、管理者が特別のロールを作成し、これにはコンテンツを表示する権限を割り当てず、このロールを持つユーザー・アカウントを作成します。特定のsceCrawlerRoleを設定しない場合、クロールには管理資格証明が必要です。sysadminユーザーIDはデフォルトで機能します。

      認証タイプがORASSOの場合、Oracle SSOが前面に来るアイデンティティ管理サーバー内のユーザーのID (およびパスワード)を入力します。このユーザーには、sysadminと同じ権限が付与される必要があります。これらの権限を付与できない場合は、このユーザーに対応するContent Server内のリモート・ユーザーを削除し、Content Server内で(同じ名前の)ローカル・バージョンのユーザーを作成します。

      管理者のパスワード: クロール管理ユーザーのパスワード

      認可ユーザーID形式: アクティブなアイデンティティ・プラグインで使用される認証属性。この値を参照するには、Oracle SESの「グローバル設定」→「アイデンティティ管理設定」ページに進みます。「アクティブ・プラグイン」の下の「認証属性」の値を入力します(例: nicknameusernameなど)。Oracle E-Business Suite R12アイデンティティ・プラグインを使用している場合は、このパラメータは空白のままにします。

      レルム:

      認証タイプがNATIVEの場合、Idc Security /cs/idcplgと入力します。ここで/cs/は、Content Serverのインストール時に指定したコンテキスト・ルートです。

      認証タイプがORASSOの場合、このフィールドは空白のままにします。

    5. 「作成およびカスタマイズ」をクリックして(または作成したソースを編集して)、その他のソース・パラメータを参照します。「クロール・パラメータ」タブで、Document Service Pipelineと入力します。

    6. 「有効化」をクリックして作成したパイプラインを選択します。

22.6.4.3 ディスカッションおよびお知らせを検索するためのOracle SESの設定

Oracle SESを使用してWebCenter Portalのディスカッションとお知らせを検索するには、まず、ディスカッション用とお知らせ用の2つのOracle SESデータベース・ソースを設定する必要があります。たとえば、ディスカッションのソースには、ソース名GS_DiscussionsおよびFORUMCRAWLER_VWのビューが設定され、お知らせのソースには、ソース名GS_AnnouncementsおよびANNOUNCEMENTS_VWのビューが設定されます。


注意:

Oracle、Microsoft SQL ServerおよびIBM DB2データベースでは、手順が多少異なります。


  1. JDBCドライバを構成します。

    1. Microsoft SQL ServerまたはIBM DB2データベースをクロールするには、適切なJDBCドライバjarファイルをOracle SESのORACLE_HOME/search/lib/plugins/oracleapplicationsディレクトリにダウンロードします。


      注意:

      • Microsoft SQL Serverの場合: Microsoft JDBCドライバ・ファイル、sqljdbc.jarおよびsqljdbc4.jarをコピーします。

      • DB2: IBMドライバ・ファイルdb2jcc.jarおよびdb2jcc_license_cu.jarをコピーします(IBM DB2 UDBクライアントから取得可能)。


      JDBCドライバがJRE 1.5用とJRE 1.6用で異なる場合(たとえば、JRE 1.5ではsqljdbc.jar、JRE 1.6ではsqljdbc4.jarなど)、次の手順を実行します。

      - 両方のドライバJarをOracle SESのORACLE_HOME/search/lib/plugins/oracleapplicationsディレクトリにダウンロードします。

      - JRE 1.6バージョンのドライバJar (SQLServerの場合sqljdbc4.jar)のエントリを、ORACLE_HOME/search/config/searchctl.confCLASSPATH要素に追加します。

      - 中間層を再起動します。

    2. drivers.propertiesファイルをDatabaseName:DriverClassNameの情報を使用して更新します。

    3. JRE 1.5 JDBCドライバJarファイル名を、appsjdbc.jarおよびDBCrawler.jarMETA-INF/MANIFEST.MF内のクラスパスに追加します。

      例: 変更前

      Class-Path:  sqljdbc.jar rsscrawler.jar  ../../pluginmessages.jar
      

      変更後

      Class-Path:  db2jcc.jar sqljdbc.jar rsscrawler.jar  ../../pluginmessages.jar
      

      変更前

      Class-Path: appsjdbc.jar
      

      変更後

      Class-Path: db2jcc.jar appsjdbc.jar
      

    KEYという名前が付けられていないkey属性の場合、drivers.propertiesファイル内のJDBCドライバ情報を変更して、database_name: driver_class_name, key_attribute_nameのようにキー属性名を指定します。

    たとえば、IDという名前のキー属性の場合、次のようになります。

    oracle : oracle.jdbc.driver.OracleDriver, ID
    

    クロール問合せでは、キー値列名の別名としてkey_attribute_nameを使用します。この例で、IDKEYVALの別名です。

    SELECT keyval id, content, url, lastmodifieddate, lang FROM sales_only
    

    OracleおよびSQL Serverデータベース: drivers.propertiesになにも指定されていない場合、次のデフォルト・ドライバが使用されます。

    • Oracle: oracle.jdbc.driver.OracleDriver

    • SQL Server: com.microsoft.sqlserver.jdbc.SQLServerDriver

  2. IBM DB2データベースの場合のみ、次の手順が必要となります。

    1. データベース・クローラ・ソースを使用するクローラが実行されていないことを確認します。Oracle SES管理ツールの「ホーム」→「スケジュール」ページで、クローラの進捗状況とステータスを確認します。(「ステータスのリフレッシュ」をクリックします。)

    2. appsjdbc.jarファイルとDBCrawler.jarファイルを再作成します。META-INF/MANIFEST.MFが正しく更新されたことを確認してください。正しく更新されない場合、クローラは失敗し、クローラのログ・ファイルに次のエラーが記録されます。

      EQP-80406: Loading JDBC driver failed
      
    3. Oracle_Home/search/lib/plugins/oracleapplications/drivers.propertiesファイルを変更して次の行を追加します。

      db2: com.ibm.db2.jcc.DB2Driver
      
    4. ORACLE_HOME/search/config/searchctl.confCLASSPATH要素にドライバJar (db2jcc.jar)を追加します。次に例を示します。

      #CLASS PATH
      CLASSPATH=ORACLE_HOME/search/webapp/config:ORACLE_HOME/search/webapp/
      SESAuthenticator.jar:ORACLE_HOME/search/lib/plugins/commons-plugins-
      stubs.jar :ORACLE_HOME /search/lib/plugins/oracleapplications/db2jcc.jar
      
    5. $ORACLE_HOME/search/config/searchctl.confファイルのJVM_OPTIONSを編集して、システム・プロパティ"-Doracle.home=ORACLE_HOME/search"を追加します。次に例を示します。

      JVM_OPTIONS= -Djava.awt.headless=true
      -Dweblogic.RootDirectory=ORACLE_HOME/search/base_domain
      -Doracle.home=ORACLE_HOME/search
      
    6. $ORACLE_HOME/search/lib/plugins/oracleapplications/pluginmessages.jarファイルを$ORACLE_HOME/search/libディレクトリにコピーします。

    7. データベース・ソースを作成します。正しい認可問合せを入力し、「セキュリティ属性の付与」で使用した属性名が認可問合せで使用する属性名と一致していることを確認します。一致していない場合、ドキュメントの検索の際、ユーザーは結果を得ることができません。

  3. ディスカッション・ソースまたはお知らせソースを作成します。


    関連項目:

    これらのソースを作成する別の方法は、第22.6.5項「WLSTを使用した検索クローラの構成」を参照してください。


    1. Oracle SESで、「ホーム」→「ソース」に進みます。

    2. 「ソース・タイプ」ドロップダウン・リストで、「データベース」を選択し、「作成」(図22-33)をクリックします。

      図22-33 データベース・ソースの作成

      図22-33の説明が続きます
      「図22-33 データベース・ソースの作成」の説明

    3. 次のパラメータを入力します。

      ソース名: unique_name。たとえば、ディスカッションをクロールする場合、GS_Discussions(お知らせをクロールする場合は、GS_Announcements)。

      データベース接続文字列: 次のいずれかを入力します。

      - Oracleデータベース: 次のいずれかを入力します。

      jdbc:oracle:thin:@host:port:sid

      jdbc:oracle:thin@host:port/serviceId

      - IBM DB2データベース: jdbc:db2://host:port/database_nameと入力します。

      - Microsoft SQL Serverデータベース: jdbc:sqlserver://host_or_IP_address:port;database_nameと入力します。

      ユーザーID: 次のいずれかを入力します。

      - Oracleデータベース: Oracle WebCenter Portalのディスカッション・サーバーのインストール時に作成されたユーザーMyPrefix_DISCUSSIONS_CRAWLER

      - Microsoft SQL Serverデータベース: Oracle WebCenter Portalのディスカッション・サーバーのインストール時に作成されたユーザーMyPrefix_DISCUSSIONS_CRAWLER

      - IBM DB2データベース: Oracle WebCenter Portalのディスカッション・サーバーのインストール時に作成されたユーザーMyPrefix_DC(MyPrefixは5文字)

      パスワード: このユーザーのパスワード。

      問合せ: 次のいずれかの問合せを入力します。

      SELECT * FROM FORUMCRAWLER_VW
      SELECT * FROM ANNOUNCECRAWLER_VW
      

      ソース・クロール・ディスカッション・フォーラムには、FORUMCRAWLER_VWを使用します。

      ソース・クロールお知らせには、ANNOUNCECRAWLER_VWを使用します。

      URL接頭辞: ホスト、ポートおよびアプリケーション名を含むWebCenter PortalアプリケーションのURL接頭辞。たとえば、Webcenter Portal: Spacesの場合、http://host:port/webcenterのようになります。

      「セキュリティ属性の付与」: WCSECATTR


      注意:

      以前のリリースのContent Serverでは、「セキュリティ属性の付与」FORUMIDが使用されていました。


    4. 「次へ」をクリックします。

    5. 「ユーザー定義ソースの作成 : ステップ2 : 認可」ページの「認可マネージャ」セクションで次のパラメータを入力します(事前に移入されていない場合)。

      プラグイン・クラス名: oracle.search.plugin.security.auth.db.DBAuthManager

      Jarファイル名: oracleapplications/DBCrawler.jar

      認可データベース接続文字列: 次のいずれかを入力します。

      - Oracleデータベース: 次のいずれかを入力します。

      jdbc:oracle:thin:@host:port:sid

      jdbc:oracle:thin@host:port/serviceId

      - IBM DB2データベース: jdbc:db2://host:port/database_nameと入力します。

      - Microsoft SQL Serverデータベース: jdbc:sqlserver://host_or_IP_address:port;database_nameと入力します。

      ユーザーID: 次のいずれかを入力します。

      - Oracleデータベース: ユーザーMyPrefix_DISCUSSIONS_CRAWLERを入力します。

      - Microsoft SQL Serverデータベース: ユーザーMyPrefix_DISCUSSIONS_CRAWLERを入力します。

      - IBM DB2データベース: ユーザーMyPrefix_DC (MyPrefixは5文字)を入力します。

      パスワード: このユーザーのパスワード

      単一レコード問合せ: false

      認可問合せ: (1行で)次を入力します。

      SELECT DISTINCT forumID as WCSECATTR 
      FROM AUTHCRAWLER_FORUM_VW 
      WHERE username = ? UNION SELECT DISTINCT -1 as WCSECATTR 
      FROM AUTHCRAWLER_FORUM_VW
      

      注意:

      以前のリリースのContent Serverでは、次の認可問合せが使用されていました。

      SELECT forumID 
      FROM AUTHCRAWLER_FORUM_VW 
      WHERE (username = ? or userID=-1) 
      UNION SELECT f.forumID 
      FROM jiveForum f, AUTHCRAWLER_CATEGORY_VW c 
      WHERE f.categoryID = c.categoryID AND (c.username =  ? or userID=-1) 
      

      認可ユーザーID形式: アクティブなアイデンティティ・プラグインで使用される認証属性。この値を参照するには、Oracle SESの「グローバル設定」→「アイデンティティ管理設定」ページに進みます。「アクティブ・プラグイン」の下の「認証属性」の値を入力します(例: nicknameusernameなど)。

      Oracle E-Business Suite R12アイデンティティ・プラグインを使用している場合は、このパラメータは空白のままにします。

    6. 「作成」をクリックしてソースの作成を完了します。

22.6.4.4 スペース、リスト、ページおよび人を検索するためのOracle SESの設定

この項では、Oracle WebCenterソースを作成する方法について説明します。


関連項目:

Oracle WebCenterソースを作成する別の方法は、第22.6.5項「WLSTを使用した検索クローラの構成」を参照してください。


  1. 「ホーム」→「ソース」ページに移動します。

  2. 「ソース・タイプ」ドロップダウン・リストで、「Oracle WebCenter」を選択し、「作成」(図22-34)をクリックします。

    図22-34 Oracle WebCenterソースの作成

    図22-34の説明が続きます
    「図22-34 Oracle WebCenterソースの作成」の説明

  3. 次のソース・パラメータを入力します。


    注意:

    WebCenter Portalの前にOracle HTTPサーバーが配置されている場合は、この手順で使用される構成URLでmod_wl_ohs.confファイルに次が必要となります。

    非クラスタ環境の場合:

    <Location /rsscrawl>
    SetHandler weblogic-handler
    WebLogicHost host_name
    WeblogicPort port
    </Location>
     
    <Location /sesUserAuth>
    SetHandler weblogic-handler
    WebLogicHost host_name
    WeblogicPort port
    </Location>
    

    クラスタ環境の場合:

    <Location /rsscrawl>
    WebLogicCluster host_name1:port,host_name2:port
    SetHandler weblogic-handler
    </Location>
     
    <Location /sesUserAuth>
    WebLogicCluster host_name1:port,host_name2:port
    SetHandler weblogic-handler
    </Location>
    

    ここで、host_name1およびhost_name2はクラスタ・ノードで、portはWebCenter Portalアプリケーションがデプロイされている管理対象サーバーのリスニング・ポート番号です。



    関連項目:

    WebCenter PortalをOracle Access Managerとともに使用する方法の詳細は、第31.2.3.1項「OAM 11gのインストールと構成」を参照してください。


    ソース名: unique_name

    構成URL: host:port_of_WebCenterSpaces/rsscrawl。例: http://myhost:8888/rsscrawl

    認証タイプ: BASIC

    ユーザーID: 第22.3.2項「Oracle SES: 構成」で登録したクロール管理ユーザー。例: mycrawladmin

    パスワード: クロール管理ユーザーのパスワード

    レルム: jazn.com

    Oracle SSOログインURL: このフィールドは空白のままにします。

    Oracle SSOアクションURL: このフィールドは空白のままにします。

    スクラッチ・ディレクトリ: オプション。Oracle SESインスタンスが配置されるシステム上のディレクトリを指定します。

    接続の試行数: データ・フィードにアクセスするためまたはステータス・フィードをアップロードするための接続試行の最大数

    「次へ」をクリックします(図22-35)。

    図22-35 Oracle WebCenterソースのパラメータ

    図22-35の説明が続きます
    「図22-35 Oracle WebCenterソースのパラメータ」の説明

  4. 「ユーザー定義ソースの作成 : ステップ2 : 認可」ページで、「プラグイン・クラス名」、「Jarファイル名」、「認可エンドポイント」は、事前に移入されています。

    次のプラグイン・パラメータを入力します。

    レルム: jazn.com

    ユーザーID: 第22.3.2項「Oracle SES: 構成」で登録したクロール管理ユーザー。例: mycrawladmin

    パスワード: クロール管理ユーザーのパスワード

    認可ユーザーID形式: アクティブなアイデンティティ・プラグインで使用される認証属性。この値を参照するには、Oracle SESの「グローバル設定」→「アイデンティティ管理設定」ページに進みます。「アクティブ・プラグイン」の下の「認証属性」の値を入力します(例: nicknameusernameなど)。Oracle E-Business Suite R12アイデンティティ・プラグインを使用している場合は、このパラメータは空白のままにします。

  5. 「作成」をクリックしてソースの作成を完了します。

22.6.4.5 スペース・クローラからのサービスの除外

スペース・クローラは次のサービスを検索するためにデータを収集します。

  • oracle.webcenter.peopleconnections.profile (ピープル・コネクション)

  • oracle.webcenter.community (スペース)

  • oracle.webcenter.page (ページ)

  • oracle.webcenter.list (リスト)

これらのサービスのいずれかの検索を無効にするには、URLパラメータ?excludedServiceIdsを使用します。Oracle SESでOracle WebCenterソースを設定する際は、/rsscrawlの後に?excludedServiceIdsを追加します。Spacesをクローリングする場合は、このパラメータを、除外するサービスIDのカンマ区切りのリストと同一に設定します。

例22-10 ピープル・コネクションのクロールの無効化

/rsscrawl?excludedServiceIds=oracle.webcenter.peopleconnections.profile

例22-11 ページのクロールの無効化

/rsscrawl?excludedServiceIds=oracle.webcenter.page

例22-12 ピープル・コネクションおよびページのクロールの無効化

/rsscrawl?excludedServiceIds=oracle.webcenter.peopleconnections.profile,oracle.webcenter.page

22.6.4.6 追加のOracle SES構成

この項では、Oracle SES管理ツールで必要な手順について説明します。

  1. Content Server、ディスカッション、お知らせおよびWebCenter Portalサービスの作成したソースの名前を含む、ソースグループを作成します。

    1. 「検索」→「ソース・グループ」に進み、「作成」をクリックします。

    2. 第22.6.1項「Oracle SES検索のためのWebCenter Portal: Spacesの設定」で入力したのと同じソース・グループ名を入力します。

    3. 「ソース・タイプの選択」ドロップダウン・リストから、各ソース・タイプ(Database、Oracle Content Server、Oracle WebCenter)を選択し、各ソース・タイプに対してリストされた「使用可能なソース」から、そのソース・タイプに対して作成したソースを「割り当てられたソース」リストに移動します。

    4. 「完了」をクリックします。

  2. 必要に応じてセキュリティ・フィルタ有効期間を構成します。これにより、システム内のユーザーの認可ポリシーがリフレッシュされます。ユーザー・ポリシーが頻繁に変更される場合は、有効期間を短くすることをお薦めします。(この章では、例としてOracle Internet Directoryアイデンティティ・プラグインを使用します。)

    たとえば、「グローバル設定」→「問合せ構成」ページの「セキュア検索の構成」の下で、「セキュリティ・フィルタ有効期間(分)」0を入力します。

    セキュリティ・フィルタ有効期間の有効な値は、0分(キャッシュなし)から526500分(1年間のキャッシュ)です。

  3. すべてを索引付けするには、各ソースに対してフル・クロールを強制する必要があります。つまり、各ソースの既存の増分クロール・スケジュールを、まずすべてのドキュメントを処理するように変更する必要があります。

    この手順は非常に重要で、これで、コンテンツが最初に完全に索引付けされるまで、検索が機能しなくなります。


    注意:

    WLSTでfullCrawlIntervalInHoursパラメータを使用して、またはFusion Middleware ControlでFull Crawl Intervalパラメータを使用してスペース・クローラのスケジュールを設定できます。


    「ホーム」→「スケジュール」ページに進み、ソース・スケジュールを選択して「編集」をクリックし、フル・クロールを強制します。

    各ソースのクロールが完了したら、同じページに戻り、クロール・ポリシーを増分(前回のクロール以降に変更されたドキュメントを索引付けする)に戻します。また、このページの「頻度」セクションで、増分クロールの実行に手動以外のタイプ(毎週、毎日など)を選択します。


    注意:

    Content Serverの最初のクロールの前に、Content Serverの「管理」ページに進み、「SESクローラ・エクスポート」を選択してスナップショットを撮ることを忘れないでください。詳細は、第22.6.2項「Oracle SES検索のためのOracle WebCenter Portal: Content Serverの設定」を参照してください。


22.6.5 WLSTを使用した検索クローラの構成

WLSTコマンドを使用して、クローラを作成したり、クローラのスケジュールを開始、停止および削除できます。これらのコマンドでは、Oracle SES内の新しいデータをクロールしたり、構成データが変更されると古いクローラを削除できます。

次の例に、これらのコマンドの一部を示します。詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』の検索: Oracle SES検索クローラに関する項を参照してください。

例22-13 WLSTでのスペース・クローラの作成

createSpacesCrawler(
'webcenter', 'webcenter_host', 'webcenter_port',
'http://ses-host:ses-port/search/api/admin/AdminService', 'ses-admin-pw',
'webcenter-crawl-user', 'webcenter-crawl-user-pw', '/tmp', 'authentication-id-format', 'ACCEPT_ALL', 'PROCESS_ALL', 'MANUAL', 1, 1, 
'MONDAY', 1, 1, 1, 1)

各要素の意味は次のとおりです。

  • webcenter_host = WebCenter Portalのホスト名

  • webcenter_port = WebCenter Portalのポート番号

  • ses-host = Oracle SESホスト名

  • ses-port = Oracle SESポート番号

  • ses-admin-pw = Oracle SES管理ユーザー・パスワード

  • webcenter-crawl-user = WebCenter Portalクロール・ユーザー名

  • webcenter-crawl-user = WebCenter Portalクロール・ユーザー・パスワード

  • authentication-id-format = Oracle SES上のアイデンティティ管理プラグインがOracle Internet Directoryに設定されている場合は、ニックネームを使用します。それ以外の場合は、Oracle SES上のアイデンティティ管理プラグインの「認証属性」パラメータの値を使用します。

例22-14 WLSTでのドキュメント・クローラの作成

createDocumentsCrawler(
'portal', 'portal_host', 'portal_port',
'http://ses-host:ses-port/search/api/admin/AdminService', 'ses-admin-pw',
'http://ucm-host:ucm-port/cs/idcplg?IdcService=
SES_CRAWLER_DOWNLOAD_CONFIG&source=default', 'ucm-crawl-user',
'ucm-crawl-user-pw', '/tmp',
'http://ucm-host:ucm-port/cs/idcplg', 'http://ucm-host:ucm-port/cs',
'Idc Security /cs/idcplg', 'authentication-id-format', 'Document-pipeline',
'ACCEPT_ALL', 'PROCESS_CHANGED', 'MANUAL', 1, 1, 'MONDAY', 1, 1, 1, 1)

各要素の意味は次のとおりです。

  • portal = この操作を実行するWebCenter Portalアプリケーションの名前

  • portal_host = アプリケーションを実行するシステムのホスト名

  • portal_port = アプリケーションにアクセスするために使用されるポート番号

  • ses-host = Oracle SESホスト名

  • ses-port = Oracle SESポート番号

  • ses-admin-pw = Oracle SES管理ユーザー・パスワード

  • ucm-host = Content Serverホスト名

  • ucm-port = Content Serverポート番号

  • ucm-crawl-user = Content Serverクロール・ユーザー名

  • ucm-crawl-user-pw = Content Serverクロール・ユーザー・パスワード

  • authentication-id-format = Oracle SES上のアイデンティティ管理プラグインがOracle Internet Directoryに設定されている場合は、ニックネームを使用します。それ以外の場合は、Oracle SES上のアイデンティティ管理プラグインの「認証属性」パラメータの値を使用します。

  • Document-pipeline = このWebCenter Portalインスタンスのために作成されたOracle SES上のドキュメント・パイプライン

例22-15 WLSTでのディスカッション・クローラの作成

createDiscussionsCrawler(
'webcenter','webcenter_host','webcenter_port',
'http://ses-host:ses-port/search/api/admin/AdminService', 'ses-admin-pw',
'jdbc:oracle:thin:@database-host:database-port:database-sid',
'Jive-crawler-schema','Jive-crawler-schema-pw', 'authentication-id-format',
'ACCEPT_ALL', 'PROCESS_ALL', 'MANUAL', 1, 1, 'MONDAY', 1, 1, 1, 1)

各要素の意味は次のとおりです。

  • webcenter_host = WebCenter Portalのホスト名

  • webcenter_port = WebCenter Portalのポート番号

  • ses-host = Oracle SESホスト名

  • ses-port = Oracle SESポート番号

  • ses-admin-pw = Oracle SES管理ユーザー・パスワード

  • database-host = Oracle WebCenter Portalのディスカッション・サーバー・データベースのホスト名

  • database-port = ディスカッション・サーバー・データベースのポート番号

  • database-sid = ディスカッション・データベース名またはSID

  • Jive-crawler-schema = ディスカッション・サーバー・クローラのスキーマ名。RCUから接頭辞を決定し、rcu-prefix_DISCUSSION_CRAWLERを使用します。

  • Jive-crawler-schema-pw = Oracle WebCenter Portalのディスカッション・サーバー・クローラ・スキーマのパスワード

  • authentication-id-format = Oracle SES上のアイデンティティ管理プラグインがOracle Internet Directoryに設定されている場合は、ニックネームを使用します。それ以外の場合は、Oracle SES上のアイデンティティ管理プラグインの「認証属性」パラメータの値を使用します。


注意:

WLSTの変更を反映させるには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。


22.6.6 Pythonスクリプトを使用したSpacesのためのOracle SES検索の構成

サンプルのPythonスクリプトは、第22.6項「Spacesアプリケーションを検索するためのOracle SESの構成」でWLSTコマンドを使用して行われる手順を実行します。サンプル・スクリプトは次のタスクを実行します。

  • Oracle SES上でのフェデレーション・トラステッド・エンティティの作成

  • WebCenter Portalでのクロール・ロールを持つクロール・ユーザーの作成

  • WebCenter PortalでのOracle SESへの接続の作成

  • Oracle SESでのWebCenter Portalクロール・ソースの作成

  • Oracle SESでのContent Serverソースの作成

  • Oracle SESでのディスカッション・ソースとお知らせソースの作成


注意:

このスクリプトはOracle SES 11.1.2以降でのみサポートされます。


このサンプル・スクリプトには次の前提条件があります。

サンプルPythonスクリプト・ファイルとそのプロパティ・ファイルは、$WC_ORACLE_HOME/webcenter/scripts/ses_11.1.2/ディレクトリにあります。

サンプルPythonスクリプトを使用するには次の手順に従ってください。

  1. ディレクトリを参照するように環境変数を設定します。次に例を示します。

    setenv SESDIR Oracle_WC1/webcenter/scripts/ses_11.1.2/
    
  2. 適切な値でConfigureSES.propertiesファイルを更新します。

  3. デフォルト・ディレクトリをwlst.shスクリプトのディレクトリに設定します。次に例を示します。

    cd Oracle_WC1/oracle/as11gr1wc/common/bin/
    
  4. ConfigureSES.pyスクリプトをConfigureSES.propertiesで実行します。次に例を示します。

    ./wlst.sh $SESDIR/ConfigureSES.py $SESDIR/ConfigureSES.properties
    
  5. Pythonスクリプトが正常に完了したら、WebCenter Portalを再起動します。

22.6.7 ページ・コンテンツのクロールのヒント

Frameworkアプリケーションでページ・コンテンツをクロールするには、次のガイドラインに従ってください。

  • ページ・テンプレートで、コマンド・リンク(af:commandLink)のかわりに実行リンク(af:goLink)を使用してページをリンクとしてレンダリングします。

  • クロール中はJDeveloperで反復開発を無効にします。反復開発を使用すると、アプリケーションの実行中に変更を加えて、ブラウザでページを更新することによりそれらの変更の結果をすぐに表示することが可能になります。反復開発機能は、特定の最適化機能を無効にすることにより動作します。

    反復開発はデフォルトで有効にされています。この機能を無効にする手順は次のとおりです。

    1. JDeveloperで、「アプリケーション」メニューから、「アプリケーション・プロパティ」を選択します。

    2. 「アプリケーション・プロパティ」ダイアログの左側で、「実行」ノードを開きます。

    3. 「WebCenter Portal」を選択します。

    4. 「反復開発の有効化」の選択を解除します。

    5. 「OK」をクリックします。

22.7 Oracle SES検索に関する問題のトラブルシューティング

この項では、Oracle SES検索を管理する際のトラブルシューティングのヒントを提供します。内容は次のとおりです。

22.7.1 検索結果が見つからない

問題

検索結果が見つかりません。

解決策

次のことを確認します。

22.7.1.1 Oracle SES接続

Oracle SES SOAP URLにアクセスできること、およびOracle SESへの接続のプロパティが正しいことを確認してください。

詳細は、第22.4.5項「Oracle SES接続のテスト」を参照してください。

22.7.1.2 ドキュメントとディスカッションの接続

WebCenter PortalにContent Serverとディスカッション・サーバーへの接続が存在することを確認してください。

Oracle SES検索ログには、WebCenter PortalサービスがOracle SES検索から除外されているかどうかが示されます。Oracle SESインスタンスで検索ログ・ファイルを探し、ログ・ファイルでtotalSearchTimeを確認してください。

サービスが除外されていない(つまり、Oracle SES検索がすべてのWebCenter Portalサービスに対して有効にされている)場合は、次のようになります。

req=Search userName=vicki totalSearchTime=1150ms userQuery=0712>

サービスが除外されている(つまり、Oracle SES検索がドキュメント、ディスカッション、およびお知らせで有効にされていない)場合は、次のようになります。

req=Search userName=vicki totalSearchTime=1133ms userQuery=0712
-wc_serviceId:oracle.webcenter.doclib
-wc_serviceId:oracle.webcenter.collab.forum
-wc_serviceId:oracle.webcenter.collab.announcement>

22.7.1.3 WebCenter Portalのクロール構成

第22.6.1項「Oracle SES検索のためのWebCenter Portal: Spacesの設定」の説明に従って、Fusion Middleware ControlまたはWLSTを使用して、Oracle SES検索がWebCenter Portalで有効にされていることを確認します。

22.7.1.4 Oracle SES構成

  1. Oracle SESに必要なすべてのパッチがインストールされていることを確認します。必要なパッチの最新情報は、Oracle Fusion Middleware Oracle WebCenter Portalインストール・ガイドの検索サービスのバックエンド要件に関する項およびリリース・ノードを参照してください。

  2. Oracle SESが、ユーザーを検証および認証するためにアイデンティティ管理システムとともに構成されていることを確認します。また、WebCenter PortalとOracle SESが同じアイデンティティ管理システム(Oracle Internet Directoryなど)を使用していることを確認します。使用するすべてのリポジトリ(WebCenter Portal: Spaces、WebCenter Portal Content: Content Server、Oracle WebCenter Portalのディスカッション・サーバーなど)は、Oracle SESと同じユーザー・ベースを共有している必要があります。

    さらに、WebCenter Portalエンド・ユーザーが検索時にセキュアに伝播されるようにするため、各Oracle SESインスタンスには1つの信頼できるエンティティが必要です。詳細は、第22.3.2項「Oracle SES: 構成」を参照してください。

    Oracle SESがフェデレーション・トラステッド・エンティティ・ユーザーと接続されていることをテストするには、第22.4.5項「Oracle SES接続のテスト」を参照してください。

22.7.1.5 ユーザー認証

WebCenter Portalアイデンティティ・プラグイン、Oracle SESおよび構成されているすべてのデータ・リポジトリ(Content Serverやディスカッション・サーバーなど)にユーザーが存在すること(つまりそのユーザーがログオンできること)を確認します。

WebCenter Portal診断ログのOracle SESプロキシ・ログイン・エラーは、次のように表示されます。

Received status "failed" during proxy login with application entity "weblogic" to
Oracle SES at [http://host:port/search/query/OracleSearch], as search user
"vicki". Defaulting to public.

22.7.1.6 Oracle SESのクロール

Oracle SESがすべてのソースで正常にクロールを実行したことを確認します。

  1. Oracle SES管理ツールで、「ホーム」→「スケジュール」タブに移動します。「ログ・ファイル」アイコンをクリックし、ソースのログ・ファイルを表示します。完全なログの場所を取得するには、「ステータス」リンクをクリックします。「クローラの進捗状況のサマリーおよびソース別ログ・ファイル」セクションに、ログ・ファイルのフル・パスが表示されます。

  2. Oracle SESが認証エラーによりContent Serverのクロール・エンドポイントにログインできない場合、次のエラーがログに記録されます。

    EQP-60303: Exiting saxthread due to errors
    
    EQP-80330: Unrecognized QName <http://schemas.xmlsoap.org/soap/envelope/>:Envelope oracle.search.sdk.crawler.PluginException       
    
  3. Oracle WebCenterソースの場合、rsscrawlサーブレットが使用できないかどうかを確認します。次に例を示します。

    FATAL      main            EQP-80309: Exception while opening a stream to the URI: https://example.com:port/rsscrawl?command=GetControl
    
  4. Content Serverソースの場合、パスワードが無効であるかどうかを確認します。次に例を示します。

    XML error
    
  5. 次の組合せを使用して、Oracle SES管理ツール内のクロール・プロセスを監視します。

    1. 「ホーム」→「スケジュール」ページでクローラの進捗状況とステータスを確認します(「ステータスのリフレッシュ」をクリック)。「ステータス」ページで、クロールの統計を表示できます。

    2. 「ホーム」→「スケジュール」→「クローラの進行状況のサマリー」→「統計」ページでクローラの統計を監視します。

    3. 「ホーム」→「一般」ページおよび「ホーム」→「統計」ページで検索の統計を監視します。

    クロールのパフォーマンスを調整するためのヒントは、Oracle Secure Enterprise Search管理者ガイドを参照してください。

  6. さらに、Content Serverインスタンス上のスナップショットとデータフィード、およびOracle WebCenter Portalのディスカッション・サーバー・データベースを調べてください。

22.7.1.7 Oracle SESの認可

  1. Oracle SES管理ツールで、「ホーム」→「ソース」タブに移動します。

  2. ソースの「編集」アイコンをクリックし、ソース構成のタブを確認します。

  3. 「認可」タブをクリックして、認可接続文字列、ユーザー名、パスワードおよび認可ユーザーID形式を確認します。

  4. Oracle SESログ・ファイル(前の手順で説明)を調べます。URL値を含むフレーズを探してください。次に例を示します。

    ORA-01017: invalid username/password error
    

Oracle SES管理ツールの詳細は、製品に付属のOracle SESドキュメントを参照してください。(これらは、Oracle Fusion Middlewareドキュメント・ライブラリのWebCenter Portal製品の領域にリストされています。)

22.7.2 検索失敗のエラー

問題

検索後に次の検索失敗のメッセージが断続的に表示される場合があります。

Search failure: time out error
Search failure: problem preparing search executor
Search failure: problem with execution

解決策

しばらく待ってから、検索を再試行してください。これらのメッセージはサービスがタイムアウトした場合に表示され、このタイムアウトは多くの場合システムの負荷に依存します。タイムアウト・エラーが続く場合は、setSearchConfigコマンドのexecutionTimeoutパラメータを調整してください。

コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetSearchConfigに関する項を参照してください。

22.7.3 WebCenter Portalに「表示」権限を付与できない

問題

第22.6.1項「Oracle SES検索のためのWebCenter Portal: Spacesの設定」の手順に従ってview権限を付与しようとすると次のエラーが表示されます。

Command FAILED, Reason: javax.naming.directory.AttributeInUseException: [LDAP: e
rror code 20 - uniquemember attribute has duplicate value.]; remaining name 'orc
lguid=F0CC506017B711DFBFFED9EA6A94EAEC,cn=Permissions,cn=JAAS Policy,cn=webcente
r,cn=wc_domain,cn=JPSContext,cn=jpsroot_webcenter_dadvmc0057'

解決策

このエラーは権限の付与時に表示されます。エラーを無視してください。

22.7.4 ソース・グループまたはソース・タイプによるOracle SESの結果の制限

問題

検索結果をソース・グループまたはソース・タイプで制限する必要があります。

解決策

Oracle SES管理ツールで、「ホーム」→「ソース」→「フェデレーテッド・ソースのカスタマイズ」→「検索制限」ページに移動し、検索の制限を設定します。またはフィルタを使用します(各フィルタは検索結果の制限として機能します)。

Oracle SESの使用方法の詳細は、Oracle Fusion Middlewareドキュメント・ライブラリ(WebCenter Portal製品領域内)でOracle SESドキュメントを参照してください。

22.7.5 検索結果に保護されたリソースが含まれない

問題

検索結果に保護されたリソースが含まれません。1つの原因は、WebCenter Portalユーザーのプロキシ・ログインがOracle SESで失敗したことです。WebCenter Portal診断ログのOracle SESプロキシ・ログイン・エラーは、次のように表示されます。

Received status "failed" during proxy login with application entity "weblogic" to Oracle SES at http://host:port/search/query/OracleSearch, as search user "vicki". Defaulting to public.

解決策

Oracle SESが、ユーザーを検証および認証するためにアイデンティティ管理システムとともに構成されていることを確認します。

また、WebCenter PortalとOracle SESが同じアイデンティティ管理システム(Oracle Internet Directoryなど)を使用していることを確認します。すべてのリポジトリ(WebCenter Portal: Spaces、WebCenter Portal Content: Content Server、Oracle WebCenter Portalのディスカッション・サーバーなど)は、Oracle SESと同じユーザー・ベースを共有している必要があります。

さらに、WebCenter Portalエンド・ユーザーが検索時にセキュアに伝播されるようにするため、各Oracle SESインスタンスには1つの信頼できるエンティティが必要です。

問題

検索結果に保護されたリソースが含まれません。もう一つの原因は、認可エンドポイントが正しく構成されていないことです。Oracle SESインスタンスで検索ログ・ファイルを探します。URL値を含むフレーズを探してください。次に例を示します。

EQP-80309: Exception while opening a stream to the URI:
http://<host>:<port>/sesUserAuth?userId=<end-user-name>

QueryFilterPlugin returned null or empty array value for security attribute
"WCSECATTR". Values required for all security attributes.

解決策

  1. Oracle SES管理ツールで、「ホーム」→「ソース」タブに移動します。

  2. ソースの「編集」アイコンをクリックし、ソース構成のタブを確認します。

  3. 「認可」タブをクリックして、認可接続文字列、ユーザー名、パスワードおよび認可ユーザーID形式を確認します。

問題

検索結果に保護されたリソースが含まれません。さらにもう1つの原因は、認可エンドポイントが認可データを返していないことです。

Oracle SESインスタンスで検索ログ・ファイルを探します。URL値を含むフレーズを探してください。次に例を示します。

A security filter authorization timeout for dsid = # occurred after 10000 milliseconds.

解決策

クロール・ソースの数を減らします。

22.7.6 検索結果にドキュメントが含まれない

問題

検索結果にドキュメントが含まれません。Content Serverドキュメントのクロールが失敗します。

解決策

  1. Oracle SES管理ツールで、「ホーム」→「スケジュール」タブに移動します。

  2. 「ログ・ファイル」アイコンをクリックし、ソースのログ・ファイルを表示します。完全なログの場所を取得するには、「ステータス」リンクをクリックします。

  3. 「クローラの進捗状況のサマリーおよびソース別ログ・ファイル」セクションに、ログ・ファイルのフル・パスが表示されます。Oracle SESが認証エラーによりContent Serverのクロール・エンドポイントにログインできない場合、次のエラーがログに記録されます。

    EQP-60303: Exiting saxthread due to errors, 
    EQP-80330: Unrecognized QName 
    <http://schemas.xmlsoap.org/soap/envelope/>:Envelope 
    oracle.search.sdk.crawler.PluginException
    
  4. Content Serverクロール・ソースの構成パラメータを更新します。

22.7.7 検索結果にディスカッションとお知らせが含まれない

問題

クロール・ソースで、「認可」タブで「単一レコード問合せ」パラメータがtrueに設定されています。

解決策

「単一レコード問合せ」パラメータをfalseに設定します。

問題

アイデンティティ管理システムでは大文字と小文字が混在したユーザー名を使用しますが、Oracle WebCenter Portalのディスカッション・サーバー(Jive)データベースでは、すべて小文字のユーザー名を使用します。クロール・ソースの認可問合せでは、ユーザー名のパラメータにLOWER()関数を適用する必要があります。

解決策

認可問合せが次の文のようであることを確認します。

SELECT forumID as WCSECATTR FROM AUTHCRAWLER_FORUM_VW WHERE LOWER(username) = LOWER(?) UNION SELECT DISTINCT -1 as WCSECATTR FROM AUTHCRAWLER_FORUM_VW

22.7.8 検索結果に最近追加されたリソースが含まれない

問題

新規リソースが最近作成されましたが、検索結果にその新規リソースが含まれません。

解決策

新規リソースが検索結果で返されるようにするには、まずそのリソースをクロールおよび索引付けする必要があります。新しいコンテンツを索引付けするために、クロール・スケジュールが定期的に実行されます。新規リソースが頻繁に作成される場合は、クロール・スケジュールの頻度を増やしてください。新規リソースをすぐにクロールする必要がある場合は、クロール・スケジュールを手動で開始してください。

22.7.9 検索結果に認可の変更が反映されない

問題

一部のリソースには、WebCenter Portalでの認可の変更により、より多くのユーザーがアクセス可能になります。たとえば、スペース内のリソースには、現在すべての認証ユーザーがアクセスできます。影響を受けるユーザーはこれらのリソースを検索できません。

解決策

認可データはOracle SESにキャッシュされます。キャッシュは、Oracle SESの「セキュリティ・フィルタ有効期間(分)」グローバル設定により無効にされます。デフォルト値は1日(1440分)です。認可データへの変更の標準的な頻度に応じて、値を調整してください。

22.7.10 検索結果に幅広いユーザーに利用可能なリソースが含まれない

問題

WebCenter Portalのスペースはパブリックにアクセス可能ですが、認証されていないユーザーは検索結果でスペース・リソースを表示できません。

解決策

デフォルトでは、スペースがパブリックに対してアクセス可能であるとしても、リソースへの「表示」アクセス権はスペースのメンバーにのみ付与されます。リソースの「表示」アクセス権を非メンバーに明示的に付与する必要があります。スペースの設定ページに移動し、「ロール」タブで対象のロールを選択し、リソースへの「表示」アクセス権を付与するよう選択します。