如何将JIRA应用程序迁移到另一台服务器

如何将JIRA应用程序迁移到另一台服务器

本文档介绍了如何在不同的服务器硬件上迁移/升级到JIRA应用程序，或者在不同的服务器环境中执行以下一项或多项操作：

• 将运行JIRA应用程序的新操作系统，
• 用于存储索引和/或附件的新位置，或
• 将存储JIRA应用程序数据的新数据库或数据库系统。

如果在迁移过程中升级到较新版本的JIRA应用程序，请参阅升级JIRA应用程序以获取有关升级前需要完成的必备任务的信息。

如果您将操作系统从Windows更改为Linux或反之，请记住您需要在文件路径（'/'到'\'或'\'到'/'）中反转“斜线”“）。

1. 在开始之前

• 检查许可-确认您的许可证支持期限仍然有效。
• 检查已知问题 -使用JIRA知识库搜索新版本中会影响到您的任何问题。
• 检查兼容性：
   
  • 确认您的操作系统，数据库，其他适用的平台和硬件仍然符合JIRA应用程序的要求。
  • 确保源实例和目标实例最初设置为具有相同的时区，以避免出现日期和时间字段的问题。
  • 如果您已经安装了JIRA应用程序附件（即JIRA应用程序未附带），请验证它们是否兼容。 您可以从Atlassian Marketplace上的加载项主页上找到加载项的兼容性信息。您也可以按照此处所述的步骤进行操作：检查应用程序更新的附加兼容性，以使Universal Add-on Manager能够帮助您。

我们强烈建议首先在测试环境中执行迁移。 不要迁移生产JIRA服务器应用程序，直到您确信测试环境升级已经成功。

• 如果您的测试环境存在任何您无法解决的问题，请在我们的支持站点上创建问题，以便我们为您提供帮助。
• 如果您在生产JIRA服务器应用程序的迁移过程中遇到任何问题，请不要让您的用户开始使用此服务器。 代替：
   
  • 继续使用旧的JIRA服务器应用程序 - 这将有助于确保您不会丢失生产数据。
  • 同时在我们的支持网站上创建一个问题，以便我们帮助您解决迁移问题。

某些防病毒或其他Internet安全工具可能会干扰迁移，并阻止该进程成功完成。 如果您遇到或预期遇到防病毒/ Internet安全工具遇到此类问题，请在继续进行JIRA应用程序迁移之前先禁用此工具。

2. 备份

2.1阻止用户更新JIRA数据

在升级过程中，您将从现有的JIRA安装（通过XML备份）导出JIRA的数据库，然后将此备份恢复为新的JIRA安装。为了确保XML备份中的数据与系统中的最新数据一致，您必须暂时限制对JIRA的访问，以便用户无法更新数据。 有关更多信息，请参阅防止用户在备份页面访问JIRA应用程序。

 小心! 不一致的XML备份无法恢复！

2.2 备份你的数据库

对现有的JIRA安装的外部数据库执行XML备份。 对于大型JIRA安装，此过程可能需要几个小时才能完成。

“嵌入式数据库”是JIRA提供的H2数据库，仅供评估之用。 如果意外在生产系统中使用H2数据库，请对此数据库执行XML备份，并继续执行此过程。

2.3备份你的JIRA主目录

1.  关闭JIRA.

2. 找到JIRA主目录。 您可以通过导航到JIRA应用程序安装目录中的 /WEB-INF/classes/jira-application.properties文件来找到有关目录位置的信息。或者，您可以打开JIRA配置工具来查看设置为您的JIRA主页的目录。
3. 导航到配置文件中指定的目录，并在另一个目录中创建它的备份。
4.  一旦备份完成，请从原始文件夹中删除文件 /dbconfig.xml。

2.4如果位于JIRA主目录之外，请备份附件和索引目录

如果附件和索引目录位于JIRA主目录之外，则必须单独备份它们。 这些页面描述了如何找出这些目录在你的实现中的位置：

