1.1 サーバ要件

Backlogプロフェッショナル(Version 1.5.3)が稼働するサーバの要件は次のとおりです。

1.2 ウェブブラウザ要件

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

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

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.1 Backlogパッケージアーカイブのダウンロード

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

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

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

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

3.3 データベースの設定(MySQLのみ)

Backlogでは課題やWikiの添付ファイルをデータベースに格納します。
MySQLの場合大きいサイズのデータを登録可能にするために max_allowed_packet の設定が必要です。
my.cnf に以下の設定を追加して、MySQLサーバを起動してください。

[mysqld]
max_allowed_packet = 16M

3.4 データベースの作成

Backlogは初期設定では、次の設定でデータベースに接続します。

データベース設定

データベース名	backlog
データベースユーザ名	backlog
データベースパスワード	backlog

上記設定は環境設定時に変更できます。あらかじめデータベースユーザの作成は行っておいてください。

• PostgreSQLの場合の例

  # createuser -S -d -R -P backlog

• MySQLの例

  # mysql -u root -p
  mysql> GRANT ALL PRIVILEGES ON *.* TO 'backlog'@'localhost' IDENTIFIED BY 'backlog' WITH GRANT OPTION;

下記例のようにして、Backlogが利用するデータベースを作成します。

• PostgreSQLの場合の例 (データベースエンコーディングに「UTF-8」を指定してください)

  # createdb -U backlog -E UTF8 backlog

• MySQLの例

  # mysqladmin -u backlog -p create backlog

3.5 RPMのインストール

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

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

  # rpm -ivh \
    backlog-app-1.5.3-01.el4.noarch.rpm \
    backlog-www-1.5.3-01.el4.i386.rpm \
    backlog-mobile-1.5.3-01.el4.i386.rpm

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

  # rpm -ivh \
    backlog-app-1.5.3-01.el5.noarch.rpm \
    backlog-www-1.5.3-01.el5.i386.rpm \
    backlog-mobile-1.5.3-01.el5.i386.rpm

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

3.6 環境設定ツールの起動

Backlogパッケージ(backlog-app)に同封している環境設定ツールを使用して、Backlogアプリケーションの環境設定を行います。
次のコマンドを実行して、環境設定ツールを起動してください。

# /opt/backlog/bin/init.sh

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

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

Backlog Professionalの環境設定を開始します。

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

BacklogにアクセスするURLを設定してください[http://localhost:8969]
（設定したURLに /backlog がコンテキストパスとして追加されます）

BacklogをWebブラウザから参照できるURLを指定します。
これは、課題に対する変更時に発行するメールに記載されるURLのベースになります。

例） http://example.jp:8969 と指定した場合、課題「ISSUE-01」に対する通知メールには http://example.jp:8969/backlog/ISSUE-01 と記載されます。

SMTPサーバのホスト名を指定してください [localhost]

メール送信時に使用するSMTPサーバのホスト名を指定します。（POP before SMTPやSMTP-AUTHなどの認証形式には対応していません）

御使用のデータベースを選択してください
( m<MySQL> / p<PostgreSQL> )

Backlogで使用するデータベースを選択します。
続いて、「データベースサーバホスト名」、「データベースサーバポート番号」、「データベースサーバアクセスユーザ名」、「データベースサーバアクセスパスワード」を指定します。

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

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

よろしいですか？
( y<続ける> / r<やり直し> ) 

• 「y<続ける>」を選択するとデーターベースに接続しテーブルを作成します。
• 「r<やり直し>」を選択した場合は、現在の設定値を保持したままBacklogにアクセスするURLの指定からやり直します。
• データベースでMySQLを使用した場合は、JDBCドライバの選択を行います。

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

環境設定ツールを起動したの現在のディレクトリに置かれた mysql-connector-java-XXX.jar を選択対象として表示します。

データベースの接続検証が行われた後、Backlogの初期テーブルの作成を行います。（すでに作成済みの場合は、作成処理をスキップすることができます。）

テーブルの新規作成を開始します。
CREATE TABLE space 
...
CREATE TABLE work_item 
テーブルの新規作成が終了しました。

 終了
設定が完了しました。

Backlogの起動を確認後、引き続き http://example.jp:8969/backlog/Setup.action に接続してユーザ情報を登録してください。

メッセージが表示されBacklogの環境設定が完了します。
このときBacklogは起動します。
Webブラウザよりインストール完了メッセージに表示されるURLにアクセスして初期設定とユーザ情報を登録を行ってください。

5.1 スペース情報の入力

ここではBacklogのスペース名、ライセンスキーを入力します。「スペース名」はログイン画面やダッシュボードの上部に表示されるスペースの名称です。「スペースURL」は課題メールなどに記載されるURLを作成するために使用します。「ライセンスキー」はご購入時に取得いただいたライセンスキーです。

5.2 管理者ユーザ情報の入力

ここでは管理者ユーザ(スペースオーナ)の情報を入力します。スペースオーナは通常の管理者の機能の他に次の機能が利用できるユーザです。 (機能の詳細については「ヘルプ」を参照してください)

• アクセス制限の編集
• ライセンスキーの変更

重要なユーザですので、メールアドレス等に間違いのないよう入力してください。

5.3 初期設定完了

設定内容・ライセンス情報に間違いないかを確認してください。

この画面が表示されれば、初期設定は完了です。自動的にBacklogのトップページ(ダッシュボード)に移動します。

また、初期設定完了の通知がスペースオーナのメールアドレス宛に送信されますので、その内容も確認してください。

BacklogのURLは、次のようになります。

[環境設定にて指定したBacklogサーバへのアクセスURL]/backlog

( 例：http://example.jp:8969/backlog/ )

8.1 設定ツールの起動

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

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

# /opt/backlog/bin/config.sh

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

9.1 データ領域

• 画像ファイル領域

  /opt/backlog/data/image

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

  /opt/backlog/lucene

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

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

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

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

9.2 ログファイル

• httpのログ

  /opt/backlog/httpd/logs

• tomcatのログ

  /opt/backlog/tomcat/logs

• モバイル版httpのログ

  /opt/backlog/httpd-mobile/logs

9.3 バックアップ

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