Jira 是 Atlassian 開發的企業級專案與議題追蹤平台，廣泛用於敏捷開發、服務台、任務管理。本文記錄在 Linux 伺服器從零部署 Jira 5.2 的完整流程：JDK → MySQL → Tomcat → Jira 四階段安裝配置，含資料庫設定、授權配置與常見問題排除。

系統需求

• Linux 伺服器（建議 4GB+ RAM，Jira + Tomcat + MySQL 共同運行）
• 根權限存取
• 網路連線（下載安裝包）

第一階段：安裝 JDK 7

# 1. 下載 JDK (範例: jdk-7u17-linux-x64.tar.gz)
# 2. 上傳至伺服器
scp jdk-7u17-linux-x64.tar.gz root@210.56.194.45:

# 3. 建立目錄並解壓
mkdir -p /usr/local/java
cp jdk-7u17-linux-x64.tar.gz /usr/local/java/
cd /usr/local/java
tar -xzf jdk-7u17-linux-x64.tar.gz

# 4. 設定環境變數
vi /etc/profile
# 追加以下內容：
export JAVA_HOME=/usr/local/java/jdk1.7.0_17
export CLASSPATH=$JAVA_HOME/lib:$JAVA_HOME/jre/lib
export PATH=$PATH:$JAVA_HOME/bin:$JAVA_HOME/jre/bin

# 5. 生效並驗證
source /etc/profile
echo $JAVA_HOME
java -version

第二階段：安裝 MySQL

# 1. 安裝
yum install mysql-server -y

# 2. 啟動並設定開機自啟
service mysqld start
chkconfig mysqld on

# 3. 安全性初始化
mysql_secure_installation

# 4. 建立 Jira 資料庫與使用者
mysql -u root -p
CREATE DATABASE jiradb CHARACTER SET utf8 COLLATE utf8_bin;
CREATE USER 'jira'@'%' IDENTIFIED BY 'jira';
GRANT ALL PRIVILEGES ON jiradb.* TO 'jira'@'%';
FLUSH PRIVILEGES;
EXIT;

第三階段：安裝 Tomcat 6

# 1. 下載與解壓
mkdir -p /usr/local/tomcat
cp apache-tomcat-6.0.20.tar.gz /usr/local/tomcat/
cd /usr/local/tomcat
tar -xzf apache-tomcat-6.0.20.tar.gz

# 2. 啟動測試
/usr/local/tomcat/tomcat/bin/startup.sh

# 驗證輸出應包含：
# Using CATALINA_BASE: /usr/local/tomcat/tomcat
# Using JRE_HOME: /usr/local/java/jdk1.7.0_17

第四階段：安裝與配置 Jira

# 1. 解壓 Jira 獨立版
mkdir -p /opt/jira
tar -xzf atlassian-jira-5.2.11-standalone.tar.gz -C /opt/jira

# 2. 啟動 Jira
/opt/jira/atlassian-jira-5.2.11-standalone/bin/startup.sh
# 查看啟動日誌
/opt/jira/atlassian-jira-5.2.11-standalone/bin/catalina.sh run

資料庫配置：修改 server.xml

<Resource name="jdbc/JiraDS" auth="Container" type="javax.sql.DataSource"
    username="jira"
    password="jira"
    driverClassName="com.mysql.jdbc.Driver"
    url="jdbc:mysql://210.56.194.45:3306/jiradb?autoReconnect=true&useUnicode=true&characterEncoding=UTF8"
    maxActive="20"
    validationQuery="select 1" />

授權配置

編輯 atlassian-jira/WEB-INF/classes/jira-application.properties 設定 jira.home，並透過管理介面輸入授權金鑰（或放置 jira.license 檔案）。

常見問題排除

維護建議

• 定期備份 $JIRA_HOME 目錄與資料庫
• 監控 JVM 記憶體使用率，調整 setenv.sh 中 JVM_MAXIMUM_MEMORY
• 訂閱 Atlassian 安全公告，及時套用修補版本
• 考慮遷移至支援版本（Jira 5.2 已停止維護），或使用 Docker 部署簡化維運

問題	原因	解決方案
Tomcat 啟動但網頁無法存取	JDK 路徑錯誤或環境變數未生效	檢查 JAVA_HOME、catalina.sh 中 JRE_HOME 設定
JIRA startup failed, JIRA has been locked	殘留 .jira-home.lock 檔案	刪除 $JIRA_HOME/.jira-home.lock 重啟
埠號衝突 (8005/8080)	其他服務佔用	修改 server.xml 埠號、netstat -tln 排查、kill -9 PID
上傳中斷導致檔案損毀	網路不穩	刪除殘留檔案重新上傳，驗證檔案大小/校驗和