Fisheye 4.8 + Crucible 4.8 のインストール (Windows)

このページでは、Atlassian の Fisheye と Crucible を Windows 環境にインストールする手順について紹介します。

はじめに

Fisheye は、Subversion、Git、Mercurial、CVS、Perforce に対応したソースコードリポジトリブラウザーです。機能の詳細については、こちらのページもご確認ください。
Crucible は、Fisheye と組み合わせて使用するコードレビュー支援ツールです。Crucible の詳細については、こちらのページも参照してください。

インストールする環境は以下を想定しています。

インストールディレクトリ (Fisheye のプログラムをインストールするディレクトリ)	C:\Atlassian\fecru-4.8.2 (インストーラーのデフォルト設定)
ホームディレクトリ (Fisheye のデータを格納するディレクトリ)	C:\Atlassian\Data\fecru (インストーラーのデフォルト設定)
コンテキストパス (URL でサーバー名に続く文字）	/fisheye
データベース	Fisheye と同一のコンピューターにインストールされた PostgreSQL を利用
Java	OpenJDK 8
起動方法	サービスとして登録し、自動起動する

対応しているプラットフォーム

Fisheye のバージョンによってサポートされている稼働環境は異なります。
最新の情報は、サポート対象プラットフォームのページからご確認ください。

対象とするリポジトリの場所

対象とするリポジトリは、Fisheye と同じコンピューター上に配置することをおすすめします。
Fisheye はリポジトリから更新履歴を読み取り、インデックス化してデータベースに保存します。
このときにネットワーク経由などで別のコンピューターのリポジトリにアクセスすると、インデックス化作業にとても時間がかかります。

このページの手順を実施する前に、以下のページの手順を実施して下さい。

インストール

Fisheye を Windows 環境にインストールします。

1. インストーラーファイルをダウンロードする

Fisheye は、Atlassian のホームページからダウンロードできます。

上記のリンクページを開くと、ダウンロードするファイルを選択する画面が表示されます。
ここでは、2020/6/20 現在、最新のバージョンである Fisheye 4.8.2 の Windows 64 bit を選択し Get started をクリックします。

以前のバージョンをダウンロードしたい場合はすべての Server バージョンをクリックします。ページが移動しますので該当のバージョンをダウンロードしてください。
同意を求めるダイアログが表示されるので、内容に問題がなければチェックボックスを有効にし Submit をクリックします。

ダウンロードしたファイルは適当なディレクトリに保存してください。

2. インストーラーを実行する

ダウンロードしたインストーラーを実行します。

確認のダイアログが表示されたら、はいをクリックします。

3. インストールを開始する

Fisheye のセットアップへようこその画面が表示されます。

Next をクリックして次へ進みます。

4. インストールのオプションを選択する

インストールの方法を選択する画面が表示されます。

今回は Custom Install を選択して Next をクリックします。

5. インストールディレクトリを選択する

Fisheye をどこにインストールするか選択する画面が表示されます。

今回は特に変更せずに Next をクリックします。

6. ホームディレクトリを選択する

Fisheye のデータをどこに格納するか選択する画面が表示されます。

今回は特に変更せずに Next をクリックします。

7. スタートメニューのグループを指定する

スタートメニューに表示するプログラムのグループを指定する画面が表示されます。

今回は特に変更せずに Next をクリックし、インストールを開始します。

インストールが始まるので、少々お待ちください。

8. インストールを完了する

インストールの完了画面が表示されます。

Finish をクリックして、インストールウィザードを終了します。

セットアップ

インストールした Fisheye を起動し、初めてブラウザーからアクセスすると、セットアップウィザードが始まります。

セットアップウィザードでは、ライセンス情報の入力や管理用のパスワードの設定などを行います。

1. セットアップウィザードを実行する

Fisheye を実行し、ブラウザーから "http://(IP アドレスまたはホスト名):8060" にアクセスすると、下図のようなセットアップウィザードの画面が表示されます。
Enter exsiting license ボタンをクリックすると Enter license key テキストボックスが表示されます。弊社からメール送付、または My Atlassian から取得したライセンスキーを入力してください。
入力できたら Next ボタンをクリックします。

2. Crucible の設定を行う

ライセンスが確認されたら、ソースコードレビューツールである Crucible も一緒に使用するか確認する画面が表示されます。
同じく Enter exsiting license ボタンをクリックすると Enter key テキストボックスが表示されますので、弊社からメール送付、または My Atlassian から取得したライセンスキーを入力してください。
入力できたら Next ボタンをクリックします。

3. Jira との接続設定を行う

Jira との接続設定を行う画面が表示されます。
ここでは Jira とは接続せずに進めますので、Skip ボタンをクリックします。

Jira について

Jira は Atlassian の課題管理ツールです。詳細はこちらのページをご確認ください。

4. パスワードを設定する

Set administrator password の画面では、管理画面にアクセスするためのパスワードを設定します。
2つのテキストボックスに同じパスワードを入力してください。簡単すぎるパスワードは、Fisheye に拒否されることがありますのでご注意ください。
パスワードを入力したら Next ボタンをクリックします。

5. Fisheye を開始する

一通りの設定が完了し、Fisheye を利用する準備ができました。
Add repository ボタンをクリックして Fisheye を開始します。

管理画面を開くための入力画面が表示されるので、セットアップウィザードで指定したパスワードを入力し Log in ボタンをクリックします。

外部データベースの設定

Fisheye のセットアップが完了したら、外部データベースの設定を行いましょう。
Fisheye のデフォルトでは、データ保存用に内蔵データベースを使用します。このデータベースは本番稼動で使用するにはパフォーマンスに問題があるため、PostgreSQL などの外部データベースを使用するように設定します。
利用可能なデータベースは、Atlassian のサポートプラットフォームページから確認できます。

ここでは、PostgreSQL を例にして手順を説明します。

1. データベースの編集画面を開く

Fisheye の管理画面左側のメニュー System Settings > Database から Database Configuration の画面を開き、下部にある Edit ボタンをクリックします。

2. データベースを指定する

データベース設定の編集画面が開きます。

Type に PostgreSQL を選択し、各項目を入力していきます。

入力する内容は以下を参考にしてください。
指定できたら Test connection ボタンを押します。

項目名	内容	入力値
Type	DB (データベース) の種別	PostgreSQL
Driver Location	使用するドライバの場所	デフォルトのまま
URL	DB の URL	DB 作成時の DB 名例: ～localhost:5432/fisheye
User Name	DB のユーザー名	fisheye 用の DB を作成したときのユーザー名
Password	DB のパスワード	fisheye 用の DB を作成したときのパスワード
Minimum Pool Connections	コネクションプールの最小値	デフォルトのまま
Maximum Pool Connections	コネクションプールの最大値	デフォルトのまま

接続テストが成功すると Connection succeeded というメッセージが表示されます。
失敗したときは、データベース作成時に指定した内容と画面の入力内容が異なっていないか確認してください。
成功したときは Save & Migrate ボタンが使用できるようになるので、ボタンをクリックします。

3. データベースの移行を実行する

データベースを移行するか確認するダイアログボックスが表示されます。
内容に問題がなければ、Confirm ボタンをクリックしてデータベースの移行を実行します。

Confirm ボタンをクリックすると、Fisheye の内蔵データベースから外部データベースに移行する作業が実行されます。
登録されているデータ量によっては時間がかかることがありますので、しばらくお待ちください。

4. データベースの移行を完了する

データベースの移行作業が完了すると、ダイアログボックス画面に Database migration successful. というメッセージが表示されます。
Ok ボタンをクリックし、データベースの移行作業を完了します。

Database Configuration の画面が表示されるので、変更した内容が反映されていることを確認してください。

コンテキストパスの設定

つづいて、Fisheye にコンテキストパスを設定します。

コンテキストパスとは、URL でサーバー名に続く文字です。
セットアップウィザードを実行するときは http://(IP アドレス):8060 をブラウザーで開きましたが、コンテキストパスとして /fisheye を設定すると、http://(IP アドレス):8060/fisheye といった URL で Fisheye へアクセスできるようになります。

1. サーバー設定画面を開く

Fisheye の管理画面左側のメニュー Global Settings > Server のリンクをクリックします。

2. サーバー設定の編集画面を開く

Server Settings の画面が表示されるので、Edit settings のボタンをクリックします。

3. コンテキストパスを設定する

Edit Web Settings の画面内、Web context の項目に "/fisheye" を入力し、画面下部にある Update ボタンをクリックします。

Server Settings 画面の Web context の値が変更されていることを確認します。

4. Fisheye を再起動する

この設定を反映するには、Fisheye の再起動が必要となります。

Fisheye が稼働しているサーバーにて、以下の手順で Fisheye を再起動してください。

Windows の検索ボックスから "サービス" を検索し、サービスを開きます。
Atlassian Fisheye を選択し、左上のサービスの再起動をクリックします。

5. Fisheye へアクセスする

Fisheye の再起動後、http://(IP アドレス):8060/fisheye といった URL で Fisheye へアクセスできるか確認してください。

リポジトリの登録

ここでは、Fisheye に既存のリポジトリを登録し、参照する手順を説明します。

1. 管理画面を開く

ブラウザーで Fisheye にアクセスし、画面の最下部にある Administration のリンクをクリックします。

管理画面を開くためのパスワード入力画面が表示されるので、Fisheye のセットアップ時に設定したパスワードを入力し、Log in ボタンをクリックします。

ご注意ください

Git リポジトリを登録するときは、あらかじめ管理画面の Global Settings > Server から Git Executable を設定しておいてください。

(Git の設定ファイルや履歴情報が格納されているディレクトリを指定します。)

※ Repository Type が Git の場合のみ必要です。

参考画像...

2. リポジトリを追加する

リポジトリの管理画面が表示されるので、Add repository ボタンをクリックします。

3. リポジトリの基本情報を設定する

追加したいリポジトリの情報を入力します。ここでは、例として Git のリポジトリを参照してみます。

Repository Type に Git を選択し、Display Name にリポジトリの名前、Description にリポジトリの説明を入力し、Next ボタンをクリックします。

4. 参照するリポジトリを設定する

次に、参照するリポジトリに接続するための情報を入力します。入力内容の詳細については、リポジトリ管理者にご確認ください。
Test Connection ボタンを押すと接続テストを実行できます。

接続テストが成功すると Connection succeeded. というメッセージが表示されます。

Close ボタンを押して参照するリポジトリの情報入力画面に戻ったら、Next ボタンをクリックします。

5. リポジトリの最終設定をする

追加するリポジトリに関する最終的な設定を行います。
ここでは、すぐにリポジトリを利用できるようにするため Enable Repository After Adding チェックをつけてください。
Add ボタンをクリックしてリポジトリを追加します。リポジトリのサイズによっては時間がかかることがあります。

リポジトリ管理画面のリストに追加したリポジトリが表示され、State が Running であることを確認します。

6. 追加されたリポジトリを確認する

リポジトリの内容を参照するときは、以下の手順からリポジトリ画面を開いてください。

画面上部のメニューから Repositories > All repositories をクリックします。
リポジトリの一覧画面から、参照したいリポジトリ名のリンクをクリックします。
リポジトリの内容が表示されることを確認します。

以上で Fisheye と Crucible のインストールは完了です。