fisheye2.2.1 & Crucible 2.2.1 安装配置笔记

1) 下载

从atlassian网站http://www.atlassian.com/download/下载，地址：http://www.atlassian.com/software/fisheye/downloads/binary/fisheye-2.2.1.zip

当前最新版本2.2.1。

后面的安装过程中发现，其实这个就是Crucible 2.2.1的包, 在Crucible的下载页面  http://www.atlassian.com/software/crucible/CrucibleDownloadCenter.jspa  找到官方的解释，如下

The Crucible download below includes a bundled version of FishEye; however, this functionality is only available with a valid FishEye license. If you are evaluating Crucible, an evaluation license is automatically generated for FishEye as well.

下面的Crucibl下载包含一个捆绑的fisheye版本。然而，这个功能仅在有效的fisheye license时才能使用。如果你正在评估Crucible，会同时自动生成一个fisheye的评估license。

2) 安装

似乎没有安装可言，fisheye解压缩后，进入bin目录，执行run.sh/run.bat即可启动fisheye.感觉是内嵌了web container，特意搜索了一下，发现了lib/jetty-6.1.16.jar文件，看来用内嵌jetty直接发布web app的方式还真是流行啊。

3) 启动
执行run.sh启动完成后，提示按照提示，使用http://localhost:8060/地址访问。

第一次进入，会要求设置管理员密码，并要求输入Crucibl和fisheye的的license。按照前面的解释，只要输入Crucibl的license即可。

目前atlassian官方提供有效时间为30天的全功能评估license，可以在atlassian网站注册，然后申请，几分钟即可搞定。

想破解的同学，提示可以在这里 http://download.csdn.net/source/951332 下载到破解后的文件，替换安装目录下的同名文件即可。毕竟是破解，就不上传文件了，大家自己去下载吧。

完成之后就可以进入管理页面了，按照提示进入http://localhost:8060/admin。

4) 配置

1. 更改数据库

默认使用的数据库是内建的hsqldb数据库，准备修改为mysql.

进入管理界面, admin menu -> system -> database configuration.类型选择mysql，其他按照要求填写，注意数据库名需要事先在mysql数据库中建立，编码我选择了UTF-8。

点击test connection 后测试成功，就可以点击"save & migrate"继续。

期间出现一个意外错误，从日志上看，执行sql/MYSQL/schema/tables_63.sql 出错，日志提示
1071: Specified key was too long; max key length is 1000 bytes

有个索引的长度超过了默认1000字节的限制，因此如法建立数据库。这个是使用utf-8编码下的常见错误了，具体原因google一下有很多介绍。不重复了，解决的方法很简单，找到sql/MYSQL/schema/tables_63.sql文件，搜索cru_pid varchar(255) 的字样，总共有三处，修改为varchar(128)就可以避开这个错误了。

重新执行，注意执行前需要清空mysql数据库，可以drop database后再次创建。

后面的过程就没有再出错了。

2. 设置jira servers

进入 admin menu -> global settings -> jira servers, "Add a JIRA Server", 依次填入相关资料，Subtask 先留空不填。

点击"test"测试，注意如果发现不成功并且提示

Couldn't send XML-RPC request to http://192.168.0.40:1080/jira/ - have you enabled your JIRA server's remote API?

表明jira服务器没有打开remote API功能，需要先设置好jira。

进入jira管理界面，'JIRA Administrators' -> Administration -> 'Global Settings -> Configuration'. -> 'Edit Configuration'

Accept remote API calls  设置为 on。

再次test就可以成功了，点击save，搞定。

3. 设置(版本控制系统)仓库

admin menu -> Repository Settings -> Repository List (new...)

点击new, "Add Repository"界面中选择subversion，填写相关资料即可。

此时进入http://192.168.0.40:8060/，在dashboard的activity中可以看到最新的subversion的commits