SRP 用の Solr 設定

AEM プラットフォーム用の Solr

別々のコレクションを使用することで、1 つの Apache Solr をノードストア（Oak）と共通ストア（SRP）の間で共有できます。

Oak と SRP のコレクションがどちらも高頻度で使用される場合は、パフォーマンス上の理由から 2 つ目の Solr をインストールすることもできます。

実稼動環境では、SolrCloudモードを使用すると、スタンドアロンモード（単一のローカルSolr設定）よりもパフォーマンスが向上します。

要件

Apache Solr のダウンロードとインストール：

• バージョン4.10 またはバ ージョン5

• Solr には Java 1.7 以降が必要です。

• サービスは不要

• 実行モードの選択：

  • スタンドアロンモード
  • SolrCloud モード（実稼動環境で推奨）

• 多言語検索(MLS)の選択

  • 標準の MLS のインストール
  • 高度な MLS のインストール

SolrCloud モード

🔗 実稼動環境ではSolrCloudmodeを使用することをお勧めします。SolrCloudモードで実行する場合は、多言語検索(MLS)をインストールする前に、SolrCloudをインストールして設定する必要があります。

SolrCloud の手順に従い、以下をインストールすることを推奨します。

• 同じサーバー上の 3 つの SolrCloud ノード
• 外部のApache ZooKeeper

また、メモリ使用量とガベージコレクションを調整するために、JVM を設定することを推奨します。

JVM の設定例

JVM_OPTS="-server -Xmx2048m -XX:MaxPermSize=768M -XX:+UseConcMarkSweepGC -XX:+CMSClassUnloadingEnabled -Xloggc:../logs/gc.log -XX:+PrintGCDetails -XX:+PrintGCDateStamps -Djava.awt.headless=true"  

SolrCloud セットアップコマンド

SolrCloud モードで実行する場合は、MLS をインストールする前に、以下の SolrCloud セットアップコマンドを理解して使用する必要があります。

1. 設定を ZooKeeper にアップロード

参照:
https://cwiki.apache.org/confluence/display/solr/Command+Line+Utilities

使用方法:
sh./scripts/cloud-scripts/zkcli.sh \
-cmd upconfig \
-zkhost server:port \
-confname *myconfig-name *\
-solrhome solr-home-path \
-confdir config-dir

2. コレクションを作成

参照:
https://cwiki.apache.org/confluence/display/solr/Solr+Start+Script+Reference#SolrStartScriptReference-Create

使用方法:
。/bin/solr create \
-c mycollection-name\
-d config-dir \
-n myconfig-name \
-p port\
-s シャード数 \
-rf レプリカ数

3. コレクションを設定セットにリンク

コレクションを ZooKeeper にアップロードした設定にリンクします。

参照:
https://cwiki.apache.org/confluence/display/solr/Command+Line+Utilities

使用方法:
sh./scripts/cloud-scripts/zkcli.sh \
-cmd linkconfig \
-zkhost server:port \
-collection mycollection-name \
-confname myconfig-name

標準の MLS と高度な MLS の比較

AEM Communities の多言語検索（MLS）は、英語を含め、サポートされるすべての言語にまたがる検索の質を向上させる目的で、Solr プラットフォーム用に構築された機能です。

AEM Communities の MLS は、標準の MLS と高度な MLS のどちらかを利用できます。標準の MLS には Solr 設定だけが含まれ、プラグインやリソースファイルは含まれていません。高度な MLS は、より包括的なソリューションであり、Solr 設定に加えてプラグインと関連リソースを含んでいます。

標準の MLS には、以下の言語のコンテンツ検索の機能強化が含まれています。

• 英語：派生語をマッチさせるためのステマーの向上
• 日本語：日本語の半角文字のトークン化の向上

高度な MLS には、下の言語のコンテンツ検索の機能強化が含まれています。

• 英語：ステマーをレマタイザーに交換
• ドイツ語：デコンパウンダーを追加
• フランス語：エリジオン処理を追加
• 中国語（簡体）：よりスマートなトークナイザーを追加
• 様々な言語：ステマー、ストップワードリスト、およびノーマライザーを追加しました。

高度な MLS では、合計で以下の 33 の言語がサポートされます。

AEM 6.1 Solr 検索、標準の MLS、高度な MLS の比較

注意:AEM 6.1は、AEM 6.1 Communities FP3以前を表します。

標準の MLS のインストール

標準の多言語検索（MLS）をサポートするには、SRP コレクション（MSRP または DSRP）について、以下の 2 つの Solr の設定ファイルを変更する必要があります。

