FishEye はJBoss や Apache で使われているバグトラッキングシステム Jira を開発している Atlassian の製品で、ソースコードリポジトリの変更履歴を確認したり、統計情報を確認したりできる Web アプリケーションです。
例によってオープンソース製品には無償のライセンスが用意されていて、JBoss.orgでも使われています。

今回 自宅の Jira とあわせて使ってみることにしました。

インストールガイドは以下のページにあります。
・英語 - FishEye Installation Guide - FishEye 1.6 - Confluence
・日本語 - FishEye インストールガイド - FishEye オンラインマニュアル (1.5版) - Atlassian Confluence

1. FishEye 1.6.3 のダウンロード
ダウンロードページより zip アーカイブをダウンロードします。FishEye はどういうわけか Jira と違って JBoss や WLS 等の既存のアプリケーションサーバにデプロイすることはできず、スタンドアロン版しかないそうです。
ちなみに Jetty を内蔵しているようです。

・FishEye Downloads

2. FishEye インストールディレクトリの作成
FishEye は自己完結型のディレクトリ構成を持っていますが、そのまま利用するとアップグレードが面倒になるため、運用環境ではデータは別ディレクトリに配置することを推奨しています。

というわけで好きな位置に fisheye ディレクトリを掘ってみました。
また、fisheye ディレクトリには fisheye-1.6.3/config.xml ファイルをコピーしておきます。

3. FishEye を起動
まずは起動してからセットアップします。

起動すると Server ID という 16 ケタの16進数の ID が発行されます。
これを控えておき、http://my.atlassian.com で評価用ライセンスを取得します。

4. ライセンスの入力
http://my.atlassian.com でライセンスキーを取得できたら http://ホスト:8060にアクセスし、ライセンスキーを入力します。

ライセンスキーを入力


ライセンスが受け入れられたところ

5. リポジトリのセットアップ
http://ホスト:8060/adminにアクセスすると、管理画面になります。

fisheye 管理画面
[Repository List > Add repository] より、リポジトリを追加するフォームが表示されます。
Name*: リポジトリの名前
Repository type: SVN, CVS, perforce の中から選択
SVN URL*: プロトコルスキームから始まるリポジトリのパスを入力
Path: リポジトリのうち特定のディレクトリだけを fisheye で表示したい場合は入力
trunk/branch/tag structure: /project/trunk/..., /project/branches/NAME/..., /project/tags/NAME/...


リポジトリ追加フォーム

フォームに必要事項を記入したら [add] でリポジトリの追加が完了。
自動的にリポジトリのスキャンが始まります。

6. コンテクストパス、ajp コネクタのセットアップ
FishEye はデフォルトでルートコンテキストで動作するようです。
今回は FishEye 用のサブドメインを立てるのではなく、http://yusuke.homeip.net/fisheye/ というパスでアクセスできるようにしたいのでコンテクストパスを設定することにしました。
コンテクストパスやその他 Web サーバの設定は [Server Settings > Web Server > Edit settings] より行えます。
以下のように設定しました。
WebContext: fisheye
Http Bind Address: 8060
Ajp13 Bind Address: 8069

Bind Address のところは特定の NIC だけでリスンてほしければ IPアドレス:ポート のフォーマットで入力すればokです。
今回は Wifi でも Ethernet でもリスンして欲しいのでポートだけ入力しました。

7. 起動スクリプト設定
デフォルトではヒープサイズや GC ログの設定がされていないようです。
最低限どれくらいのヒープサイズで動くのかわかりませんのでざっくりと 64mb に設定し、-XX:+PrintGCTimeSamps オプションで GC 状況のログを取っておくことにしました。
設定は fisheyectl.sh に書きます。

8. mod_jk 設定
8060番ポートに穴を空けたくないので mod_jk を以下のように設定して Apache と連携させました。
worker.properties

uriworkermap.properties

9. 起動設定
FishEye は run.sh で簡単に起動できますが、サーバ(再)起動時に手動で起動するのは面倒なので自動起動できるように設定しました。


MacOSX 独自の起動スクリプトを書く


# vi StartupParameters.plist

