Atlassian：Confluence升級

在本指南中，我們將引導(dǎo)您使用安裝程序?qū)⒛?Confluence 站點升級到 Windows 或 Linux 上的最新 Confluence 版本。

如果您有當(dāng)前的軟件維護，可以升級到任何更高版本。 請參閱我們的許可常見問題解答以了解更多信息。 

 

其他升級 Confluence 的方法：

• 手動 – 不使用安裝程序升級服務(wù)器或單節(jié)點數(shù)據(jù)中心。

• 停機的集群 – 升級您的數(shù)據(jù)中心集群。

• 無需停機的集群 - 滾動升級到兼容的錯誤修復(fù)版本，無需停機。

不應(yīng)使用 XML 備份來升級 Confluence。

在你開始之前

在升級 Confluence 之前，您需要回答幾個問題。 

哪種升級方法是最佳選擇？	您可以選擇使用安裝程序進行升級，也可以使用 zip 或 tar.gz 文件手動升級。 在大多數(shù)情況下，安裝程序是升級 Confluence 實例的最簡單方法。 如果您符合以下條件，則需要手動升級： 作為本次升級的一部分，移動到另一個操作系統(tǒng)或文件位置。 從Confluence 3.5或更早版本升級 從Confluence 5.6或更早版本升級，并且之前使用EAR/WAR發(fā)行版將Confluence部署到現(xiàn)有的應(yīng)用服務(wù)器。  執(zhí)行滾動升級，并且需要單獨升級每個節(jié)點。
你有資格升級嗎？	要檢查您的許可證的軟件維護是否是最新的，請轉(zhuǎn)到配置 > 常規(guī)配置 > 疑難解答和支持工具，并確保許可證支持期未過期。   軟件維護：在此期間的任何時候都可以升級。   如果你的支持期已經(jīng)過期，請按照提示更新你的許可證，并在升級前重新申請。
我們支持的平臺有變化嗎？	查看你要升級的Confluence版本的支持平臺頁面。這將給你提供關(guān)于支持的操作系統(tǒng)、數(shù)據(jù)庫和瀏覽器的信息。 最好知道： Confluence安裝程序包括Java（JRE）和Tomcat，所以你不需要單獨升級這些。 如果你需要升級你的數(shù)據(jù)庫，請務(wù)必閱讀你計劃升級到的Confluence版本（以及任何介于兩者之間的版本）的升級說明，以檢查你可能需要進行的任何數(shù)據(jù)庫配置更改。
你需要改變你的環(huán)境嗎？	較新的 Confluence 版本有時需要更改您的環(huán)境，例如提供更多內(nèi)存或調(diào)整您的反向代理設(shè)置。 最好知道： 我們使用升級說明來傳達會影響您的更改，例如： 對支持的數(shù)據(jù)庫、內(nèi)存要求或其他將影響你的環(huán)境的變化。 在這個版本中發(fā)生重大變化或被刪除的功能。 你可能需要在升級后立即在你的實例或環(huán)境中采取的行動。 閱讀你要升級的版本和介于兩者之間的版本的說明是很重要的。例如，如果你要從5.8升級到5.10，你應(yīng)該閱讀5.9和5.10的升級說明。

 

計劃你的升級

創(chuàng)建一個自定義的升級計劃

計劃升級？你可以在Confluence中立即生成一個定制的升級計劃。 前往 配置> 常規(guī)配置 > 計劃你的升級

你需要安裝一個兼容版本的故障排除和支持工具應(yīng)用程序。 

1. 確定你的升級路徑

使用下面的表格來確定從當(dāng)前版本到最新版本Confluence的最有效升級路徑。

您的版本	推薦升級到Confluence 7的路徑
2.7或更早	升級到2.7.4，然后升級到3.5.17，并遵循以下路徑。
2.8至3.4	升級到3.5.17，并遵循以下路徑。
3.5	升級到5.0.3，并遵循以下路徑。
4.0至4.3	升級到5.10.x，并遵循下面的路徑。
5.0至7.x	直接升級到最新版本的Confluence 7。

如果你要升級到下一個錯誤修復(fù)更新（例如，從7.9.0到7.9.4），你可以在不停機的情況下升級。

 

 

Confluence 7是一次重大升級

請務(wù)必檢查Confluence升級矩陣，做一個完整的備份，并在升級你的生產(chǎn)站點之前在非生產(chǎn)環(huán)境中測試你的升級。

