Atlassian：Confluence升級(jí)

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

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

 

其他升級(jí) Confluence 的方法：

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

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

• 無(wú)需停機(jī)的集群 - 滾動(dòng)升級(jí)到兼容的錯(cuò)誤修復(fù)版本，無(wú)需停機(jī)。

不應(yīng)使用 XML 備份來(lái)升級(jí) Confluence。

在你開始之前

在升級(jí) Confluence 之前，您需要回答幾個(gè)問題。 

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

 

計(jì)劃你的升級(jí)

創(chuàng)建一個(gè)自定義的升級(jí)計(jì)劃

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

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

1. 確定你的升級(jí)路徑

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

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

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

 

 

Confluence 7是一次重大升級(jí)

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

企業(yè)版本

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

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

2. 完成升級(jí)前的檢查

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

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

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

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

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

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

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

 

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

• 選擇你打算升級(jí)的版本，然后點(diǎn)擊檢查。

 

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

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

最好知道：

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

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

 

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

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

• 請(qǐng)參閱為升級(jí)Confluence創(chuàng)建一個(gè)暫存環(huán)境，以幫助創(chuàng)建一個(gè)環(huán)境來(lái)測(cè)試你的升級(jí)。

• 按照下面的步驟來(lái)升級(jí)你的測(cè)試環(huán)境。 

•  

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

升級(jí)Confluence

4. 備份 

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

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

一旦你確認(rèn)你的數(shù)據(jù)庫(kù)備份是成功的，你可以選擇禁用升級(jí)恢復(fù)文件的自動(dòng)生成，因?yàn)檫@個(gè)過程對(duì)于中等規(guī)?；蜉^大的網(wǎng)站來(lái)說可能需要很長(zhǎng)時(shí)間。

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

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

我的主目錄在哪里？

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

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

 

5. 下載Confluence

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

 

6. 運(yùn)行安裝程序

• 運(yùn)行安裝程序

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

如果提示允許升級(jí)向?qū)?duì)你的計(jì)算機(jī)進(jìn)行修改，請(qǐng)選擇 "是"。如果你不這樣做，安裝向?qū)?duì)你的操作系統(tǒng)的訪問將受到限制，任何后續(xù)的安裝選項(xiàng)將受到限制。

 

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

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

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

接下來(lái)，運(yùn)行安裝程序——我們建議使用 sudo 運(yùn)行安裝程序：

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

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

  

• 按照提示升級(jí) Confluence：
   

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

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

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

  • 安裝向?qū)?huì)通知您 Confluence 安裝目錄中的自定義設(shè)置。 記下這些，因?yàn)槟院笮枰匦聭?yīng)用它們。

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

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

• 如果你當(dāng)前的Confluence實(shí)例是手動(dòng)安裝的，它將只檢查Confluence安裝目錄下的confluence子目錄。安裝向?qū)Р粫?huì)通知你在任何其他目錄中的修改，例如對(duì)bin目錄下的啟動(dòng)腳本的修改或?qū)erver.xml文件的修改（如SSL配置）。 

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

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

升級(jí)后

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

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

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

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

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

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

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

在升級(jí)過程中，向?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ù)，都需要手動(dòng)重新應(yīng)用。  

 

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

• 停止你升級(jí)后的Confluence實(shí)例。

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

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

• 重新啟動(dòng)升級(jí)后的Confluence實(shí)例。

我們強(qiáng)烈建議你在升級(jí)生產(chǎn)實(shí)例之前在測(cè)試實(shí)例中測(cè)試你的定制，因?yàn)镃onfluence可能已經(jīng)發(fā)生了變化，使你的定制無(wú)法使用。

手動(dòng)編輯新文件，而不是復(fù)制舊文件，因?yàn)檫@些文件中的默認(rèn)配置可能在不同的Confluence版本中有所改變。

 

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

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

• 轉(zhuǎn)到

 > 管理應(yīng)用

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

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

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

 

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

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

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

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

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

如果Synchrony沒有運(yùn)行，或在編輯器中看到錯(cuò)誤，請(qǐng)參見 "協(xié)作編輯的故障排除"，因?yàn)槟憧赡苡幸粋€(gè)配置錯(cuò)誤的反向代理。 

故障排除

出了什么問題嗎？

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

 

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

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

• 數(shù)據(jù)庫(kù)不支持在線備份
  升級(jí)向?qū)?huì)提示你使用數(shù)據(jù)庫(kù)的備份工具備份你的數(shù)據(jù)庫(kù)。如果你的數(shù)據(jù)庫(kù)不支持在線備份，請(qǐng)停止升級(jí)進(jìn)程，關(guān)閉Confluence，進(jìn)行數(shù)據(jù)庫(kù)備份，然后再次運(yùn)行安裝程序，繼續(xù)升級(jí)。

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

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

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

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

 

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