1. Oracle WebCenter Portalの管理
  2. ツールおよびサービスの管理
  3. WebCenter Portal用の検索の構成

10 WebCenter Portalでの検索の構成

検索を構成して、WebCenter Portalのオブジェクトの索引付けと検索を行います。

ノート:

リリース12c (12.2.1.4.0)からは、Oracle WebCenter PortalでのOracle SESのサポートは非推奨になりました。以前のリリースからアップグレードした場合、Oracle SESを使用するように、アップグレードしたインスタンスを構成できます。このリリースでは、ElasticsearchまたはOpenSearchを使用したOCI検索サービスを使用してオブジェクトの索引付けと検索を行うようWebCenter Portalを構成する必要があります。

権限:

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、WebCenter Portal管理を使用して付与されるAdministratorロールが付与されている必要があります。

ロールと権限の詳細は、「管理操作、ロールおよびツールの理解」を参照してください。

トピック:

Elasticsearchとの統合

Elasticsearchを構成して、WebCenter Portalのオブジェクトの索引付けと検索を行います。

トピック:

Elasticsearchでの検索の理解

Elasticsearchは高度にスケーラブルな検索エンジンです。大量のデータを迅速に保存、検索および分析でき、HTTP WebインタフェースとスキーマレスなJSONドキュメントを使用する分散型マルチテナント対応の全文検索エンジンを備えています。

Elasticsearchの利点

  • Elasticsearchは、Luceneに組み込まれている機能と同様の全文検索機能を備えています。

  • Elasticsearchはドキュメント指向型です。データを構造化されたJSONドキュメントとして保存し、すべてのフィールドがデフォルトで索引付けされるため、優れたパフォーマンスを実現します。

  • ElasticsearchはAPI指向であり、シンプルなRestful APIを使用して処理の実行が可能です。

  • Elasticsearchでは、テキストを直接検索するかわりに索引を検索するので、検索結果を高速に取得します。

WebCenter Portalでは、Elasticsearchを構成して次のリソースを検索できます。

  • ドキュメント(Wikiおよびブログを含む)

  • ポータル、ページ・メタデータ、ページ・コンテンツ(HTML、テキストおよびスタイル・テキスト・コンポーネントのコンテンツ)、リストおよび人的リソース

  • お知らせおよびディスカッション(以前のリリースからアップグレードされたポータルでのみ使用可能)

Elasticsearchの構成の前提条件

次の要件を確認してください。

  • Oracle WebCenter Portalがインストールされていること。

  • オプション検索にWebCenter Contentを使用する場合は、WebCenter Contentが構成され、必要なコンポーネントがすべて有効になっていることを確認してください。「Oracle WebCenter Content Serverへの接続の管理」を参照してください。

WebCenter PortalでのElasticsearchの構成ロードマップ

表10-1 ロードマップ - WebCenter PortalでのElasticsearchの設定

担当者 タスク

管理者

WebCenter Portalでのクロール管理ユーザーの作成

管理者

Elasticsearchおよびプラグインのインストール

管理者

WebCenter Contentの検索の構成

管理者

 WebCenter Portalの検索の構成
管理者 検索クローラの構成

管理者

(オプション) WebCenter Portal管理での検索設定のカスタマイズ

管理者

(オプション)検索のグローバル属性の変更

管理者

(オプション)検索のカスタム属性の構成
管理者

(オプション)カスタム・ファセットの作成

Elasticsearchおよびプラグインのインストール

Elasticsearchは、単一サーバー設定または3つ以上のサーバーで構成されるクラスタ設定としてインストールできます。

次のトピックでは、単一のサーバー、クラスタを設定し、Oracle HTTP Serverを使用してロード・バランシングを行う方法について説明します:

単一サーバーの設定
単一サーバー設定をインストールするには、まずElasticsearchリリースからElasticsearch 7.17.xバイナリをダウンロードする必要があります。その後、次のステップに従います:
  1. 次の環境変数を設定します。
    • JAVA_HOME - 値をJavaホーム・ディレクトリに設定します。
    • PATH - パスを$JAVA_HOME/binに更新します。
  2. ORACLE_HOME/wcportal/es/installES.propertiesファイルを編集し、プロパティの値を指定します。
    # A valid ORACLE_HOME. This must contain elasticsearch binaries at $ORACLE_HOME/wcportal/es.
ORACLE_HOME=
#
# A valid Admin Server host which contains WebCenter Portal.
ADMIN_SERVER_HOST_NAME=
#
# Admin server port.
ADMIN_SERVER_PORT=
#
# A valid Weblogic administrator user name.
WLS_ADMIN_USER=
#
# A valid user name configured with crawler privileges.
SEARCH_APP_USER=
#
# Fusion Middleware configuration directory. This will typically be $WEBCENTER_PORTAL_DOMAIN_HOME/config/fmwconfig.
# If $WEBCENTER_PORTAL_DOMAIN_HOME is not accessible from this host, copy the directory $WEBCENTER_PORTAL_DOMAIN_HOME/config/fmwconfig
# from WebCenter Portal domain host to this host and provide that location.
WCP_FMW_CONFIG_LOCATION=
#
# Name of the Elasticsearch cluster. Default value is CURRENT_HOST_NAME and it will be replaced with current hostname. This default is appropriate for single-host environment only.
# If this value is changed, make sure that you don't reuse the same cluster names in different environments. Otherwise, you might end up with nodes joining the wrong cluster. 
# Cluster name should be environment-specific and unique across your enterprise.
ELASTIC_SEARCH_CLUSTER_NAME=CURRENT_HOST_NAME
#
# Name of the Elasticsearch node. Default value is CURRENT_HOST_NAME and it will be replaced with current hostname. This default is appropriate for single-host environment only.
# If this value is changed, make sure that you don't reuse the same node name within the Elasticsearch cluster. 
ELASTIC_SEARCH_NODE_NAME=CURRENT_HOST_NAME
#
# HTTP port of Elasticsearch server. Default value is 9200.
ELASTIC_SEARCH_PORT=9200
#
# Elasticsearch network host. Default value is 0.0.0.0 and it means Elasticsearch server will listen on all network interfaces.
# If you have a requirement to limit traffic on multi-homed hosts with multiple network interfaces, set to a specific hostname, IP address, or network interface name.
# If network interface name is to be specified, it should be specified as: _[networkInterface]_, for example _eth0_.
ELASTIC_SEARCH_NETWORK_HOST=0.0.0.0
#
# Elasticsearch home folder's parent directory. Configure the folder path where the esHome folder should be created.
# Default value is DEFAULT and it means esHome will be created in $ORACLE_HOME folder's parent directory.
# For example, if $ORACLE_HOME is /u01/oracle/fmw, then esHome will be /u01/oracle/esHome.
ELASTIC_SEARCH_HOME_DIR_PARENT=DEFAULT
#
# Transport port of Elasticsearch server. Default value is 9300.
# This configuration is used for internal communication between nodes within the cluster.
ELASTIC_SEARCH_TRANSPORT_PORT=9300
#
# An absolute path of Elasticsearch installer file. The installer can be downloaded from- https://www.elastic.co/downloads/past-releases#elasticsearch
# The installer configured should be as per the OS where Elasticsearch server is being installed (i.e. .tar.gz for Linux and .zip for Windows).
# For eg. for Elasticsearch 7.17.0 version this would be elasticsearch-7.17.0-linux-x86_64.tar.gz on Linux and elasticsearch-7.17.0-windows-x86_64.zip on Windows.
ELASTIC_SEARCH_INSTALLER_LOCATION=
#
# Elasticsearch version. The value should be corresponding to the installer file which was downloaded.
ELASTIC_SEARCH_VERSION=
#
##########################################################################################################################################################################
#
# NOTE: The following properties are required/applicable only if Elasticsearch is being installed in windows.
#
##########################################################################################################################################################################
#
# An absolute path of the directory where curl for Windows has been installed. The curl for Windows can be downloaded from- https://curl.se/download.html
WINDOWS_CURL_HOME=
#
##########################################################################################################################################################################
#
# NOTE: The following properties are required/applicable only if setting up a cluster.
#
##########################################################################################################################################################################
#
# Elasticsearch cluster discovery host list. All the hosts that will be part of the cluster should be configured in this list.
# Each host should be declared by the appropriate fully-qualified hostname.
# Each host should be formatted in double-quotes separated with a comma and space. The list should be wrapped in square-brackets. For example, ["host1.example.com", "host2.example.com"].
ELASTIC_SEARCH_CLUSTER_HOST_LIST=
#
# Elasticsearch cluster discovery node list. All the nodes that will be part of the cluster should be configured in this list.
# Each node should be declared by the corresponding value of ELASTIC_SEARCH_NODE_NAME specified during the installation.
# Each node should be formatted in double-quotes separated with a comma and space. The list should be wrapped in square-brackets. For example, ["node-1", "node-2"].
ELASTIC_SEARCH_CLUSTER_NODE_LIST=
#
# The name of the certificate which will be generated and used for the secure communication between the nodes of the cluster.
# The certificate generated is of PKCS#12 format. Hence the certificate extension should be .p12 only.
ELASTIC_SEARCH_CERTIFICATE_NAME=
#
# The primary host of Elasticsearch cluster. This should be one of the hosts in ELASTIC_SEARCH_CLUSTER_HOST_LIST.
# Only during installation on this host, the certificate specified in ELASTIC_SEARCH_CERTIFICATE_NAME and user specified in SEARCH_APP_USER are created.
# The configured value should be fully-qualified hostname.
ELASTIC_SEARCH_PRIMARY_HOST=
  3. 次のコマンドを入力してElasticsearchおよびプラグインをインストールします。
    ORACLE_HOME/oracle_common/common/bin/wlst.sh
ORACLE_HOME/wcportal/es/installES.py
ORACLE_HOME/wcportal/es/installES.properties
    次に、Linuxに正常にインストールされた場合の出力例を示します:
    ...

-> Installing file:////tmp/webcenter-search-es-content-crawl-plugin.zip
-> Downloading file:////tmp/webcenter-search-es-content-crawl-plugin.zip
[=================================================] 100%   
-> Installed orcl-wcp-es-content-crawl-plugin
-> Please restart Elasticsearch to activate any plugins installed
Creating the user crawladmin in Elasticsearch server...

...

The user crawladmin is created successfully.
Executing /home/Oracle/product/esHome/startElasticsearch.sh
Elasticsearch server installation is complete. Elasticsearch server home is at: /home/Oracle/product/esHome
  4. ElasticsearchがWindowsにインストールされている場合は、次のコマンドを実行してElasticsearchサーバーを保護します:
    ORACLE_HOME/wcportal/es/secureESNode.cmd
ORACLE_HOME/wcportal/es/installES.properties
    次に、正常にインストールされた場合の出力例を示します。
    ...

"**************** Creating the user crawladmin in Elasticsearch server... ****************"
Enter password for user 'crawladmin': ********
"Please input the admin user password when prompted for host password below."
Enter host password for user 'elastic':
"Create user crawladmin is successful."
"**************** Stopping Elasticsearch server ****************"
"**************** Starting Elasticsearch server, please wait... ****************"
"************ Elasticsearch server setup completed successfully. Elasticsearch server home is at: D:\Oracle\Middleware\esHome ************"
  5. 正常にインストールされたら、Elasticsearchが正しく構成されていることを確認します。

    1. Mozilla Firefoxブラウザを使用して、URL http://host:9200にアクセスします。

      ユーザー名とパスワードを入力する基本認証ダイアログが表示されます。

    2. WebCenter Portalで作成したクロール・ユーザー名とパスワードを入力します。「WebCenter Portalでのクロール管理ユーザーの作成」を参照してください。

      正常にログインできれば、Elasticsearch Serverは正しく構成されています。

      ノート:

      ログインできないか、Elasticsearchのインストールに失敗する場合は、次の場所にあるログを確認してください。

      /home/Oracle/product/esHome/esNode/logs

OHSを使用したクラスタおよびロード・バランシングの設定
WebCenter PortalでElasticsearchクラスタを使用するには、まずElasticsearchクラスタを設定する必要があります(3つ以上のElasticsearchサーバーが必要です)。その後、Oracle HTTP Server (OHS)を使用してElasticsearchクラスタでロード・バランシングを実行できます。クラスタ設定の場合は、Elasticsearchサーバーをインストールする前に、ホストの一部のシステム設定を変更する必要があります。

システム設定の変更

