1 システム要件

Backlogはウェブアプリケーションであり、稼働させるためにはサーバが必要となります。また、Backlogを使用するにはウェブブラウザが必要です。

1.1 サーバ要件

Backlogプロフェッショナル(Version 1.4.0)が稼働するサーバの要件は次のとおりです。なお下記以外の環境でも動作するかもしれませんが、サポートいたしません。

1.1.1 ハードウェア

ハードウェア
CPU 1.5GHz以上
メモリ 1GB以上
ハードディスク 30GB以上

1.1.2 OS

下記のOSで動作します。

  • Red Hat Enterprise Linux ES 4
  • Red Hat Enterprise Linux 5 server
  • CentOS 4
  • CentOS 5

いずれもi386版(32bit版)のみ動作可能です。 x86_64版(64bit版)では動作しません。

1.1.3 Java

  • Java SE 6 (Sun Microsystemsが配布するRPM形式でのインストール)

1.1.4 データベース

下記のデータベースで動作します。

  • PostgreSQL 8.2
  • PostgreSQL 8.3
  • PostgreSQL 8.4
  • MySQL 5.0
  • MySQL 5.1

アップグレードの際にデータベースを変更することはできません。
Backlogスタンダードで利用していたデータベースをそのまま利用します。

1.1.5 SMTPサーバ

SMTP認証なしでメール送信が可能なSMTPサーバが必要です。
Red Hat Enterprise Linux や CentOS に標準でインストールされる Sendmail が利用できます。

1.2 ウェブブラウザ要件

Backlogの利用に適したウェブブラウザは次のとおりです。

1.2.1 Windows XP または Vista の場合

  • Internet Explorer 6 または 7 または 8
  • Firefox 3.5 以上

1.2.2 Mac OSX (10.4以降) の場合

  • Firefox 3.5 以上
  • Safari 3 以上

1.2.3 Linux (Ubuntu) の場合

  • Firefox 3.5 以上

上記以外のウェブブラウザでも動作する可能性はございますが、サポート対象外とさせて頂いております。ご了承ください。

2 Java のフォント設定

Backlogが生成するバーンダウンチャート等の画像に日本語を表示するために、Javaのフォント設定が必要です。
次の手順で設定できます。

2.1 フォントのインストール

次のコマンドにて日本語フォントパッケージをインストールします。
インストール済であれば下記操作は必要ありません。

  • Red Hat Enterprise Linux ES 4 の場合
    # up2date -i fonts-ja
  • CentOS4 の場合
    # yum install fonts-ja
  • Red Hat Enterprise Linux 5 server または CentOS5 の場合
    # yum install fonts-japanese

2.2 Javaインストールディレクトリへフォントをリンク

下記手順にてインストールしたフォントをリンクします。ここで、JAVA_HOME 環境変数はJavaのインストールディレクトリです。( 例: /usr/java/default )

# mkdir $JAVA_HOME/jre/lib/fonts/fallback
# ln -s /usr/share/fonts/ja/TrueType/kochi-*.ttf $JAVA_HOME/jre/lib/fonts/fallback/

3 アップグレード

次の手順でBacklogをインストールします。

  • Backlogパッケージ(RPMファイル)をダウンロードします。
  • データベースドライバをダウンロード・インストールします。
  • RPMのインストール
  • アップグレードツールを起動します。
  • 質問に答えて先に進めば、アップグレードは完了します。

3.1 Backlogパッケージアーカイブのダウンロード

ご購入時にお知らせしましたダウンロードサイトにアクセスします。アクセスにはユーザ名・パスワードが必要です。

画面:ダウンロード画面

BacklogパッケージRPMがダウンロードできます。ダウンロードするRPMファイルは3つあり、ご使用のOSによってRPMファイルが異ります。

3.1.1 Red Hat Enterprise Linux ES 4 または CentOS 4 の場合

  • backlog-app-1.4.0-01.el4.noarch.rpm
  • backlog-www-1.4.0-01.el4.i386.rpm
  • backlog-mobile-1.4.0-01.el4.i386.rpm

3.1.2 Red Hat Enterprise Linux 5 server または CentOS 5 の場合

  • backlog-app-1.4.0-01.el5.noarch.rpm
  • backlog-www-1.4.0-01.el5.i386.rpm
  • backlog-mobile-1.4.0-01.el5.i386.rpm