• 您的附件目录 - 请参阅您的JIRA版本文档中的“配置文件附件”页面。
• •索引目录 - 请参阅您的JIRA版本的文档中的搜索索引页面。

有关在JIRA中备份附件的更多信息，另请参阅备份数据。

2.5备份你的JIRA安装目录

“JIRA安装目录”是安装JIRA时JIRA应用程序文件和库被提取到的目录。

3. 设置新的JIRA应用程序安装

如果您正在运行“关键任务”JIRA服务器应用程序，我们强烈建议您在测试环境中执行本指南的其余步骤（例如，使用单独的测试JIRA应用程序数据库和JIRA应用程序主目录副本） 升级为生产使用。

3.1安装新版本的JIRA应用程序

首先，您必须从新安装JIRA应用程序开始，不管是当前版本还是新版本。 如果在此过程中升级JIRA应用程序，请参阅升级JIRA应用程序以获取有关升级前需要完成的必备任务的信息。

将您需要的JIRA应用程序分发下载并提取到新目录。不要覆盖您现有的JIRA应用程序安装。 确保已经关闭，并将新的JIRA应用程序版本安装到新的位置。

3.2将您的新JIRA应用程序指向您的现有JIRA应用程序主目录（的副本）

如果您的新JIRA 7.1安装位于新服务器上，请在继续之前将现有JIRA主目录的备份从旧服务器复制到新服务器。

设置分配：

1. 打开JIRA配置工具.
2. 单击JIRA主页选项卡。
3. 更新JIRA主目录字段：
    
   • 如果您的JIRA 7.1安装位于新服务器上，请将JIRA主目录字段更新为复制的JIRA主目录的路径。
   • 如果您的JIRA 7.1安装位于同一台服务器上，请将JIRA主目录字段更新为现有JIRA主目录的路径。

 您还可以通过定义操作系统环境变量JIRA_HOME来设置JIRA主目录的位置。 此变量的此值优先于JIRA安装目录中jira-application.properties文件中jira.home属性的值。

3.3将新版本的JIRA应用程序连接到一个新的空数据库

创建一个新的，空的数据库，新的JIRA安装将用来存储其数据。

按照第2阶段的数据库相关的“连接JIRA到...”的说明进行操作，虽然从第4阶段开始，请注意下面的黄色注意事项：

如果在现有的JIRA安装中使用数据库（例如，称为jiradb），并且新的JIRA安装的数据库运行在同一台机器或数据库服务器上，则可以使用不同的名称创建新的数据库（例如直观类似jiradb_440 为JIRA 4.4.0）。但是，确保新的数据库具有与旧的JIRA数据库相同的访问权限。 如果您需要帮助，请咨询您的数据库管理员。

 如果您正在使用嵌入式H2数据库，则不需要创建新的数据库。

3.4将现有的JIRA应用程序配置迁移到新安装

如果您已经修改了现有JIRA安装的配置文件中的属性，请在新的JIRA安装中进行相同的修改。但是，因为配置文件中的属性可能在版本之间发生了变化，所以不能简单地从现有安装中复制配置文件，并替换新安装中的等效文件。

对于您在现有JIRA安装中修改的每个文件，您需要在新的JIRA安装中手动编辑每个等效文件并重新应用修改。如果您的新JIRA安装中没有文件（例如最近的JIRA版本中的osuser.xml），那么只需将该文件复制到新的JIRA安装中即可。

 特定于版本的升级说明包含有关在这些通常修改的文件中可能已更改的属性的详细信息。

除上述文件外，还应考虑和/或执行以下配置作为升级过程的一部分：

