在你開始之前

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

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

第 2 步：選擇您的版本

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

第 3 步：停止集群

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

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

在第一個節(jié)點上升級 Jira

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

步驟 1. 下載 Jira

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

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

如果您要同時升級 Jira Software 和 Jira Service Management，請僅升級 Jira Software。您稍后將直接在 Jira 中升級 Jira Service Management，無需單獨的安裝程序。

步驟 2. 提取文件

解壓縮您下載的存檔，然后開始升級。

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

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

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

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

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

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

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

在使用 Jira 時，您可能已經(jīng)對 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.

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

• 確保您不只是復(fù)制舊文件，因為它們包含的“本機(jī)”設(shè)置可能在 Jira 版本之間發(fā)生了變化。

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

• 請注意，檢查只會在以下配置文件上運行：

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

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

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

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

• • 不要刪除 catalina.sh 中的雙引號
  • 在一行中設(shè)置所有參數(shù)，在 setenv.sh 或 setenv.bat 中沒有任何新行

否則，您可能會在啟動 Jira 時遇到問題。 

池最大大小

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

 

步驟 5. 禁用自動重新索引

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

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

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

• /jira-config.properties

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

 

第一個節(jié)點上的升級后步驟

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

步驟 1. 首次啟動 Jira

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

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

• 請注意，文件更改檢查僅在以下配置文件上運行：

- atlassian-jira/ 目錄

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

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

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

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

升級后登陸頁面

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

 

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

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

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

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

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

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

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

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

升級應(yīng)用程序時，每個節(jié)點都會在重新啟動時從共享主目錄中提取最近修改的應(yīng)用程序 jar 文件。

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

 

步驟 4. 重建索引

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

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

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

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

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

 

升級剩余節(jié)點

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

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

加入集群

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

做得好！

您已將 Jira 升級到新版本。