Jira7.13升级Jira8.9完整技术方案

Altassian官网对Jira 7版本支持的最后日期是：2020-11-28，此后不再支持JIRA 7.13版本，JIRA8版本整体在功能上并没有什么惊艳，但根据官方说法性能优化有比较大的改进，为了同步，还是有必要进行升级。

假如服务器上部署的是Jira7.13版本，破解的方案是通过试用license+替换atlassian-extras-3.2.jar的方式来破解的，升级时如果直接用前一篇《JIRA8.X版本安装及插件破解》中的方法，再启动JIRA服务时会报license错误，猜测的原因是因为当初安装JIRA7.13时的破解方式不同导致的，破解作者也提到过：“破解需要成套使用，不能只破解插件，要先使用xxxxx-xxxxx.jar破解服务”。通过多次实验，可以采用如下方案进行升级，具体步骤如下：

1 升级准备

1.1 先做实例运行状况检查，确保通过，如下图。

Addons -> Manage addons -> JIRA update check，检查升级目标版本与当前版本中插件的兼容性，如下图：

这里可能还会有其他几个状态：

incompatible：不兼容。这种情况要么不升级（或者找一个可以兼容的可以升级的版本），要么禁用插件

compatible：直接兼容

Compatible, if updated：升级插件可以与目标Jira版本升级

Compatible once both are updated：jira升级完成后，插件需要升级。官方建议的步骤是先disable插件，然后升级Jira，最后升级插件

Unknown：未知状态，建议先在测试环境试验下。

1.2 备份数据库和JIRA

备份数据库

备份JIRA，可使用JIRA自带的备份工具【备份系统】，全站备份一个zip文件，备份文件将存放在这里: /var/atlassian/application-data/jira/export

2 前置条件

2.1 Jira7.13 安装环境：Centos 7 + Mysql 5.6，对应的IP为：192.168.138.128，记为：Server_A

2.2 Jira 的server id为：BZPI-CUUD-QQGJ-XXXX

2.3 Jira7.13通过试用license+替换atlassian-extras-3.2.jar的方式破解的

3 升级步骤

3.1 计算license

上传xxxx-xxxx.jar 包到服务器目录/opt/atlassian下

#cd /opt/atlassian

#java -jar xxxx-xxxx.jar -p jira -m abc@qq.com -n shvm -o shgds -s BZPI-CUUD-QQGJ-XXXX

上面命令会输出license，如下图:

3.2 在Jira7.13的数据库表：productlicense 里删除license，更新为步骤3.1计算出的license

3.3 升级安装Jira 8.9.1，升级安装交互过程如下：

升级最后的交互，选N，不启动。

如果直接启动，会报错如下：

A fatal error occured during initialisation. JIRA has been locked.

com.atlassian.extras.common.LicenseException: Failed to verify the license.

3.4 使用命令启动JIRA服务：

#cd cd /opt/atlassian/jira/bin

#vim setenv.sh

export JAVA_OPTS="-javaagent:/opt/atlassian/atlassian-agent.jar ${JAVA_OPTS}" # 将该配置写入setenv.sh文件中

#./start-jira.sh # 启动

或者

JAVA_OPTS="-javaagent:/opt/atlassian/xxxxx-xxxxx.jar" /opt/atlassian/jira/bin/start-jira.sh

tail -f /opt/atlassian/jira/logs/catalina.out，如果启动成功，会有如下输出

Upgrade Succeeded! JIRA has been upgraded to build number 804000

3.5 进入首页验证，首页会有告警，先忽略继续，如下图：

会进入JIRA升级通知页面，但页面上方会提示三方插件失效。

3.6 验证JIRA license

3.7 破解插件

#cd /opt/atlassian

#java -jar xxxxx-xxxxx.jar -p ‘com.go2group.jira.plugin.synapse’ -m abc@qq.com -n shvm -o shgds -s BZPI-CUUD-QQGJ-VCEJ

效果如下图：

3.8 完整按照上面的步骤，升级成功