Wednesday, March 24, 2010

Installing Atlassian FishEye and Crucible

Here I will explain how to install another Atlassian tool, the Fisheye (v2.2.1) (see the previous post for more about JIRA and Confluence). This documentation is based on the original guide, which I recommend you to read:


http://confluence.atlassian.com/display/FISHEYE/FishEye+Installation+Guide


1. First you need to download it. You can go to the download page: http://www.atlassian.com/software/fisheye/FishEyeDownloadCenter.jspa or get it with:

#---
wget http://www.atlassian.com/software/fisheye/downloads/binary/fisheye-2.2.1.zip
#---


I will assume that you already done the first steps from the JIRA and Confluence installation guide (MySQL + Tomcat) and that you have a running SVN server (see installation here). It is also assumed that you already enrolled a license for FishEye and Crucible. Have it handy.

2. To install FishEye you need to decompress the archive file:
#---
unzip fisheye-2.2.1.zip -d /usr/local/
#---


3. You need to create the database for FishEye and Crucible (I assume that the daemon is running):
#---
mysql -u root -p
#---


4. At the MySQL shell:
#---
CREATE DATABASE fisheyedb CHARACTER SET utf8;
GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,ALTER,INDEX,LOCK TABLES ON fisheyedb.* TO 'fisheyeuser'@'localhost' IDENTIFIED BY '';
FLUSH PRIVILEGES;
\q
#---


5. Check if you can access the databases:
#---
mysql \--user=fisheyeuser \--password= \--database=fisheyedb
#---


6. Then prepare for running:
#---
export FISHEYE_HOME="/usr/local/fecru-2.2.1/"
mkdir -p /var/local/atlassian/fisheye
export FISHEYE_INST="/var/local/atlassian/fisheye"
export JAVA_HOME="/usr/java/default/"
export JRE_HOME="/usr/java/default/jre/"
cp $FISHEYE_HOME/config.xml $FISHEYE_INST/
cd $FISHEYE_HOME/bin
./run.sh
#---


6.1. Wait until the server is up an than go to: http://localhost:8060/

7. Go directly to the Database Configuration and provide the following fields with the following data:

Type: MySQL
URL: jdbc:mysql://localhost/fisheyedb
User Name: fisheyeuser
Password: <plain text pass for fisheyeuser>


Hit "Test Connection" and than "Save & Migrate"

8. Go to Users and add a user putting it as administrator (in Administrators)

9. Add a user to your JIRA Server, if you have one: http://localhost:8080/jira

10. Set JIRA to accept API remote calls:
Administration -> General Configuration -> Accept remote API calls (must be ON)

11. Then return to FishEye and configure your JIRA server with the corresponding user. (You have to have at least one project).

12. Add a user in SVN by editing the files (for the very crude installation): [/var/svn/<repository>/conf/passwd]

13. Then return to FishEye and configure your SVN repository: svn://localhost/var/svn/<project>

P.S.: You may need to add an additional rule to your IPtables in the file [/etc/sysconfig/iptables]:

...
# Tomcat (FishEye)
-A INPUT -m state --state NEW -m tcp -p tcp --dport 8060 -j ACCEPT
...


#---
service iptables restart
#---


Related posts:
JIRA and Confluence instalation: http://gka-linux.blogspot.com/2010/03/jira-and-confluence.html
SVN instalation: http://gka-linux.blogspot.com/2009/07/subversion-and-apache-with-pam.html

No comments: