在你开始之前

第 1 步：准备升级

确保您已完成中的步骤 准备升级. 这些是强制性的先决条件，对于顺利升级至关重要。

第 2 步：选择您的版本

如果您需要帮助选择适合您的版本，请前往 升级矩阵 快速了解所有 Jira 版本的功能、支持的平台和技术升级说明。

第 3 步：停止集群

如果您是，请省略此步骤 以零停机时间升级您的数据中心.

在集群中的所有节点上停止 Jira。我们还建议您将负载均衡器配置为将流量从 Jira 重定向，直到在所有节点上完成升级。

在第一个节点上升级 Jira

为避免单独升级每个节点，您只需升级其中一个，并将其 设为模板。然后，您将此模板复制到其余节点。您可以在此处选择任何节点。

步骤 1. 下载 Jira

• 从我们的网站下载 Jira 应用程序之一。选择 tar.gz 或 zip 存档。

• • 吉拉软件
  • Jira 服务管理 （仅限 tar.gz 存档）

如果您要同时升级 Jira Software 和 Jira Service Management，请仅升级 Jira Software。您稍后将直接在 Jira 中升级 Jira Service Management，无需单独的安装程序。

步骤 2. 提取文件

解压缩您下载的存档，然后开始升级。

• 将文件解压缩（解压缩）到一个目录（这是您的新安装目录，必须与您现有的安装目录不同）。 
• 将 Jira 指向您 现有的 Jira 主目录。

• 我们建议您通过设置JIRA_HOME环境变量来完成。有关如何执行此操作的更多信息，请参阅设置 Jira 主目录.

步骤 3. 安装数据库驱动程序

如果您使用的是 Oracle 或 MySQL 数据库，请下载新的 JDBC 驱动程序。对于其他数据库，可以省略此步骤。

如果驱动程序是最新的，您也可以从以前的版本复制它。

• 下载以下驱动程序之一：
  • Oracle： JDBC 驱动程序 19.3 ( ojdbc8 )
  • MySQL： MySQL 连接器/J 5.1 驱动程序。
• 把它放在 /lib.

第 4 步：重新应用任何自定义更改并增加 pool-max-size

在使用 Jira 时，您可能已经对 Jira 文件添加了一些自定义修改。这些可能包括连接详细信息、与内存分配相关的设置或其他 JVM 参数。通常，这些是包含自定义更改的文件： 

• server.xml
• dbconfig.xml
• jira-config.properties
• web.xml
• for more, see Important files in Jira.

• 通过从备份中复制您的自定义更改，将它们重新应用于您各自的新 Jira 文件。

• 确保您不只是复制旧文件，因为它们包含的“本机”设置可能在 Jira 版本之间发生了变化。

• 我们将对 Jira 启动进行另一次检查，并向您显示您可能已跳过但仍包含尚未复制的更改的所有文件。然后您将能够单击以自动复制更改。

• 请注意，检查只会在以下配置文件上运行：

- / atlassian-jira/目录
-  /conf/server.xml
-  /bin/setenv.sh

• 并且仅 ATST 插件 1.20.0 及更高版本支持自动传输。

• 要自动传输更改，修改文件的安装程序副本需要与您要升级到的版本相同。

•  由于 包含“*”的 catalina.sh 中的 JAVA_OPTS 扩展停止在 linux 上启动 错误，Tomcat 从8.5.48版开始使用双引号 。这就是为什么当您在 setenv.sh 或 setenv.bat 中升级和设置参数时，请确保：

• • 不要删除 catalina.sh 中的双引号
  • 在一行中设置所有参数，在 setenv.sh 或 setenv.bat 中没有任何新行

否则，您可能会在启动 Jira 时遇到问题。 

池最大大小

如果您要从 Jira 7.x 升级到 Jira 8.x，我们建议在升级前将 dbconfig.xml 中的 pool-max-size 参数更改为 40。在 8.x 上重新索引期间，保留默认值 20 有时会导致“ResultSet Closed”错误。有关实施更改的信息，请参阅 调整数据库连接。

 

步骤 5. 禁用自动重新索引

从 Jira 7.x 升级到 Jira 8.x 时，建议执行此步骤。如果您已经在 8.x 线上，则可以省略此步骤。