3.2 データベースドライバのダウンロード・インストール

Backlogでは、Java言語およびPerl言語用のデータベースドライバを使用します。ご使用のデータベースによって、以下を行ってください。

3.2.1 MySQLの場合

  • Java言語用 MySQLデータベースドライバ

    Java言語用データベースドライバをダウンロードする必要があります。下記URLのダウンロードサイトより「Platform Independent (Architecture Independent), Compressed TAR Archive / 5.1.13 / 3.6M」をダウンロードし、展開します。
    http://dev.mysql.com/downloads/connector/j/5.1.html

    画面:MySQLドライバのダウンロードサイト

    展開したファイルの「mysql-connector-java-5.1.13-bin.jar」を、Backlogパッケージアーカイブを展開したディレクトリにコピーしてください。

    # tar zxfv mysql-connector-java-5.1.13.tar.gz
    # cp mysql-connector-java-5.1.13/mysql-connector-java-5.1.13-bin.jar /tmp/backlog-1.4.0/
  • Perl言語用 MySQLデータベースドライバ

    OS付属の"perl-DBD-MySQL"パッケージ(またはそのアップデート)をインストールしてください。

    # yum install perl-DBD-MySQL

3.2.2 PostgreSQLの場合

  • Java言語用 PostgreSQLデータベースドライバ

    Java言語用データベースドライバは、Backlogに付属していますので、何もする必要はありません。

  • Perl言語用 PostgreSQLデータベースドライバ

    OS付属の"perl-DBD-Pg"パッケージ(またはそのアップデート)をインストールしてください。

    # yum install perl-DBD-Pg

3.3 RPMのインストール

以下のコマンドにてBacklogパッケージをインストールします。

  • Red Hat Enterprise Linux ES 4 または CentOS 4 の場合
    # rpm -ivh \
      backlog-app-1.4.0-01.el4.noarch.rpm \
      backlog-www-1.4.0-01.el4.i386.rpm \
      backlog-mobile-1.4.0-01.el4.i386.rpm
  • Red Hat Enterprise Linux 5 server または CentOS 5 の場合
    # rpm -ivh \
      backlog-app-1.4.0-01.el5.noarch.rpm \
      backlog-www-1.4.0-01.el5.i386.rpm \
      backlog-mobile-1.4.0-01.el5.i386.rpm

1.4.0よりモバイル版が追加されました。( backlog-mobile-1.4.0-01.el5.i386.rpm )
モバイル版は携帯電話からアクセスしていただくためのパッケージとなっておりますが、
Backlogをイントラネット内で利用される場合など、モバイル版をご利用されない場合はインストールする必要はございません。
モバイル版について もご確認ください。

3.5 アップグレードツールの起動

Backlogパッケージ(backlog-app)に同封しているアップグレードツールを使用して、プロフェッショナル版へのアップグレードを行います。

# /opt/backlog/bin/upgrade.sh

スタンダード版(Tomcat)の停止を確認するメッセージが表示されます。

問題なければ、アップグレード処理を始めてください。