デフォルトでは、ElasticsearchサーバーはHTTPおよびトランスポート(内部)通信のループバック・アドレスにバインドされます。クラスタに参加するには、トランスポート通信を介してElasticsearchサーバーに到達でき、非ループバック・アドレスにトランスポートをバインドする必要があります。非ループバック・アドレスにバインドされると、Elasticsearchサーバーはブートストラップ・チェックを適用します。そのため、正常に実行するには、次のシステム設定をrootユーザーとして変更する必要があります:

  1. <install-user>の開いているファイル・ハンドルの最大数は65,536以上である必要があります。ログイン・ユーザーの現在の値は、ulimit -nコマンドを使用して取得されます。目的の値まで増やすには、/etc/security/limits.confファイルに次の行を追加します:
    <install-user>  -  nofile  65536
    ファイルを閉じて保存します。更新された設定を有効にするには、<install-user>がログアウトして再度ログインする必要があります。
  2. <install-user>の最大スレッド数は4096以上である必要があります。ログイン・ユーザーの現在の値は、ulimit -uコマンドを使用して取得できます。

    目的の値まで増やすには、次の行を /etc/security/limits.confファイルに追加します: 

    <install-user>  -  nproc  4096

    ファイルを閉じて保存します。更新された設定を有効にするには、<install-user>がログアウトして再度ログインする必要があります。

  3. <install-user>の最大仮想メモリー領域は262144以上である必要があります。現在の値は、コマンド/sbin/sysctl vm.max_map_countを使用して取得できます。

    目的の値まで増やすには、/etc/sysctl.confファイルに次を追加(または更新)します: 

    vm.max_map_count=262144
    ファイルを閉じて保存します。更新された設定を有効にするには、/sbin/sysctl -pコマンドをrootユーザーとして実行します。

プライマリ・ホストへのElasticsearchのインストール

システム設定を変更したら、Elasticsearchサーバーをクラスタ固有の構成でインストールする必要があります。インストールを続行する前に、クラスタのプライマリ・ホストを特定する必要があります。プライマリ・ホストは、Elasticsearchサーバーを最初にインストールする必要があるクラスタのホストの1つにすぎません。Elasticsearchサーバーをプライマリ・ホストにインストールする手順は、次のとおりです:

システム設定を変更したら、次に説明するように、Elasticsearchサーバーを特定の構成でインストールする必要があります:

  1. ORACLE_HOME/wcportal/es/installES.propertiesファイルを編集し、必要な値を指定します。クラスタ設定では、次のプロパティ値を指定し、クラスタのノードごとに値を同じにする必要があります:

    表10-2 プロパティ値

    プロパティ 値
    ELASTIC_SEARCH_CLUSTER_NAME <クラスタを識別する一意の値>
    ELASTIC_SEARCH_CLUSTER_HOST_LIST ["host1.example.com", "host2.example.com", "host3.example.com"]
    ELASTIC_SEARCH_CLUSTER_NODE_LIST ["node-1", "node-2", "node-3"]
    ELASTIC_SEARCH_CERTIFICATE_NAME <証明書の名前>
    ELASTIC_SEARCH_PRIMARY_HOST <プライマリ・ホストの完全修飾名>

    ここで、host[n].example.comは完全修飾ホスト名、node[n]はhost[n].example.comに対応するELASTIC_SEARCH_NODE_NAMEの値です。

  2. 次のコマンドを入力してElasticsearchおよびプラグインをインストールします。
    ORACLE_HOME/oracle_common/common/bin/wlst.sh
ORACLE_HOME/wcportal/es/installES.py
ORACLE_HOME/wcportal/es/installES.properties
    次に、Linuxに正常にインストールされた場合の出力例を示します:
    ...

-> Installing file:////tmp/webcenter-search-es-content-crawl-plugin.zip
-> Downloading file:////tmp/webcenter-search-es-content-crawl-plugin.zip
[=================================================] 100%   
-> Installed orcl-wcp-es-content-crawl-plugin
-> Please restart Elasticsearch to activate any plugins installed
Generating node certificate for secured communication...
Node certificate generated and password added to elasticsearch keystore successfully.
Creating the user crawladmin in Elasticsearch server...

...

The user crawladmin is created successfully.
Executing /home/Oracle/product/esHome/startElasticsearch.sh
Elasticsearch server installation is complete. Elasticsearch server home is at: /home/Oracle/product/esHome
  3. ElasticsearchがWindowsにインストールされている場合は、次のコマンドを実行してElasticsearchサーバーを保護します:
    ORACLE_HOME/wcportal/es/secureESNode.cmd
ORACLE_HOME/wcportal/es/installES.properties
  4. 正常にインストールされると、Elasticsearchサーバーが稼働します。Elasticsearchサーバーが正しく構成されていることを確認します。

プライマリ以外のホストへのElasticsearchのインストール

クラスタのプライマリ・ホストへのインストールが成功すると、Elasticsearchサーバーをクラスタの他のホスト(プライマリ以外のホスト)にインストールできます。Elasticsearchサーバーをプライマリ以外のホストにインストールする手順は、次のとおりです:

  1. ORACLE_HOME/wcportal/es/installES.propertiesファイルを編集し、必要な値を指定します。クラスタ設定では、次のプロパティ値を指定し、クラスタのノードごとに値を同じにする必要があります:

    表10-3 プロパティ値

    プロパティ 値
    ELASTIC_SEARCH_CLUSTER_NAME <クラスタを識別する一意の値>
    ELASTIC_SEARCH_CLUSTER_HOST_LIST ["host1.example.com", "host2.example.com", "host3.example.com"]
    ELASTIC_SEARCH_CLUSTER_NODE_LIST ["node-1", "node-2", "node-3"]
    ELASTIC_SEARCH_CERTIFICATE_NAME <証明書の名前>
    ELASTIC_SEARCH_PRIMARY_HOST <プライマリ・ホストの完全修飾名>
  2. 次のコマンドを入力してElasticsearchおよびプラグインをインストールします。
    ORACLE_HOME/oracle_common/common/bin/wlst.sh
ORACLE_HOME/wcportal/es/installES.py
ORACLE_HOME/wcportal/es/installES.properties
    正常にインストールされると、Elasticsearchサーバーは起動しません。次に、正常にインストールされた場合の出力例を示します。
    ...

-> Installing file:////tmp/webcenter-search-es-content-crawl-plugin.zip
-> Downloading file:////tmp/webcenter-search-es-content-crawl-plugin.zip
[=================================================] 100%   
-> Installed orcl-wcp-es-content-crawl-plugin
-> Please restart Elasticsearch to activate any plugins installed

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
NOTE: Elasticsearch server installation is not complete. Please copy the required files from the primary host as mentioned in the documentation and start the server to complete the installation.
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  3. ElasticsearchがWindowsにインストールされている場合は、次のコマンドを実行してElasticsearchサーバーを保護します:
    ORACLE_HOME/wcportal/es/secureESNode.cmd
ORACLE_HOME/wcportal/es/installES.properties
  4. ノード証明書(ELASTIC_SEARCH_CERTIFICATE_NAMEプロパティに指定されたファイル)およびelasticsearch.keystoreファイルを、プライマリ・ホストのES_HOME/esNode/configフォルダからプライマリ以外のホストのES_HOME/esNode/configフォルダにコピーします。
  5. 次のコマンドを実行して、Elasticsearchサーバーを起動します:
    # applicable if installing on Linux
ES_HOME/startElasticsearch.sh

# applicable if installing on Windows
ES_HOME/startElasticsearch.cmd
  6. Elasticsearchサーバーが稼働したら、Elasticsearchサーバーが正しく構成されていることを確認します。
クラスタ設定の検証
クラスタ設定を検証するには、Mozilla Firefoxブラウザを使用してURL http://host1.example.com:9200にアクセスします。
ユーザー名とパスワードを入力する基本認証ダイアログが表示されます。WebCenter Portalで作成したクロール・ユーザー名とパスワードを入力します。ログインに成功したら、URL http://host1.example.com:9200/_cluster/healthにアクセスします。受信したレスポンスを確認すると、ノードの数は次のようになります:
"number_of_nodes": 3
これは、クラスタが3つのノードから構成されて正常に設定されていることを示します。

ノート:

前述のステップは、クラスタの一部である任意のホスト名を使用して検証できます。
OHSを使用したロード・バランシングの設定
Oracle HTTP Server (OHS)を使用して、Elasticsearchクラスタでロード・バランシングを実行できます。これを行うには、OHSの仮想ホスト構成を使用する必要があります。OHSの仮想ホストは、サーバー名またはポート番号に基づいて構成できます。ポート・ベースの仮想ホストの構成例は次のとおりです:
  1. ファイルwcp-search.confをmoduleconfディレクトリに作成します(これは、ファイルhttpd.confがあるディレクトリに置く必要があります)。ポート・ベースの仮想ホストの構成例は次のとおりです:
    <Location />
  WLSRequest ON
  SetHandler weblogic-handler
  WebLogicCluster host1.example.com:9200,host2.example.com:9200,host3.example.com:9200
  WLIOTimeoutSecs 30000
  WLSocketTimeoutSecs 600
</Location>

    構成されたポートを使用してOHSサーバーにアクセスすると、リクエストはWebLogicCluster構成に示されているホストのいずれかにリダイレクトされます。

  2. OHSを再起動します。
ロード・バランシング設定の検証
ロード・バランシング設定を検証するには、Mozilla Firefoxブラウザを使用して、前述の構成済のOHS URLにアクセスします。
ユーザー名とパスワードを入力する基本認証ダイアログが表示されます。WebCenter Portalで作成したクロール・ユーザー名とパスワードを入力します。ログインに成功したら、URL http://OHS-HOST:OHS-PORT/_cluster/healthにアクセスします。受信したレスポンスを確認すると、ノードの数は次のようになります:
"number_of_nodes": 3

これは、OHSを使用したロード・バランシングが3つのノードで正常に設定されていることを示します。

HTTPSを使用したElasticsearchの保護
Elasticsearch 7.xサーバーは、クライアントとElasticsearchサーバー間の通信がSSLを介して発生するように、HTTPSを使用して保護できます。構成するには、次のステップが必要です:
  1. Elasticsearchサーバーを停止します。
  2. 次の環境変数を設定します。
    • ES_HOME - これをElasticsearchホーム・ディレクトリに設定します。
    • JAVA_HOME - これをJavaホーム・ディレクトリに設定します。
    • PATH - $JAVA_HOME/binを使用するように更新します。
  3. 任意の単一ノードで、クラスタ内のノードの証明書および秘密キーを生成します。プロンプトが表示されたら、証明書のパスワードを指定します。
    $ES_HOME/elasticsearch/bin/elasticsearch-certutil cert -s -out $ES_HOME/esNode/config/https-certificate.p12 --dns <DNS_name>
    <DNS_name>は、クラスタのノードの完全修飾ホスト名のカンマ区切りリストです。
  4. 上で使用されるパスワードはElasticsearchキーストアに格納する必要があります。次のコマンドを実行してパスワードを格納します:
    $ES_HOME/elasticsearch/bin/elasticsearch-keystore add xpack.security.http.ssl.keystore.secure_password
$ES_HOME/elasticsearch/bin/elasticsearch-keystore add xpack.security.http.ssl.truststore.secure_password
  5. $ES_HOME/esNode/config/https-certificate.p12および $ES_HOME/esNode/config/elasticsearch.keystoreファイルをクラスタ内のすべてのノードの$ES_HOME/esNode/configディレクトリにコピーします。
  6. クラスタの各ノードで、$ES_HOME/esNode/config/elasticsearch.ymlファイルに次の構成を追加します:
    xpack.security.http.ssl.enabled: true
xpack.security.http.ssl.verification_mode: certificate
xpack.security.http.ssl.keystore.path: https-certificate.p12
xpack.security.http.ssl.truststore.path: https-certificate.p12
  7. Elasticsearchサーバーを起動します。
WebCenter Portalキーストアへの証明書の追加
クライアントとサーバー間の信頼を確立するには、Elasticsearchサーバー証明書をWebCenter Portalキーストアに追加する必要があります。

Elasticsearchサーバーからの証明書のダウンロード

次のステップを使用して、Elasticsearchサーバーから証明書を取得できます:
  1. Firefoxブラウザを開き、次のコマンドを使用してElasticsearchサーバーに接続します:
    https://host_name:9200

    ここで、host_nameはElasticsearchサーバーの名前です。

  2. セキュリティ例外を受け入れて続行します。プロンプトが表示されたら、ログイン資格証明を指定します。
  3. 「URL」フィールドで「ロック」アイコンをクリックし、安全でない接続、「詳細情報」の順にナビゲートします。
  4. ポップアップ・ウィンドウで、「証明書の表示」ボタンをクリックします。
  5. リンクPEM (証明書)をクリックして、.PEM形式で証明書をダウンロードします。