企業(yè)版本

長期支持版本是一個功能版本，在其整個兩年的支持窗口期間，得到回傳的關(guān)鍵安全更新和關(guān)鍵錯誤修復(fù)。如果你每年只能升級一次，可以考慮升級到長期支持版本。 

長期支持版本最初被稱為企業(yè)版。

2. 完成升級前的檢查

• 檢查你計劃升級的版本（以及任何介于兩者之間的版本）的升級說明。 

• 轉(zhuǎn)到配置 > 常規(guī)配置 > 計劃你的升級，然后選擇你想升級的版本。這將運行一些升級前的檢查。 

• 轉(zhuǎn)到配置 > 常規(guī)配置 > 故障排除和支持工具，運行健康檢查。 

• 如果你的許可證中包含的軟件維護期已經(jīng)過期，你可以繼續(xù)使用Confluence，但你需要在升級前更新。

• 進入 >常規(guī)配置>許可細節(jié)，按照提示更新你的許可。

• 如果你使用的是嵌入式（試用）數(shù)據(jù)庫，你應(yīng)該在升級前遷移到另一個數(shù)據(jù)庫。參見嵌入式H2數(shù)據(jù)庫以了解更多信息。

• 數(shù)據(jù)庫的字符編碼必須設(shè)置為UTF+8（或Oracle數(shù)據(jù)庫的AL32UTF8）。除非你有正確的字符編碼，否則你將無法升級到當(dāng)前的Confluence版本。

 

• 進入配置>管理應(yīng)用程序，向下滾動到Confluence更新檢查，檢查你的市場應(yīng)用程序的兼容性。

• 選擇你打算升級的版本，然后點擊檢查。

 

如果你有不兼容的附加組件...

如果你的用戶依賴特定的市場應(yīng)用，你可能想等到它們兼容了再升級Confluence。供應(yīng)商通常會在主要版本發(fā)布后很快更新他們的應(yīng)用程序。

最好知道：

• 如果一個應(yīng)用程序還不兼容，你可以在升級時暫時停用它。

• 在新版本發(fā)布后，Atlassian實驗室和其他免費應(yīng)用程序的兼容性信息通常不會立即提供。在許多情況下，應(yīng)用程序仍然可以工作，所以在升級你的生產(chǎn)站點之前，請在測試站點中試一試。

 

3. 在測試環(huán)境中升級Confluence

• 創(chuàng)建一個當(dāng)前生產(chǎn)環(huán)境的暫存副本。 

• 請參閱為升級Confluence創(chuàng)建一個暫存環(huán)境，以幫助創(chuàng)建一個環(huán)境來測試你的升級。

• 按照下面的步驟來升級你的測試環(huán)境。 

•  

• 在升級你的生產(chǎn)環(huán)境之前，測試任何不支持的用戶安裝的應(yīng)用程序、自定義（如自定義主題或布局）和代理配置（如果可能）。   

升級Confluence

4. 備份 

• 備份你的數(shù)據(jù)庫并確認備份是正確創(chuàng)建的。 

• 如果你的數(shù)據(jù)庫不支持在線備份，你就需要先停止Confluence。  

一旦你確認你的數(shù)據(jù)庫備份是成功的，你可以選擇禁用升級恢復(fù)文件的自動生成，因為這個過程對于中等規(guī)模或較大的網(wǎng)站來說可能需要很長時間。

• 備份你的安裝目錄
  安裝程序?qū)⑼耆鎿Q這個目錄，所以你添加的任何文件（如keystore或SSL證書）都不會被保留。安裝向?qū)陂_始升級前備份這個目錄，但你也應(yīng)該先手動備份。 
   

• 備份你的主目錄。  
  安裝向?qū)Ыo你提供的選項是，作為安裝過程的一部分，你也可以備份你的主目錄，但你也應(yīng)該在開始升級前手動備份這個目錄。 
    

我的主目錄在哪里？

你可以在<installation-directory>/confluence/WEB-INF/classes/confluence-init.properties文件中找到主目錄的位置。

這是你的搜索索引和附件存儲的地方。如果你在Confluence主目錄之外存儲附件，你也應(yīng)該備份你的附件目錄。 

 

5. 下載Confluence

下載適合你的操作系統(tǒng)的安裝程序。 

 

6. 運行安裝程序

• 運行安裝程序