======================================================================
   Backlog Professional upgrader
   ____             _    _
   |  _ \           | |  | |
   | |_) | __ _  ___| | _| | ___   __ _
   |  _ < / _` |/ __| |/ / |/ _ \ / _` |
   | |_) | (_| | (__|   <| | (_) | (_| |
   |____/ \__,_|\___|_|\_\_|\___/ \__, |
                                   __/ |
                                  |___/

                                         [http://www.backlog.jp]
======================================================================

バックログのアップグレードを開始します。

起動タイトル表示され、環境設定を開始します。
メッセージ中に表示される[]の値は、未入力時に既定値として設定されます。

Backlog Standard をインストールしているディレクトリを絶対パスで指定してください

スタンダード版がインストールされているディレクトリを絶対パスで指定してください。
(スタンダード版で使用しているTomcatのインストール先が/usr/local/apache-tomcatの場合、/usr/local/apache-tomcat/webappsを指定します。)

次の設定内容で起動設定を行います。

Backlog URL       [http://localhost:8969]
SMTPサーバホスト  [localhost]
データベース      [PostgreSQL]
  サーバホスト        [localhost]
  ポート番号      [5432]
  ユーザ          [backlog]
  パスワード      [backlog]

よろしいですか?
( y<続ける> / r<やり直し> ) 
  • 現在インストールされているスタンダード版の設定確認が行われ「y<続ける>」を選択することでアップグレードが行われます。
  • 「n<やめる>」を選択した場合は、アップグレードを中止します。

なお、使用しているデータベースがMySQLの場合はJDBCドライバ(Java言語用データベースドライバ)の選択を行う必要があります。

使用するJDBCドライバを選択してください。
1:mysql-connector-java-3.1.12.jar
2:mysql-connector-java-5.1.13.jar

カレントディレクトリに置かれた mysql-connector-java-XXX.jar を選択対象として表示します。

データベースの接続検証が行われた後、移行作業が行われます。

正常にアップグレードが完了しました。

引き続き Backlogをご利用ください。

メッセージが表示されBacklogのアップグレードが完了します。
注)アップグレード処理により スタンダード版 Backlog 及び、スタンダード版で使用していた、イメージファイルとインデックスファイルを管理する作業ディレクトリは削除されません。

4 Backlogの起動

Backlogは以下のコマンドで起動します。

# /etc/init.d/backlog-app start
# /etc/init.d/backlog-www start
# /etc/init.d/backlog-mobile start

5 ライセンスキーの更新

アップグレードが完了したら、プロフェッショナル版の追加機能を使用するためにライセンスキーの更新を行う必要があります。
Backlogにログイン後、管理画面 -> ライセンスキーの変更 より「ライセンスキーの変更」画面を表示して、プロフェッショナル版ライセンスキーに更新を行ってください。

画面:ライセンスキーの変更

6 モバイル版について

Backlogをイントラネット内で利用される場合など、
モバイル版が必要ない・利用しない場合は、backlog-mobile サービスを停止することができます。
また、アンインストールしてもPC版の利用には影響しません。

サービスを停止する場合

# /etc/init.d/backlog-mobile stop
# chkconfig backlog-mobile off

携帯電話からアクセスする場合、
Backlog URL のポート番号に80または443(httpsの場合)を指定しなければいけない場合があります。
(DoCoMoをご利用の場合等)

7 アップグレード(インストール)後の再設定

アップグレード(インストール)後に、次の設定値を再設定することができます。

  • SMTPサーバ
  • データベースの再設定(データベースの種類の変更は行えません)

7.1 設定ツールの起動

Backlogパッケージ(backlog-app)に同封している設定ツールを使用して、Backlogアプリケーションの再設定を行います。

次のコマンドを実行して、設定ツールを起動してください。

# /opt/backlog/bin/config.sh

8 インストールディレクトリ構成

Backlog プロフェッショナルは次のディレクトリ構成でインストールが行われます。

/opt/backlog
|– bin
|– data
| |– image
| |– lucene
| | `– index
| |– share
| | `– dav
| `– svn
|– httpd
|– httpd-mobile
|– licenses
|– licenses-mobile
|– neon
|– perl
|– perl-mobile
|– scripts
|– subversion
`– tomcat

8.1 データ領域

  • 画像ファイル領域

    /opt/backlog/data/image

  • インデックス検索ファイル領域

    /opt/backlog/lucene

  • 「ファイル共有」機能で管理されるファイル領域

    /opt/backlog/data/share/dav/プロジェクト名

  • 「Subversion」機能のリポジトリ領域

    /opt/backlog/data/svn/プロジェクト名

8.2 ログファイル

  • httpのログ

    /opt/backlog/httpd/logs

  • tomcatのログ

    /opt/backlog/tomcat/logs

  • モバイル版httpのログ

    /opt/backlog/httpd-mobile/logs

8.3 バックアップ

Backlogのバックアップを行う場合は、データベースのダンプと合わせて/opt/backlog/data以下のデータ領域ディレクトリをバックアップしてください。

  • Linuxは、Linus Torvalds氏の日本およびその他の国における登録商標または商標です。
  • Red Hatは米国およびその他の国におけるRed Hat, Incの登録商標または商標です。
  • OracleとJavaは、Oracle Corporation 及びその子会社、関連会社の米国及びその他の国における登録商標です。文中の社名、商品名等は各社の商標または登録商標である場合があります。
  • その他記載されている会社名および商品名は各社の登録商標または商標です。

Author: Backlog Support <support@backlog.jp>

Date: 2010-07-16 13:55:34 JST