1 システム要件
Backlogはウェブアプリケーションであり、稼働させるためにはサーバーが必要となります。また、Backlogを使用するにはウェブブラウザーが必要です。
1.1 サーバー要件
Backlogスタンダードの最新版が稼働するサーバーの要件は次のとおりです。
1.1.1 ハードウェア
CPU | 2.5GHz以上 |
---|---|
メモリ | 2GB以上 |
ハードディスク | 30GB以上 |
1.1.2 OS
下記のOSで動作します。
- Red Hat Enterprise Linux 7
- CentOS 7
タイムゾーンは日本標準時(JST)に設定してください。
# timedatectl set-timezone Asia/Tokyo
またデータベースサーバーやSMTPサーバーなど、他に利用するミドルウェアのタイムゾーンも
全て日本標準時で稼働している事を確認してください。
1.1.3 Java
下記のいずれかのJavaで動作します。
- OpenJDK 8 最新版 ( Red Hat 社が提供する yum リポジトリからのインストールを推奨 )
- OracleJDK 8 最新版 ( Oracle 社が配布するRPM形式でのインストールを推奨 )
OpenJDK 8 はサーバーにインストールされている証明書を利用するため、インストール済みの証明書によっては Backlog の Webhook が送信できない場合があります。 Webhook が機能しない場合は、お客様ご自身で証明書を追加する必要があります。
1.1.4 アプリケーションサーバー
下記のアプリケーションサーバーで動作します。
- Apache Tomcat 9.0
1.1.5 データベース
下記のデータベースで動作します。
- MySQL 8.0
- MySQL 5.7 ( 2023年10月にサポート終了予定 )
MySQL のサポート終了予定日については、Oracle Lifetime Support Policy: Technology Products ("MySQL" で検索) を参考に記載しています。
1.1.6 SMTPサーバー
SMTP認証なしでメール送信が可能なSMTPサーバーが必要です。
Red Hat Enterprise Linux や CentOS に標準でインストールされる Sendmail や Postfix が利用できます。
1.1.7 Active Directory サーバー
Backlog のユーザー認証に Active Directory を利用する場合に必要です。( 1.5.0 からの新機能 )
Backlog は、DNS の SRV リソースレコードにより Active Directory サーバーを見付け接続し、ユーザーを認証します。
Active Directory 用のゾーン定義や SRV リソースレコードの設定があらかじめ必要です。
Windows Server 2012 R2、Windows Server 2016 および Windows Server 2019 での Active Directory に対応しています。
1.2 ウェブブラウザー要件
Backlogの利用に適したOSとウェブブラウザーは次のとおりです。
1.2.1 Windows 8 / Windows 10 の場合
- Microsoft Edge
- Mozilla Firefox 最新版
- Google Chrome 最新版
1.2.2 Mac OSX の場合
- Apple Safari 最新版
- Mozilla Firefox 最新版
- Google Chrome 最新版
上記以外のウェブブラウザーでも動作する可能性はございますが、サポート対象外とさせて頂いております。ご了承ください。
2 Java のフォント設定
Backlogが生成するバーンダウンチャート等の画像に日本語を表示するために、Javaのフォント設定が必要です。
次の手順で設定できます。
2.1 フォントのインストール
次のコマンドにて日本語フォントパッケージをインストールします。
# yum install ipa-pgothic-fonts
2.2 Javaインストールディレクトリへフォントをリンク
下記手順にてインストールしたフォントをリンクします。ここで、JAVA_HOME 環境変数はJavaのインストールディレクトリです。( 例: /usr/java/default )
# mkdir -p $JAVA_HOME/jre/lib/fonts/fallback
# ln -s /usr/share/fonts/ipa-pgothic/ipagp.ttf $JAVA_HOME/jre/lib/fonts/fallback/
3 Apache Tomcat の設定
3.1 HTTP コネクタの設定
Backlogを利用するためにはTomcatを HTTP コネクタにて利用することが必須です。またその設定ファイル「server.xml」の「Connector」の属性に「URIEncoding="UTF-8"」を追加する必要があります。
<Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" URIEncoding="UTF-8"/>
もし AJP コネクタを併用する場合には、そちらも「URIEncoding="UTF-8"」の設定を追加してください。
3.2 Java 起動オプションの設定
全文検索機能のために、Tomcat の Java の起動オプションとして「-Dsolr.solr.home=<全文検索用のディレクトリのパス>」を追加する必要があります。
ここで指定する全文検索用のディレクトリのパスは、インストーラー実行時の二つ目の手順である、「スペースおよびユーザーアイコン画像を保存したり検索インデックスの作成を行うディレクトリを絶対パスで指定してください」で指定するパスに「/solr」を追加したものとなります。
たとえば、指定するパスが「/var/lib/backlog」の場合は以下のようになります。
- -Dsolr.solr.home=/var/lib/backlog/solr
また、Wiki 名に "/" を含む場合にも正しく表示させるために、下記のオプションを指定します。
- -Dorg.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH=true
値の設定方法はご利用環境にあわせた形となります。例えば、<Tomcat のインストールディレクトリ>/bin/catalina.sh を利用する場合には、同じディレクトリに setenv.sh というファイルを作成し、以下のように環境変数 CATALINA_OPTS にて指定してください。(既にある場合は追記してください)
export CATALINA_OPTS="-Dsolr.solr.home=/var/lib/backlog/solr -Dorg.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH=true"
3.3 全文検索機能の依存ライブラリの設定
Version 1.8.0 以降、全文検索機能を利用するための依存ライブラリを Tomcat に追加しておく必要があります。
下記ダウンロードリンクから、依存ライブラリをまとめたファイルをダウンロードして、<Tomcat のインストールディレクトリ>/lib にコピーしてください。
https://backlog.com/ja/enterprise/doc/standard/solr-ext.zip
# wget https://backlog.com/ja/enterprise/doc/standard/solr-ext.zip
# unzip solr-ext.zip
# cp solr-ext/* /usr/local/apache-tomcat/lib/
また、コピーしたファイルの中にログ出力を制御する log4j.properties があります。
log4j.properties 中のログ出力ディレクトリの設定を、ご利用環境に合わせて <Tomcat のインストールディレクトリ>/logs に変更してください。
solr.log=/usr/local/apache-tomcat/logs/
4 インストール
4.1 Backlogパッケージアーカイブのダウンロードと展開
ご購入時にお知らせしましたダウンロードサイトにアクセスします。
上記より新規インストール用のBacklogパッケージアーカイブがダウンロードできます。ダウンロード完了後、適当な場所に展開してください。
- 例:「/tmp」ディレクトリに展開する場合
# cd /tmp # tar zxfv backlog-1.12.2.tar.gz
4.2 データベースドライバーのダウンロード
ダウンロードサイトよりJava言語用データベースドライバーをダウンロードします。
- Product Version: 5.1.49
- Operating System: Platform Independent
展開したファイルの「mysql-connector-java-5.1.49-bin.jar」を、Backlogパッケージアーカイブを展開したディレクトリにコピーしてください。
- 例
# unzip mysql-connector-java-5.1.49.zip
# cp mysql-connector-java-5.1.49/mysql-connector-java-5.1.49-bin.jar /tmp/backlog/
4.3 データベースの設定
my.cnfには以下の設定を追加してください。
4.3.1 MySQL 8.0の場合
[mysqld]
sql_mode="NO_ENGINE_SUBSTITUTION"
default_authentication_plugin=mysql_native_password
4.3.2 MySQL 5.7の場合
[mysqld]
max_allowed_packet = 16M
character-set-server=utf8mb4
sql_mode = "NO_ENGINE_SUBSTITUTION"
[mysql]
default-character-set=utf8mb4
[client]
default-character-set=utf8mb4
4.4 データベースの作成
Backlogは初期設定では、次の設定でデータベースに接続します。
データベース名 | backlog |
---|---|
データベースユーザー名 | backlog |
ユーザー名・パスワードはインストール時および設定ファイルで変更できます。あらかじめユーザーとデータベースは作成しておいてください。
4.5 インストーラーの起動
Backlogパッケージアーカイブに同封しているインストーラーを使用して、Backlogアプリケーションのインストールを行います。
Backlogパッケージアーカイブを展開したディレクトリに移動してインストーラーの起動を行ってください。
# java -jar backlog-installer.jar
======================================================================
____ _ _
| _ \ | | | | This Backlog
| |_) | __ _ ___| | _| | ___ __ _ installer
| _ < / _` |/ __| |/ / |/ _ \ / _` |
| |_) | (_| | (__| <| | (_) | (_| |
|____/ \__,_|\___|_|\_\_|\___/ \__, |
__/ |
|___/ [http://backlog.backlog.jp]
======================================================================
バックログのインストールを開始します。
インストーラー起動タイトルが表示され、インストールが開始します。
メッセージ中に表示される[]の値は、未入力時に既定値として設定されます。
warファイルを配備するディレクトリを絶対パスで指定してください []
Backlogアプリケーションのwarファイルを配備するディレクトリパスを指定してください。
(通常は "Tomcatのインストールされているパス/webapps" を指定します。)
スペースおよびユーザアイコン画像を保存したり検索インデックスの作成を行うディレクトリを絶対パスで指定してください []
スペースおよびユーザーアイコン画像を保存したり、検索インデックスの作成を行う作業ディレクトリを指定します。
(課題やWikiへの添付ファイルはここには保存されません)
なお、指定したディレクトリが存在しない場合は、インストーラーが作成します。
注)ここで作成される作業ディレクトリの所有者とグループには、Backlogを起動するユーザー(アプリケーションサーバーの実行ユーザー)を指定する必要があります。
BacklogにアクセスするURLを設定してください [http://localhost:8080]
(設定したURLに /backlog がコンテキストパスとして追加されます)
BacklogをWebブラウザから参照できるURLを指定します。
これは、課題に対する変更時に発行するメールに記載されるURLのベースになります。
例) http://localhost:8080 と指定した場合、課題「ISSUE-01」に対する通知メールには http://localhost:8080/backlog/ISSUE-01 と記載されます。
Tomcat の HTTP コネクタのポートを指定してください [8080]
HTTP コネクタの設定で server.xml で指定した HTTP コネクタのポート番号を指定します。
SMTPサーバのホスト名を指定してください [localhost]
メール送信時に使用するSMTPサーバーのホスト名を指定します。(POP before SMTPやSMTP-AUTHなどの認証形式には対応していません)
使用のデータベースを選択してください ( m<MySQL> / p<PostgreSQL> )
Backlogで使用するデータベースを選択します。mを入力してください。
続いて、「データベースサーバーホスト名」、「データベースサーバーポート番号」、「データベースサーバーアクセスユーザ名」、「データベースサーバーアクセスパスワード」を指定します。
Backlog インストール先 [/usr/local/apache-tomcat/webapps]
Backlog 作業パス [/var/lib/backlog]
Backlog URL [http://localhost:8080]
Tomcat HTTPポート [8080]
SMTPサーバホスト [localhost]
データベース [MySQL]
サーバホスト [localhost]
ポート番号 [3306]
ユーザ [backlog]
パスワード [backlog]
よろしいですか?
(y <続ける> / r <やり直し>)
- データベースの設定が終了した後、設定の確認が行われ「y<続ける>」を選択することでインストールが開始されます。
- 「r<やり直し>」を選択した場合は、現在の設定値を保持したままBacklogアプリケーションのインストール先の指定からやり直します。
- 続いて、JDBCドライバーの選択を行います。
使用するJDBCドライバを選択してください。
1:mysql-connector-java-5.1.49-bin.jar
データベースの接続検証が行われた後、Backlogの初期テーブルの作成を行います。(すでに作成済みの場合は、作成処理をスキップすることができます。)
テーブルの新規作成を開始します。
...
テーブルの新規作成が終了しました。
warファイルを配備します >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 終了
インストールが完了しました。
Tomcatを起動してください。
引き続き http://localhost:8080/backlog/Setup.action にアクセスし、ライセンス情報や管理者ユーザ情報を登録してください。
インストール完了メッセージが表示されBacklogのインストールが完了します。
(インストール済みの環境に再インストールした場合は、配備済みのwarファイルは日付を元に付けられた別名で保存されます。)
Webブラウザーよりインストール完了メッセージに表示されるURLにアクセスして初期設定とユーザー情報を登録を行ってください。
5 初期設定
インストーラーによる作業が完了したら、まず初期設定を行う必要があります。
初期設定では、ライセンスキーや管理者情報を登録します。
まず、次の初期設定用URLにアクセスしてください。
[インストール時に設定したBacklogサーバーへのアクセスURL]/backlog/Setup.action
( 例:http://localhost:8080/backlog/Setup.action )
5.1 スペース情報の入力
ここではBacklogのスペース名、ライセンスキーを入力します。
「スペース名」はログイン画面やダッシュボードの上部に表示されるスペースの名称です。
「スペースURL」は課題メールなどに記載されるURLを作成するために使用します。
「ライセンスキー」はご購入時に取得いただいたライセンスキーです。
ヌーラボの利用規約を必ずお読みになり、「利用規約に同意する」にチェックしてください。
5.2 管理者ユーザー情報の入力
ここでは管理者ユーザ(スペースオーナー)の情報を入力します。スペースオーナーは通常の管理者の機能の他に次の機能が利用できるユーザーです。
(機能の詳細については「ヘルプ」を参照してください)
- アクセス制限の編集
- ライセンスキーの変更
- スペースオーナーの変更
重要なユーザーですので、メールアドレス等に間違いのないよう入力してください。
5.3 初期設定完了
設定内容・ライセンス情報に間違いないかを確認してください。
この画面が表示されれば、初期設定は完了です。自動的にBacklogのトップページ(ダッシュボード)に移動します。
また、初期設定完了の通知がスペースオーナーのメールアドレス宛に送信されますので、その内容も確認してください。
BacklogのURLは、次のようになります。
[環境設定にて指定したBacklogサーバーへのアクセスURL]/backlog
6 インストール・初期設定がおわったら
- まず初めに、プロジェクトおよびユーザーを追加しましょう。
- 追加されたユーザーには、BacklogのURLとログインに必要な情報がメールで通知されます。
- プロジェクトを作成したら、マイルストーンやカテゴリを作成しましょう。
- 詳細な機能の説明については、いつも画面の右上に表示されている「ヘルプ」を参照してください。
- 運用に関する情報を、運用ガイドでご確認ください。
- Linuxは、Linus Torvalds氏の日本およびその他の国における登録商標または商標です。
- Red Hatは米国およびその他の国におけるRed Hat, Incの登録商標または商標です。
- MySQLとJavaは、Oracle Corporation 及びその子会社、関連会社の米国及びその他の国における登録商標です。文中の社名、商品名等は各社の商標または登録商標である場合があります。
- その他記載されている会社名および商品名は各社の登録商標または商標です。
改訂履歴
2024-10-31
- バージョン 1.12.2 リリースに伴い、Backlogパッケージアーカイブファイル名を backlog-1.12.2.tar.gz に変更しました。
2024-02-29
- MySQL 8.0について追記しました。
- バージョン 1.12.0 リリースに伴い、Backlogパッケージアーカイブファイル名を backlog-1.12.0.tar.gz に変更しました。
2023-12-01
- バージョン 1.11.17 リリースに伴い、Backlogパッケージアーカイブファイル名を backlog-1.11.17.tar.gz に変更しました。
2023-11-08
- バージョン 1.11.16 リリースに伴い、Backlogパッケージアーカイブファイル名を backlog-1.11.16.tar.gz に変更しました。
2023-08-29
- PostgreSQLについて削除しました。
2023-06-22
- サーバー要件のデータベースにMySQL 8.0について追記しました。
- バージョン 1.11.14 リリースに伴い、Backlogパッケージアーカイブファイル名を backlog-1.11.14.tar.gz に変更しました。
2023-03-16
- バージョン 1.11.13 リリースに伴い、Backlogパッケージアーカイブファイル名を backlog-1.11.13.tar.gz に変更しました。
2022-10-13
- バージョン 1.11.11 リリースに伴い、Backlogパッケージアーカイブファイル名を backlog-1.11.11.tar.gz に変更しました。
2022-07-13
- バージョン 1.11.10 リリースに伴い、Backlogパッケージアーカイブファイル名を backlog-1.11.10.tar.gz に変更しました。
2022-04-20
- 「1.1.7 Active Directory サーバー」項から Windows Server 2008 を削除し、Windows Server 2019 を追加しました。
2022-02-24
- バージョン 1.11.8 リリースに伴い、Backlogパッケージアーカイブファイル名を backlog-1.11.8.tar.gz に変更しました。
2021-12-21
- バージョン 1.11.7 リリースに伴い、Backlogパッケージアーカイブファイル名を backlog-1.11.7.tar.gz に変更しました。
2021-12-14
- バージョン 1.11.6 リリースに伴い、Backlogパッケージアーカイブファイル名を backlog-1.11.6.tar.gz に変更しました。
2021-07-29
- バージョン 1.11.3 リリースに伴い、Backlogパッケージアーカイブファイル名を backlog-1.11.3.tar.gz に変更しました。
- 「1.1 サーバー要件」項で、「(Version 1.11.0)が稼働するサーバーの要件」を「最新版が稼働するサーバーの要件」に文言を変更しました。
- PostgreSQL 9.5 のサポート終了に伴い、「1.1.5 データベース」項から PostgreSQL 9.5 を削除しました。
- MySQL 5.6 のサポート終了に伴い、「1.1.5 データベース」項から MySQL 5.6 を削除しました。
- 「1.2 ウェブブラウザー要件」項から Internet Explorer 11 を削除しました。
- 「4.3.4 sql_mode (MySQL 5.7 をご利用の場合のみ)」項のタイトルを「4.3.4 sql_mode」に変更しました。
- 「4.3.5 innodb_large_prefix (MySQL 5.6 をご利用の場合のみ)」項を削除しました。
2021-01-29
- サーバー要件の OS から Red Hat Enterprise Linux 6 と CentOS 6 を削除し、それらに関する記述を削除しました。
- 「1.2 ウェブブラウザー要件」項の、Backlog の利用に適した OS から Windows 7 を削除しました。
- バージョン 1.11.1 リリースに伴い、Backlogパッケージアーカイブファイル名を backlog-1.11.1.tar.gz に変更しました。
- 「1.1 サーバー要件」項で、「(Version 1.11.0)が稼働するサーバーの要件」を「(Version 1.11.1)が稼働するサーバーの要件」に文言を変更しました。
2020-10-09
- バージョン 1.11.0 リリースに伴い、Backlogパッケージアーカイブファイル名を backlog-1.11.0.tar.gz に変更しました。
- 「1.1 サーバー要件」項で、「(Version 1.10.12)が稼働するサーバーの要件」を「(Version 1.11.0)が稼働するサーバーの要件」に文言を変更しました。
- 「4.3.3 default-character-set」項で、my.cnf に設定する値を utf8 から utf8mb4 に変更しました。
- 「4.3.5 innodb_large_prefix (MySQL 5.6 をご利用の場合のみ)」項を追加しました。
2020-06-22
- バージョン 1.10.14 リリースに伴い、Backlogパッケージアーカイブファイル名を backlog-1.10.14.tar.gz に変更しました。
- 「1.1 サーバー要件」項で、「(Version 1.10.12)が稼働するサーバーの要件」を「(Version 1.10.14)が稼働するサーバーの要件」に文言を変更しました。
2020-05-18
- PostgreSQL 9.4 のサポート終了に伴い、「1.1.5 データベース」項から PostgreSQL 9.4 を削除しました。
2020-02-05
- バージョン 1.10.12 リリースに伴い、Backlogパッケージアーカイブファイル名を backlog-1.10.12.tar.gz に変更しました。
- 「1.1 サーバー要件」項で、「(Version 1.10.11)が稼働するサーバーの要件」を「(Version 1.10.12)が稼働するサーバーの要件」に文言を変更しました。
2019-11-07
- 「1.1.5 データベース」項に、PostgreSQL サポート終了に関する注意書きを追記しました。
2019-10-31
- バージョン 1.10.11 リリースに伴い、Backlogパッケージアーカイブファイル名を backlog-1.10.11.tar.gz に変更しました。
- 「1.1 サーバー要件」項で、「(Version 1.10.10)が稼働するサーバーの要件」を「(Version 1.10.11)が稼働するサーバーの要件」に文言を変更しました。
- 「1.1.4 データベース」項に、PostgreSQL 9.5、9.6のサポートを追記しました。
2019-08-19
- バージョン 1.10.10-02 リリースに伴い、Backlogパッケージアーカイブファイル名を backlog-1.10.10-02.tar.gz に変更しました。
2019-08-09
- 「1.2 ウェブブラウザー要件」項の、Backlogの利用に適したOSから Windows Vista を削除し、Windows 10 を追加しました。
2019-06-13
- バージョン 1.10.10 リリースに伴い、Backlogパッケージアーカイブファイル名を backlog-1.10.10.tar.gz に変更しました。
- 「1.1 サーバー要件」項で、「(Backlogスタンダード(Version 1.10.9)が稼働するサーバーの要件」を「(Version 1.10.10)」に文言を変更しました。
2019-05-21
- PostgreSQL 9.3 のサポート終了に伴い、「1.1.5 データベース」項から PostgreSQL 9.3 を削除しました。
- 「1.1.5 データベース」項に、各データベースのサポート終了予定日を追記しました。
2019-04-16
- バージョン 1.10.9 リリースに伴い、Backlogパッケージアーカイブファイル名を backlog-1.10.9.tar.gz に変更しました。
- 「1.1 サーバー要件」項で、「(Backlogスタンダード(Version 1.10.8)が稼働するサーバーの要件」を「(Version 1.10.9)」に文言を変更しました。
2019-03-06
- バージョン 1.10.8 リリースに伴い、Backlogパッケージアーカイブファイル名を backlog-1.10.8.tar.gz に変更しました。
- 「1.1 サーバー要件」項で、「(Backlogスタンダード(Version 1.10.7)が稼働するサーバーの要件」を「(Version 1.10.8)」に文言を変更しました。
- 「1.2 ウェブブラウザー要件」項から Internet Explorer 9 と Internet Explorer 10 を削除しました。
2019-01-22
- バージョン 1.10.7 リリースに伴い、Backlogパッケージアーカイブファイル名を backlog-1.10.7.tar.gz に変更しました。
- 「1.1 サーバー要件」項で、「(Backlogスタンダード(Version 1.10.6)が稼働するサーバーの要件」を「(Version 1.10.7)」に文言を変更しました。
- 「1.1.2 OS」項に、動作OS として Red Hat Enterprise Linux 7 と CentOS 7 を追記しました。
- 「1.1.2 OS」項に、Red Hat Enterprise Linux 7 または CentOS 7 の場合の、timedatectl コマンドによるタイムゾーンの設定方法を追記しました。
- 「1.1.3 Java」項に、OpenJDK 8 最新版 を追記しました。
- 「1.1.3 Java」項に、OpenJDK 8 の証明書について追記しました。
- 「2.1 フォントのインストール」項から「Red Hat Enterprise Linux 6 server または CentOS6 の場合」という文言を削除しました。 Red Hat Enterprise Linux 7 および CentOS 7 でも同じ設定手順であるためです。
- 「2.2 Javaインストールディレクトリへフォントをリンク」項から「Red Hat Enterprise Linux 6 server または CentOS6 の場合」という文言を削除しました。 Red Hat Enterprise Linux 7 および CentOS 7 でも同じ設定手順であるためです。
- 「2.2 Javaインストールディレクトリへフォントをリンク」項でコマンド mkdir にオプション -p を追加し、ディレクトリを再帰的に作成するようにしました。
2018-10-29
- バージョン 1.10.6 リリースに伴い、Backlogパッケージアーカイブファイル名を backlog-1.10.6.tar.gz に変更しました。
- 「1.1 サーバー要件」項で、「(Backlogスタンダード(Version 1.10.5)が稼働するサーバーの要件」を「(Version 1.10.6)」に文言を変更しました。
2018-10-05
- 改訂履歴を本ドキュメントに追加しました。
- バージョン 1.10.5 リリースに伴い、Backlogパッケージアーカイブファイル名を backlog-1.10.5.tar.gz に変更しました。
- 「1.1 サーバー要件」項で、「(Backlogスタンダード(Version 1.10.4)が稼働するサーバーの要件」を「(Version 1.10.5)」に文言を変更しました。
- 「4.2 データベースドライバーのダウンロード (MySQLの場合のみ)」項で、作業ディレクトリ「/tmp/backlog-1.10.4」を「/tmp/backlog」に変更しました。
- 改訂履歴欄の追加に伴い、本ドキュメントの更新日時欄を削除しました。