運行該.exe文件。我們建議使用Windows管理員帳戶。

如果提示允許升級向?qū)δ愕挠嬎銠C進行修改，請選擇 "是"。如果你不這樣做，安裝向?qū)δ愕牟僮飨到y(tǒng)的訪問將受到限制，任何后續(xù)的安裝選項將受到限制。

 

• 改變到你下載Confluence的目錄，然后執(zhí)行此命令，使安裝程序可執(zhí)行。

$ chmod a+x atlassian-confluence-X.X.X-x64.bin

其中X.X.X是你下載的Confluence版本。

接下來，運行安裝程序——我們建議使用 sudo 運行安裝程序：

$ sudo ./atlassian-confluence-X.X.X-x64.bin

您還可以選擇以 root 用戶權(quán)限運行安裝程序。

  

• 按照提示升級 Confluence：
   

  • 出現(xiàn)提示時，選擇升級現(xiàn)有的 Confluence 安裝（對于 Linux 用戶，這是選項 3）。

  • 確保向?qū)Ыㄗh的現(xiàn)有 Confluence 安裝目錄正確（如果您在同一臺機器上安裝了多個 Confluence，這一點尤其重要）。

  • 強烈建議備份 Confluence 主頁。 這將創(chuàng)建 Confluence 主目錄和安裝目錄的 .zip 備份。

  • 安裝向?qū)ㄖ?Confluence 安裝目錄中的自定義設(shè)置。 記下這些，因為您以后需要重新應(yīng)用它們。

安裝向?qū)ㄖ阕远x的能力取決于你現(xiàn)有的 Confluence 實例是如何安裝的：

• 如果你當(dāng)前的Confluence實例是用安裝程序安裝的，向?qū)z查整個Confluence安裝目錄。

• 如果你當(dāng)前的Confluence實例是手動安裝的，它將只檢查Confluence安裝目錄下的confluence子目錄。安裝向?qū)Р粫ㄖ阍谌魏纹渌夸浿械男薷?，例如對bin目錄下的啟動腳本的修改或?qū)erver.xml文件的修改（如SSL配置）。 

你不會收到關(guān)于你添加到安裝目錄中的文件的通知，所以一定要先把它們備份。

• 該向?qū)㈥P(guān)閉你的Confluence實例并繼續(xù)進行升級。一旦完成，它將重啟Confluence，然后你可以在瀏覽器中啟動Confluence，確認升級成功。
   
  取決于你的實例的大小和要運行的升級任務(wù)的數(shù)量，這個步驟可能需要幾分鐘或幾個小時。

升級后

7. 復(fù)制你的數(shù)據(jù)庫驅(qū)動程序

如果你使用的是Oracle或MySQL數(shù)據(jù)庫，你需要從現(xiàn)有的Confluence安裝目錄中復(fù)制jdbc驅(qū)動jar文件到新安裝目錄中的confluence/WEB-INF/lib。

Microsoft SQL和Postgres用戶可以跳過這一步。  

8. 如果需要的話，重新安裝服務(wù)（僅Windows）。

如果你在Windows上以服務(wù)形式運行Confluence，你應(yīng)該刪除現(xiàn)有的服務(wù)，然后通過運行<install-directory>/bin/service.bat重新安裝服務(wù)。

這將確保服務(wù)獲得最新的JVM選項。 

9. 重新應(yīng)用任何修改

在升級過程中，向?qū)哪悻F(xiàn)有的Confluence安裝中遷移了以下內(nèi)容。

• 你的<install-directory>/conf/server.xml文件中的TCP端口值。 

• <install-directory>/confluence/WEB-INF/classes/confluence-init.properties中的Confluence主目錄的位置。
    

所有其他定制，包括你的<install-directory>/bin/setenv.sh / setenv.bat文件中的CATALINA_OPTS參數(shù)，都需要手動重新應(yīng)用。  

 

任何其他配置、定制（包括<install-directory>/conf/server.xml文件中的任何其他修改）、<install-directory>/bin/setjre.sh或setjre.bat中你自己的Java安裝路徑或添加到安裝目錄中的其他文件在升級期間不會被遷移，需要手動重新應(yīng)用。

• 停止你升級后的Confluence實例。

• 編輯每個文件，并在升級后的Confluence安裝目錄中重新應(yīng)用定制的文件。

• 復(fù)制任何其他文件（如keystore或SSL證書）。