WebCenter Portalキーストアへの証明書の追加

証明書がダウンロードされたら、WebCenter Portalキーストアにインポートする必要があります。

インポートするには:

  1. WebCenter Portalサーバーで次のコマンドを実行し、プロンプトが表示されたらキーストアのパスワードを入力します:
    keytool -importcert -alias es_cert -file /filepath/sslcertificate/es_certificate.pem -keystore <JDK_path>/jre/lib/security/cacerts
  2. 管理対象サーバーを再起動します。
HTTPSで実行されているElasticsearchサーバーへの接続の検索
検索接続が存在しない場合、HTTPSで実行されているElasticsearchサーバーへの検索接続は、次のコマンドを使用して作成できます:
createSearchConnection(appName='webcenter', name='<conn_name>', url='https://<ES_host>:<ES_port>', indexAliasName='<index_alias>', appUser='<app_user>', appPassword='<app_user_password>')

検索接続がすでに存在する場合は、HTTPSを使用するように更新する必要があり、次のコマンドを使用して実行できます: 

setSearchConnection(appName='webcenter', name='<existing_conn_name>', indexAliasName='<existing_index_alias>', appUser='<app_user>', appPassword='<app_user_password>', useSSL=1)

OpenSearchを使用したOCI検索サービスとの統合

OpenSearchを構成して、WebCenter Portalのオブジェクトの索引付けと検索を行います。

トピック:

OpenSearchを使用したOCI検索サービスの理解

OpenSearchを使用したOracle Cloud Infrastructure (OCI)検索サービスは、Oracle管理サービスとして提供されるインサイト・エンジンです。停止時間なしで、サービスのパッチ適用、更新、アップグレード、バックアップおよびサイズ変更がOracleによって自動化されます。大量のデータをすばやく格納、検索および分析し、結果をほぼリアルタイムで確認できます。

OCI Search Serviceは、実績のあるOpenSearchテクノロジとOCIの柔軟性を兼ね備えています。

WebCenter Portalでは、OpenSearchを使用したOCI検索サービスを構成して次のリソースを検索できます。

  • ドキュメント(Wikiおよびブログを含む)

  • ポータル、ページ・メタデータ、ページ・コンテンツ(HTML、テキストおよびスタイル・テキスト・コンポーネントのコンテンツ)、リストおよび人的リソース

  • お知らせおよびディスカッション(以前のリリースからアップグレードされたポータルでのみ使用可能)。

ノート:

Oracle WebCenter Portalは、オンプレミスでホストして実行できますが、WebCenter Portalをクラウドで実行する際にOCI OpenSearchとの統合を最大限に活用するために、WebCenter PortalをOCIにホストすることを常にお薦めします。

OpenSearchを使用したOCI検索サービスを構成するための前提条件

次の要件を確認してください。

  1. OCIテナンシの詳細を取得します。
  2. Oracle Cloudコンソールで必要なサービス・ポリシーを作成し、ニーズに合せてカスタマイズします。たとえば、任意のユーザーを目的のグループに変更し、必要に応じてコンパートメントへのパスを指定します。

    機能するポリシー:

    Allow group <your_group> to manage opensearch-family in compartment opensearch
Allow service opensearch to manage vcns in compartment opensearch
Allow service opensearch to manage vnics in compartment opensearch
Allow service opensearch to use subnets in compartment opensearch
Allow service opensearch to use network-security-groups in compartment opensearch
  3. パブリック・サブネットとプライベート・サブネットを持つVCNを作成します。
    • 簡略化したプロセス:
      1. Oracle Cloudコンソールのナビゲーション・メニューを開きます。
      2. 「ネットワーキング」をクリックし、「仮想クラウド・ネットワーク」をクリックします。
      3. 「VCNウィザードの起動」をクリックし、「インターネット接続性を持つVCNの作成」をクリックします。
    • カスタム・プロセス:
      1. Oracle Cloudコンソールのナビゲーション・メニューを開きます。
      2. 「ネットワーキング」をクリックし、「仮想クラウド・ネットワーク」をクリックします。
      3. 「VCNの作成」をクリックし、必要な詳細を指定します。
  4. VCNのパブリック・サブネットにVMインスタンスを作成します。
    1. Oracle Cloudコンソールのナビゲーション・メニューを開きます。
    2. 「コンピュート」,をクリックし、「インスタンス」をクリックします。
    3. 「インスタンスの作成」をクリックします。
    4. 「名前」を入力し、コンパートメントを選択します。
    5. 「イメージとシェイプ」領域で、デフォルト値(Oracle Linux 7、VM.Standard.E4.Flex)を使用します。
    6. 「ネットワーキング」領域で、パブリック・サブネットを選択し、パブリックIPを割り当てます。
    7. 「SSHキーの追加」領域で、既存のSSHキーを使用するか、新しいSSHキーを生成するかを決定します。新しいSSHキーを生成する場合は、忘れずにキーをダウンロードしてください。

WebCenter PortalでのOpenSearchを使用したOCI検索サービスの構成ロードマップ

表10-4 ロードマップ - WebCenter PortalでのOpenSearchを使用したOCI検索サービスの設定

担当者 タスク

管理者

WebCenter Portalでのクロール管理ユーザーの作成

管理者

OCIでのOpenSearchインスタンスの作成

管理者

WebCenter PortalキーストアへのOpenSearch SSL証明書のインポート

管理者

WebCenter Contentの検索の構成

管理者

 WebCenter Portalの検索の構成
管理者 検索クローラの構成

管理者

(オプション) WebCenter Portal管理での検索設定のカスタマイズ

管理者

(オプション)検索のグローバル属性の変更

管理者

(オプション)検索のカスタム属性の構成
管理者

(オプション)カスタム・ファセットの作成

OCIでのOpenSearchインスタンスの作成

タスク1: OCI検索サービス・クラスタの作成

  1. Oracle Cloudコンソールのナビゲーション・メニューを開きます。「データベース」、OCI検索サービスの順にクリックし、「クラスタ」をクリックします。次に、「クラスタの作成」をクリックします。クラスタを作成するクラスタ名とコンパートメントを選択します。

    図10-1 クラスタの作成


    クラスタの構成

  2. 「次」をクリックします。
  3. クラスタのサイズ設定を選択し、「次」をクリックします。

    図10-2 ノードの構成


    ノードの構成

  4. 作成したVCNを選択し、プライベート・サブネットを選択します。

    図10-3 ネットワークの構成


    ネットワークの構成

  5. 「次」をクリックします。クラスタの作成後、OCI検索サービス・クラスタの詳細ページで、APIエンドポイントと、代替で使用できるIPアドレスをメモします。

    図10-4 クラスタ情報


    クラスタ情報

タスク2: VCNセキュリティ・リストでのセキュリティ・ルールの作成

VCNで、次のセキュリティ・ルールを使用してセキュリティ・リストを作成します。または、VCNのデフォルトのセキュリティ・リストに追加できます。

  1. VCNの詳細ページを開き、「セキュリティ・リスト」をクリックし、「セキュリティ・リスト」を選択して、「イングレス・ルールの追加」をクリックします。

    ノート:

    ポート9200 (OpenSearch)のルールと5601 (OpenSearch Dashboards)のルールを追加します。

    図10-5 ポート: 9200のTCPトラフィック


    ステートレス

    図10-6 ポート: 5601のTCPトラフィック


    TCPトラフィック

    図10-7 セキュリティ・リスト


    セキュリティ・リスト

タスク3: OCI検索サービスへの接続のテスト - OpenSearchエンドポイント

次のオプションのいずれかを使用します。

  1. オプション1: 作成されたVMインスタンス内から
    1. SSH経由でインスタンスに接続します:
      ssh -i ~/.ssh/id_rsa_opensearch.key opc@<your_VM_instance_public_IP>
    2. 次のいずれかのコマンドを実行します。
      curl https://mycluster.opensearch.us.example.com:9200
# OpenSearch API endpoint example

      curl https://<your_opensearch_private_IP>:9200 --insecure
# OpenSearch private IP example
  2. オプション2: ポート転送を通じてローカル・マシンから
    1. ターミナルで次のポート転送SSHコマンドを実行します。接続がアクティブなままになるように、ターミナルを閉じないでください。
      ssh -C -v -t -L 127.0.0.1:5601:<your_opensearch_dashboards_private_IP>:5601 -L 127.0.0.1:9200:<your_opensearch_private_IP>:9200 opc@<your_VM_instance_public_IP> -i <path_to_your_private_key>
    2. 新しいターミナル・ウィンドウを開いて次のコマンドを実行します。
      curl https://localhost:9200 --insecure
      ステップが正しく実行されると、使用されるオプションに関係なく、レスポンスが次のように表示されます。
      {
"name" : "opensearch-master-0",
"cluster_name" : "opensearch",
"cluster_uuid" : "M6gclrE3QLGEBlkdme8JkQ",
"version" : {
   "distribution" : "opensearch",
   "number" : "1.2.4-SNAPSHOT",
   "build_type" : "tar",
   "build_hash" : "e505b10357c03ae8d26d675172402f2f2144ef0f",
   "build_date" : "2022-02-08T16:44:39.596468Z",
   "build_snapshot" : true,
   "lucene_version" : "8.10.1",
   "minimum_wire_compatibility_version" : "6.8.0",
   "minimum_index_compatibility_version" : "6.0.0-beta1"
},
"tagline" : "The OpenSearch Project: https://opensearch.org/"
}

タスク4: OpenSearchクラスタのプライベートIPのメモ

次の図に示すように、クラスタのプライベートIPをメモすることができます。

図10-8 クラスタ情報


クラスタ情報

WebCenter PortalキーストアへのOpenSearch SSL証明書のインポート

OpenSearch SSL証明書をインポートするには:

  1. パブリック・サブネットに作成されたパブリックVMにログインします(「OpenSearchを使用したOCI検索サービスを構成するための前提条件」のステップ2を参照)。 
    ssh -i ~/.ssh/id_rsa_opensearch.key opc@<your_VM_instance_public_IP>
  2. パブリックVMで次のコマンドを実行して、OCI OpenSearchのSSL証明書を取得します:
    $ echo -n | openssl s_client -showcerts -connect Opensearch_Private_IP:9200 -servername opensearch.us-ashburn-1.oci.oracleiaas.com|sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > /tmp/opensearch_cert_chain.crt

    ここで、servernameはOpenSearchクラスタが実行されているサーバーの名前です。servernameは、OCI IDを除くAPIエンドポイントの最後の部分です。(上のイメージを参照してください)

  3. WebCenter PortalがOpenSearch証明書を信頼するためには、OpenSearch証明書をWebCenter Portalトラスト・ストアにインポートする必要があります。次のWLSTコマンドを使用して、WebCenter Portalトラスト・ストアに証明書をインポートします。 
    $ svc=getOpssService(name='KeyStoreService')
$ svc.importKeyStoreCertificate(appStripe='system',name='trust',password='',alias='opensearch_cert_chain',type='TrustedCertificate',filepath='/tmp/opensearch_cert_chain.crt',keypassword='')
$ syncKeyStores(appStripe='system',keystoreFormat='KSS')
$ exit()
  4. ホスト名の検証を無効化するには:
    1. WebLogicコンソールにログインします。
    2. 「ロックして編集」ボタンをクリックします。
    3. 左側のナビゲーションから「サーバー」を選択し、「サーバー名」、「構成」、「SSL」、「拡張」の順に選択します。「ホスト名の検証」ドロップダウン・メニューから「なし」を選択します。「保存」をクリックして、変更をアクティブにします。

WebCenter Portalでのクロール管理ユーザーの作成

Elasticsearchを使用して検索するには、WebCenter Portalとバックエンドのアイデンティティ管理サーバーで、既存のユーザーをクロール管理に指定するか、クロール管理ユーザー(mycrawladminなど)を作成します。クロール管理ユーザーは一度だけ作成する必要があります。

ノート:

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

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

  1. 「データ・ブラウザ」タブで、ターゲットcnに移動し、「作成」をクリックします。

    この例では、"dc=com,dc=oracle,dc=us,cn=Users"に移動します。

  2. 「オブジェクト・クラスの追加」ダイアログで、該当するオブジェクト・クラスを選択し、「OK」をクリックします。

    図10-9 Oracle Directory Services Manager - オブジェクト・クラスの追加

    図10-9の説明が続きます
    「図10-9 Oracle Directory Services Manager - オブジェクト・クラスの追加」の説明
  3. 識別名(DN)パスを見つけて、「選択」をクリックします。

    この例では、"dc=com,dc=oracle,dc=us,cn=Users"を選択します。

    wcadm_selectdn1.gifの説明が続きます
    図wcadm_selectdn1.gifの説明
  4. 「新規エントリの作成」ダイアログで、プロパティを入力し、「次へ」をクリックします。

    図10-10 Oracle Directory Services Manager - 新規エントリの作成

    図10-10の説明が続きます
    「図10-10 Oracle Directory Services Manager - 新規エントリの作成」の説明
  5. 新規エントリが正常に作成されたことを確認したら、「終了」をクリックします。

    図10-11 Oracle Directory Services Manager - ステータス

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

