在你開(kāi)始之前

第 1 步：準(zhǔn)備升級(jí)

確保您已完成中的步驟 準(zhǔn)備升級(jí). 這些是強(qiáng)制性的先決條件，對(duì)于順利升級(jí)至關(guān)重要。

第 2 步：選擇您的版本

如果您需要幫助選擇適合您的版本，請(qǐng)前往 升級(jí)矩陣 快速了解所有 Jira 版本的功能、支持的平臺(tái)和技術(shù)升級(jí)說(shuō)明。

第 3 步：停止集群

如果您是，請(qǐng)省略此步驟 以零停機(jī)時(shí)間升級(jí)您的數(shù)據(jù)中心.

在集群中的所有節(jié)點(diǎn)上停止 Jira。我們還建議您將負(fù)載均衡器配置為將流量從 Jira 重定向，直到在所有節(jié)點(diǎn)上完成升級(jí)。

在第一個(gè)節(jié)點(diǎn)上升級(jí) Jira

為避免單獨(dú)升級(jí)每個(gè)節(jié)點(diǎn)，您只需升級(jí)其中一個(gè)，并將其 設(shè)為模板。然后，您將此模板復(fù)制到其余節(jié)點(diǎn)。您可以在此處選擇任何節(jié)點(diǎn)。

步驟 1. 下載 Jira

• 從我們的網(wǎng)站下載 Jira 應(yīng)用程序之一。選擇 tar.gz 或 zip 存檔。

• • 吉拉軟件
  • Jira 服務(wù)管理 （僅限 tar.gz 存檔）

如果您要同時(shí)升級(jí) Jira Software 和 Jira Service Management，請(qǐng)僅升級(jí) Jira Software。您稍后將直接在 Jira 中升級(jí) Jira Service Management，無(wú)需單獨(dú)的安裝程序。

步驟 2. 提取文件

解壓縮您下載的存檔，然后開(kāi)始升級(jí)。

• 將文件解壓縮（解壓縮）到一個(gè)目錄（這是您的新安裝目錄，必須與您現(xiàn)有的安裝目錄不同）。 
• 將 Jira 指向您 現(xiàn)有的 Jira 主目錄。

• 我們建議您通過(guò)設(shè)置JIRA_HOME環(huán)境變量來(lái)完成。有關(guān)如何執(zhí)行此操作的更多信息，請(qǐng)參閱設(shè)置 Jira 主目錄.

步驟 3. 安裝數(shù)據(jù)庫(kù)驅(qū)動(dòng)程序

如果您使用的是 Oracle 或 MySQL 數(shù)據(jù)庫(kù)，請(qǐng)下載新的 JDBC 驅(qū)動(dòng)程序。對(duì)于其他數(shù)據(jù)庫(kù)，可以省略此步驟。

如果驅(qū)動(dòng)程序是最新的，您也可以從以前的版本復(fù)制它。

• 下載以下驅(qū)動(dòng)程序之一：
  • Oracle： JDBC 驅(qū)動(dòng)程序 19.3 ( ojdbc8 )
  • MySQL： MySQL 連接器/J 5.1 驅(qū)動(dòng)程序。
• 把它放在 /lib.

第 4 步：重新應(yīng)用任何自定義更改并增加 pool-max-size

在使用 Jira 時(shí)，您可能已經(jīng)對(duì) Jira 文件添加了一些自定義修改。這些可能包括連接詳細(xì)信息、與內(nèi)存分配相關(guān)的設(shè)置或其他 JVM 參數(shù)。通常，這些是包含自定義更改的文件： 

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

• 通過(guò)從備份中復(fù)制您的自定義更改，將它們重新應(yīng)用于您各自的新 Jira 文件。

• 確保您不只是復(fù)制舊文件，因?yàn)樗鼈儼?ldquo;本機(jī)”設(shè)置可能在 Jira 版本之間發(fā)生了變化。

• 我們將對(duì) Jira 啟動(dòng)進(jìn)行另一次檢查，并向您顯示您可能已跳過(guò)但仍包含尚未復(fù)制的更改的所有文件。然后您將能夠單擊以自動(dòng)復(fù)制更改。

