手动升级JIRA应用程序

手动升级JIRA应用程序

如果您从早于7.0的JIRA版本进行升级，则应该咨询迁移中心。JIRA 7.0的发行包含影响您的用户管理，应用程序访问和登录权限以及您的JIRA安装设置的功能，在升级之前了解需求和含义非常重要。迁移中心在一个便利的空间中拥有所有这些信息。

本页介绍如何升级不支持快速升级方法或回退方法的JIRA安装。 如果您符合以下任何标准，则应使用此方法升级JIRA：

• 您在Solaris上使用JIRA 4.0.0或更高版本。
• 在Windows或Linux上使用JIRA 4.0.0 - 4.2.x。

 

1. 开始之前

• 阅读有关新版本 -查看您要升级到的JIRA版本的发行说明和升级说明。如果您计划在升级过程中跳过几个JIRA版本，我们强烈建议您阅读当前版本和要升级到的版本之间的所有主要版本的升级指南。
• 检查许可 -确认您的许可证支持期限仍然有效。
• 检查已知问题-使用JIRA知识库搜索新版本中会影响到您的任何问题。
• 检查兼容性： 
   
  • 确认您的操作系统，数据库，其他适用的平台和硬件仍然符合JIRA 7.1的要求。 “支持终止声明”页面还包含有关JIRA未来版本的平台支持的重要信息。
  • 如果您已经安装了JIRA插件（即不包含在JIRA中），请确认它们将与要升级到的JIRA版本兼容。 您可以从Atlassian Marketplace的插件主页中找到插件的兼容性信息。
  • 某些防病毒或其他Internet安全工具可能会干扰JIRA升级过程，并阻止成功完成该过程。 如果您遇到或预期遇到与您的防病毒/ Internet安全工具有关的问题，请在继续进行JIRA升级之前禁用此工具。
• 预先测试并测试新版本的JIRA -我们强烈建议首先在测试环境中执行升级。 在您确定测试环境升级成功之前，请不要升级您的生产JIRA服务器。
  • 如果您的测试环境升级有任何问题无法解决，请在支持网站上创建问题，以便我们为您提供帮助。
  • 如果在生产JIRA服务器的升级过程中遇到任何问题，请不要让您的用户开始使用此服务器。 请进行以下操作：
     
    • 继续使用旧的JIRA服务器 - 这将有助于确保您不会丢失生产数据。
    • •也在我们的支持网站上创建一个问题，以便我们可以帮助您解决升级问题。

 

2. 备份

在开始JIRA升级之前，我们强烈建议您备份现有的JIRA安装。

2.1阻止用户更新JIRA数据

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

 Be aware! 不一致的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版本安装到新的位置。

 

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连接到PostgreSQL
• 将JIRA连接到MySQL
• 将JIRA连接到Oracle
• 将JIRA连接到SQL Server 2008

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

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

3.4将现有的JIRA配置迁移到新的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）。

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将启动其安装向导。 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文件安装到新的JIRA版本中，并执行其他所需的插件安装。
   2. 如果插件有一个属性文件，则应用与旧属性文件中相同的更改（不要仅复制旧的属性文件）。
6. 确认新服务器正常工作后，确保为新服务器标识更新生产许可证，如下所示：
    
   1. 登录到官网（联系哲想软件可登陆）。
   2. 找到适当的许可证。
   3. 按照新的生产服务器ID编辑服务器ID，并保存。
   4. 更新新服务器中的生产许可证。

恭喜！ 您已完成JIRA迁移/升级。