Luxorのアップグレード手順

Luxor Ver.1.3.11へのアップグレード手順を記載します。

※ ここでは Ver.1.3.9 からアップグレードする場合の例を記載します。他のバージョンでは元ファイル名を読み替えてください。

1) tomcatサービスの停止

   # /etc/init.d/solrTomcat stop

2) 前バージョンのバックアップ

(1)/var/solr/の配下をバックアップします。

/var/solr/配下は自動的に参照されますので、必ず別ディレクトリにコピーし、/var/solr/配下にはバックアップデータを置かないよう注意してください。
(バックアップ先を/root/backup/var/solr/とします)

   # mkdir -p /root/backup/var/solr/
   # cd /root/backup/var/solr/
   # cp -p /var/solr/common_schema.xml .
   # cp -pr /var/solr/failover .
   # cp -p /var/solr/filetype.txt .
   # cp -pr /var/solr/install .
   # cp -pr /var/solr/insuite .
   # cp -p /var/solr/luxor.xml .
   # cp -pr /var/solr/queue .
   # cp -pr /var/solr/smartdb .
   # cp -p /var/solr/solr.xml .
   # cp -p /var/solr/log4j.xml .

(2) /etc/init.d/solrTomcatをバックアップします。
(バックアップ先を/root/backup/initdとします)

   # mkdir -p /root/backup/initd
   # cd /root/backup/initd
   # cp -p /etc/init.d/solrTomcat .

3) luxor.1.3.11.tbzを Luxor サーバに転送
(ここでは、/root 配下に転送したこととします。)

4) 転送したluxor.1.3.11.tbzを解凍

   # cd /root
   # tar jxvf luxor.1.3.11.tbz
   # cd luxor.1.3.11

5) アップグレード元バージョンのsetup.conf を最新バージョンのsetup.confに反映

※ ここでは、アップグレード元バージョンのsetup.conf が/root/luxor.1.3.9/以下に存在する場合の例を記載します。

   # sh setup.sh -mergeConf /root/luxor.1.3.9/setup.conf

6) luxor.1.3.11のsetup.confを編集

   # vi setup.conf

※ setup.conf内のパラメータ設定はLuxor 1.3.8のインストレーションガイドを参照してください。

※ Ver1.3.4より、ホットスタンバイ冗長構成機能に対応しています。JMXをOFFにしないと冗長構成時の切り替えが正常に動作しません。既存バージョンにて「jmx=on」に変更している場合、必ず「jmx=off」に書き換えください。

(1)tomcatMediaFileの設定値を1.3.11用の設定に変更

   tomcatMediaFile=apache-tomcat-8.5.32.tar.gz

(2)javaMediaFileの設定値を1.3.11用の設定に変更

   javaMediaFile=jre-8u172-linux-x64.tar.gz

(3)javaDirの設定値を1.3.11用の設定に変更

   javaDir=jre1.8.0_172

(4)検索精度向上オプションの利用・不利用によって設定を変更します。

※ 1.3.6で追加された検索精度向上機能は、デフォルで利用します。
(利用しない場合、ここで設定変更を行います。)

 ・検索精度向上オプションを使用する(デフォルトはv2)
   setup.conf内の項目 schemaISEVer, schemaSDBVerがv2になっていることを確認する。

 ・検索精度向上オプションを使用しない
   setup.conf内の項目 schemaISEVer, schemaSDBVerがv1になっていることを確認する。

7) tomcatMediaFileを配置

   # cd /usr/local/solr/
   # tar zxvf /root/luxor.1.3.11/apache-tomcat-8.5.32.tar.gz
   # rm -rf tomcat
   # ln -s apache-tomcat-8.5.32 tomcat
   # chown -R webadmin.webadmin apache-tomcat-8.5.32
   # chown -R webadmin.webadmin tomcat

8) javaMediaFileを配置

   # cd /usr/local/solr/
   # tar zxvf /root/luxor.1.3.11/jre-8u172-linux-x64.tar.gz
   # chown -R root.root jre1.8.0_172