• 使用JIRA与Atlassian的人群 - 如果您正在与JIRA一起使用Crowd，请按照将Crowd与JIRA集成中所述，将您的新JIRA配置为与Crowd交谈。
• 记得配置Crowd以授予JIRA新的主机名/ IP访问权限。
• 为JIRA分配额外的内存 - 如果您之前已经为JIRA分配额外的内存，请为新的JIRA实例执行相同的操作。
• 插件 - 对于您在旧JIRA中安装的任何插件，请联系哲想软件下载新版JIRA的插件版本。
• 字符编码 - 确保新旧位置上的字符编码（即区域设置）相同。 如果附件在两个不兼容的编码系统之间移动，则新版本的JIRA可能无法正常工作。
• 自定义 —如果您进行了任何自定义（代码，模板或配置文件），请将这些更改的兼容版本复制到新的JIRA。 （组织中开发人员需要为旧版本进行自定义，需要构建和测试新版本的等同更改，并为您提供要复制到已升级JIRA安装的文件。）
• (可选）在另一个端口上运行JIRA—如果你的新JIRA与旧的JIRA安装在同一台机器上，你可能希望确保它运行在不同的端口上（如果你需要重新启动旧的JIRA）。

3.5开始你的新的JIRA应用程序版本

1. 确认您的旧JIRA安装已关闭 - 如果此JIRA服务器仍在运行，请将其关闭。
2. 按照启动JIRA说明启动新版本的JIRA。

不要重新启动旧的JIRA安装

如果新的JIRA 7.1安装与旧的JIRA 7.1安装在同一台服务器上，那么它可能仍然被配置为使用与新的JIRA安装相同的JIRA主目录。 运行两个共享JIRA主目录的独立JIRA安装可能会导致严重的数据损坏。

不过，我们建议您不要删除旧JIRA安装的任何方面（或备份组件），除非您确信已升级的JIRA安装正常运行。

3.6将旧数据导入新的JIRA应用程序

在开始新的JIRA安装之后，JIRA将启动其安装向导。 JIRA在空数据库开始时会发生这种情况。 从这里，您可以导入备份文件，并使用XML备份数据填充数据库。 您需要备份您在备份步骤中创建的以前版本的JIRA。 

将旧的JIRA数据导入到新的JIRA中：

1. 将先前备份的附件目录还原到新JIRA的附件目录中。 
2. 启动JIRA。
3. 在设置向导中，选择导入现有数据。
4. 在“文件名”字段中，指定您在导出过程（上文）中先前创建的XML备份文件。 压缩文件应该包含两个xml文件：activeobjects.xml和entities.xml。 这两个文件都必须包含在压缩文件中才能使导入过程正常工作。
    执行XML还原时避免通过代理，特别是如果您的JIRA实例非常大。 使用代理可能会导致超时错误。
5. 再次通过您的Web浏览器访问JIRA，并使用您之前的JIRA安装中的用户名登录。
6. 快速浏览您的JIRA网站，确认您的项目和问题是否存在，一切看起来都正常。 您应该在页脚中看到新的JIRA版本号。

4. 迁移后检查和任务

强烈建议您在启动新的JIRA应用程序实例后执行以下检查和任务： 

1. 检查您的服务器日志是否出现错误消息，即使JIRA应用程序似乎运行正常。 如果在那里有任何你不能解决的错误，创建一个支持案例，附上你的日志文件，我们会建议你的错误。
2. 如果您以前使用外部用户管理，请在新的JIRA应用程序实例中启用它。
3. 如果在升级时更改机器，请将路径从应用程序的“JIRA管理”部分更改为索引，附件和备份目录。
4. 启用电子邮件，如果您在测试期间禁用它。
5. 如果您将自定义设置从新旧JIRA应用程序迁移到新JIRA应用程序，请确保已完全测试它们。
    
   1. 如果您已经下载了新的JIRA应用程序版本的插件，请将安装下载的JAR文件安装到您的新版本中，并执行其他所需的插件安装。
   2. 如果插件有一个属性文件，则应用与旧属性文件中相同的更改（不要仅复制旧的属性文件）。

恭喜！ 您已完成您的JIRA应用程序迁移/升级。