一次jira版本升级实践

JIRA版本升级步骤（3.13—4.4.5）
摘要
近期项目由于持续集成需要升级Jira版本，从3.13升级到4.4.5
整个过程较痛苦，由于之前没有进行过相关工作，走了较多弯路过程记录如下
大致的思路是，通过jira自带的备份功能，先将数据进行备份，数据库备份，jira附件备份
安装新版本，然后倒入备份数据，设置附件目录即完成整个导入过程
安装环境：Win2000
旧jira版本：3.13
升级jira版本：4.4.5
数据库：mysql5.01
1.备份
运行数据备份使用jira自带的备份功能进行备份
①管理员登录jira
②管理-->import&export-->backup data to excel 导出当前数据到xml
③查看当前附件存放路径，如下图
④备份此路径中的文件内容（我是对此文件夹打压缩包拷贝到其他磁盘上）
2.安装破解
这里啰嗦一句，jira是商业收费软件，但是对开源项目免费，所以受到开源社区欢迎，并且一旦授权会提供源码，公司可以二次自定义开发，所以目前市场占有率较高，也较流行。

①装新版jira4.4.5 下载路径（官网，自己找吧，我当时官网打不开，在百度云盘上找到
的—本来想提供下载地址）
②破解
每个大版本的破解文件可通用，安装完jira后，停止服务，将文件系统破解文件
jira_crack.rar解压后的atlassian-jira文件夹覆盖到jira4.4.5安装目录
将atlassian-jira文件夹下的Version2LicenseDecoder.class放入
atlassian-jira\WEB-INF\lib\atlassian-extras-2.2.2.jar此jar包的对应目录中，至此破解完成
③汉化
将下载的文件atlassian-bundled-plugins.zip替换jira安装目录
atlassian-jira\WEB-INF\classes中的压缩文件
将language_zh_CN.jar文件放入atlassian-jira\WEB-INF\li b目录，并更名为
jira-lang-zh_CN-4.4.5.jar
（注意版本号要与安装的jira版本号一致）
还有一步安装中文插件放在最后
3.导入3.13版本数据
①更改附件目录
为了保证升级失败能够迅速回退，应保证版本关闭后，旧版本直接启动就可使用，所以除了安装的新版本在独立目录外，附件目录也需要新建，并进行更改，更改过程如下
将3.13版本备份的xml文件中附件路径（我的为D:\jira\data\attachmentt)全部替换为新的目录即可
注意：如果要使用mysql的话，需要新建数据库schema，已防止旧版本不可用（此处略）
②启动jira
首次启动时会要求选择数据库是hsql统还是其他数据库，这个要看jira旧版本的情况，这个依赖不大，mysql性能相对好一些，自带的hsql在项目不大时，也可以使用，升级时，支持从hsql到mysql，也支持从msql到hsql，我选择的是新旧版本一致，均为mysql，选择ip，用户名，密码既可以（需要一些时间初始化）
数据库初始化完成后，进入下一步，会要求输入注册码或者是可以导入既有数据，此步不导入数据，输入注册码
<破解文档中有的-->
注：CreationDate安装日期，需要手工修改，MaintenanceExpiryDat e支持到期日期，LicenseExpiryDate注册码有效期，此值修改为2099即可，ServerID页面上会进行展示，修改成页面展示的id即可
下一步输入管理员账号密码即完成安装的初始化
3.安装插件
需要查看旧版本安装了那些插件，已防止新版本导入后功能不可用，3.13版本的插件jar 包均放在安装目录的web-inf/lib目录下，我升级是判断的依据是jar包名中包含plugin并且修改日期与其他jar包不同。

找到插件jar包后，进入新版本jira中安装搜索插件安装即可（注，如果不知道插件的名字，可以用rar打开jar包，查看jar包根目录的xml文件，xml中包含插件信息）
4.导入数据
以上步骤准备好后，即可导入3.13版本的数据了，管理员登录jira，进入管理员面板导入数据
此时将xml备份文件拷贝到新版本jira的索引目录D:\Program Files
(x86)\Atlassian\Application Data\JIRA4\import中，进行导入即可
等待重建索引即可
5错误排除：
1.内存溢出
安装过程中，选择了安装为服务，此时默认的内存大小较小，方法如下
Identify the name of the service that JIRA is installed as in Windows ( Control Panel > Administrative Tools > Services ):
In the above example, the SERVICENAME is: JIRA120312230938
∙Open the command window from Start > Run > type in 'cmd' > press 'Enter'
∙cd to the bin subdirectory of your JIRA Installation Directory (or the bin subdirectory of your Tomcat installation directory if you're a
∙re running the JIRA WAR distribution).
For JIRA 5.1 or below:
Tomcat6w //ES //%servicename%
For JIRA 5.2 or above:
Tomcat7w //ES //%servicename%
In the above example, it would be tomcat6w //ES//JIRA120312230938
Click on the Java tab to see the list of current start-up options:
∙Set the maximum memory allocation here
∙Restart JIRA for changes to be picked up.
以上为官网提供的方法步骤，设置最大内存大小即可
2.流程不通
主要是有一些自定义插件不兼容导致，如本次升级后，问题流转时需要更新当前时
间%%current_datetime%%，此参数是jsu插件的功能，但是需要在jira5.2版本才支持，所以只有对jsu插件中的功能进行修改，增加此功能进行解决（也可以升级至5.2版本，但是测试中发现升级后项目信息丢失较多，一些自定义字段不能使用，所以放弃升级5.2）
3.升级后无法启动
此问题困扰了很久，查了很多资料，网上也没有相关问题，报错内容为porject component could not null
主要是报错内容为java错误，最后发现3.13版本导出的xml文件中，不知为何有一行porject component 只有id
无name，删除此行后，问题解决。