JIRA&Confluence升级过程记录

JIRA用于需求缺陷管理，Confluence用于文档协作，知识库管理，两个是好基友。

团队最开始的JIRA版本为6.3.6，该版本有些插件不支持，功能也不够丰富，需要升级JIRA到最新版，升级的时候最新版是8.1.0，此文记录升级jira过程中遇到的问题。为了在保留原来数据的情况下进行升级，一开始的想法是新安装一个最新的jira、然后原来的jira导出备份，再在新的jira上导入备份，似乎显得很简单，操作过程中发现，由于版本跨度太大，并不能导入原有的备份，版本不能兼容，只能另找方法，查找jira文档，找到了如下一句话：If you plan to upgrade from JIRA and JIRA Agile less than 6.4.x and 6.3.5 respectively, you must upgrade to JIRA Software 7.0 as an interim version before upgrading further。

也找到其他人也遇到类似的问题：

可以看出由于版本跳跃得比较大，从6.x到8.x，jira并不支持直接升级，所以需要升级到一个中间过渡版本，此次升级过渡版本为7.0.0(升级好后再升级了个子版本7.0.11)然后再从这个版本升级到8.1。 mysql版本为5.7.x， 新版JIRA更换了字符排序规则，根据文档，在my.cnf加入如下配置：

default-storage-engine=INNODB

character_set_server=utf8mb4

innodb_default_row_format=DYNAMIC

innodb_large_prefix=ON

innodb_file_format=Barracuda

innodb_log_file_size=2G

collation-server=utf8mb4_bin

max_allowed_packet=256M

transaction-isolation=READ-COMMITTED

binlog_format=row

JIRA升级，执行相应的版本的安装包：

[root@ecs-test ~]# ./atlassian-jira-software-8.1.0-x64.bin

Unpacking JRE ...

Starting Installer ...

This will install JIRA Software 8.5.1 on your computer.

OK [o, Enter], Cancel [c]

Click Next to continue, or Cancel to exit Setup.

Choose the appropriate installation or upgrade option.

Please choose one of the following:

Express Install (use default settings) [1], Custom Install (recommended for advanced users) [2, Enter], Upgrade an existing JIRA installation [3]

3

Select the folder where you would like JIRA Software to be installed.

Where should JIRA Software be installed?

[/opt/atlassian/jira]

/app/jira

Default location for JIRA Software data

[/var/atlassian/application-data/jira]

/data/jira

Configure which ports JIRA Software will use.

.....

重点是选择选择Upgrade an existing JIRA installation [3]

Confluence升级如下（JIRA和Confluence相似）

选择后，根据提示进行操作，即可完成升级。 

完成后出现遇到问题记录:

1. jira 8.1默认不显示插件安装的页面Add-on page is not displaying

Resolution

Update UPM with a manual way:-

1.1 Download the latest UPM version (eg. 2.20.7) from https://marketplace.atlassian.com/plugins/com.atlassian.upm.atlassian-universal-plugin-manager-plugin/versions

Shut down the application.

1.2 Remove the existing UPM JAR file from this directory in your JIRA home directory: $JIRA_HOME/plugins/installed-plugins

The name of the JAR file may be prepended with a number, such as:

xxxxxx.atlassian-universal-plugin-manager-plugin-2.18.4.jar

1.3 Copy the new downloaded UPM JAR file into the same directory.

1.4 Restart JIRA application.

2、访问时安全提示：你可以临时访问管理功能。如果不再需要，请取消访问 。更多信息, 请查看文档。

[root@ecs-test application]# cat $JIRA_HOME/atlassian-jira/WEB-INF/classes/jira-application.properties

# Do not modify this file unless instructed. It is here to store the location of the JIRA home directory only and is typically written to by the installer.

jira.home = $JIRA_HOME/jira_home # jira数据目录

[root@ecs-test jira]# cd $JIRA_HOME/jira_home

[root@ecs-test jira_home]# touch jira-config.properties

[root@ecs-test jira_home]# vim jira-config.properties

jira.websudo.is.disabled = true

[root@ecs-test jira_home]# chown jira.jira jira-config.properties

破解JIRA,下载破解文件
下载地址： https://gitee.com/pengzhile/atlassian-agent/releases

vim ${INSTALL_PATH}/bin/setenv.sh

# 找到JAVA_OPTS变量 添加

-Dpassword.confirmation.disabled=true -javaagent:/xxx/xxxx/atlassian-agent-v1.2.2/atlassian-agent.jar

如图：

升级JIRA过程中出现如下界面：

java -jar atlassian-agent.jar -p jira -m [email protected] -n [email protected] -o https://zhile.io -s BSG-KDPW-IYES-14DCE

-p jira(指的是jira产品)，具体的可以根据-p进行参考

-m [email protected](随意写)

-n [email protected](随意写)

-o https://zhile.io (随意写)

-s BSG-KDPW-IYES-14DCE (即jira显示的服务器ID)

具体用法使用java -jar atlassian-agent.jar查看详细参数信息

推荐一些好用的JIRA插件:

工作流必须的插件

Agile Cards

Adaptavist ScriptRunner for JIRA

JSU Automation Suite for Jira Workflows

Jira Misc Custom Fields 可以自定义工作流字段

Git Integration for Jira GIT插件

Enhancer Plugin for JIRA

JIRA Toolkit Plugin

JIRA Watcher Field

工作日志和测试管理插件

Tempo Timesheets

synapseRT - Test management and QA in JIRA