WebCenter Contentの検索の構成

このトピックでは、WebCenter Contentの検索を構成する方法を説明します。

ノート:

次のトピックは、WebCenter Contentが構成されている場合にのみ適用されます。

WebCenter Contentでのクロール・ユーザーの作成

この手順では、WebCenter Contentでクロール・ユーザーを新規作成する方法について説明します。

adminロールを持つユーザーでクロールする場合、クロール・ユーザーとして管理ユーザー・アカウントを使用します。非管理ユーザーでクロールする場合は、新しいクロール・ユーザーを作成します。

WebCenter Contentでクロール・ユーザーを作成するには:
  1. WebCenter Contentに管理者としてログオンします。
  2. sescrawlerroleロールを作成するには、次を実行します。
    1. 「WebCenter Content」ホーム・ページで、「管理」メニューから「管理アプレット」を選択します。
    2. 「ユーザー管理」を選択します。
      「ユーザー管理」ダイアログが開きます。

      図10-12 「ユーザー管理」ページ


      図10-12の説明が続きます
      「図10-12 「ユーザー管理」ページ」の説明

    3. 「ユーザー管理」ダイアログで、「セキュリティ」タブ→「ロールの権限」を選択します。
    4. 「ロールの権限」ダイアログで、「新規ロールの追加」をクリックします。
    5. 「新規ロールの追加」ダイアログで、「ロール名」および「ロール表示名」にsescrawlerroleを指定します。
    6. 「OK」をクリックします。
  3. ユーザーsescrawlerを作成し、そのユーザーにsescrawlerroleロールを割り当てるには、次を実行します。
    1. 「WebCenter Content」ホーム・ページで、「管理」メニューから「管理アプレット」を選択します。
    2. 「ユーザー管理」を選択します。
      「ユーザー管理」ダイアログが開きます。
    3. 「ユーザー」タブで、「追加」をクリックします。
    4. 「認証タイプ」に「ローカル」を選択して、「OK」をクリックします。
    5. 「ユーザーの追加」ダイアログで、名前にsescrawlerと入力してパスワードを指定します。
    6. 「ロール」タブで、「ロールの追加」をクリックし、sescrawlerroleを選択してユーザーにロールを割り当てます。
    7. 「OK」をクリックします。
    8. 「ユーザー管理」ダイアログを閉じます。
  4. WebCenter Contentホーム・ページで、「管理」→「管理サーバー」を開きます。「一般構成」を選択し、「追加の構成変数」セクションでsceCrawlerRole=sescrawlerroleエントリを追加します。
  5. WebCenter Contentを再起動します。

SESCrawlerExportコンポーネントの構成

開始する前に、 SESCrawlerExportコンポーネントが有効化されていることを確認してください。有効化されていない場合は、コンポーネントを有効にし(「WebCenterConfigureコンポーネントの有効化」を参照)、WebCenter Contentサーバーを再起動します。

管理ユーザーと非管理ユーザーに対してSESCrawlerExportコンポーネントを構成するには:
  1. システム管理者としてWebCenter Contentにログオンします。
  2. WebCenter Contentホーム・ページで、「管理」を開き、「SESCrawlerExport」を選択します。

    図10-13 WebCenter Content Serverの「管理」メニュー

    この画像は、SESCrawlerExportコンポーネントが表示された「管理」メニューを示しています。
  3. 「SESCrawlerExport管理」ページで、「SESCrawlerExportの構成」をクリックします。

    図10-14 「SESCrawlerExport管理」ページ

    この画像は、「SESCrawlerExportの構成」ボタンが表示された「SESCrawlerExport管理」ページを示しています。
  4. 「SESCrawlerExportの構成」ページで、「クローラ・ロール」の値を設定します。
    • 管理ユーザーに対してSESCrawlerExportを構成する場合は、「クローラ・ロール」の値にadminを設定します。
    • 非管理ユーザーに対してSESCrawlerExportを構成する場合は、「クローラ・ロール」の値にsescrawlerroleを設定します。
    次の図は、「クローラ・ロール」に非管理ユーザーのsescrawlerroleが設定されている「SESCrawlerExportの構成」ページを示しています。

    図10-15 「SESCrawlerExportの構成」ページ

    この画像は、「SESCrawlerExportの構成」ページの各種パラメータと、「更新」ボタンおよび「リセット」ボタンを示しています。

  5. 「更新」をクリックします。
  6. WebCenter Contentを再起動します。

WebCenter Portalの検索の構成

WebCenter Portalの検索を構成するには、WebCenter PortalとElasticsearchまたはOpenSearchを使用したOCI検索サービスとの間の接続を構成する必要があります。

トピック:

Elasticsearch用のWebCenter Portalの構成