9) バージョンアップとサービスの再起動

   # cd /root/luxor.1.3.11
   # sh setup.sh -homeOverwrite
   # /etc/init.d/solrTomcat start

10) インデックスの再作成 (検索精度向上オプションを使用する場合)

※ Luxor Ver1.3.6以前のバージョンからVer1.3.11へアップグレードする場合にのみ必要となる手順です。精度向上機能の詳細に関しては、インストレーションガイドを参照してください。

※ setup.shを実行すると以下のファイルが上書きされますので、チューニング等の理由により手動で修正している場合は再度修正する必要があります。

/var/solr/luxor.xml
/var/solr/*/*/conf/solrconfig.xml
/usr/local/solr/tomcat/conf/server.xml
/usr/local/solr/tomcat/conf/tomcat-users.xml
/usr/local/solr/tomcat/webapps/solr/WEB-INF/web.xml
/usr/local/solr/tomcat/webapps/solr/WEB-INF/classes/junit_systemtest.properties
/etc/init.d/solrTomcat

11) Luxorバージョンの確認

http://luxorのip:10080/solr/About にアクセスする。

     アップグレード後:1.3.11-[build   9320f3e]

バックアップからのリストア手順

モジュールアップグレード手順中に、問題が発生した場合のリストア手順を以下に記載します。 ※ ここでは Ver.1.3.11 からアップグレードした場合の例を記載します。他のバージョンでは元ファイル名を読み替えてください。

1) tomcatサービスの停止

   # /etc/init.d/solrTomcat stop

2) ファイルの削除

(1)/var/solr/の配下を削除します。

   # rm -rf /var/solr/common_schema.xml
   # rm -rf /var/solr/failover
   # rm -rf /var/solr/filetype.txt
   # rm -rf /var/solr/install
   # rm -rf /var/solr/insuite
   # rm -rf /var/solr/luxor.xml
   # rm -rf /var/solr/queue
   # rm -rf /var/solr/smartdb
   # rm -rf /var/solr/solr.xml
   # rm -rf /var/solr/log4j.xml

(2)/etc/init.d/solrTomcatを削除します。

   # rm -rf /etc/init.d/solrTomcat

(3)/usr/local/solr/tomcatを削除します。

   # cd /usr/local/solr/
   # rm tomcat

3) バックアップしたsolrファイルの復元

(1)使用するTomcatの変更
   (元Tomcatバージョンを読み替えてください。ここではapache-tomcat-8.5.27を例にします。)

   # cd /usr/local/solr/
   # ln -s apache-tomcat-8.5.27 tomcat
   # chown -R webadmin.webadmin tomcat

(2)アップグレード手順「2) 前バージョンのバックアップ」の(1)でバックアップされたファイルを/var/solr/の配下に設置してください。
   (バックアップ時の保存先が/root/backup/var/solrとしていた場合)

   # cd /var/solr/ 
   # cp -p /root/backup/var/solr/common_schema.xml .
   # cp -p /root/backup/var/solr/filetype.txt .
   # cp -p /root/backup/var/solr/luxor.xml .
   # cp -p /root/backup/var/solr/solr.xml .
   # cp -p /root/backup/var/solr/log4j.xml .
   # cp -pr /root/backup/var/solr/install .
   # cp -pr /root/backup/var/solr/insuite .
   # cp -pr /root/backup/var/solr/queue .
   # cp -pr /root/backup/var/solr/smartdb .
   # cp -pr /root/backup/var/solr/failover .

(3)アップグレード手順「2) 前バージョンのバックアップ」の(2)でバックアップされたファイルを/etc/init.d/配下に設置してください。

(バックアップ時の保存先が/root/backup/initd/としていた場合) 

   # cd /etc/init.d
   # cp -p /root/backup/initd/solrTomcat .

4) tomcatサービスの起動

   # /etc/init.d/solrTomcat start