• 重新啟動升級后的Confluence實例。

我們強烈建議你在升級生產(chǎn)實例之前在測試實例中測試你的定制，因為Confluence可能已經(jīng)發(fā)生了變化，使你的定制無法使用。

手動編輯新文件，而不是復(fù)制舊文件，因為這些文件中的默認配置可能在不同的Confluence版本中有所改變。

 

10. 更新你的應(yīng)用程序（附加組件）

你可以更新任何與新版本的Confluence兼容的應(yīng)用程序。

• 轉(zhuǎn)到

 > 管理應(yīng)用

• 將您的應(yīng)用更新到受支持的版本。

在這個階段，清除插件緩存會很有用。 了解如何執(zhí)行此操作

這是可選的，但可用于避免第三方應(yīng)用程序和插件出現(xiàn)任何問題。

 

11. 更新您的反向代理并檢查您是否可以訪問 Confluence

如果您要從 Confluence 5.x 升級到 Confluence 6.x，則需要修改您的反向代理（如果使用）以添加 Synchrony，這是協(xié)作編輯所必需的。 有關(guān)您需要對代理配置進行的更改的詳細信息，請參閱代理和 SSL 注意事項。

升級完成后，您應(yīng)該訪問 Confluence（通過您的反向代理，而不是直接）并且：

• 前往配置 > 一般配置 > 協(xié)作編輯，檢查Synchrony狀態(tài)是否運行。 

• 編輯任何頁面，檢查你的瀏覽器是否可以連接到Synchrony。

如果Synchrony沒有運行，或在編輯器中看到錯誤，請參見 "協(xié)作編輯的故障排除"，因為你可能有一個配置錯誤的反向代理。 

故障排除

出了什么問題嗎？

如果你需要重試升級，你必須先恢復(fù)升級前的備份。  不要嘗試再次運行升級，或者在升級失敗后再次啟動舊版本的Confluence。 

 

• 不能繼續(xù)升級，因為許可證已過期
  如果你的許可證已經(jīng)過期，并且在升級前沒有更新和重新申請，你將在升級過程中收到錯誤。有關(guān)如何解決這個問題的信息，請參見升級超過當(dāng)前許可期限。

• 由于與反病毒軟件有沖突，無法繼續(xù)升級
  一些反病毒或其他互聯(lián)網(wǎng)安全工具可能會干擾Confluence的升級過程，并阻止該過程成功完成，特別是當(dāng)你把Confluence作為一個Windows服務(wù)運行時。如果你的防病毒/互聯(lián)網(wǎng)安全工具遇到或預(yù)計會遇到這樣的問題，請在進行Confluence升級前先禁用該工具。

• 數(shù)據(jù)庫不支持在線備份
  升級向?qū)崾灸闶褂脭?shù)據(jù)庫的備份工具備份你的數(shù)據(jù)庫。如果你的數(shù)據(jù)庫不支持在線備份，請停止升級進程，關(guān)閉Confluence，進行數(shù)據(jù)庫備份，然后再次運行安裝程序，繼續(xù)升級。

• 升級需要很長的時間
  如果你有一個非常大的數(shù)據(jù)庫（即數(shù)據(jù)庫備份需要很長的時間來完成），將confluence.upgrade.recovery.file.enabled系統(tǒng)屬性設(shè)置為false會加速升級過程。只有在執(zhí)行升級前有一個備份數(shù)據(jù)庫和驗證備份的過程時，才應(yīng)該使用它。

• Confluence不能啟動
  不兼容的市場應(yīng)用有時會阻止Confluence的成功啟動。你可以在啟動Confluence時暫時禁用所有用戶安裝的應(yīng)用程序來解決這個問題。參見啟動和停止Confluence獲取更多信息。

• 協(xié)作編輯錯誤
  如果Synchrony沒有運行，或者你看到一個錯誤，請前往故障排除協(xié)作編輯，了解如何在你的環(huán)境中啟動和運行協(xié)作編輯。最常見的問題是配置錯誤的反向代理或端口8091對Synchrony不可用。   

升級后空間目錄為空
如果你從Confluence 6.3或更早的版本升級，有一個已知的問題，即空間目錄中不出現(xiàn)空格。你需要在升級后重新索引你的網(wǎng)站來解決這個問題。

 

你也可以參考Confluence知識庫中的升級故障排除指南，或者從Atlassian Answers社區(qū)查看答案。