• 請(qǐng)注意，檢查只會(huì)在以下配置文件上運(yùn)行：

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

• 并且僅 ATST 插件 1.20.0 及更高版本支持自動(dòng)傳輸。

• 要自動(dòng)傳輸更改，修改文件的安裝程序副本需要與您要升級(jí)到的版本相同。

•  由于 包含“*”的 catalina.sh 中的 JAVA_OPTS 擴(kuò)展停止在 linux 上啟動(dòng) 錯(cuò)誤，Tomcat 從8.5.48版開(kāi)始使用雙引號(hào) 。這就是為什么當(dāng)您在 setenv.sh 或 setenv.bat 中升級(jí)和設(shè)置參數(shù)時(shí)，請(qǐng)確保：

• • 不要?jiǎng)h除 catalina.sh 中的雙引號(hào)
  • 在一行中設(shè)置所有參數(shù)，在 setenv.sh 或 setenv.bat 中沒(méi)有任何新行

否則，您可能會(huì)在啟動(dòng) Jira 時(shí)遇到問(wèn)題。 

池最大大小

如果您要從 Jira 7.x 升級(jí)到 Jira 8.x，我們建議在升級(jí)前將 dbconfig.xml 中的 pool-max-size 參數(shù)更改為 40。在 8.x 上重新索引期間，保留默認(rèn)值 20 有時(shí)會(huì)導(dǎo)致“ResultSet Closed”錯(cuò)誤。有關(guān)實(shí)施更改的信息，請(qǐng)參閱 調(diào)整數(shù)據(jù)庫(kù)連接。

 

步驟 5. 禁用自動(dòng)重新索引

從 Jira 7.x 升級(jí)到 Jira 8.x 時(shí)，建議執(zhí)行此步驟。如果您已經(jīng)在 8.x 線(xiàn)上，則可以省略此步驟。

由于我們?cè)?Jira 8.0 中引入的索引更改，升級(jí)后任何早期 Jira 版本的索引都將不兼容。要?jiǎng)?chuàng)建新索引，Jira 會(huì)在您啟動(dòng)它后立即觸發(fā)自動(dòng)重新索引。為避免重新索引兩次（啟動(dòng)后和升級(jí)應(yīng)用程序之后），您可以禁用自動(dòng)重新索引，并在準(zhǔn)備好后運(yùn)行第二次。

• 編輯或創(chuàng)建以下文件：

• /jira-config.properties

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

 

第一個(gè)節(jié)點(diǎn)上的升級(jí)后步驟

僅在第一個(gè)節(jié)點(diǎn) （您剛剛升級(jí)的節(jié)點(diǎn)）上完成這些升級(jí)后步驟 。其余節(jié)點(diǎn)稍后將從共享目錄下載升級(jí)的應(yīng)用程序和索引。

步驟 1. 首次啟動(dòng) Jira

啟動(dòng)新的 Jira 版本，并將其連接到數(shù)據(jù)庫(kù)。

• （安裝程序）返回升級(jí)向?qū)Р?dòng) Jira。
  
  （安裝程序和手冊(cè)）您還可以通過(guò)轉(zhuǎn)到/bin并運(yùn)行以下文件之一來(lái)啟動(dòng) Jira  ：
  • 視窗：  start-jira.bat
  • Linux：  start-jira.sh 
• 在瀏覽器中打開(kāi) Jira。
• 按照屏幕上的說(shuō)明完成設(shè)置。 
• 如果您遺漏了任何尚未復(fù)制的自定義更改文件，您現(xiàn)在可以自動(dòng)復(fù)制這些更改。 

• 請(qǐng)注意，文件更改檢查僅在以下配置文件上運(yùn)行：

- atlassian-jira/ 目錄

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

• 并且僅ATST插件1.20.0及更高版本支持自動(dòng)傳輸。

• 要自動(dòng)傳輸更改，修改文件的安裝程序副本需要與您要升級(jí)到的版本相同。

