您已選擇使用安裝程序升級 Jira 數(shù)據(jù)中心（集群）。

在你開始之前

第 1 步：準備升級

確保您已完成準備升級中的步驟。 這些是強制性的先決條件，對于順利升級至關重要。

第 2 步：選擇您的版本

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

第 3 步：停止集群

如果您要在零停機時間的情況下升級數(shù)據(jù)中心，請省略此步驟。

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

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

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

 

步驟 1. 下載Jira

• 從我們的網(wǎng)站下載 Jira 應用程序之一。 選擇 Windows 或 Linux 二進制文件。

 

Jira Software

Jira Service Management

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

步驟 2. 啟動安裝向導

安裝向導將指導您完成升級過程。

• 運行您下載的安裝程序。

 

·我在使用Windows...

·我在使用Linux...

 

• 按照向導中的提示進行操作：
  • 出現(xiàn)提示時，選擇升級現(xiàn)有的 Jira 安裝。
  • 確保向導建議的現(xiàn)有 Jira 安裝目錄正確（如果您在同一臺機器上安裝了多個 Jira，這一點尤其重要。）
  • 如果您已經(jīng)備份了 Jira 主目錄，請清除備份 Jira 主目錄復選框以避免創(chuàng)建額外的備份。
  •  

該向導會通知您 Jira 安裝目錄中的自定義項。 記下這些，因為您以后需要重新應用它們。 

您當前的自定義將被覆蓋，但您可以稍后從備份中復制它們。

 

在最后一個屏幕中，升級向導會要求您啟動 Jira 實例并完成升級。 我們建議您停止此步驟，并完成此頁面中的剩余步驟，直到第一次使用 Start Jira。

在此處啟動 Jira 不會以任何方式影響您的升級，但需要關閉 Jira 才能完成剩余步驟。 完成它們后，您可以返回向導并啟動 Jira。

 

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

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

如果驅動程序是最新的，您也可以從以前的版本復制它。

 

• 下載以下驅動程序之一：

Oracle: JDBC driver 19.3 (ojdbc8)

MySQL: MySQL Connector/J 5.1 driver.

• 將其放在 /lib 中。

 

步驟 4. 重新應用修改并增加 pool-max-size

在使用 Jira 時，您可能已經(jīng)對 Jira 文件添加了一些自定義修改。 這些可能包括連接詳細信息、與內存分配相關的設置或其他 JVM 參數(shù)。 在此步驟中，您需要通過從備份中復制新文件來重新應用相同的修改。

 

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

 

遷移的修改

在升級過程中，向導從您現(xiàn)有的 Jira 安裝中遷移了以下內容：

• server.xml文件中的TCP值。
• jira-application.properties文件中你的Jira主目錄的位置。
• setenv.sh / setenv.bat文件中的以下值。

·jvm_support_recommended_args

·jvm_minimum_memory

·jvm_maximum_memory

·jira_max_perm_size 

其他修改

除上述之外，您需要重新應用所有其他修改。 以下是最重要的文件： 

• server.xml
• dbconfig.xml
• jira-config.properties
• web.xml
• setenv.sh / setenv.bat (memory allocation and other JVM arguments)
• for more, see Important files in Jira

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

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

- /atlassian-jira/ directory
- /conf/server.xml
- /bin/setenv.sh

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

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

池最大大小

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

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

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

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

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

/jira-config.properties

 

• 添加以下行，并保存文件：

upgrade.reindex.allowed=false 

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

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

第 1 步：首次啟動 Jira

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

• （安裝程序）返回升級向導并啟動 Jira。
  
  （安裝程序和手冊）您還可以通過轉到 /bin 并運行以下文件之一來啟動 Jira：
  • Windows:  start-jira.bat
  • Linux:  start-jira.sh 
• 在瀏覽器中打開 Jira。
• 按照屏幕上的說明完成設置。

如果您遺漏了任何尚未復制的自定義更改文件，您現(xiàn)在可以自動復制這些更改。 

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

- atlassian-jira/ directory
- conf/server.xml
- bin/setenv.sh

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

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

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

升級后登陸頁面

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

 

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

第 2 步：（可選）更新 Jira 服務管理

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

• 轉到管理> 應用程序 > 版本和許可證。
• 更新 Jira 服務管理。 這會自動將 Jira Service Management 更新為兼容版本。

 

步驟 3. 升級應用程序（附加組件）

現(xiàn)在，您可以升級具有“兼容”狀態(tài)的應用程序。 如果您需要有關狀態(tài)和應用的更多信息，請參閱準備升級。

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

升級 DC 集群中的應用

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

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

 

步驟 4. 重建索引

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

• 轉到管理> 索引，然后運行 Lock Jira 并重建重新索引。

步驟 5. 將升級后的 Jira 復制為模板

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

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

 

 

升級剩余節(jié)點

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

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

加入集群

您可以通過轉到管理> 系統(tǒng) > 系統(tǒng)信息，然后向下滾動到集群節(jié)點部分來檢查升級的節(jié)點是否加入集群。

 

做得好！

您已將 Jira 升級到新版本。