TomcatとJREのアップグレードについて

Tomcatのアップグレード手順

Luxorで使用するTomcatのアップグレード手順を記載します。例としてTomcat8系(Tomcat8.X.XX)のアップデート手順を記載します。以降の説明については、X.XXを適用するバージョンに適宜読み替えてください。


【1】サービスを停止

① Luxorで使用するTomcatをアップグレードする前に、Tomcatサービスを停止してください。

 # service solrTomcat stop

② Luxorで使用するTomcatのインストール先ディレクトリを確認します。Luxorのインストールパッケージのsetup.conf(/root/luxor.1.3.X/setup.conf)で、"tomcatInstallDir"の項目を確認します。

※Luxorのインストールパッケージを/root配下に解凍しインストールしたもの、またインストール先のディレクトリ"tomcatInstallDir"を/usr/local/solrに設定したものとします。以降の説明については、Xを適用するバージョンに適宜読み替えてください。


【2】 Tomcatモジュールをダウンロード

① Apache Tomcatのオフィシャルサイト"http://tomcat.apache.org" にアクセスし、Tomcat8のダウンロードページを開きます。

② Binary DistributionsのCOREの「tar.gz」を選択し、apache-tomcat-8.5.9.tar.gzのモジュールをダウンロードします。


【3】 ダウンロードファイルを展開

ダウンロードしたファイルを、Luxorサーバの/usr/local/solr/配下へコピーして、そのルート配下に解凍します。

   # cd /usr/local/solr/
   # tar xvzf apache-tomcat-8.5.9.tar.gz

【4】 モジュールを配置

① 解凍後、Tomcat8のwebappsディレクトリ配下の全ファイル・ディレクトリを削除します。
※指定したディレクトリ配下の全ファイル・ディレクトリが削除されますので、指定ルートに十分確認した上でご実施ください。

   # rm -rf /usr/local/solr/apache-tomcat-8.5.9/webapps/*

② ディレクトリの権限を変更します。

   # chown -R webadmin.webadmin /usr/local/solr/apache-tomcat-8.5.9

③ "solr.war"を配置します。

   # cd /usr/local/solr/tomcat/webapps/
   # cp -p solr.war /usr/local/solr/apache-tomcat-8.5.9/webapps/
   # chown webadmin.webadmin /usr/local/solr/apache-tomcat-8.5.9/webapps/solr.war
   # mkdir -p /usr/local/solr/apache-tomcat-8.5.9/webapps/solr
   # cd /usr/local/solr/apache-tomcat-8.5.9/webapps/solr
   # unzip -n /usr/local/solr/apache-tomcat-8.5.9/webapps/solr.war

④ "junit_systemtest.properties"を配置します。

   # cd /usr/local/solr/tomcat/webapps/solr/WEB-INF/classes/
   # cp -p junit_systemtest.properties /usr/local/solr/apache-tomcat-8.5.9/webapps/solr/WEB-INF/classes/

【5】 ディレクトリの権限を変更

Tomcat8ディレクトリ配下の権限を変更します。

 # chown -H -R webadmin.webadmin /usr/local/solr/apache-tomcat-8.5.9/webapps/solr

【6】 参照先を変更

① /usr/local/solr/配下に既存シンボリックリンクの"tomcat"を削除します。

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

② Tomcat8ディレクトリへのシンボリックリンク"tomcat"を作成します。

 # ln -s apache-tomcat-8.5.9 tomcat
 # chown -R webadmin.webadmin tomcat

【7】設定を変更

① /usr/local/solr/tomcat/conf/server.xmlをテキストエディタで開きます。

② ポートを修正します。

   修正前
    <Server port="8005" shutdown="SHUTDOWN">
   修正後
    <Server port="18005" shutdown="SHUTDOWN">

③ Connector executorタグを削除し、ExecutorタグおよびConnector executorタグを追加します。

   修正前
    <Connector port="8080" ~ />
   修正後
    <Executor name="tomcatThreadPool" namePrefix="catalina-exec-" maxThreads="200" minSpareThreads="25"/>
    <Connector executor="tomcatThreadPool" port="10080" URIEncoding="UTF-8" maxPostSize="42991616" protocol="HTTP/1.1"
              connectionTimeout="20000"
              redirectPort="8443" />

※上記追加項目はsetup.confを確認の上、設定してください。

"port"は、setup.confの"solrPort"の値を設定します。 "maxPostSize"は、setup.confの"maxPostSize"の値を設定します。(setup.confの"maxPostSize"項目がない場合、"maxPostSize"を設定しないでください。)

④ 以下の内容をコメントアウトにします。

   修正前
    <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />
   修正後
    <!-- <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" /> -->

【8】Tomcatを起動

① Tomcatサービスを起動します。

   # service solrTomcat start

② /usr/local/solr/tomcat/logs/catalina.outを確認し、起動バージョンがTomcat8であることを確認します。

   例)下記が出力されていることを確認
   情報: Starting Servlet Engine: Apache Tomcat/8.5.9

以上でアップグレードは完了となります。


【9】動作コマンドによる確認方法

次のコマンドを実行してください。

 # cd /root/luxor.1.3.X
 # sh setup.sh -installCheck

実行の結果 (a) 問題がない場合、以下の内容が出力されます。

   installCheck SUCCESS!

(b) 問題がある場合、以下の内容が出力されます。

   installCheck failed. See ./installCheck.log
   ※installCheck.logの内容を確認してください。

JREのアップグレード手順

Luxorで使用するJREのアップグレード手順を記載します。例としてjre1.8.0_XXXのアップデート手順を記載します。以降の説明については、XXXを適用するバージョンに適宜読み替えてください。


【1】サービスを停止

① JREをアップグレードする前に、Tomcatを停止してください。

 # service solrTomcat stop

② インストール先ディレクトリを確認します。
Luxorのインストールパッケージのsetup.conf(/root/luxor.1.3.X/setup.conf)で、"tomcatInstallDir"の項目を確認します。

※Luxorのインストールパッケージを/root配下に解凍しインストールしたもの、またインストール先のディレクトリ"tomcatInstallDir"を/usr/local/solrに設定したものとします。以降の説明については、Xを適用するバージョンに適宜読み替えてください。


【2】 JREモジュールをダウンロード

① JavaのオフィシャルサイトでJREのモジュールをダウンロードする。

※以降は64bitのjre-8u111-linux-x64.tar.gzをダウンロードしたものとします。

  • サーバ/OS が 64bit の場合:jre-8u111-linux-x64.tar.gz
  • サーバ/OS が 32bit の場合:jre-8u111-linux-i586.tar.gz

【3】 ダウンロードファイルを展開

ダウンロードしたファイルを、Luxorサーバの/usr/local/solr配下へコピーして、そのルート配下に解凍します。

 # cd /usr/local/solr
 # tar zxvf jre-8u111-linux-x64.tar.gz
 # chown -R root:root jre1.8.0_111

【4】設定の変更

① luxor.1.3.Xのsetup.confを開きます。

 # vi setup.conf

②「javaDir」設定を変更します。

 javaDir=jre1.8.0_111

③「javaDir」設定変更を反映します。

 # sh setup.sh -refrectConf

【5】Tomcatを起動

① Tomcatサービスを起動します。

 # service solrTomcat start

以上でアップグレードは完了となります。


【6】動作コマンドによる確認方法

次のコマンドを実行してください。

   # cd /root/luxor.1.3.X
   # sh setup.sh -installCheck

実行の結果

(a) 問題がない場合、以下の内容が出力されます。

   installCheck SUCCESS!

(b) 問題がある場合、以下の内容が出力されます。

   installCheck failed. See ./installCheck.log

  ※installCheck.logの内容を確認してください。