WebCenter Portalの検索を構成するには、WebCenter PortalとElasticsearch間の接続を構成し、ElasticsearchでWebCenter Contentクロール・ユーザーおよびWebCenter Content管理ユーザーを構成する必要があります。

  1. Oracleホーム・ディレクトリに移動してWLSTスクリプトを起動します。
  2. Oracle WebCenter Portalドメイン(WC_Portal)サーバーに接続します。

  3. WLSTコマンド・プロンプトでWLSTコマンドのcreateCredを実行し、ElasticsearchでWebCenter Contentのクロール・ユーザーを構成します。
    createCred(map="oracle.es.security", key="content.crawl.credentials", user='wcc-crawl-user', password='wcc-crawl-password', desc="UCM Crawl User")

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

    • wcc-crawl-userはWebCenter Contentのクロール・ユーザーです。「WebCenter Contentでのクロール・ユーザーの作成」を参照してください

    • wcc-crawl-passwordはWebCenter Contentのクロール・ユーザーのパスワードです。

    • descはWebCenter Contentのクロール・ユーザーの説明です。

    次の例では、WebCenter Contentのクロール・ユーザーの構成方法を示します。

    createCred(map="oracle.es.security", key="content.crawl.credentials", user='sescrawler', password='welcome1', desc="UCM Crawl User")

  4. WLSTコマンド・プロンプトでWLSTコマンドのcreateCredを実行し、ElasticsearchでWebCenter Contentの管理ユーザーを構成します。
    createCred(map="oracle.es.security", key="content.admin.credentials", user='wcc-admin-user', password='wcc-admin-password', desc="UCM Admin User")
    各要素の意味は次のとおりです。
    • wcc-admin-userは、WebCenter Contentの管理ユーザーです。
    • wcc-admin-passwordは、WebCenter Contentの管理パスワードです。
    • descは、WebCenter Contentの管理ユーザーの説明です。
    次の例では、WebCenter Contentの管理ユーザーの構成方法を示します:
    createCred(map="oracle.es.security", key="content.admin.credentials", user='weblogic', password='welcome1', desc="UCM Admin User")
  5. ユーザー資格証明が追加されたことを確認するには:
    • Fusion Middleware Control http:<host:port>/emに接続します。
    • 「WebLogicドメイン」ドロップダウン・メニューの「セキュリティ」→「資格証明」を選択します。
    • oracle.es.securityを展開します。
    • 2つの資格証明があることを確認します:
      • content.admin.credentials: ElasticsearchのWebCenter Content管理ユーザー(たとえば、weblogic、またはContent Serverの管理権限を持つその他のユーザー)の場合
      • content.crawl.credentials: ElasticsearchのWebCenter Contentクロール・ユーザー(たとえば、sescrawlerユーザーやElasticsearchクロールの実行用に作成したユーザー)の場合
  6. Elasticsearchサーバーを停止して起動します。
  7. 次のように、WLSTコマンド・プロンプトでWLSTコマンドのcreateSearchConnectionを実行し、WebCenter PortalとElasticsearch間の接続を構成します。
    createSearchConnection(appName, name, url, indexAliasName, appUser, appPassword)

    ここで:

    • appNameはWebCenter Portalのアプリケーション名で、値はwebcenterです。

    • nameは接続名です。名前はアプリケーション内で一意である必要があります。たとえば、dev-esです。

    • urlはElasticsearchサーバーの場所です。たとえば、http://host:9200です

      ノート: Elasticsearchクラスタへの接続を選択した場合。ロード・バランサのURL (https://OHS-host:portなど)を入力します

    • indexAliasNameはElasticsearchサーバーの索引別名です。たとえば、webcenter_portalです。

      次の例に示すように、索引は別名を接頭辞として使用して作成されます。

      • <indexAliasName>_portals (たとえば、webcenter_portal_portalsです)

      • <indexAliasName>_documents (たとえば、webcenter_portal_documentsです)

      ノート: 名前は小文字の英数字とし、すべてのポータル・サーバー間で一意にする必要があります。

    • appUserはクロール管理ユーザーの名前です。たとえば、mycrawladminです。

    • appPasswordはクロール管理ユーザーのパスワードです。

    次の例では、WebCenter Portal (webcenter)とhttp://host:9200'にあるElasticsearch間の接続を作成します:

    createSearchConnection (appName='webcenter',name='dev-es', url='http://host:9200', indexAliasName='webcenter_portal', appUser='mycrawladmin', appPassword='welcome1')

    次の例では、WebCenter Portal (webcenter)とhttp://OHS-HOST:OHS-PORTにあるElasticsearchクラスタ間の接続を作成します:

    createSearchConnection (appName='webcenter',name='dev-es', url='http://OHS-HOST:OHS-PORT', indexAliasName='webcenter_portal', appUser='mycrawladmin', appPassword='welcome1')

OpenSearchを使用したOCI検索サービス用のWebCenter Portalの構成

WebCenter Portalの検索を構成するには、WebCenter PortalとOpenSearchを使用したOCI検索サービスの間の接続を構成し、クロール管理ユーザーにクロール・アプリケーション・ロールを付与する必要があります。
  1. Oracleホーム・ディレクトリに移動してWLSTスクリプトを起動します。
  2. Oracle WebCenter Portalドメイン(WC_Portal)サーバーに接続します。

  3. WLSTコマンド・プロンプトで、grantAppRole WLSTコマンドを実行して、クロール管理ユーザーにアプリケーション・ロールを付与し、WebCenter Portalユーザーのかわりに検索を実行できるようにします。
    grantAppRole(appStripe='webcenter', appRoleName='webcenter#-#defaultcrawl', principalClass='weblogic.security.principal.WLSUserImpl', principalName='crawl-admin-user')

    ここで、crawl-admin-userはクロール管理ユーザーです。

    次の例では、クロール管理ユーザーにアプリケーション・ロールを付与する方法を示します。
    grantAppRole(appStripe='webcenter', appRoleName='webcenter#-#defaultcrawl', principalClass='weblogic.security.principal.WLSUserImpl', principalName='mycrawladmin')
  4. 次のように、WLSTコマンド・プロンプトでWLSTコマンドのcreateSearchConnectionを実行し、WebCenter PortalとElasticsearch間の接続を構成します。
    createSearchConnection(appName, name, url, indexAliasName, appUser, appPassword)

    ここで:

    • appNameはWebCenter Portalのアプリケーション名で、値はwebcenterです。

    • nameは接続名です。名前はアプリケーション内で一意である必要があります。たとえば、dev-esです。

    • urlは、OpenSearchを使用したOCI検索サービス・サーバーの場所です。たとえば、https://OpensearchPrivateIP:9200などです

    • indexAliasNameは、OpenSearchを使用したOCI検索サービス・サーバーの索引別名の名前です。たとえば、webcenter_portalです。

      次の例に示すように、索引は別名を接頭辞として使用して作成されます。

      • <indexAliasName>_portals (たとえば、webcenter_portal_portalsです)

      • <indexAliasName>_documents (たとえば、webcenter_portal_documentsです)

      ノート: 名前は小文字の英数字とし、すべてのポータル・サーバー間で一意にする必要があります。

    • appUserはクロール管理ユーザーの名前です。たとえば、mycrawladminです。

    • appPasswordはクロール管理ユーザーのパスワードです。

    次の例では、WebCenter Portal (webcenter)とhttps://OpensearchPrivateIP:9200にあるOpenSearchを使用したOCI検索サービスの間の接続を作成します。

    createSearchConnection (appName='webcenter',name='dev-es', url='https://OpensearchPrivateIP:9200', indexAliasName='webcenter_portal', appUser='mycrawladmin', appPassword='welcome1')

WebCenter Portalでのユーザーの同期

ポータルのフル・クロールを実行する前に、LDAP同期WLSTコマンドを実行して、すべてのユーザーをポータルで使用できるようにしておくことをお薦めします。

WebCenter Portalでユーザーを同期するには:
  1. Oracleホーム・ディレクトリに移動してWLSTスクリプトを起動します。
  2. Oracle WebCenter Portalドメイン(WC_Portal)サーバーに接続します。
  3. WLSTコマンド・プロンプトでWLSTコマンドのstartSyncProfilesを実行し、プロファイル情報を同期します。
    startSyncProfiles(appName='webcenter')

    ノート:

    プロファイル情報の同期には、ユーザー数によって少し時間がかかる場合があります。

  4. isSyncProfilesRunningコマンドを実行して、ユーザー同期が完了していることを確認します。
    isSyncProfilesRunning(appName='webcenter')

検索クローラの構成

次のタイプのクローラを構成して、WebCenter Portalリソースを索引付けできます。

  • ポータル・クローラ: ポータル・クロール・ソースを使用して、リスト、ページ・メタデータ、ページ・コンテンツ(HTML、テキストおよびスタイル・テキストの各コンポーネントのコンテンツ)、ポータル、プロファイルなどの特定のオブジェクトをクロールします。

  • ドキュメント・クローラ: ドキュメント・クロール・ソースを使用して、Wikiやブログなどのドキュメントをクロールします。

  • ディスカッション・クローラ: ディスカッション・クロール・ソースを使用して、ディスカッション・フォーラムおよびお知らせをクロールします。このオプションは、ディスカッションが含まれている以前のリリースからアップグレードされたポータルに対してのみ使用できます。

次のトピックでは、WebCenter Portal管理の「スケジューラ」UIを使用して、様々なクロール・ソースを作成する方法を説明します。

ポータル・クロール・ソースの作成

クロール・ソースを作成してリスト、ページ・メタデータ、ページ・コンテンツ(HTML、テキストおよびスタイル・テキストの各コンポーネントのコンテンツ)、ポータル、プロファイルなどのオブジェクトをクロールする手順:
  1. 「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「ツールとサービス」をクリックします。

    ブラウザに次のURLを入力して、直接「ツールとサービス」ページに移動することも可能です。 

    http://host:port/webcenter/portal/admin/settings/tools
  2. 検索のアイコンをクリックして「検索設定」ページを開きます。

    図10-16 Elasticsearchの「設定」

    この図は、「検索設定」ページの検索設定オプション(検索範囲、カスタム属性など)を示しています。
  3. 「スケジューラ」タブで「ポータル」クロール・ソースを選択し、「編集」をクリックします。

    図10-17 Elastic Searchの設定の「スケジューラ」

    この画像は、「検索設定」ページを示しています。
  4. 「ポータル・クロール・ソースの編集」ページで、次のソース・パラメータを必要に応じて変更します。

    • 最大接続試行回数: 構成URLにアクセスするための接続試行の最大数。2から10までの値を選択します。

    • 構成URL: RSSクロール・サーブレットのURL。たとえば: http://wcp-host:wcp-port/rsscrawl

    図10-18 Elastic Searchの「ポータル・クロール・ソースの編集」

    この画像は、「ポータル・クロール・ソースの編集」ページを示しています。
  5. WebCenter Portalのクロール管理ユーザーの資格証明を入力します。
  6. 「テスト」をクリックして、接続をテストします。
  7. 「保存して閉じる」をクリックして、変更内容を保存します。

ドキュメント・クロール・ソースの作成

WebCenter Contentを構成した場合は、ドキュメント(Wikiやブログを含む)のクロール・ソースを作成できます。
  1. 「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「ツールとサービス」をクリックします。

    ブラウザに次のURLを入力して、直接「ツールとサービス」ページに移動することも可能です。 

    http://host:port/webcenter/portal/admin/settings/tools
  2. 検索のアイコンをクリックして「検索設定」ページを開きます。
  3. 「スケジューラ」タブで「ドキュメント」クロール・ソースを選択し、「編集」をクリックします。

    図10-19 Elastic Searchの設定の「スケジューラ」

    この画像は、「検索設定」ページを示しています。
  4. 「ドキュメント・クロール・ソースの編集」ページで、次のソース・パラメータを必要に応じて変更します。

    • 最大接続試行回数: 構成URLにアクセスするための接続試行の最大数。2から10までの値を選択します。

    • 構成URL: Webcenter ContentのSESCrawlerExportコンポーネントのURL。

      たとえば: http://wcc-host:wcc-port/cs/idcplg?IdcService=SES_CRAWLER_DOWNLOAD_CONFIG&source=source_name

      source_nameは、Webcenter ContentのSESCrawlerExportコンポーネントのソース名(sceSourceName)パラメータで使用される文字列の1つにする必要があります。

      SESCrawlerExportパラメータの詳細は、『Oracle WebCenter Contentの管理』のSESCrawlerExportパラメータの構成に関する項を参照してください。

      たとえば: http://host.example.con:port/cs/idcplg?IdcService=SES_CRAWLER_DOWNLOAD_CONFIG&source=esDS

    図10-20 Elastic Searchのドキュメント・クロール・ソースの編集

    この画像は、「ドキュメント・クロール・ソースの編集」ページを示しています。
  5. WebCenter Contentのクロール管理ユーザーのログイン資格証明を入力します。
  6. 「テスト」をクリックして、接続をテストします。
  7. 「保存して閉じる」をクリックして、変更内容を保存します。

コンテンツのスナップショットの取得

スナップショットにより、SESCrawlerExportコンポーネントのFeedLocパラメータで指定された場所で、configFile.xmlが生成されます。XMLフィードは、wikisなどのソース名でサブディレクトリに作成されます。コンテンツ・サーバー・インスタンスに格納されているアイテム数および生成しているソース数によっては、スナップショットの実行に多少時間がかかることがあります。

ノート:

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

コンテンツのスナップショットを取得するには:
  1. システム管理者としてWebCenter Contentにログオンします。
  2. 「管理」ドロップダウン・メニューから、「SESCrawlerExport」を選択します。
  3. 「すべてのソース」を選択して「タスク・スナップショット」をクリックします。

ディスカッション・クロール・ソースの作成

このオプションは、ディスカッションを使用する以前のリリースからアップグレードされたポータルに対してのみ使用できます。ディスカッション・フォーラムとお知らせをクロールするためのクロール・ソースを作成するには:
  1. 「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「ツールとサービス」をクリックします。

    ブラウザに次のURLを入力して、直接「ツールとサービス」ページに移動することも可能です。 

    http://host:port/webcenter/portal/admin/settings/tools
  2. 検索のアイコンをクリックして「検索設定」ページを開きます。
  3. 「スケジューラ」タブで「ディスカッション」クロール・ソースを選択し、「編集」をクリックします。

    図10-21 Elasticsearchの設定の「スケジューラ」

    この画像は、Elasticsearchの設定の「スケジューラ」を示しています。
  4. 「ディスカッション・クロール・ソースの編集」ページで、次のソース・パラメータを必要に応じて変更します。

    • データベース接続文字列: ディスカッション・スキーマのjdbc url。文字列の書式は、jdbc:oracle:thin@host:port:servernameです。

    図10-22 Elastic Searchのドキュメント・クロール・ソースの編集

    この画像は、「ディスカッション・クロール・ソースの編集」ページを示しています。
  5. ディスカッション・クローラ・スキーマのユーザー名(Prefix_Discussions_Crawlerなど)とパスワードを入力します。
  6. 「テスト」をクリックして、接続をテストします。
  7. 「保存して閉じる」をクリックして、変更内容を保存します。

WebCenter PortalでのAutoSuggestの有効化

WebCenter Portalでは、autosuggestを有効にすると、検索フィールドにキーワードを入力したときに提示されるキーワードのリストを表示できます。提示されるキーワードは、最近アクセスしたポータルに基づきます。

属性wcEnableAutoSuggestは、autosuggestを構成するために使用します。デフォルトでは、属性はfalseに設定されています。WebCenter Portalの「管理」→「属性」ページで属性の値を変更できます。値を変更したら、WebCenter Portalサーバーを再起動して、変更を有効にする必要があります。

デフォルト値を変更するには:
  1. 管理者としてWebCenter Portalにログインします。
  2. ポータル・ブラウザで、「管理」タイルをクリックして、左側のペインの「属性」をクリックします。
  3. 「属性」ページで、wcEnableAutoSuggestの「アクション」アイコンをクリックし、「属性の編集」を選択します。
    この図は、autosuggest属性がtrueに設定された「属性」ページを示しています。
  4. 「属性の編集」ダイアログで、属性をtrueに変更します。無効化するには、属性値をfalseに設定します。
  5. 「OK」をクリックします。
  6. WebCenter Portalを再起動します。

検索のカスタム属性の構成

WebCenter Portalを使用して検索すると、特定の事前定義済属性のみが検索結果に表示されます。WebCenter Portalでは、検索結果に追加属性を表示することができます。これを行うには、ポータル管理の「検索設定」ページを使用し、そのページの「カスタム属性」セクションで、検索結果に表示されるカスタム検索属性と、それらの属性の表示順序を選択できます。「検索設定」ページのこのリストは、search-service-attributes.xmlによって導出されます。これには、各サービスでクロールするすべての属性のリストが含まれます。検索の索引のタイプは、このメタデータによって定義されます。search-service-attributes.xmlファイルでは、新しいカスタム属性を追加することも、既存の属性を変更することも可能です。

次の手順では、ドキュメント・サービスを例として使用し、新しいカスタム検索属性を追加する方法について説明します:

新しいカスタム検索属性を追加するには:
  1. カスタム・メタデータ・フィールドを作成します。「Oracle WebCenter Contentへのカスタム・メタデータ・フィールドの追加」を参照してください。
  2. WebCenter Contentの索引を再構築します。「WebCenter Contentの索引の再構築」を参照してください。
  3. Oracle WebCenter ContentのSESCrawlerExportコンポーネントのメタデータ・リストを更新します。
    1. システム管理者としてOracle WebCenter Contentにログオンします。
    2. WebCenter Contentホーム・ページで、「管理」を開き、「SESCrawlerExport」を選択します。

      図10-23 WebCenter Content Serverの「管理」メニュー

      この画像は、SESCrawlerExportコンポーネントが表示された「管理」メニューを示しています。

    3. 「SESCrawlerExport管理」ページで、「SESCrawlerExportの構成」をクリックします。

      図10-24 「SESCrawlerExport管理」ページ

      この画像は、「SESCrawlerExportの構成」ボタンが表示された「SESCrawlerExport管理」ページを示しています。

    4. 「SESCrawlerExportの構成」ページで、「メタデータ・リスト」に新しいカスタム属性を追加します。

      この例では、Web Site Object Typeカスタム属性(xWebsiteObjectType)がメタデータに追加されます。 

      dDocAuthor,dDocAccount,dDocCreatedDate,dDocCreator,dDocFunction,dDocLastModifiedDate,dDocLastModifier,dDocName,
dID,dDocType,dFileSize,dFormat,dOriginalName,dOutDate,dRevLabel,dSecurityGroup,fParentGUID,sceHostname,xClbraRoleList,
xClbraUserList,xComments,xIdcProfile,xLibraryGUID,xWCTags,xWCWorkflowApproverUserList,xWCWorkflowAssignment,
xAnnotationDetails,dDocTitle,xRegionDefinition, xWebsiteObjectType
  4. 新しいカスタム属性をsearch-service-attributes.xmlファイルに追加します。
    1. 次のように、WLSTコマンド・プロンプトでWLSTコマンドのexportMetadataを実行し、MDSリポジトリから最新のsearch-service-attributes.xmlファイルをエクスポートします。
      exportMetadata('webcenter', 'WC_Portal', toLocation='/tmp/es', docs='/oracle/webcenter/search/scopedMD/
s8bba98ff_4cbb_40b8_beee_296c916a23ed/search-service-attributes.xml')
    2. 新しいカスタム属性をsearch-service-attributes.xmlファイルに追加します。

      この例では、Web Site Object Typeがsearch-service-attributes.xmlファイルのoracle.webcenter.doclibサービスIDの下に追加されます。 

      <service id="oracle.webcenter.doclib">
    <attribute name="author" displayNameKey="WC_AUTHOR" displayName="Author" type="keyword"/>
    <attribute name="doc_author" displayNameKey="WC_DOC_AUTHOR" displayName="Author" type="keyword" backendAttribute="dDocAuthor"/>
       … 
       …
       …
       …
   <attribute name="wcsecattr" displayNameKey="WC_SECATTR" displayName="Security Attributes" type="keyword" hidden="true"/>
   <attribute name="wcsecattr_deny" displayNameKey="WC_SECATTRDENY" displayName="Security Deny Attributes" type="keyword" hidden="true"/>
   <attribute name="website_object_type" displayNameKey="WC_xWebsiteObjectType" displayName="Web Site Object Type" 
type="keyword" backendAttribute="xWebsiteObjectType"/>
</service>
    3. 更新されたsearch-service-attributes.xmlファイルを保存し、WLSTコマンドのimportMetadaを使用してMDSリポジトリにインポートします。
       
      importMetadata('webcenter', 'WC_Portal', fromLocation='/tmp/es', docs='/oracle/webcenter/search/scopedMD/
s8bba98ff_4cbb_40b8_beee_296c916a23ed/search-service-attributes.xml')
  5. ポータル管理の「検索設定」ページにアクセスし、新しい属性が「カスタム属性」セクションの「使用可能な属性」に表示されているかどうかを確認します。

    この例では、Web Site Objectが新しく追加されたカスタム属性です。

    図10-25 新しく追加されたカスタム属性の確認

    図10-25の説明が続きます
    「図10-25 新しく追加されたカスタム属性の確認」の説明
  6. 「使用可能な属性」のリストから新しく追加されたカスタム属性を選択し、「組み込まれた属性」列に移動して、その属性が検索結果に表示されるようにします。
  7. 「適用」をクリックします。
  8. ポータルに移動し、「グローバル検索」フィールドに検索条件を入力して、「検索」アイコンをクリックします。

    次の図は、新しく作成されたカスタム属性Web Site Object Typeを含む検索結果を示しています:

    図10-26 作成されたカスタム属性が表示された検索結果

    図10-26の説明が続きます
    「図10-26 作成されたカスタム属性が表示された検索結果」の説明

カスタム・ファセットの作成

Oracle WebCenter Portalは、新しい検索を実行せずに検索結果を絞り込むファセット検索をサポートしています。ファセット検索を使用すると、検索結果が事前定義済カテゴリにグループ化されて、ユーザーが関連するカテゴリ(Author、Portal、Last Modified dateなど)に基づいて検索結果を絞り込むことができるようになります。

Oracle WebCenter Portalでは、デフォルトで、特定の事前定義済ファセットが「検索設定」ページで提供されます。ファセットのリストは、search-service-custom-facets.xmlメタデータ・ファイルによって導出され、ファイルの各ファセットはsearch-service-attributes.xmlメタデータ・ファイルにマップされます。

次に、search-service-custom-facets.xmlメタデータ・ファイルの例を示します。 

<custom-facet dataType="keyword" displayName="Author" displayNameKey="ES_FACET_AUTHOR" mappedSearchAttribute="author" name="Author" itemsToDisplay="20"/>
<custom-facet dataType="keyword" displayName="Service ID" displayNameKey="ES_FACET_SERVICEID" mappedSearchAttribute="wc_serviceId" name="Service ID"/>
<custom-facet dataType="keyword" displayName="Portal" displayNameKey="ES_FACET_SCOPE" mappedSearchAttribute="wc_scopeGuid" name="Scope GUID" itemsToDisplay="20"/>
<custom-facet dataType="keyword" displayName="Tags" displayNameKey="ES_FACET_TAGS" mappedSearchAttribute="wc_tagWords" name="Tags"itemsToDisplay="20"/>
<custom-facet dataType="keyword" displayName="Mimetype" displayNameKey="ES_FACET_MIMETYPE" mappedSearchAttribute="mimetype" name="Mimetype" itemsToDisplay="20"/>
<custom-facet dataType="date" displayName="Last Modified Date" displayNameKey="ES_FACET_LASTMODIFIED" mappedSearchAttribute="lastmodified"
name="Last Modified Date" />

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

  • nameは、ファセットの名前です。

  • displayNameKeyは、カスタム・ファセット・メタデータの値です。

  • displayNameは、ファセットの表示名です。

    ノート:

    ビジネスが複数の言語でサポートされている場合は、新しく追加されたカスタム・ファセットを任意の言語に翻訳できます。「検索ファセットの文字列の翻訳」を参照してください。

  • mappedSearchAttributeは、検索属性を持つカスタム・ファセットのマップに使用されます。この値は、search-service-attributes.xmlメタデータ・ファイルのname属性値と同じである必要があります。

  • dataTypeは、データ型です。使用可能なデータ型は、keyword、keyword_textおよびdateです。この値は、search-service-attributes.xmlメタデータ・ファイルの型の値と同じである必要があります。ユーザーがカスタム・ファセットの値に対して大/小文字を区別する検索を実行する場合は、データ型keywordを使用する必要があります。ユーザーがカスタム・ファセットの値に対して大/小文字を区別しない検索を実行する場合は、データ型keyword_textを使用する必要があります。
  • itemsToDisplayは、ファセットに表示される項目の最大数を定義するオプションの属性です。値が指定されていない場合は、WebCenter Portalの「管理」→「ツールとサービス」→「検索」オプションを使用してデフォルト値が構成されます。

    ノート:

    この属性は、dataType keywordを使用している場合にのみサポートされます。

ビジネス・ニーズに基づいて、Oracle WebCenter Portalで使用可能な任意のサービスのsearch-service-custom-facets.xmlメタデータ・ファイルのファセットのリストを追加または変更できます。たとえば、search-service-custom-facets.xmlメタデータ・ファイルにリストされたドキュメント、ユーザーおよびその他のサービスのカスタム・ファセットを追加できます。

この項では、ドキュメント・サービスにカスタム・ファセットを追加する方法を示します。ドキュメント・サービスのカスタム・ファセットを追加するには、最初にOracle WebCenter Contentでカスタム・メタデータ・フィールドを追加してから、コンテンツ索引を再構築する必要があります。

次のステップでは、ドキュメント・サービスにカスタム・ファセットを追加する方法について説明します。

  1. Oracle WebCenter Contentへのカスタム・メタデータ・フィールドの追加
  2. WebCenter Contentの索引の再構築
  3. SESCrawlerExportコンポーネントの構成
  4. 検索設定メタデータの構成
  5. 検索カスタム・ファセット・メタデータの構成
  6. ポータル内のドキュメントのメタデータの更新
  7. 検索結果でのファイル除外の構成

Oracle WebCenter Contentへのカスタム・メタデータ・フィールドの追加

ドキュメント・サービス用のカスタム・ファセットを追加するには、Oracle WebCenter Contentでメタデータ・フィールドの作成から開始する必要があります。この例では、新しいメタデータ・フィールドを作成し、そのフィールドにCustomMetadataFieldという名前を付けます。
Oracle WebCenter Contentにカスタム・メタデータ・フィールドを追加するには:
  1. システム管理者としてOracle WebCenter Contentにログインします。
  2. WebCenter Contentホーム・ページで、「管理」を開き、「管理アプレット」を選択します。
  3. 「管理アプレット」ページで、「構成マネージャ」をクリックします。
  4. 「構成マネージャ」ページで、「情報フィールド」タブをクリックし、「追加」をクリックして新しいカスタム・メタデータ・フィールドを追加します。
  5. 「メタデータ・フィールド名の追加」ダイアログで、メタデータの名前を入力します。たとえば、CustomMetadataFieldの場合、「OK」をクリックします。

    ノート:

    メタデータ・フィールド名は一意である必要があり、最大フィールド長は29文字です。文字、数値およびアンダースコア(_)のみを使用します。空白やその他の特殊文字は使用できません。

  6. 「メタデータ・フィールド名の追加」ダイアログで、次の情報を編集します。

    • フィールド・タイプ: ドロップダウン・リストから「ロング・テキスト」を選択します。

    • ユーザー・インタフェース上で有効化: フィールドを表示するには「有効」を選択します。このオプションを選択しないと、このフィールドは検索ページで非表示になります。

    • 検索索引の有効化: 検索用にメタデータ・フィールドを索引付する場合は、「索引付け」を選択します。このオプションを選択しなかった場合、フィールドは索引付けされず、検索ページにも表示されません。

  7. 「OK」をクリックします。
  8. 「構成マネージャ」ページで、「データベース設計の更新」をクリックし、「OK」をクリックして確認します。

WebCenter Contentの索引の再構築

Oracle WebCenter Contentでは、新しいメタデータ・フィールドを作成した後、リポジトリ・マネージャ・ユーティリティを使用してコレクションを再構築し、検索索引を更新する必要があります。

Oracle WebCenter Contentの検索索引を再構築および更新するには:
  1. システム管理者としてOracle WebCenter Contentにログインします。
  2. WebCenter Contentホームページで、「管理」を開き、「管理アプレット」を選択します。
  3. 管理アプレット・ページで「リポジトリ・マネージャ」をクリックします。
  4. 「リポジトリ・マネージャ」ページで、「インデクサ」タブをクリックします。
  5. 「コレクション再構築サイクル」セクションで、「開始」をクリックし、「OK」をクリックして次に進みます。

    ノート:

    検索索引の再構築には時間がかかります。

  6. 次に、新しいカスタム・メタデータ・フィールドを使用してSESCrawlerExportコンポーネントを構成します。「SESCrawlerExportコンポーネントの構成」を参照してください。

SESCrawlerExportコンポーネントの構成

新しく作成したメタデータ・フィールドで、Oracle WebCenter Content SESCrawlerExportコンポーネントを更新する必要があります。

SESCrawlerExportを更新するには:
  1. システム管理者としてWebCenter Contentにログインします。
  2. WebCenter Contentホーム・ページで、「管理」を開き、「SESCrawlerExport」を選択します。
  3. 「SESCrawlerExport管理」ページで、「SESCrawlerExportの構成」をクリックします。
  4. 「SESCrawlerExportの構成」ページで、「メタデータ・リスト」に新しく作成したメタデータを追加します。たとえば、xCustomMetadataFieldです。

    次の図に、「SESCrawlerExportの構成」ページを示します。ここで、新しく作成されたメタデータ・フィールドがメタデータ・リストに追加されます。

    図10-27 「SESCrawlerExportの構成」ページ

    この画像は、「SESCrawlerExportの構成」ページの各種パラメータと、「更新」ボタンおよび「リセット」ボタンを示しています。
  5. 「更新」をクリックします。
  6. 次に、新しい検索メタデータ・フィールドを、search-service-attributes.xmlファイルに追加します。「検索設定メタデータの構成」を参照してください。

検索設定メタデータの構成

定義済のカスタム属性を、Oracle WebCenter Portalに追加する必要があります。新しいカスタム属性を「検索設定」ページに表示するには、search-service-attributes.xmlを追加または更新する必要があります。

定義済のカスタム属性を追加するには:
  1. 次のように、WLSTコマンド・プロンプトでWLSTコマンドのexportMetadataを実行し、MDSリポジトリから最新のsearch-service-attributes.xmlファイルをエクスポートします。 
    exportMetadata(application='webcenter', server='WC_Portal', toLocation='/tmp/mds_dump', docs='/oracle/webcenter/search/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/search-service-attributes.xml')
  2. 新しい検索属性フィールドをid="oracle.webcenter.doclib"のセクション内のsearch-service-attributes.xmlファイルに追加します。タイプ・フィールドをキーワードに設定します。
    <service id="oracle.webcenter.doclib">
.........................
......................
<attribute name="custom_metadata_field" 
displayNameKey="WC_CustomMetadataField"
displayName="Custom Metadata Field"  type="keyword" 
backendAttribute="xCustomMetadataField"/>
</service>

    ノート:

    displayName属性を使用すると、言語のサポートが可能になり、displayNameはポータルの検索設定の「カスタム属性」セクションに表示されます。

    Oracle WebCenter Portalでは、他の言語への文字列の翻訳がサポートされます。displayName属性を他の言語に翻訳するには、「カスタム検索属性の文字列の翻訳」を参照してください。

  3. 更新されたsearch-service-attributes.xml ファイルを保存し、WLSTコマンドのimportMetadaを使用してMDSリポジトリにインポートします。 
     importMetadata(application='webcenter', server='WC_Portal', fromLocation='/tmp/mds_dump',docs='/oracle/webcenter/search/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/search-service-attributes.xml')
  4. 次に、新しいファセットを作成し、そのファセットを検索属性にマップします。「検索カスタム・ファセット・メタデータの構成」を参照してください。

検索カスタム・ファセット・メタデータの構成

WebCenter Portalの「検索設定」ページでは、検索結果とともに表示するファセットを選択できます。「検索設定」ページのこのリストは、search-service-custom-facets.xmlメタデータ・ファイルによって導出されます。これには、WebCenter Portalで使用されるファセットのリストが含まれます。search-service-custom-facets.xmlメタデータの各ファセットは、mappedSearchAttribute属性を使用してカスタム属性にマップされます。

検索カスタム・ファセット・メタデータを構成するには:
  1. 次のようにして、WLSTコマンド・プロンプトでexportMetadata WLSTコマンドを実行し、最新のsearch-service-custom-facets.xmlメタデータ・ファイルをMDSリポジトリからエクスポートします。
    exportMetadata(application='webcenter', server='WC_Portal', toLocation='/tmp/mds_dump',docs='/oracle/webcenter/search/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/search-service-custom-facets.xml')
  2. search-service-custom-facets.xmlファイルを開き、新しいファセットを作成して、ファセットを検索属性にマップします。
    ?xml version='1.0' encoding='UTF-8'?>
<search-service-custom-facets 
xmlns="http://xmlns.oracle.com/webcenter/search/customfacets">
.............................
<custom-facet name="CustomFacet" dataType="keyword" 
displayNameKey="WC_CustomFacet"
 displayName="Custom Facet" 
mappedSearchAttribute="custom_metadata_field"/>
</search-service-custom-facets>

    説明

    • custom-facet nameは、作成するカスタム・ファセットの名前です。

      ノート:

      dataTypeはkeywordである必要があります。また、displayName属性は言語サポートを提供するために使用する必要があり、displayNameはポータルの検索設定の「ファセット」セクションに表示されます。

      Oracle WebCenter Portalでは、他の言語への文字列の翻訳がサポートされます。displayName属性を他の言語に翻訳するには、「検索ファセットの文字列の翻訳」を参照してください。

    • mappedSearchAttributeは、カスタム属性を持つファセットのマップに使用される属性です。

      ノート:

      search-service-custom-facets.xmlメタデータ・ファイルのmappedSearchAttribute属性には、search-service-attributes.xmlメタデータ・ファイルのname属性で指定された値と同じ値が含まれている必要があります。この例では、custom_metadata_fieldを使用します。

  3. search-service-custom-facets.xmlメタデータ・ファイルを保存し、importMetada WLSTコマンドを使用してMDSリポジトリにインポートします。
    importMetadata(application='webcenter', server='WC_Portal', fromLocation='/tmp/mds_dump',docs='/oracle/webcenter/search/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/search-service-custom-facets.xml'
  4. WebCenter Portalにログインします。
  5. ポータル管理の「検索設定」ページにアクセスして、新しい属性が「ファセット」および「カスタム属性」セクションに表示されるかどうかを確認します。
  6. 新しく追加したファセットを選択して、「組み込まれたファセット」セクションに移動し、「適用」をクリックします。

    この例では、Custom Facetを選択します。

  7. 新しく追加したカスタム属性を選択して「組み込まれた属性」セクションに移動し、「適用」をクリックします。

    この例では、CustomMetadata Fieldを選択します。

ポータル内のドキュメントのメタデータの更新

新しく作成したメタデータ・フィールド値をポータル内のドキュメントに追加します。この例では、CustomMetadataFieldです。
ドキュメントのメタデータ・フィールド値を更新するには:
  1. ポータルで、ドキュメント・ページに移動します。
  2. 編集するドキュメントを選択し、「その他」ドロップダウン・メニューから「プロパティ」をクリックします。

    図10-28 コンテンツ・マネージャ

    この図は、「ドキュメント」ページを示しています。
  3. 「メタデータ」タブで、新しく追加したメタデータ・フィールドCustomMetadataFieldを見つけて、「編集」をクリックします。
  4. 新しく作成したメタデータ・フィールドの値を追加し、「保存」をクリックします。

    図10-29 ドキュメントの編集の「メタデータ」タブ

    図10-29の説明が続きます
    「図10-29 ドキュメントの編集の「メタデータ」タブ」の説明
  5. 「検索設定」ページに表示する新しいファセットに対して増分クロールを実行します。「手動による増分クロールの開始」を参照してください。
  6. ポータルに移動し、「グローバル検索」フィールドに検索条件を入力して、「検索」アイコンをクリックします。

    次の図に、新しく作成したファセットCustom Facetを含む検索結果を示します。

    図10-30 作成されたファセットが表示された検索結果

    この図は、検索結果が表示されたポータル・ページを示しています。

検索結果でのファイル除外の構成

検索結果から特定のファイル・タイプを除外するように構成できます。ファイル・タイプを除外するには、メタデータ・ファイルsearch-service-exclude-file-types.xmlにファイル・タイプを指定する必要があります。

検索結果でファイルの除外を構成するには、次のステップを実行する必要があります:
  1. メタデータ・サービス・ドキュメントのエクスポート
  2. フィルタするファイル・タイプの更新
  3. メタデータ・サービス・ドキュメントのインポート
  4. 検索結果でのファイル除外の確認

メタデータ・サービス・ドキュメントのエクスポート

MDS内のファイルの場所は、/oracle/webcenter/search/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/search-service-exclude-file-types.xmlです。

メタデータ・サービス・ドキュメントsearch-service-exclude-file-types.xmlをエクスポートするには、次のコマンドを入力します:
exportMetadata(application='webcenter', server='WC_Portal', toLocation='/tmp/search', docs='/oracle/webcenter/search/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/search-service-exclude-file-types.xml')

メタデータ・サービス・ドキュメントsearch-service-exclude-file-types.xmlで、除外するファイル・タイプをカスタマイズできます。

フィルタするファイル・タイプの更新

このメタデータは、検索中に除外する必要があるファイル・タイプを指定する方法について説明します。 

<?xml version='1.0' encoding='UTF-8'?>
<search-service-exclude-file-types xmlns="http://xmlns.oracle.com/webcenter/search/excludefiletypes">
  <exclude-file-in-search>
    <fileType extension=".xml" customType="site-studio-file" description="Exclude Site Studio data files that have extension .xml"/>
    <fileType extension=".wav" description="Exclude all the file types with extension .wav"/>
    <fileType extension=".jpeg" description="Exclude all the file types with extension .jpeg"/>
  </exclude-file-in-search>
</search-service-exclude-file-types>
次に、このメタデータに関する重要なポイントをいくつか示します:
  • 検索からフィルタするファイルの拡張子を、このメタデータ・ファイルに入力する必要があります。
  • customType属性はオプションです。検索結果でSite Studioのデータ・ファイルを除外する場合は、拡張子".xml"のcustomTypeをsite-studio-fileと指定します。
  • description属性はオプションです。除外されるファイルの詳細を説明します。

メタデータ・サービス・ドキュメントのインポート

メタデータ・サービス・ドキュメントsearch-service-exclude-file-types.xmlをインポートするには、次のコマンドを入力します: 

importMetadata(application='webcenter', server='WC_Portal', fromLocation='/tmp/search', docs='/oracle/webcenter/search/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/search-service-exclude-file-types.xml')

検索結果でのファイル除外の確認

ファイル・タイプの除外を確認するには、「検索」アイコンをクリックしてファイル・タイプ(*.wavや*.jpegなど)を指定し、これらのファイル・タイプが検索結果から除外されていることを確認します。同様に、.xmlファイルを検索し、Site Studioで作成された.xmlファイルが除外されていることを確認します。

検索問合せパターンのカスタマイズ

Oracle WebCenter Portalでは、検索問合せパターンをカスタマイズできます。これを行うには、検索に使用する問合せ文字列の問合せのパターンを変更します。

検索問合せパターンをカスタマイズするには、次のステップを実行します:
  1. メタデータ・サービス・ドキュメントのエクスポート
  2. 問合せ文字列の問合せパターンの変更
  3. メタデータ・サービス・ドキュメントのインポート

メタデータ・サービス・ドキュメントのエクスポート

メタデータ・サービス・ドキュメントsearch-service-custom-config.xmlをエクスポートするには、次のコマンドを入力します: 

exportMetadata(application='webcenter', server='WC_Portal', toLocation='/tmp/search', docs='/oracle/webcenter/search/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/search-service-custom-config.xml')

メタデータ・サービス・ドキュメントsearch-service-custom-config.xmlでは、問合せパターンをカスタマイズし、検索語にワイルドカードを追加することを有効または無効にできます。

問合せ文字列の問合せパターンの変更

問合せ文字列の問合せパターンは、query_stringというプロパティの値として含まれます。次に示すスニペットは、query_stringプロパティのデフォルト値です。%sは、WebCenter Portalの検索フィールドを介した検索語入力で置き換えられるトークンを示します。%sは、query_string値に何回でも指定でき、このトークンが出現するたびに検索語に置き換えられます。詳細は、https://www.elastic.co/guide/en/elasticsearch/reference/6.8/query-dsl-query-string-query.htmlを参照してください。 

<!-- The query_string query to be executed in Elasticsearch. The value should be in JSON format. -->
<property name="query_string"><![CDATA[
   "query_string": {
      "query": "(%s)"
   }]]>
</property>

ワイルドカードの処理

ワイルドカード(*)を検索語に追加するかどうかは、プロパティappend_wildcardによって決まります。trueの場合、検索語に*が追加されます。

ノート:

append_wildcardをtrueに設定すると、すべての結果が同じ関連性スコアになります。適切な関連性スコアを設定するには、query_stringパターンでrewrite: scoring_booleanを使用する必要があります
<property name="append_wildcard">false</property> 
Example:
<property name="query_string"><![CDATA[
   "query_string": {
      "query": "(%s)",
      "rewrite": "scoring_boolean"
   }]]>
</property>

問合せ文字列の問合せパターンのサンプル

次に、問合せ文字列の問合せパターンの例をいくつか示します:

  1. すべてのフィールドを検索し、titleフィールドの一致を2ずつ増やします。
    <property name="query_string"><![CDATA[
   "query_string": {
      "query": "(title:%s^2 OR %s)"
   }]]>
</property>
  2. titleおよびcontentフィールドのみを検索します。
    <property name="query_string"><![CDATA[
   "query_string": {
      "fields": ["title", "content"],
      "query": "(%s)"
   }]]>
</property>
  3. すべてのフィールドの正確なフレーズを検索します。
    <property name="query_string"><![CDATA[
   "query_string": {
      "query": "(\"%s\")"
   }]]>
</property>

問合せ文字列の問合せの例

次に示す例は、前述の問合せ文字列の問合せパターンのサンプルに関するものです:

  1. 検索語がschoolで、append_wildcard値がfalseの場合、%sはschoolに置き換えられ、query_string値は次のようになります:
    "query_string": {
      "query": "(title:school^2 OR school)"
   }
 
"query_string": {
      "fields": ["title", "content"],
      "query": "(school)"
   }
 
"query_string": {
      "query": "(\"school\")"
   }

    ノート:

    append_wildcardプロパティ値がtrueの場合、前述の例では%sがschool*に置き換えられます。
  2. 検索語がschool childrenで、append_wildcard値がfalseの場合、%sはschool childrenに置き換えられ、query_string値は次のようになります:
    "query_string": {
      "query": "(title:school children^2 OR school children)"
   }
 
"query_string": {
      "fields": ["title", "content"],
      "query": "(school children)"
   }
 
"query_string": {
      "query": "(\"school children\")"
   }

    ノート:

    append_wildcardプロパティ値がtrueの場合、前述の例では%sがschool children*に置き換えられます。

メタデータ・サービス・ドキュメントのインポート

メタデータ・サービス・ドキュメントsearch-service-custom-config.xmlをインポートするには、次のコマンドを入力します: 

importMetadata(application='webcenter', server='WC_Portal', fromLocation='/tmp/search', docs='/oracle/webcenter/search/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/search-service-custom-config.xml')

クロールのスケジューリング

増分検索クロールをスケジュールすることや、フル・クロール、高速クロールまたは再索引付けクロールを手動で開始することができます。この項では、クロールをスケジュールする方法と、クロールを開始、有効化または無効化する方法を説明します。

増分クロールのスケジューリング

デフォルトでは、クローラは「手動」に設定されますが、次のようにして、分、時間単位、日単位など異なる頻度を指定できます。
  1. 「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「ツールとサービス」をクリックします。

    ブラウザに次のURLを入力して、直接「ツールとサービス」ページに移動することも可能です。 

    http://host:port/webcenter/portal/admin/settings/tools
  2. 検索のアイコンをクリックして「検索設定」ページを開きます。
  3. 「スケジューラ」タブで、クロール・ソースを選択して「スケジュール」をクリックし、クロール・ソースの「スケジュール」ページを開きます。

    図10-31 Elastic Searchの「ポータル・クローラのスケジュール」


    この画像は、「ポータル・クローラのスケジュール」ページを示しています。

  4. 「頻度タイプ」リストから必要な頻度タイプを選択します。
    頻度タイプ 指定する必要があるデータ

    手動による起動

    これがデフォルトのクローラの頻度タイプです。「手動による起動」を選択した場合は、スケジュールを手動で起動してください。

    分

    「分」を選択した場合は、「起動の間隔」を分単位で指定します。

    指定できる値: 10から59分。

    毎時

    「毎時」を選択した場合は、「起動の間隔」を時間単位で指定します。

    指定できる値: 1から23時間。

    毎日

    「毎日」を選択した場合は、「起動の間隔」を日単位で指定し、「起動時間のスケジュール」を指定します。

    指定できる値: 1から99日および1から12 AMまたはPMまでの時間

    毎週

    「毎週」を選択した場合は、「起動の間隔」を週単位で指定し、「起動時間のスケジュール」を指定します。

    指定できる値: 1から12週および1から12 AMまたはPMまでの時間
  5. 「保存して閉じる」をクリックします。

スケジュール済クロールの有効化と無効化

クロールが処理中の場合は、クロールを無効化できません。クロールに定義されたスケジュールを有効化または無効化するには:
  1. 「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「ツールとサービス」をクリックします。

    ブラウザに次のURLを入力して、直接「ツールとサービス」ページに移動することも可能です。 

    http://host:port/webcenter/portal/admin/settings/tools
  2. 検索のアイコンをクリックして「検索設定」ページを開きます。
  3. 「スケジューラ」タブで変更するクロール・ソースを選択し、「有効化」をクリックしてクロールに定義されているスケジュールを有効化するか、「無効化」クリックしてクロール・スケジュールを停止します。

手動によるフル・クロールの開始

フル・クロールを手動で開始すれば、WebCenter Portal内のすべてのアイテムをクロールできます。フル・クロールには時間がかかるため、ピーク時間外に開始してください。フル・クロールは手動で開始する必要があり、自動実行されるようにスケジュールできません。

フル・クロールを開始するには:

  1. 「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「ツールとサービス」をクリックします。

    ブラウザに次のURLを入力して、直接「ツールとサービス」ページに移動することも可能です。 

    http://host:port/webcenter/portal/admin/settings/tools
  2. 検索のアイコンをクリックして「検索設定」ページを開きます。
  3. 「スケジューラ」タブで、クロール・ソースを選択して「スケジュール」をクリックし、クロール・ソースの「スケジュール」ページを開きます。

    図10-32 ポータル・クローラのスケジュール


    この画像は、「ポータル・クローラのスケジュール」ページを示しています。

  4. 「スケジューラ」タブで、「すべてのアイテムのクロール」を展開し、「今すぐクロールを開始」をクリックします。
    WebCenter Portalにより、選択したクロール・ソースのフル・クロールがただちに開始されます。

手動による高速クロールの開始

高速クロールを手動で開始すると、変更されたアイテムのみをクロールできます。変更されたすべてのアイテムのメタデータ・フィールドのみをクロールします。この操作では、変更されたドキュメントのコンテンツはクロールされません。このクロールは、ドキュメント・クロール・ソースにのみ適用できます。高速クロールは手動で実行する必要があり、自動で実行されるようにスケジュールすることはできません。

高速クロールを開始するには:
  1. 「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「ツールとサービス」をクリックします。

    ブラウザに次のURLを入力して、直接「ツールとサービス」ページに移動することも可能です。 

    http://host:port/webcenter/portal/admin/settings/tools
  2. 検索のアイコンをクリックして「検索設定」ページを開きます。
  3. 「スケジューラ」タブで、「ドキュメント」クロール・ソースを選択し、「スケジュール」をクリックして「ドキュメント・クローラのスケジュール」ページを開きます。

    図10-33 ドキュメント・クローラのスケジュール


    この画像は、「ドキュメント・クローラのスケジュール」ページを示しています。

  4. 「スケジューラ」タブで、アイテムの高速クロールを展開し、高速クロールの開始をクリックします。
    ドキュメントの高速クロールがWebCenter Portalによってただちに開始されます。

手動による再索引付けクロールの開始

search-service-attributes.xmlファイルで1つ以上のカスタム検索属性のタイプが変更されると、手動で再索引付けクロールを開始できます。再索引付けクロールで、ある索引から別の索引にコピーされるのは、クロールされたアイテムのみです。再索引付けクロールは手動で実行する必要があり、自動で実行されるようにスケジュールすることはできません。たとえば、属性 wc_descriptionで、型がtextと定義されているとします。ここで、型がkeywordに変更されます。このシナリオでは、(前述のように)フル・クロールではなく、再索引付けクロールを開始できます。

再索引付けクロールを開始するには:
  1. 「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「ツールとサービス」をクリックします。

    ブラウザに次のURLを入力して、直接「ツールとサービス」ページに移動することも可能です。 

    http://host:port/webcenter/portal/admin/settings/tools
  2. 検索のアイコンをクリックして「検索設定」ページを開きます。
  3. 「スケジューラ」タブで、クロール・ソースを選択して「スケジュール」をクリックし、クロール・ソースの「スケジュール」ページを開きます。

    図10-34 Elastic Searchの「ポータル・クローラのスケジュール」


    この画像は、「ポータル・クローラのスケジュール」ページを示しています。

  4. 「スケジューラ」タブで、アイテムの再索引付けクロールを展開し、今すぐ再索引付けを開始をクリックします。
    WebCenter Portalにより、選択したクロール・ソースの再索引付けクロールがただちに開始されます。

手動による増分クロールの開始

増分クロールを手動で開始して、WebCenter Portalの最後のクロール後に作成、更新または削除されたアイテムのみをクロールできます。

増分クロールを開始するには:
  1. 「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「ツールとサービス」をクリックします。

    ブラウザに次のURLを入力して、直接「ツールとサービス」ページに移動することも可能です。 

    http://host:port/webcenter/portal/admin/settings/tools
  2. 検索のアイコンをクリックして「検索設定」ページを開きます。
  3. 「スケジューラ」タブでクロール・ソースを選択し、「開始」をクリックします。

    選択したクロール・ソースの増分クロールがWebCenter Portalによって即時に開始されます。

WebCenter Portal管理での検索設定のカスタマイズ

WebCenter Portal管理の「検索設定」ページで、「結果タイプとフィルタリング」、「検索範囲」、「ファセット」および「カスタム属性」をカスタマイズできます。ポータル・マネージャは、管理するポータルの検索範囲のみをリセットできます。

Elasticsearchの検索設定をカスタマイズするには:

  1. 「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「ツールとサービス」をクリックします。

    ブラウザに次のURLを入力して、直接「ツールとサービス」ページに移動することも可能です。 

    http://host:port/webcenter/portal/admin/settings/tools
  2. 検索のアイコンをクリックして「検索設定」ページを開きます。

    図10-35 Elasticsearchの「設定」

    この図は、「検索設定」ページの検索設定オプション(検索範囲、カスタム属性など)を示しています。
  3. 「検索」タブで、「フィルタリング・ドロップダウンの有効化」を選択して、選択したサービスに基づいた検索結果のフィルタリングを有効にします。

    図10-36 Elastic Searchの「設定」 - 「結果タイプとフィルタリング」

    この図は、WebCenter Portalで使用可能な結果タイプと、「フィルタリング・ドロップダウンの有効化」が選択されている状態を示しています。
  4. 検索結果に含める結果タイプを選択するには、「使用可能な結果タイプ」と「組み込まれた結果タイプ」間で結果タイプを移動します。
  5. ホーム・ポータルのみまたはすべてのポータル(ホーム・ポータルを含む)の検索結果を含めるように「検索範囲」を設定します。

    図10-37 Elasticsearchの「設定」 - 「検索範囲」

    この図は、使用可能な検索範囲を示しています。この例では、「すべてのポータル」オプションが選択されています。
  6. 検索結果とともに表示するファセットとその表示順序を選択するために、「使用可能なファセット」リストと「組み込まれたファセット」リストの間でファセットを移動します。

    図10-38 Elasticsearchの「設定」 - 「ファセット」

    この図は、使用可能なファセットを示しています。「使用可能」と「含める」の2つのセクションがあります。
  7. 「カスタム属性」セクションでは、「組み込まれた属性」セクションに属性を移動して、検索結果に表示されるカスタム検索属性と、それらの属性の表示順序を選択できます。

    図10-39 Elasticsearchの「設定」 - 「カスタム属性」

    この図は、使用可能なカスタム属性を示しています。「使用可能な属性」と「含める」の2つのセクションがあります。
  8. 「適用」をクリックします。

Elasticsearchサーバーでのドキュメント・コンテンツのクロール・プラグインのデフォルト接続設定の変更

Elasticsearchをインストールしたら、構成ファイルを使用して、ドキュメント・コンテンツのクロール・プラグインのデフォルト接続設定を変更できます。

構成ファイル内の次の属性を指定できます。

  • es.wcc.connection.timeout: 接続タイムアウトまでの間隔(秒単位)。これは、ElasticsearchサーバーでWebCenter Contentサーバーへの接続が確立されるまで待機する時間です。デフォルト値は30秒です。

  • es.wcc.read.timeout: 読取りタイムアウトまでの間隔(秒単位)。ElasticsearchサーバーがWebCenter Contentサーバーに接続されると、この属性によってWebCenter Contentサーバーが特定のリクエストに応答するまでの許容時間が指定されます。デフォルト値は30秒です。

  • es.wcc.max.connection.attempts: WebCenter Contentサーバーにアクセスするための接続試行の最大数。デフォルト値は3です。

デフォルト接続設定を変更するには:
  1. Elasticsearchサーバーで、/home/Oracle/product/esHome/esNode/configディレクトリに移動し、webcenter.propertiesファイルを作成します
  2. webcenter.properties ファイルで、次の属性を追加し、必要な値を指定します。

    • es.wcc.connection.timeout

    • es.wcc.read.timeout

    • es.wcc.max.connection.attempts

    たとえば、次のようにします。 
    es.wcc.connection.timeout=60
es.wcc.read.timeout=60
es.wcc.max.connection.attempts=5
  3. ファイルを保存してElasticsearchサーバーを再起動します。

検索のグローバル属性の変更

ノート:

次に説明する属性はElastisearchのものです。ただし、これらはOpenSearchを使用したOCI検索サービスが構成されている場合にも適用されます。

wcESConnectionTimeoutPeriod属性とwcESReadTimeoutPeriod属性は、WebCenter PortalとElasticsearch間の相互作用を構成する場合に使用します。wcESDocumentsCrawlerThreads属性は、ドキュメントのクロール処理に必要なスレッド数を構成する場合に使用します。

属性は次のとおりです。

  • wcESConnectionTimeoutPeriod: 接続タイムアウトまでの間隔(秒単位)。これは、WebCenter PortalでElasticsearchサーバーへの接続が確立されるまで待機する時間です。デフォルト値は30秒です。

  • wcESReadTimeoutPeriod: 読取りタイムアウトまでの間隔(秒単位)。WebCenter PortalがElasticsearchサーバーに接続されると、これによってElasticsearchサーバーが特定のリクエストに応答するまでの許容時間が指定されます。デフォルト値は30秒です。

  • wcESDocumentsCrawlerThreads: ドキュメントをクロールする検索のタスクはスレッドで処理されます。これは、固定数のスレッドを持つスレッド・プールを作成し、各スレッドでドキュメントのクロールを処理することによって実行されます。wcESDocumentsCrawlerThreads属性を使用すると、スレッド・プールの作成で使用するスレッド数を指定できます。デフォルト値は10です。クロール・タスク用に使用できるスレッドがないと、そのタスクはキューに入り、他のタスクが完了するまで待機します。

WebCenter Portal管理の「属性」ページでは、属性のデフォルト値を変更できます。値を変更したら、WebCenter Portalサーバーを再起動して、変更を有効にする必要があります。

デフォルト値を変更するには:
  1. 「設定」ページで「属性」をクリックします。

    図10-40 Elasticsearchの「設定」の「属性」

    このスクリーンショットは、「属性」ページを示しています。
  2. 「属性」ページで、属性の「アクション」アイコンをクリックして、「属性の編集」を選択します。
  3. 「属性の編集」ダイアログで、属性の値を変更します。
  4. 「OK」をクリックします。
  5. WebCenter Portalを再起動します。