• 復(fù)制更改后，系統(tǒng)會(huì)提示您重新啟動(dòng) Jira。

升級(jí)后登陸頁(yè)面

升級(jí)成功后，您應(yīng)該會(huì)看到升級(jí)后登錄頁(yè)面。它有一些關(guān)于新版本的有用信息，如下所示。

 

• 需要知道： 可能會(huì)影響您作為管理員的工作的新功能列表。
• 用戶(hù)應(yīng)用程序：升級(jí)后應(yīng)用程序的 狀態(tài)。
• 申請(qǐng)鏈接： 您的申請(qǐng)鏈接的狀態(tài)。
• 發(fā)行說(shuō)明： 鏈接到發(fā)行說(shuō)明，您可以在其中查看有關(guān)升級(jí)到的版本的更多詳細(xì)信息。

步驟 2.（可選）更新 Jira 服務(wù)管理

如果您使用的是 Jira Service Management，則可以直接在 UI 中對(duì)其進(jìn)行更新，而無(wú)需下載單獨(dú)的安裝程序。

• 轉(zhuǎn)到 管理 > 應(yīng)用程序 > 版本和許可證。
• 更新 Jira 服務(wù)管理。這會(huì)自動(dòng)將 Jira Service Management 更新為兼容版本。

步驟 3. 升級(jí)應(yīng)用程序（附加組件）

現(xiàn)在，您可以升級(jí)具有Compatible 的應(yīng)用程序， 一旦兩者都更新 狀態(tài)。如果您需要有關(guān)狀態(tài)和應(yīng)用程序的更多信息，請(qǐng)參閱 準(zhǔn)備升級(jí).

• 轉(zhuǎn)到 管理 > 管理應(yīng)用程序 > 管理應(yīng)用程序。
• 將您的應(yīng)用升級(jí)到受支持的版本。
• 應(yīng)用升級(jí)后，您可以啟用它們。

升級(jí) DC 集群中的應(yīng)用

升級(jí)應(yīng)用程序時(shí)，每個(gè)節(jié)點(diǎn)都會(huì)在重新啟動(dòng)時(shí)從共享主目錄中提取最近修改的應(yīng)用程序 jar 文件。

為了確定文件版本，Jira 使用 atlassian-plugin.xml 中的 值。如果有多個(gè) 值，Jira 使用 java.lang.String#compareTo 來(lái)比較不同的值。

 

步驟 4. 重建索引

重新索引 Jira 以重新創(chuàng)建索引。此步驟可能需要一些時(shí)間，具體取決于您有多少問(wèn)題和應(yīng)用程序。

• 轉(zhuǎn)到 管理 > 索引，然后運(yùn)行 Lock Jira 并重建 reindex。

步驟 5. 將升級(jí)后的 Jira 復(fù)制為模板

在此步驟中，您將復(fù)制新的安裝目錄以及您迄今為止所做的所有修改。這將為您提供一個(gè)模板，您稍后會(huì)將其復(fù)制到其他節(jié)點(diǎn)。

• 將新安裝目錄復(fù)制  到其他位置。這將是您的模板。

 

升級(jí)剩余節(jié)點(diǎn)

到目前為止，您應(yīng)該擁有準(zhǔn)備好的 Jira 模板，以及共享目錄中可用的升級(jí)附加組件和索引數(shù)據(jù)。在這一步中，您將模板復(fù)制到其他節(jié)點(diǎn)并一一啟動(dòng)它們。

• 將模板安裝目錄復(fù)制  到新節(jié)點(diǎn)。
• 如果此節(jié)點(diǎn)上本地主目錄的路徑不同，請(qǐng)?jiān)趕etenv.bat / setenv.sh 文件中更新它 。
• 在此節(jié)點(diǎn)上啟動(dòng) Jira。
• 沖洗并重復(fù)： 在下一個(gè)節(jié)點(diǎn)上重復(fù)這些步驟。

加入集群

您可以通過(guò)轉(zhuǎn)到管理 > System > System info，然后向下滾動(dòng)到Cluster nodes部分。

做得好！

您已將 Jira 升級(jí)到新版本。