• schema.xml
• solrconfig.xml

Solr 4.10用の標準のMLSファイル(schema.xml、solrconfig.xml)

Solr 5用の標準のMLSファイル(schema.xml、solrconfig.xml)

標準の MLS ファイルは AEM リポジトリに格納されます。

注意：Solr ファイルは msrp/ フォルダーに格納されていますが、DSRP にも対応します（変更不要）。

ダウンロード手順:必要に応じ solrX て、または solr4 で置 solr5 き換えます。

1. CRXDE|Liteを使用して、

   • /libs/social/config/datastore/msrp/solrX/schema.xml
   • /libs/social/config/datastore/msrp/solrX/solrconfig.xml

2. Solrがデプロイされているローカルサーバーにダウンロードします。

   • jcr:contentノードのjcr:dataプロパティを探します。
   • viewを選択してダウンロードを開始します
   • ファイルが適切な名前とエンコーディング(UTF8)で保存されていることを確認します。

3. スタンドアロンモードまたはSolrCloudモードのインストール手順に従います。

SolrCloud モード - 標準の MLS

1. SolrCloud モードの Solr をインストールして設定します。

2. 以下の手順で新しい設定を用意します。

   1. new-config-dir​を作成します（例：solr-install-dir/myconfig/）。

   2. 既存のSolr設定ディレクトリの内容を​new-config-dir​にコピーします。

      • Solr4の場合：solr-install-dir/example/solr/collection1/conf/*
      • Solr5の場合：solr-install-dir/server/solr/configsets/data_driven_schema_configs/&ast；をコピーします。

   3. ダウンロードした​schema.xml​と​solrconfig.xml​を​new-config-dir​にコピーして、既存のファイルを上書きします。

3. 新しい設定をZooKeeperにア ップロードします。

4. シャードの数、レプリカ数および設定名など、必要なパラメーターを設定してコレクションを作成します。

5. コレクションの作成中に設定名が提供されなかった場合は、新しく作成したコレクションとZooKeeperにアップロードした設定をリンクします。

6. MSRP の場合、新規インストールである場合を除き、MSRP インデックス再作成ツールを実行します。

スタンドアロンモード - 標準の MLS

1. スタンドアロンモードの Solr をインストールします。

2. Solr5 を実行している場合、以下のコマンドで collection1 を作成します（Solr4 と同様）。

   • 。/bin/solr start
   • 。/bin/solr create_core -c collection1 -d sample_techproducts_configs

3. 例えば以下の Solr 設定ディレクトリに schema.xml と solrconfig.xml にバックアップします。

   • Solr4の場合：solr-install-dir/example/solr/collection1/conf/
   • Solr5用に作成：solr-install-dir/server/solr/collection1/conf/

4. ダウンロードした schema.xml と solrconfig.xml を同じディレクトリにコピーします。

5. Solr を再起動します。

6. MSRP の場合、新規インストールである場合を除き、MSRP インデックス再作成ツールを実行します。

高度な MLS のインストール

高度な MLS をサポートするための SRP コレクション（MSRP または DSRP）については、カスタムスキーマと Solr 設定に加え、新しい Solr プラグインが必要です。必要な項目はすべて、ダウンロード可能なzipファイルにパッケージ化されます。 また、Solrがスタンドアロンモードでデプロイされる場合に使用するインストールスクリプトも含まれています。

高度なMLSパッケージを入手するには、ドキュメントのデプロイセクションのAEM Advanced MLSを参照してください。

SolrCloud モードまたはスタンドアロンモードのどちらかのインストールを開始するには：

• AEM-SOLR-MLS zipアーカイブをSolrをホストするサーバーにダウンロードします。
• アーカイブを解凍します。

SolrCloud モード - 高度な MLS

インストール手順 - 以下のとおり、Solr4 と Solr5 で少し違いがある点に注意してください。

1. SolrCloud モードの Solr をインストールして設定します。

2. 高度な MLS パッケージの内容をディスクに抽出します。内容は次のとおりです。

   • schema.xml
   • solrconfig.xml
   • stopwords/​フォルダー
   • profiles/​フォルダー
   • extra-libs/ フォルダー

3. 以下の手順で新しい設定を用意します。

   1. new-config-dir​を作成します。

      • 例： solr-install-dir/myconfig/
      • stopwords/とlang/のサブフォルダーを作成する

   2. 既存のSolr設定ディレクトリの内容を​new-config-dir​にコピーします。

      • Solr4の場合：solr-install-dir/example/solr/collection1/conf/&ast；をコピーします。
      • Solr5の場合：solr-install-dir/server/solr/configsets/data_driven_schema_configs/&ast；をコピーします。

   3. 抽出した​schema.xml​と​solrconfig.xml​を​new-config-dir​にコピーして、既存のファイルを上書きします。

   4. Solr5の場合：solr_install_dir/server/solr/configsets/sample_techproducts_configs/conf/lang/*.txt"を​new-config-dir/lang/にコピーします。

   5. 抽出した​stopwords/​フォルダーを​new-config-dir​にコピーし、new-config-dir/stopwords/*.txtを生成します。

4. 新しい設定をZooKeeperにア ップロードします。

5. 以下のとおり、新しい profiles/ フォルダーをコピーします。

   • Solr4の場合：各ノードのresources/フォルダーにコピーします。
   • Solr5の場合：各Solrインストールのserver/resources/フォルダーにをコピーします。 すべてのノードが同じSolrインストールディレクトリにある場合、この手順は1回だけ実行されます。

6. SolrCloudの各ノードのsolr-homeディレクトリ（solr.xmlを含む）に​lib/​フォルダーを作成します。 以下の場所から各ノードの新しいlib/フォルダーにjarをコピーします。

   • 高度な MLS のパッケージから抽出した extra-libs/
   • solr-install-dir/contrib/extraction/lib/.jar
   • solr-install-dir/dist/solr-cell.jar
   • solr-install-dir/contrib/clustering/lib/.jar
   • solr-install-dir/dist/solr-clustering.jar
   • solr-install-dir/contrib/langid/lib/.jar
   • solr-install-dir/dist/solr-langid.jar
   • solr-install-dir/contrib/velocity/lib/.jar
   • solr-install-dir/dist/solr-velocity.jar
   • solr-install-dir/contrib/analysis-extras/lib/.jar
   • solr-install-dir/contrib/analysis-extras/lucene-libs/.jar

7. シャードの数、レプリカ数および設定名など、必要なパラメーターを設定してコレクションを作成します。

8. 設定の名前をコレクション作成中に指定しなかった​**​場合は、ZooKeeper にアップロードした設定に新しく作成したこのコレクションをリンクします。

9. MSRP の場合、新規インストールである場合を除き、MSRP インデックス再作成ツールを実行します。

スタンドアロンモード - 高度な MLS

高度な MLS のパッケージには、インストールスクリプトが同梱されています。

スタンドアロンの Solr サーバーをホストしているサーバーにパッケージの内容を抽出したら、必要なリソースと設定ファイルをインストールするために、インストールスクリプトを実行します。

• スタンドアロンモードの Solr をインストールします。

• Solr5 を実行している場合、以下のコマンドで collection1 を作成します（Solr4 と同様）。

  • 。/bin/solr start
  • 。/bin/solr create_core -c collection1 -d sample_techproducts_configs

• インストールスクリプトを実行します。[-v 4|5] [-d solrhome] [-c collectionpath]をインストールします。
  ここで、

  • -d solhome

    Solrインストールディレクトリ

  • -c collectionpath

    Solr内のコレクションパス

  • –help

    印刷コマンドラインオプション

  • -v [4|5]

    solrのバージョンを設定

• Solr 4.10.4 の場合の例：

  • Install.bat -v 4 -d c:/solr-4.10.4 -c c:/solr-4.10.4/example/solr/collection1

• Solr 5.4.0 の場合の例：

  • Install.sh -v 5 -d /tmp/solr-5.4.0 -c /tmp/solr-5.4.0/server/solr/collection1

注意：

• インストールスクリプトは、新しいバージョンをインストールする前に、「.orig」を追加してschema.xmlとsolrconfig.xmlをバックアップします。

solrconfig.xml について

solrconfig.xml は、自動コミットの間隔と検索表示を制御するファイルであり、テストと調整が必要です。

<autoCommit>：デフォルトでは、AutoCommit（安定ストレージへのハードコミット）の間隔は、15 秒に設定されています。検索の表示は、デフォルトでコミット前のインデックスを使用します。

コミットによる変更が反映された更新済みのインデックスを使用するよう検索を変更するには、含まれている <openSearcher> を true に変更します。

<autoSoftCommit>：「ソフト」コミットを使用すると、変更は表示されます（インデックスが更新されます）が、変更は安定ストレージに同期（ハードコミット）されません。その結果、パフォーマンスが向上します。 デフォルトでは、<autoSoftCommit>は無効で、含まれる<maxTime>は —1に設定されています。