intra-mart Accel Platform Solr管理者ガイド 第8版 2024-04-01

6. Solrの操作

IM-ContentsSearch を利用するにあたって必要となる Solr の運用上の手順などについて説明します。

6.1. インデックスの削除

インデックスを削除する方法について説明します。
開発時や環境再構築時に一旦インデックスを削除したい場合などに実行してください。
管理画面から削除するクエリを指定して削除できます。いずれも、 Solr が起動されている状態で実行する必要があります。
  • コア名「default」内のインデックスをすべて削除する操作

    1. 管理画面を開きます。

      http://localhost:8983/solr/#/default/documents
      
    2. 「Document Type」、「Document」を以下の通り入力します。

      Document Type:Solr Command (raw XML or JSON)
      Document:{‘delete’: {‘query’: ‘:‘}}
    3. 「Submit Document」リンクをクリックします。

コラム

IM-ContentsSearch では、インデックスを削除するためのジョブを用意しています。

6.2. Solrの移行

Solr に保存されている設定ファイルやインデックスの移行手順について説明します。
移行先のサーバでインデックスを再度作成する場合にはインデックスのコピーは必要ありません。
本書では intra-mart Accel Platform 2021 Spring(Bergamot) 以降の Solr を移行する手順を記載します。
過去のバージョンの移行手順はドキュメントアーカイブの管理者ガイドを参照してください。

コラム

2020 Winter(Azalea) 以前の Solr からの移行はできません。
Solr を新規で構築し、インデックスを作成してください。

注意

Solr のデータの移行作業を行う前には、バックアップを行うことを推奨します。

  • 作業は必ず Solr を停止させている状態で開始してください。
  • 移行先の Solr は弊社提供のセットアップ資材で構築構築している環境とします。
%OLD_HOME%:移行元の Solr インストールディレクトリ
%NEW_HOME%:移行先の Solr インストールディレクトリ
  1. solrディレクトリのコピー

    <%OLD_HOME%/server/solr> ディレクトリを <%NEW_HOME%/server/solr> ディレクトリ配下にコピーします。

  2. インデックス保存ディレクトリのコピー

    インデックスが保存されているディレクトリをコピーしてください。

    • <%OLD_HOME%/server/solr/%コア名%/conf/solrconfig.xml>の dataDir に指定しているディレクトリを変更していない場合

      <%OLD_HOME%/server/solr/%コア名%> ディレクトリ配下に data ディレクトリがあるため、手順2でコピー済みです。
    • <%OLD_HOME%/server/solr/%コア名%/conf/solrconfig.xml>の dataDir に指定しているディレクトリを変更している場合

      複数のコアを設定している場合はそれぞれのディレクトリと <solrconfig.xml> の dataDir の設定を確認してください。
  3. その他環境設定

    Solr に同梱されている Jetty の設定をデフォルト設定から変更している場合は、移行先の環境に合わせて変更してください。

  4. Jettyの起動

    Solr を起動し、正常に起動されることを確認してください。

  5. Solr管理画面の確認

    ブラウザでSolr管理画面が表示できることを確認してください。

    http://<HOST>:<PORT>/solr/#/
    

6.3. Solrのバックアップ

  1. solrディレクトリのバックアップ

    %SOLR_HOME%/server/solr ディレクトリをバックアップしてください。
    <solrconfig.xml> の dataDir の指定を変更していない場合は %SOLR_HOME% ディレクトリに設定ファイルとインデックスが保存されているため、下記の手順を行う必要はありません。
  2. インデックスのバックアップ

    インデックスが保存されているディレクトリをバックアップしてください。
    複数のコアを設定している場合はそれぞれの <solrconfig.xml> の dataDir に指定されているディレクトリをそれぞれバックアップしてください。