由于我们在 Jira 8.0 中引入的索引更改，升级后任何早期 Jira 版本的索引都将不兼容。要创建新索引，Jira 会在您启动它后立即触发自动重新索引。为避免重新索引两次（启动后和升级应用程序之后），您可以禁用自动重新索引，并在准备好后运行第二次。

• 编辑或创建以下文件：

• /jira-config.properties

• 添加以下行，并保存文件：
• upgrade.reindex.allowed=false

 

第一个节点上的升级后步骤

仅在第一个节点 （您刚刚升级的节点）上完成这些升级后步骤 。其余节点稍后将从共享目录下载升级的应用程序和索引。

步骤 1. 首次启动 Jira

启动新的 Jira 版本，并将其连接到数据库。

• （安装程序）返回升级向导并启动 Jira。
  
  （安装程序和手册）您还可以通过转到/bin并运行以下文件之一来启动 Jira  ：
  • 视窗：  start-jira.bat
  • Linux：  start-jira.sh 
• 在浏览器中打开 Jira。
• 按照屏幕上的说明完成设置。 
• 如果您遗漏了任何尚未复制的自定义更改文件，您现在可以自动复制这些更改。 

• 请注意，文件更改检查仅在以下配置文件上运行：

- atlassian-jira/ 目录

- conf/server.xml
- bin/setenv.sh

• 并且仅ATST插件1.20.0及更高版本支持自动传输。

• 要自动传输更改，修改文件的安装程序副本需要与您要升级到的版本相同。

• 复制更改后，系统会提示您重新启动 Jira。

升级后登陆页面

升级成功后，您应该会看到升级后登录页面。它有一些关于新版本的有用信息，如下所示。

 

• 需要知道： 可能会影响您作为管理员的工作的新功能列表。
• 用户应用程序：升级后应用程序的 状态。
• 申请链接： 您的申请链接的状态。
• 发行说明： 链接到发行说明，您可以在其中查看有关升级到的版本的更多详细信息。

步骤 2.（可选）更新 Jira 服务管理

如果您使用的是 Jira Service Management，则可以直接在 UI 中对其进行更新，而无需下载单独的安装程序。

• 转到 管理 > 应用程序 > 版本和许可证。
• 更新 Jira 服务管理。这会自动将 Jira Service Management 更新为兼容版本。

步骤 3. 升级应用程序（附加组件）

现在，您可以升级具有Compatible 的应用程序， 一旦两者都更新 状态。如果您需要有关状态和应用程序的更多信息，请参阅 准备升级.

• 转到 管理 > 管理应用程序 > 管理应用程序。
• 将您的应用升级到受支持的版本。
• 应用升级后，您可以启用它们。

升级 DC 集群中的应用

升级应用程序时，每个节点都会在重新启动时从共享主目录中提取最近修改的应用程序 jar 文件。

为了确定文件版本，Jira 使用 atlassian-plugin.xml 中的 值。如果有多个 值，Jira 使用 java.lang.String#compareTo 来比较不同的值。

 

步骤 4. 重建索引

重新索引 Jira 以重新创建索引。此步骤可能需要一些时间，具体取决于您有多少问题和应用程序。

• 转到 管理 > 索引，然后运行 Lock Jira 并重建 reindex。

步骤 5. 将升级后的 Jira 复制为模板

在此步骤中，您将复制新的安装目录以及您迄今为止所做的所有修改。这将为您提供一个模板，您稍后会将其复制到其他节点。

• 将新安装目录复制  到其他位置。这将是您的模板。

 

升级剩余节点

到目前为止，您应该拥有准备好的 Jira 模板，以及共享目录中可用的升级附加组件和索引数据。在这一步中，您将模板复制到其他节点并一一启动它们。

• 将模板安装目录复制  到新节点。
• 如果此节点上本地主目录的路径不同，请在setenv.bat / setenv.sh 文件中更新它 。
• 在此节点上启动 Jira。
• 冲洗并重复： 在下一个节点上重复这些步骤。

加入集群

您可以通过转到管理 > System > System info，然后向下滚动到Cluster nodes部分。

做得好！

您已将 Jira 升级到新版本。