JIRA维护记——使用原实例位置恢复数据

一、出现问题

昨天下班了，同事反馈Jira又不能使用了。想都不用想，肯定是磁盘空间不足了，因为已经出现过几次了。之前都是清理一下磁盘空间即可，都不用重启Jira。

今天一上班就开始清理磁盘空间，把一些日志啊，temp目录中的文件啊之类的清理一下，已经有几百兆的空间了，刷新Jira还是不能正常使用，检索不出数据，于是尝试重启。

Jira应用程序实例一般是安装在/opt/atlassian/jira下，数据保存在/var/atlassian/application-data/jira下，如果Jira还可以正常运行，具体信息可以在系统下的系统信息中查看：

JIRA的控制脚本在/opt/atlassian/jira/bin下面，启动与关闭有好几个脚本，最直观的就是：start-jira.sh、startup.sh、stop-jira.sh、shutdown.sh。关于这几个脚本，官方有解释：Understand startup and shutdown scripts in Jira server。

脚本	说明
start-jira.sh	使用user.sh中定义的用户启动Jira
stop-jira.sh	使用user.sh中定义的用户关闭Jira
—	—
startup.sh	使用catalina.sh start中启动Jira
shutdown.sh	使用当前用户关闭Jira

如果没有安装过服务，即不能使用service jira start和service jira stop来开关，正确的开关脚本应该是根据/var/atlassian/application-data/jira的用户和组来决定。

由于很久没维护过Jira了，忘记应该使用哪一组来关闭和启动了。就在这四个脚本中随便使用了一组脚本来关闭和启动，发现要么关闭不了，要么启动不了；要么进程还在，要么记录进程PID的/opt/atlassian/jira/work/catalina.pid文件还在；要么是启动了，因为目录不能访问，不能正常使用，反正是有问题。后面又遇到使用了两个关闭脚本都关闭不了了，就直接Kill掉进程。后面想起来，是安装过服务的，可以使用service jira start和service jira stop来开关，这才是正确的开关方式。

在使用重启大法的过程中，Jira却莫名其妙地进入到了初始化界面（注意，初始化需要许可证），要求选数据库，事感不对，赶紧备份数据，包含数据库和数据目录/var/atlassian/application-data/jira。停服，备份好后，继续操作，莫名其妙完全进入新的实例了，之前的所有东西都不见了。看了一下/var/atlassian/application-data/jira/dbconfig.xml目录下的配置，发现使用的是本地文件，不是Mysql。

<?xml version="1.0" encoding="UTF-8"?>

<jira-database-config>
  <name>defaultDS</name>
  <delegator-name>default</delegator-name>
  <database-type>h2</database-type>
  <schema-name>PUBLIC</schema-name>
  <jdbc-datasource>
    <url>jdbc:h2:file:/var/atlassian/application-data/jira/database/h2db</url>
    <driver-class>org.h2.Driver</driver-class>
    <username>sa</username>
    <password></password>
    <pool-min-size>20</pool-min-size>
    <pool-max-size>20</pool-max-size>
    <pool-max-wait>30000</pool-max-wait>
    <min-evictable-idle-time-millis>4000</min-evictable-idle-time-millis>
    <time-between-eviction-runs-millis>5000</time-between-eviction-runs-millis>
    <pool-max-idle>20</pool-max-idle>
    <pool-remove-abandoned>true</pool-remove-abandoned>
    <pool-remove-abandoned-timeout>300</pool-remove-abandoned-timeout>
  </jdbc-datasource>
</jira-database-config>

二、解决问题

1、修改数据库连接

为了不影响正式数据，在本机虚拟机中尝试安装新Jira，并连接到数据库，得到一个新的Mysql的数据库配置dbconfig.xml（读者可以不必再新装Jira了，可以直接复制下面的配置进行修改）：

<?xml version="1.0" encoding="UTF-8"?>

<jira-database-config>
  <name>defaultDS</name>
  <delegator-name>default</delegator-name>
  <database-type>mysql</database-type>
  <jdbc-datasource>
    <url>jdbc:mysql://address=(protocol=tcp)(host=127.0.0.1)(port=3306)/jira?useUnicode=true&amp;characterEncoding=UTF8&amp;sessionVariables=default_storage_engine=InnoDB</url>
    <driver-class>com.mysql.jdbc.Driver</driver-class>
    <username>jira</username>
    <password>jira</password>
    <pool-min-size>20</pool-min-size>
    <pool-max-size>20</pool-max-size>
    <pool-max-wait>30000</pool-max-wait>
    <validation-query>select 1</validation-query>
    <min-evictable-idle-time-millis>60000</min-evictable-idle-time-millis>
    <time-between-eviction-runs-millis>300000</time-between-eviction-runs-millis>
    <pool-max-idle>20</pool-max-idle>
    <pool-remove-abandoned>true</pool-remove-abandoned>
    <pool-remove-abandoned-timeout>300</pool-remove-abandoned-timeout>
    <pool-test-on-borrow>false</pool-test-on-borrow>
    <pool-test-while-idle>true</pool-test-while-idle>
    <validation-query-timeout>3</validation-query-timeout>
  </jdbc-datasource>
</jira-database-config>

将上面的配置中连接的数据库名、IP、端口、账号、密码修改为自己所需要的，把它保存到/var/atlassian/application-data/jira/dbconfig.xml，使用service jira start启动Jira。由于前面已经初始化过了，可以进入系统，所以这里没有再进入初始化。

2、恢复系统

使用了之前的数据库连接后， 就可以使用之前的账号密码登录Jira了。然后在管理页面的系统中使用恢复系统功能：

从页面中可以看到，需要把要恢复的文件存放在/var/atlassian/application-data/jira/import目录下：

由于Jira实例还是原来的位置，所以原来的数据都还在，特别是目录/var/atlassian/application-data/jira/data保存了所有附件及头像，目录/var/atlassian/application-data/jira/export下保存了Jira自动备份的文件，找到最新的文件，复制到/var/atlassian/application-data/jira/import目录下，然后在上图文件名中填写正确的文件名，比如2023-Jun-6--2000.zip，表示是2023年6月6号20点备份的。然后复原，等待完成，重新登录即可。

又可以愉快的使用Jira了。

Btw：由于Jira会自动备份，在/var/atlassian/application-data/jira/export目录下可能会有比较多的备份文件，可以定期进行清理，以减少磁盘占用空间。