Page tree

Contents

はじめに

ここでは、AtlassianFishEye2.8をWindows環境にインストールする手順をご紹介します。
FishEyeは、Subversion、Git、Mercurial、CVS、Perforceに対応したソースコードリポジトリブラウザです。機能の詳細については、こちらのページもご確認ください。

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

プログラムディレクトリ

C:\Atlassian\FishEye

データディレクトリ

C:\Atlassian\FishEye_home

コンテキストルート 
(URLでサーバー名に続く文字)
/fisheye

DB

FishEye と同一のコンピュータにインストールされたPostgreSQLを利用(今回はfisheye_dbを使用)

javaJava SE Development Kit 7u7

起動方法

起動用バッチファイルをダブルクリックして起動

リポジトリFishEyeと同じコンピュータ上に作成することをおすすめします

対応しているDBのバージョン

FishEye2.8がサポートしているPostgreSQLのバージョンは「8.2, 8.3, 8.4」となっています。これら以外のバージョンはサポート対象外となりますのでご注意ください。

最新の情報は、Atlassianのサポートプラットフォームのページ( https://confluence.atlassian.com/display/FISHEYE/Supported+Platforms )で確認できます。

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

1.JDKのインストール

はじめに

このページでは、JDK7u6のインストールと環境変数の設定について説明します。本ドキュメントでは、2012年8月時点での最新バージョンである「Java SE Development Kit 7」を使用しています。

1.ダウンロード

Java SE Downloadsページ( http://www.oracle.com/technetwork/java/javase/downloads/index.html )をブラウザーで開きます。
Java Platform(JDK) 7u7」のボタンをクリックします。

ダウンロードページが開きます。
JDKをダウンロードするには、ライセンスに同意する必要があります。ライセンス内容をご確認いただき、「Accept License Agreement」にチェックを付けてください。 

リストからファイルをダウンロードできるようになります。Windows用のインストーラはリストの最後にあります。
お使いの環境に合わせて、32ビット(x86)版または64ビット(x64)版をダウンロードしてください。

ダウンロードしたファイルは、適当なフォルダに保存してください。

2.インストール

インストーラを起動するには、ダウンロードしたファイルをダブルクリックします。
(起動時にセキュリティの警告が表示されることがあります。) 

最初にJDKのインストーラ画面が表示されます。「次へ」ボタンをクリックしてインストーラを進めます。

インストールオプションを選択する画面が表示されます。
ここでは何も変更せずに「次へ」ボタンをクリックしてください。

 

JDKのインストールを行います。しばらくお待ちください。

JDKのインストールが終了すると、続いてJREのインストールが始まります。
インストール先を確認指定する画面が表示されますので、何も変更せずに「次へ」ボタンをクリックしてください。 

JREのインストールを行います。しばらくお待ちください。

作業が終了すると完了画面が表示されます。
閉じる」ボタンをクリックしてインストーラを終了してください。

以上でJDKのインストール作業は終了です。

2.ダウンロード

FishEyeは、Atlassianのホームページからダウンロードできます。
最初は英語で表示されていますが、右上の「Languages」から「日本語」を選択すると日本語表示に切り替えられます。
この画面では「無料トライアル」のリンクをクリックします。

 「開発ツール」の「FishEye」に表示されている「トライアル」ボタンをクリックします。

ここではダウンロード版を使用するので、「ダウンロード」の「無料トライアル開始」ボタンをクリックします。

FishEyeのダウンロードファイルは各プラットフォーム共通です。表示された画面の「ダウンロード」ボタンをクリックすると、ダウンロードが開始されます。
ダウンロードしたファイルは適当なフォルダに保存してください。 

3.インストール

FishEyeをWindows環境にインストールする手順について説明します。
あらかじめAtlassianのサイトからインストール用のファイルをダウンロードしておいてください。

インストール

ダウンロードしたファイルを適当なフォルダに保存します。
ファイルを右クリックして表示されるポップアップメニューから「すべて展開」を選択します。

 「圧縮(ZIP形式)フォルダーの展開」ダイアログボックスが表示されたら「展開」ボタンをクリックします。

ZIPファイルを解凍し、ファイルを展開します。少し時間がかかりますので、しばらくお待ちください。

ファイルの解凍が終わったら、展開されたフォルダの中にある「fecru-2.8.1」フォルダをインストール先のフォルダに移動します。
ここでは、「C:\Atlassian\FishEye」フォルダに移動しました。 

環境変数とデータディレクトリの設定

JAVAホームディレクトリやFishEyeに情報を保存するデータディレクトリの場所を指定するため、環境変数の設定を行います。

 環境変数設定内容
JAVAホームディレクトリJAVA_HOMEC:\Program Files\Java\jdk1.7.0_07
コマンド検索先の指定PATH%PATH%;%JAVA_HOME%
FishEyeデータディレクトリFISHEYE_INSTC:\Atlassian\FishEye_home

環境変数の設定は、C:\Atlassian\FishEye\fecru-2.8.1\bin\fisheyectl.bat で行います。
fisheyectl.bat をエディタで開き、以下のように編集してください。

C:\Atlassian\FishEye\fecru-2.8.1\bin\fisheyectl.bat(一部省略)
@echo off

@setlocal

set JAVA_HOME=C:\Program Files\Java\jdk1.7.0_07   ←この行を追加する。
set PATH=%PATH%;%JAVA_HOME%;                      ←この行を追加する。
set FISHEYE_INST=C:\Atlassian\FishEye_home        ←この行を追加する。
set FISHEYE_HOME=%~dp0..


if exist "%FISHEYE_HOME%\fisheyeboot.jar" goto haveFishEye


echo Could not find "%FISHEYE_HOME%\fisheyeboot.jar"
goto end


:haveFishEye

(以下省略)

次に、データディレクトリとして使うフォルダの準備を行います。
データディレクトリ用のフォルダ(C:\Atlassian\FishEye_home)を作成します。

データディレクトリ用のフォルダに、FishEyeが使用するためのファイルとフォルダをコピーします。
プログラムディレクトリの fecru-2.8.1フォルダにある varフォルダと config.xmlファイルを選択し、右クリックして表示されるポップアップメニューから「コピー」を選択します。

作成したデータディレクトリ用のフォルダを開き、右クリックして表示されるポップアップメニューから「貼り付け」を選択します。

起動と終了

FishEyeを起動するため、「~\fecru-2.8.1\bin」フォルダの「start.bat」を実行します。

「セキュリティの警告」ダイアログボックスが表示されたら「実行」ボタンをクリックします。

コマンドプロンプトのウィンドウが開き、処理状況が表示されます。

WARN: your default encoding (windows-31j) does not support unicode.
This is likely to cause problems if any of the filenames, branch names or tag names in one of your repositories contain unicode characters.
Update your locale settings or start with the -Dfile.encoding=UTF-8 option to avoid these problems.
2012-09-04 09:45:56,489 INFO  - FishEye/Crucible 2.8.1 (20120829051639), Built on 2012-08-29
2012-09-04 09:45:58,143 INFO  - Starting UpgradeManager...
2012-09-04 09:45:58,582 INFO  -
2012-09-04 09:45:58,582 INFO  - =======================================================
2012-09-04 09:45:58,582 INFO  -
2012-09-04 09:45:58,583 INFO  - Welcome to FishEye!
2012-09-04 09:45:58,583 INFO  -
2012-09-04 09:45:58,583 INFO  - You need to configure an admin password and enter your
2012-09-04 09:45:58,584 INFO  - license key. You can do this by accessing FishEye through
2012-09-04 09:45:58,584 INFO  - a web browser, once the server has started:
2012-09-04 09:45:58,584 INFO  -
2012-09-04 09:45:58,586 INFO  - http://koyama-think:8060
2012-09-04 09:45:58,586 INFO  -
2012-09-04 09:45:58,586 INFO  - Refer to the FishEye administration guide
2012-09-04 09:45:58,586 INFO  - for more information:
2012-09-04 09:45:58,587 INFO  -
2012-09-04 09:45:58,587 INFO  - https://confluence.atlassian.com/display/FISHEYE/Starting+to+use+FishEye
2012-09-04 09:45:58,587 INFO  -
2012-09-04 09:45:58,587 INFO  - =======================================================
2012-09-04 09:45:58,587 INFO  -
2012-09-04 09:45:58,591 INFO  - Your Server ID is ????-????-????-????
2012-09-04 09:46:03,595 INFO  - Starting database...
2012-09-04 09:46:07,223 INFO  - Starting plugin system...
2012-09-04 09:46:25,361 INFO  - Server started on :8060 (http) (control port on 127.0.0.1:8059)

~ Server started on :8060 (http) ~」というメッセージが表示されたら、FishEyeを利用可能です。

FishEyeを終了するときは

start.batと同じフォルダにある stop.bat を実行します。

ログファイルの出力先

FishEyeのログファイルは C:\Atlassian\FishEye_home\var\log に出力されています。

Windows セキュリティの重要な警告が表示されたときは

FishEyeを実行したときに、以下の画面のような「Windows セキュリティの重要な警告」ダイアログボックスが表示されることがあります。
この場合は「アクセスを許可する」ボタンをクリックしてください。 

4.セットアップ

FishEyeの画面から行うセットアップ作業として、「セットアップウィザードの実行」「コンテキストルートの設定」「外部データベースの設定」を行います。

セットアップウィザードの実行

インストールしたFishEyeに初めてアクセスすると、セットアップウィザードが始まります。
セットアップウィザードでは、ライセンス情報の入力、管理用パスワードの設定などを行います。

ブラウザーで「http://(サーバー名 または IPアドレス):8060」にアクセスすると、セットアップウィザードが表示されます。
Enter exsiting license」ボタンをクリックすると「Enter license key」テキストボックスが表示されます。ここに弊社からメールでお送りしたライセンスキーを入力してください。
入力できたら「Next」ボタンをクリックします。 

 

ライセンスが確認されたら、FishEye評価版に同梱されているソースコードレビューツールのCrucibleも一緒に評価するか確認する画面が表示されます。
今回はFishEyeのみ利用したいので、チェックを外してから「Next」ボタンを押してください。 

Crucibleについて

CrucibleはAtlassianのコードレビュー支援ツールです。詳細はこちらのページをご確認ください。

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

JIRAについて

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

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

 

これでFishEyeを利用する準備ができました。
Add repository」ボタンをクリックしてFishEyeを開始します。

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

FishEyeの管理画面が表示されます。

コンテキストルートの設定

最初にFishEyeにコンテキストルートを設定します。
コンテキストルートとは、URLでサーバー名に続く文字です。 セットアップウィザードを実行するときに「http://(サーバー名):8060」をブラウザーで開きました。コンテキストルートとして「/fisheye」を設定すると、「http://(サーバー名):8060/fisheye」を代わりに使うようになります。

管理画面で「Global Settings」→「Server」リンクをクリックします。

Server Settings」画面が開き、現在の設定が表示されます。
画面下側にある「Edit settings」ボタンをクリックします。

Web context」に「/fisheye」と入力します。

画面下の方にある「Update」ボタンをクリックします。

Web context」の設定値が変更されていることを確認します。

コンテキストルートを設定することにより、FishEyeのURLは「http://(サーバー名):8060/fisheye」に変更されます。

この設定を反映するには、FishEyeの再起動が必要です。

stop.batを実行してFishEyeを停止したあと、start.batを実行します。

再起動後は、「http://(サーバー名):8060/fisheye」のURLで FishEye にアクセスできるか確認してください。

外部データベースの設定

コンテキストルートを設定したURLでFishEyeにアクセスできたら、続いて外部データベースの設定を行います。

FishEyeは、データ保存用にデフォルトでは内蔵データベースを 使用します。このデータベースは本番稼動で使用するにはパフォーマンスに問題があるため、PostgreSQLなどの外部データベースを使用するように設定します。
利用可能なデータベースは、Atlassianのサポートプラットフォームのページ( https://confluence.atlassian.com/display/FISHEYE/Supported+Platforms )で確認してください。
ここでは、PostgreSQLを例にして手順を説明します。

まずFishEyeの画面下部にある「Administration」リンクをクリックして管理画面を開きます。

画面左側のメニューで、「System Settings」→「Database」のリンクをクリックします。

Database Configuration」画面が開きます。デフォルトでは、「Type」が「Built-In」になっており、内蔵データベースを使用しています。
設定を変更するため「Edit」ボタンをクリックします。

データベース設定の編集画面が開きます。
Type」ドロップダウンリストで「PostgreSQL」を選択します。
続いて「URL」に表示されている文字列の一番最後の部分を、データベース作成時に設定したデータベース名に置き換えます。ここでは「fisheye_db」としました。 
User Name」「Password」も同様に、データベース作成時に設定したユーザー名トパスワードを入力します。ユーザー名は「fisheye_db_usr」としました。 
入力できたら、設定内容を確認するため「Test Connection」ボタンをクリックします。

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

FishEyeの使用するデータベースを内蔵データベースから外部データベースに切り換える作業が自動的に実行されます。登録されているデータ量によっては、時間がかかることがあります。しばらくお待ちください。
切り替えが成功すると、画面に「Database migration successful.」というメッセージが表示されます。
メッセージを確認したら「OK」ボタンをクリックします。

 「Database Configuration」画面に戻ります。
変更した内容が反映されていることを確認してください。

5.リポジトリの登録

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

FishEyeの画面の下側に表示されている「Administration」リンクをクリックして管理画面を開きます。

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

リポジトリの管理画面が表示されます。既存のリポジトリを登録するため「Add Existing」ボタンをクリックします。

追加したいリポジトリの情報を入力します。ここでは、例としてSubversionのリポジトリを参照してみます。
最初の画面では、リポジトリの種類とFishEyeで表示するときの名前、説明を入力します。今回はSubversionのリポジトリを参照するので、Repository Typeドロップダウンリストから「Subversion」を選択します。名前と説明には、リポジトリを識別するための適当な内容を指定してください。
入力できたら「Next」ボタンをクリックします。 

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

接続テストが成功すると「Connection succeeded.」というメッセージが表示されます。
メッセージを確認して「Close」ボタンをクリックします。

Next」ボタンをクリックします。

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

リポジトリのリストに、いま追加したリポジトリが追加されます。
State」が「Running」であることを確認してください。 

追加したリポジトリの状態を確認します。
リストの右端にある歯車をアイコンをクリックしてポップアップメニューを表示し、「View」を選択します。

 リポジトリのステータス画面が表示されます。
State」が「Running」になっていることを確認してください。「Recent Activity」には、リポジトリに対して最近実行したコマンドが表示されています。
確認できたら「Close Without Saving」をクリックして画面を閉じます。 

 追加したリポジトリの内容を参照するときは、画面上部の「Source」をクリックします。

リストに先ほど追加したリポジトリが表示されているので、リポジトリ名のリンクをクリックします。

リポジトリの内容を参照することができます。

6.サービスとして登録

ご注意ください

Windows環境では、FishEye2.8をそのままサービスとして登録することはできません
外部ツールを使用して、サービスとして動作させるための設定を行う必要があります。

Atlassianが公開しているFishEye2.8のドキュメント「 Running FishEye as a Windows service 」(英語)を参考に作業を行なってください。

 


以上でFishEyeのインストールは終了です。お疲れさまでした。

ご参考

お使いの環境によっては、追加でファイルシステムエンコードの設定を行わないと不具合の発生することがあります。
ファイルシステムエンコードの設定は、以下のテクニカルFAQを参考にしてください。

TECHFAQ-81 FishEyeのファイルシステムエンコードを設定したい

  • No labels

This page has no comments.