JIRA安裝
一、 瞭解JIRA
JIRA 是目前比較流行的基於Java架構的管理系統 ，是集項目計劃、任務分配、需求管理、錯誤跟蹤於一體的商業軟件，功能全面，界面友好，安裝簡單，配置靈活，權限管理以及可擴展性方面都十分出色。
因爲是基於JAVA的所以需要JAVA環境，因爲是商業軟件所以會要有license key 。
二、 具體安裝過程
1、基礎環境（以自己實踐的環境爲例）
操作系統： Linux （具體用過的RHEL 5.4）
2、思考過程
正確的思考方式：
A、直接下載JIRA程序，安裝方法查看解壓包中的README.txt或者有些軟件包還有一個INSTALL
B、以JIRA的官方安裝方法爲基準 再參考google搜索出來的其他文章。
C、遇到具體再具體分析。
3、下載JIRA
JIRA 官網：http://www.atlassian.com/software/jira/
4、根據README.txt安裝
——————-
第1步. 安裝JDK環境 ，配置java的環境變量
chmod +x jdk-6u14-linux-i586.bin
./jdk-6u14-linux-i586.bin
mv jdk1.6.0_14 /usr/local/jdk
在/etc/profile尾添加
JAVA_HOME=/usr/local/jdk
CLASSPATH=.:$JAVA_HOME/lib/tools.jar:$JAVA_HOME/lib/dt.jar
PATH=$JAVA_HOME/bin:$PATH
export JAVA_HOME
export PATH
export CLASSPATH
需重啓機器啊
查看是否成功:
用java -version
也可以編寫個hello.java測試下
第2步：安裝tomcat
1. 下載apache-tomcat-7.0.2.tar.gz
2. #tar -zxvfapache-tomcat-7.0.2.tar.gz；//解壓
3. 配置環境變量 /etc/profile
CATALINA_HOME=/usr/local/apache-tomcat-7.0.2
export CATALINA_HOME
4. ./tomcat/bin/startup.sh； //啓動tomcat
顯示 UsingCATALINA_BASE:
Using CATALINA_HOME:
Using CATALINA_TEMDIR:
Using JAVA_HOME:
到這裏說明Tomcat已經安裝好了，也啓動成功了，可以輸入http://localhost:8080查看
注意：防火牆對於8080的端口是否開放 iptables
8080端口是否被佔用，修改conf/server.xml文件
Ps –ef |grep tomcat 查看進程
第3步：配置MYSQL
創建數據庫: create database jiradb characterset utf8;
創建用戶權限
grant all privileges on jiradb.* to jirauser@localhost identified by'mypassword' with grant option;
flush privileges;
第4步：安裝MYSQL/JJDBC 驅動
作用就是讓JAVA可以通過JDBC連接MYSQL
將mysql-connector-java-xxx-bin.jar的文件，放入tomcat/lib，或者放入在jira的lib文件下
第5步:安裝jira
1、創建Jira運行時使用的目錄 mkdir /var/jira_home
2、去Atlanssian官網下載jira，地址： http://www.atlassian.com/download/ ，注意下載的時候不要選擇"Standalone"版本，去下載war包格式的，atlassian-jira-4.3.4-war
3、解壓到某目錄，進入Jira的目錄並且給build.sh加上執行權限，運行之後會自動生成一個war包，位置在dist-tomcat/tomcat-6/atlassian-jira-4.3.4.war
4、我們需要拷貝這個war包到tomcat下的webapps目錄（$CATALINA_HOME/webapps)
5、啓動tomcat讓其解壓後,再停掉Tomcat，把webapps下解壓出來的目錄拷貝到/home/http/jira-4.3.2(該步驟只是習慣，也可以不用移出來),並且刪除掉
6、修改A:vi /home/jira/conf/context.xml
修改成如下幾項
<Context path="/jira" docBase="/home/http/atlassian-jira-4.3.2">
<Parameter name ="jira.home"value="/var/jira_home"/>
<Resource name="jdbc/JiraDS"auth="Container" type="javax.sql.DataSource"
username="jira" 數據庫用戶名
password="jira" 數據庫密碼
driverClassName="com.mysql.jdbc.Driver"
url="jdbc:mysql://localhost/jiradb?autoReconnect=true&useUnicode=true&characterEncoding=UTF8" jiradb是數據庫名稱
maxActive="20"
validationQuery="select 1"/>
<Resource name="UserTransaction"auth="Container" type="javax.transaction.UserTransaction"factory="org.objectweb.jotm.UserTransactionFactory"jotm.timeout="60"/>
<Manager pathname=""/>
</Context>
修改B、
vim /home/jira/atlassian-jira/WEB_INF/classes/entityengine.xml
將其中的hsql改成mysql 數據庫類型<datasource name="defaultDS"field-type-name="hsql"
<datasource name="defaultDS" field-type-name="mysql"
刪除 schema-name="PUBLIC"
第6步：破解
在參照了網友的文檔後，本人選擇了使用iNViSiBLE的破解以及keygen程序，具體文檔可見： http://tonyty163.blog.51cto.com/721698/463101
iNViSiBLE程序下載：/Files/helloLinux/iNViSiBLE.zip ,請注意該程序需要系統配置了jdk纔可以運行，windows用戶請運行.bat,linux用戶運行.sh腳本。
該程序給/home/http/jira/atlassian-jira/WEB-INF/lib/atlassian-extras-2.2.2.jar 打上了補丁，並且重新覆蓋該文件即可。這裏本人不再累述該過程。
第7步：運行JIRA服務
*uix使用JIRA根目錄下的bin/starup.shwindows用bin\startup.bat
運行後可以通過logs下的日誌進行查看報錯
4. Point your browser at http://localhost:8080/
You should see JIRA’s Setup Wizard.
第七步：訪問JIRA
通過http://JIRA_server_ip:8080 進行查看 如果出來界面說明配置正確 如果報404等其它問題就是配置中出現問題了
通過仔細檢查配置文件都沒有改錯或者寫錯的話 那麼很有可能就是你的MYSQL連接不正確
三、問題排錯
可能大部分的人第一次安裝都不會那麼順利，我就是遇到了不少的問題，如何進行排錯呢，日誌是肯定不能少的。
出現問題後查看 logs下面的catalina.2009-07-14.log和catalina.out 日誌 但只能得到兩個錯誤
1、創建log4j.properties
vim /home/jira/common/classes/log4j.properties
log4j.rootLogger=DEBUG, R
log4j.appender.R=org.apache.log4j.RollingFileAppender
log4j.appender.R.File=${catalina.home}/logs/tomcat.log
log4j.appender.R.MaxFileSize=10MB
log4j.appender.R.MaxBackupIndex=10
log4j.appender.R.layout=org.apache.log4j.PatternLayout
log4j.appender.R.layout.ConversionPattern=%p %t %c - %m%n
2、下載 log4j
wget http://apache.freelamp.com/logging/log4j/1.2.15/apache-log4j-1.2.15.tar.gz
tar zxvf apache-log4j-1.2.15.tar.gz
cp apache-log4j-1.2.15/log4j-1.2.15.jar /home/jira/common/lib/
3、下載commons logging
wgethttp://apache.freelamp.com/commons/logging/binaries/commons-logging-1.1.1-bin.tar.gz
tar zxvf commons-logging-1.1.1-bin.tar.gz
cp commons-logging-1.1.1/commons-logging-1.1.1.jar /home/jira/common/lib/
這樣配置完後 重啓JIRA可以在日誌中看到更詳細的記錄
第一個就是在當前啓動JIRA服務的目錄下會產生atlassian-jira.log
tail -f atlassian-jira.log
第二個在logs中的catalina.out 跟上面的日誌內容是一樣的
分析：
以下就我出現的問題具體分析下日誌：
日誌取最早出現的error
問題A、main ERROR[jira.appconsistency.db.DatabaseConsistencyCheck] There was a SQL exceptionchecking for database driver correctness. Skipping
2009-07-14 17:12:57,743 main ERROR [core.entity.jdbc.DatabaseUtil] Unable toesablish a connection with the database… Errorwas:org.apache.tomcat.dbcp.dbcp.SQLNestedExceptio
n: Cannot load JDBC driver class ‘org.mysql.jdbc.Driver’
這個是名字打錯了，幾次折騰重新安裝時把驅動的名字打錯了 應該把 ‘org.mysql.jdbc.Driver’改成
‘com.mysql.jdbc.Driver’
問題B、org.apache.tomcat.dbcp.dbcp.SQLNestedException: Cannot createPoolableConnectionFactory (Server connection failure during transaction. Due tounderlying exception: ‘java.net.ConnectException: Connection refused’.
連接被拒絕了，其實這個原因是一直沒有成功的根源，我當時用的是slackware 12.1的默認mysql的服務啓動是skip-network 即是不能通過網絡訪問的，但手動本地localhost是可以的所以連接的，所以帶來了問題的麻煩
解決：去掉啓動腳本中的—skip-network
問題C：rg.apache.tomcat.dbcp.dbcp.SQLNestedException:Cannot create PoolableConnectionFactory (Server connection failure duringtransaction. Due to underlying exception: ‘java.sql.SQLException: Access deniedfor user ‘jirauser’@'127.0.0.1′ (using password: YES)’.
還是訪問被拒絕但已經有明顯的訪問方式爲jirauser’@'127.0.0.1′ ，這個很奇怪，爲什麼配置中用的是localhost卻用127.0.0.1來訪問，雖然邏輯上是一樣的，但mysql好像不能區分，所以又給127.0.0.1添加了一條權限
解決：grant all privileges on jiradb.* tojirauser@’127.0.0.1′ identified by ‘mypassword’ with grant option;
最後看到日誌中出了
Database configuration OK
___ Database Configuration _______
Loading entityengine.xml from :file:/home/atlassian-jira-enterprise-3.13.4-standalone/atlassian-jira/WEB-INF/classes/entityengine.xml
Entity model data source name : defaultDS
Entity model field type name : mysql
Entity model schema name :
Database Version : MySQL – 5.0.51b-log
Database Driver : MySQL-AB JDBC Driver – mysql-connector-java-5.0.5 ( $Date:2007-03-01 00:01:06 +0100 (Thu, 01 Mar 2007) $, $Revision: 6329 $ )
Database URL :jdbc:mysql://localhost:3306/jiradb?autoReconnect=true&useUnicode=true&characterEncoding=UTF8
Database JNDI address : java:comp/env/jdbc/JiraDS