Backlog スタンダード Apache Tomcat 9 への移行ガイド

1.1 Apache Tomcat 9 のダウンロード

Apache Tomcat ダウンロードページから tar.gz 形式の Apache Tomcat 9 をダウンロードします。ここでは、次のように wget コマンドでダウンロードします。2018年7月現在はバージョン 9.0.10 が最新版ですが、最新のバージョンをご確認ください。

# wget http://archive.apache.org/dist/tomcat/tomcat-9/v9.0.10/bin/apache-tomcat-9.0.10.tar.gz

1.2 Apache Tomcat 9 のインストール

ダウンロードした Apache Tomcat 9 を解凍し、インストールしたいディレクトリに移動させます。ここでは /usr/local/apache-tomcat-9.0.10 にインストールすることにします。

# tar zxvf apache-tomcat-9.0.10.tar.gz
# mv apache-tomcat-9.0.10 /usr/local/

Apache Tomcat 9 の所有者を変更します。ここでは所有者を tomcat とします。

# chown -R tomcat:tomcat /usr/local/apache-tomcat-9.0.10

2.1 HTTP コネクタの設定

Backlog スタンダード インストールガイド : 3.1 HTTP コネクタの設定にしたがって、HTTP コネクタを設定します。

設定ファイル /usr/local/apache-tomcat-9.0.10/conf/server.xml の「Connector」の属性に「URIEncoding="UTF-8"」を追加してください。

<Connector port="8080" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" URIEncoding="UTF-8"/>

もし AJP コネクタを併用する場合には、そちらも「URIEncoding="UTF-8"」の設定を追加してください。

2.2 Java 起動オプションの設定

Backlog スタンダード インストールガイド : 3.2 Java 起動オプションの設定にしたがって、Java 起動オプションを設定します。

Apache Tomcat 7 のインストールディレクトリにある setenv.sh ファイルをコピーしてください。

例えば、<Apache Tomcat 7 のインストールディレクトリ>/bin/にsetenv.shを配置している場合は、以下のようにコピーします。

# cp <Apache Tomcat 7 のインストールディレクトリ>/bin/setenv.sh /usr/local/apache-tomcat-9.0.10/bin/

2.3 全文検索機能の依存ライブラリの設定

Backlog スタンダード インストールガイド : 3.3 全文検索機能の依存ライブラリの設定にしたがって、全文検索機能の依存ライブラリを設定します。

# wget https://backlog.com/ja/enterprise/doc/standard/solr-ext.zip
# unzip solr-ext.zip
# cp solr-ext/* /usr/local/apache-tomcat-9.0.10/lib/

コピーしたファイルの中にある log4j.properties をインストールガイドにしたがって変更します。

solr.log=/usr/local/apache-tomcat-9.0.10/logs/

コピーしたファイルの所有者を、Apache Tomcat 9 の所有者に変更します。ここでは所有者を tomcat とします。

chown tomcat:tomcat /usr/local/apache-tomcat-9.0.10/lib/*

2.4 warファイルの移行

Apache Tomcat 7 の webapps ディレクトリに存在する2つのwarファイルを、Apache Tomcat 9 側にコピーします。

# cp <Apache Tomcat 7 のインストールディレクトリ>/webapps/backlog.war /usr/local/apache-tomcat-9.0.10/webapps/
# cp <Apache Tomcat 7 のインストールディレクトリ>/webapps/backlog-solr.war /usr/local/apache-tomcat-9.0.10/webapps/

3.1 Apache Tomcat 7 の停止

Apache Tomcat 7 を停止します。

# <Apache Tomcat 7 のインストールディレクトリ>/bin/catalina.sh stop

3.2 Apache Tomcat 9 の起動

Apache Tomcat 9 を起動します。

# /usr/local/apache-tomcat-9.0.10/bin/catalina.sh start