これで fisheye/StartupParameters.plist の２つのファイルを見て Mac OSX 起動時に勝手に FishEye を起動してくれるようになります。
コマンドラインから操作する際は
# SystemStarter start|stop|restart fisheye
でできます。
標準(エラー)出力は $FISHEYE_INST/var/log に記録されます。

10. robots.txt の設定
FishEye をセットアップしたことで、Google や Yahoo! にコードリポジトリそのものの索引を作ってもらう必要がなくなりましたので以下のように設定して検索対象からはずしました。
FishEye のコードは検索でヒットしても良いので Disallow に入れていません。


11. 完了
以上の設定で無事 FishEye をインストールできました。
・FishEye: browsing yusuke.homeip.net/

しばらく使ってみて特に問題無ければオープンソースプロジェクト向けライセンスの発行を依頼したいと思います。

関連記事:
・Jira 3.13.1 へ FishEye プラグイン 2.3 をインストール
・Jira をバージョン 3.13.1 へアップデート
・Jira をバージョン 3.12.3 へアップデート

Jira(バグトラッキングシステム), Confluence(Wiki) など Atlassian 社の製品は日本では代理店であるイマヒマ社より購入していただくことも可能です。
・チームウェア - アトラシアン JIRA（ジラ）：画期的な課題トラッキング! Confluence（コンフルエンス）：企業向けウィキ

もう２ヶ月以上も前になりますが自宅サーバの blogware として使っている Pebble をバージョン1.9 から最新の 2.3.1 にアップデートしました。
Pebble はオープンソースのブログソフトで、Simon Brown という最近ニュージャージーに引っ越したイギリス人が主に開発しています。
メーリングリストはそこそこ活発で今でもアクティブにアップデートが行われている製品です。

Pebble のインストールは何も難しいことはありませんが、手順を記しておきます。
アプリケーションサーバは JBoss AS 4.2.2 です。

1. ダウンロード
Sourceforgeより最新版をダウンロード。

2. メールセッションの有効化。
Pebble 1.9 では直接 JavaMail を叩いているようで Pebble の設定内に SMTP サーバなどがありました。
Pebble 2.3.1 ではメールセッションを使ってメールの設定を外だしできます。
JBoss の default コンフィギュレーションにはメールセッションの機能がなかったため、all コンフィギュレーションより mail-ra.rar と mail-service.xml をコピーしてきて、mail-service.xml を以下のように変更しました。

<?xml version="1.0" encoding="UTF-8"?>
<server>
  <mbean code="org.jboss.mail.MailService"
         name="jboss:service=Mail">
    <attribute name="JNDIName">java:/Mail</attribute>
    <attribute name="User">yusuke@homeip.net</attribute>
    <attribute name="Password">**********</attribute>
    <attribute name="Configuration">
      <configuration>
        <property name="mail.store.protocol" value="pop3"/>
        <property name="mail.transport.protocol" value="smtp"/>
        <property name="mail.pop3.host" value="pop3.gmail.com"/>
        <property name="mail.smtp.host" value="smtp.gmail.com"/>
        <property name="mail.smtp.port" value="465"/>
        <property name="mail.from" value="yusuke@yusuke.homeip.net"/>
        <property name="mail.smtp.socketFactory.class" value="javax.net.ssl.SSLSocketFactory"/>
        <property name="mail.smtp.socketFactory.fallback" value="false"/>
        <property name="mail.smtp.socketFactory.port" value="465"/>
        <property name="mail.smtp.auth" value="true"/>
        <property name="mail.smtp.user" value="yusuke@homeip.net"/>
        <property name="mail.smtp.password" value="**********"/>
        <property name="mail.debug" value="false"/>
      </configuration>
    </attribute>
    <depends>jboss:service=Naming</depends>
  </mbean>
</server>

jboss-web.xml には以下のように設定

<jboss-web>
  <context-root>/</context-root>
  <resource-ref>
    <res-ref-name>mail/Session</res-ref-name>
    <jndi-name>java:/Mail</jndi-name>
  </resource-ref>
</jboss-web>

3. デプロイ
ルートコンテキストにデプロイしたいので、jboss-web.deployer/ROOT.war を削除。
続いて pebble.war を deploy ディレクトリに移動。

4. アクセス
http://host:port/ にアクセスし、ユーザ名:username、パスワード:password でログイン

ほんと簡単です。

以上