SRP 用の 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 モードを推奨します。SolrCloud モードで実行する場合は、多言語検索（MLS）をインストールする前に、SolrCloud をインストールして設定する必要があります。

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

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

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

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

参考：
  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

参考：
  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 number-of-shards \
    -rf number-of-replicas

コレクションを 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

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

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

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

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

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

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

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

注意：ここで言う AEM 6.1 とは、AEM 6.1 Communities FP3 以前を指します。

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

• 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 モードのインストール手順に従います。

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/* をコピー
   3. ダウンロードした schema.xml と solrconfig.xml を new-config-dir にコピーして既存のファイルを上書きします。
3. ZooKeeper に新しい設定をアップロードします。
4. シャードの数、レプリカ数および設定名など、必要なパラメーターを設定してコレクションを作成します。
5. 設定の名前をコレクション作成中に指定しなかった場合は、ZooKeeper にアップロードした設定に新しく作成したこのコレクションをリンクします。
6. MSRP の場合、新規インストールである場合を除き、MSRP インデックス再作成ツールを実行します。

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

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

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

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

インストール手順 - 以下のとおり、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/* をコピー
      • Solr5 の場合：solr-install-dir/server/solr/configsets/data_driven_schema_configs/* をコピー
   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 インストールディレクトリにある場合、このステップは一度だけ実行します。 
6. lib/ フォルダーを、SolrCloud の各ノードの（solr.xml が含まれている）solr-home ディレクトリ内に作成します。jar ファイルを以下の場所から各ノードの新しい lib/ フォルダーにコピーします。
   
   • 高度な 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 のパッケージには、インストールスクリプトが同梱されています。

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

• スタンドアロンモードの Solr をインストールします。
• Solr5 を実行している場合、以下のコマンドで collection1 を作成します（Solr4 と同様）。
  • ./bin/solr start
  • ./bin/solr create_core -c collection1 -d sample_techproducts_configs
• インストールスクリプトを実行：Install [-v 4|5] [-d solrhome] [-c collectionpath]
  各オプションの説明：
  • -d solrhome
    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 は、自動コミットの間隔と検索表示を制御するファイルであり、テストと調整が必要です。

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

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

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