手動(dòng)升級(jí)JIRA應(yīng)用程序

如果您從早于7.0的JIRA版本進(jìn)行升級(jí)，則應(yīng)該咨詢遷移中心。JIRA 7.0的發(fā)行包含影響您的用戶管理，應(yīng)用程序訪問(wèn)和登錄權(quán)限以及您的JIRA安裝設(shè)置的功能，在升級(jí)之前了解需求和含義非常重要。遷移中心在一個(gè)便利的空間中擁有所有這些信息。

本頁(yè)介紹如何升級(jí)不支持快速升級(jí)方法或回退方法的JIRA安裝。 如果您符合以下任何標(biāo)準(zhǔn)，則應(yīng)使用此方法升級(jí)JIRA：

• 您在Solaris上使用JIRA 4.0.0或更高版本。
• 在Windows或Linux上使用JIRA 4.0.0 - 4.2.x。

 

1. 開始之前

• 閱讀有關(guān)新版本 -查看您要升級(jí)到的JIRA版本的發(fā)行說(shuō)明和升級(jí)說(shuō)明。如果您計(jì)劃在升級(jí)過(guò)程中跳過(guò)幾個(gè)JIRA版本，我們強(qiáng)烈建議您閱讀當(dāng)前版本和要升級(jí)到的版本之間的所有主要版本的升級(jí)指南。
• 檢查許可 -確認(rèn)您的許可證支持期限仍然有效。
• 檢查已知問(wèn)題-使用JIRA知識(shí)庫(kù)搜索新版本中會(huì)影響到您的任何問(wèn)題。
• 檢查兼容性： 
   
  • 確認(rèn)您的操作系統(tǒng)，數(shù)據(jù)庫(kù)，其他適用的平臺(tái)和硬件仍然符合JIRA 7.1的要求。 “支持終止聲明”頁(yè)面還包含有關(guān)JIRA未來(lái)版本的平臺(tái)支持的重要信息。
  • 如果您已經(jīng)安裝了JIRA插件（即不包含在JIRA中），請(qǐng)確認(rèn)它們將與要升級(jí)到的JIRA版本兼容。 您可以從Atlassian Marketplace的插件主頁(yè)中找到插件的兼容性信息。
  • 某些防病毒或其他Internet安全工具可能會(huì)干擾JIRA升級(jí)過(guò)程，并阻止成功完成該過(guò)程。 如果您遇到或預(yù)期遇到與您的防病毒/ Internet安全工具有關(guān)的問(wèn)題，請(qǐng)?jiān)诶^續(xù)進(jìn)行JIRA升級(jí)之前禁用此工具。
• 預(yù)先測(cè)試并測(cè)試新版本的JIRA -我們強(qiáng)烈建議首先在測(cè)試環(huán)境中執(zhí)行升級(jí)。 在您確定測(cè)試環(huán)境升級(jí)成功之前，請(qǐng)不要升級(jí)您的生產(chǎn)JIRA服務(wù)器。
  • 如果您的測(cè)試環(huán)境升級(jí)有任何問(wèn)題無(wú)法解決，請(qǐng)?jiān)谥С志W(wǎng)站上創(chuàng)建問(wèn)題，以便我們?yōu)槟峁椭?/span>
  • 如果在生產(chǎn)JIRA服務(wù)器的升級(jí)過(guò)程中遇到任何問(wèn)題，請(qǐng)不要讓您的用戶開始使用此服務(wù)器。 請(qǐng)進(jìn)行以下操作：
     
    • 繼續(xù)使用舊的JIRA服務(wù)器 - 這將有助于確保您不會(huì)丟失生產(chǎn)數(shù)據(jù)。
    • •也在我們的支持網(wǎng)站上創(chuàng)建一個(gè)問(wèn)題，以便我們可以幫助您解決升級(jí)問(wèn)題。

 

2. 備份

在開始JIRA升級(jí)之前，我們強(qiáng)烈建議您備份現(xiàn)有的JIRA安裝。

2.1阻止用戶更新JIRA數(shù)據(jù)

在升級(jí)過(guò)程中，您將從現(xiàn)有的JIRA安裝（通過(guò)XML備份）導(dǎo)出JIRA的數(shù)據(jù)庫(kù)，然后將此備份恢復(fù)為新的JIRA安裝。為了確保XML備份中的數(shù)據(jù)與系統(tǒng)中的最新數(shù)據(jù)一致，您必須暫時(shí)限制對(duì)JIRA的訪問(wèn)，以便用戶無(wú)法更新數(shù)據(jù)。

 Be aware! 不一致的XML備份無(wú)法恢復(fù)！

2.2 備份數(shù)據(jù)庫(kù)

對(duì)現(xiàn)有的JIRA安裝的外部數(shù)據(jù)庫(kù)執(zhí)行XML備份。 對(duì)于大型JIRA安裝，此過(guò)程可能需要幾個(gè)小時(shí)才能完成。

“嵌入式數(shù)據(jù)庫(kù)”是JIRA提供的H2數(shù)據(jù)庫(kù)，僅供評(píng)估之用。 如果意外在生產(chǎn)系統(tǒng)中使用H2數(shù)據(jù)庫(kù)，請(qǐng)對(duì)此數(shù)據(jù)庫(kù)執(zhí)行XML備份，并繼續(xù)執(zhí)行此過(guò)程。

2.3備份JIRA主目錄

1.  關(guān)閉JIRA.

2. 找到JIRA主目錄。 您可以通過(guò)導(dǎo)航到JIRA應(yīng)用程序安裝目錄中的 /WEB-INF/classes/jira-application.properties文件來(lái)找到有關(guān)目錄位置的信息?；蛘?，您可以打開JIRA配置工具來(lái)查看設(shè)置為您的JIRA主頁(yè)的目錄。
3. 導(dǎo)航到配置文件中指定的目錄，并在另一個(gè)目錄中創(chuàng)建它的備份。
4.  一旦備份完成，請(qǐng)從原始文件夾中刪除文件 /dbconfig.xml。

2.4如果位于JIRA主目錄之外，請(qǐng)備份附件和索引目錄

如果附件和索引目錄位于JIRA主目錄之外，則必須單獨(dú)備份它們。這些頁(yè)面描述了如何找出這些目錄在你的實(shí)現(xiàn)中的位置：

• 您的附件目錄 - 請(qǐng)參閱您的JIRA版本文檔中的“配置文件附件”頁(yè)面。
• 索引目錄 - 請(qǐng)參閱您的JIRA版本的文檔中的搜索索引頁(yè)面。

有關(guān)在JIRA中備份附件的更多信息，另請(qǐng)參閱備份數(shù)據(jù)。

2.5備份你的JIRA安裝目錄

“JIRA安裝目錄”是安裝JIRA時(shí)JIRA應(yīng)用程序文件和庫(kù)被提取到的目錄。

3. 設(shè)置新的JIRA安裝

如果您運(yùn)行的是“關(guān)鍵任務(wù)”JIRA服務(wù)器，則強(qiáng)烈建議在執(zhí)行生產(chǎn)升級(jí)之前，在測(cè)試環(huán)境中執(zhí)行本指南的其余步驟（例如，使用單獨(dú)的測(cè)試JIRA數(shù)據(jù)庫(kù)和JIRA主目錄副本）。

3.1安裝新版本的JIRA

將您需要的JIRA發(fā)行版下載并提取到新目錄。不要覆蓋您現(xiàn)有的JIRA安裝。 確保已經(jīng)關(guān)閉，并將新的JIRA版本安裝到新的位置。

 

3.2將您的新JIRA指向您現(xiàn)有JIRA主目錄（的副本）

如果您的新JIRA 7.1安裝位于新服務(wù)器上，請(qǐng)?jiān)诶^續(xù)之前將現(xiàn)有JIRA主目錄的備份從舊服務(wù)器復(fù)制到新服務(wù)器。

設(shè)置分配：

1. 打開JIRA配置工具。
2. 單擊JIRA主頁(yè)選項(xiàng)卡。
3. 更新JIRA主目錄字段：
    
   • 如果您的JIRA 7.1安裝位于新服務(wù)器上，請(qǐng)將JIRA主目錄字段更新為復(fù)制的JIRA主目錄的路徑。
   • 如果您的JIRA 7.1安裝位于同一臺(tái)服務(wù)器上，請(qǐng)將JIRA主目錄字段更新為現(xiàn)有JIRA主目錄的路徑。

 您還可以通過(guò)定義操作系統(tǒng)環(huán)境變量JIRA_HOME來(lái)設(shè)置JIRA主目錄的位置。 此變量的此值優(yōu)先于JIRA安裝目錄中jira-application.properties文件中jira.home屬性的值。

3.3將新版本的JIRA連接到一個(gè)新的空數(shù)據(jù)庫(kù)

創(chuàng)建一個(gè)新的，空的數(shù)據(jù)庫(kù)，新的JIRA安裝將用來(lái)存儲(chǔ)其數(shù)據(jù)。

按照第2階段的數(shù)據(jù)庫(kù)相關(guān)的“連接JIRA到...”的說(shuō)明進(jìn)行操作，雖然從第4階段開始，請(qǐng)注意下面的黃色注意事項(xiàng)：

• 將JIRA連接到PostgreSQL
• 將JIRA連接到MySQL
• 將JIRA連接到Oracle
• 將JIRA連接到SQL Server 2008

如果在現(xiàn)有的JIRA安裝中使用數(shù)據(jù)庫(kù)（例如，稱為jiradb），并且新的JIRA安裝的數(shù)據(jù)庫(kù)在同一臺(tái)機(jī)器或數(shù)據(jù)庫(kù)服務(wù)器上運(yùn)行，則可以使用不同的名稱創(chuàng)建新的數(shù)據(jù)庫(kù)（例如直觀類似jiradb_440 為JIRA 4.4.0）。但是，確保新的數(shù)據(jù)庫(kù)具有與舊的JIRA數(shù)據(jù)庫(kù)相同的訪問(wèn)權(quán)限。 如果您需要幫助，請(qǐng)咨詢您的數(shù)據(jù)庫(kù)管理員。

 如果您正在使用嵌入式H2數(shù)據(jù)庫(kù)，則不需要?jiǎng)?chuàng)建新的數(shù)據(jù)庫(kù)。

3.4將現(xiàn)有的JIRA配置遷移到新的JIRA安裝

如果您已經(jīng)修改了現(xiàn)有JIRA安裝的配置文件中的屬性，請(qǐng)?jiān)谛碌腏IRA安裝中進(jìn)行相同的修改。 但是，因?yàn)榕渲梦募械膶傩钥赡茉诎姹局g發(fā)生了變化，所以不能簡(jiǎn)單地從現(xiàn)有安裝中復(fù)制配置文件，并替換新安裝中的等效文件。

對(duì)于您在現(xiàn)有JIRA安裝中修改的每個(gè)文件，您需要在新的JIRA安裝中手動(dòng)編輯每個(gè)等效文件并重新應(yīng)用修改。 如果您的新JIRA安裝中沒有文件（例如最近的JIRA版本中的osuser.xml），那么只需將該文件復(fù)制到新的JIRA安裝中即可。

 特定于版本的升級(jí)說(shuō)明包含有關(guān)這些通常已修改的文件中可能已更改的屬性的詳細(xì)信息。

除上述文件外，還應(yīng)考慮和/或執(zhí)行以下配置作為升級(jí)過(guò)程的一部分：

• 使用JIRA與Atlassian的人群？ - 如果您正在與JIRA一起使用Crowd，請(qǐng)按照將Crowd與JIRA集成中所述配置新的JIRA與Crowd交談。
  • 記得配置Crowd以授予JIRA新的主機(jī)名/ IP訪問(wèn)權(quán)限。
• 為JIRA分配額外的內(nèi)存 —如果您之前已經(jīng)為JIRA分配了額外的內(nèi)存，請(qǐng)為新的JIRA實(shí)例執(zhí)行相同的操作。
• 字符編碼 —確保新舊位置的字符編碼（即區(qū)域設(shè)置）相同。 如果附件在兩個(gè)不兼容的編碼系統(tǒng)之間移動(dòng)，則新版本的JIRA可能無(wú)法正常工作。
• 自定義—如果您進(jìn)行了任何自定義（代碼，模板或配置文件），請(qǐng)將這些更改的兼容版本復(fù)制到新的JIRA。 （組織中開發(fā)人員需要為舊版本進(jìn)行自定義，需要構(gòu)建和測(cè)試新版本的等同更改，并為您提供要復(fù)制到已升級(jí)JIRA安裝的文件。）
• （可選）在另一個(gè)端口上運(yùn)行JIRA—如果你的新JIRA與舊的JIRA安裝在同一臺(tái)機(jī)器上，你可能希望確保它運(yùn)行在不同的端口上（如果你需要重新啟動(dòng)舊的JIRA）。

3.5開始你的新版本的JIRA

1. 確認(rèn)您的舊JIRA安裝已關(guān)閉 - 如果此JIRA服務(wù)器仍在運(yùn)行，請(qǐng)將其關(guān)閉。
2. 按照啟動(dòng)JIRA說(shuō)明啟動(dòng)新版本的JIRA。

不要重新啟動(dòng)舊的JIRA安裝

如果新的JIRA 7.1安裝與舊的JIRA 7.1安裝在同一臺(tái)服務(wù)器上，那么它可能仍然被配置為使用與新的JIRA安裝相同的JIRA主目錄。 運(yùn)行兩個(gè)共享JIRA主目錄的獨(dú)立JIRA安裝可能會(huì)導(dǎo)致嚴(yán)重的數(shù)據(jù)損壞。

不過(guò)，我們建議您不要?jiǎng)h除舊JIRA安裝的任何方面（或備份組件），除非您確信已升級(jí)的JIRA安裝正常運(yùn)行。

3.6將舊的JIRA數(shù)據(jù)導(dǎo)入到新的JIRA中

在開始新的JIRA安裝之后，JIRA將啟動(dòng)其安裝向?qū)А?JIRA在空數(shù)據(jù)庫(kù)開始時(shí)會(huì)發(fā)生這種情況。 從這里，您可以導(dǎo)入備份文件，并使用XML備份數(shù)據(jù)填充數(shù)據(jù)庫(kù)。 您需要備份您在備份步驟中創(chuàng)建的以前版本的JIRA。

要將舊的JIRA數(shù)據(jù)導(dǎo)入到新的JIRA中：

1. 將先前備份的附件目錄還原到新JIRA的附件目錄中。 （請(qǐng)參閱恢復(fù)數(shù)據(jù)。）

2.  啟動(dòng)JIRA.

3. 在設(shè)置向?qū)е?，選擇導(dǎo)入現(xiàn)有數(shù)據(jù)。
4. 在“文件名”字段中，指定您在導(dǎo)出過(guò)程（上文）中先前創(chuàng)建的XML備份文件。 壓縮文件應(yīng)該包含兩個(gè)xml文件：activeobjects.xml和entities.xml。 這兩個(gè)文件都必須包含在壓縮文件中才能使導(dǎo)入過(guò)程正常工作。
    執(zhí)行XML還原時(shí)避免通過(guò)代理，特別是如果您的JIRA實(shí)例非常大。 使用代理可能會(huì)導(dǎo)致超時(shí)錯(cuò)誤。
5. 再次通過(guò)您的Web瀏覽器訪問(wèn)JIRA，并使用您之前的JIRA安裝中的用戶名登錄。
6. 快速瀏覽您的JIRA網(wǎng)站，確認(rèn)您的項(xiàng)目和問(wèn)題是否存在，一切看起來(lái)都正常。 您應(yīng)該在頁(yè)腳中看到新的JIRA版本號(hào)。

4. 升級(jí)后檢查和任務(wù)

強(qiáng)烈建議您在開始新的JIRA實(shí)例后執(zhí)行以下檢查和任務(wù)：

1. 檢查您的服務(wù)器日志是否出現(xiàn)錯(cuò)誤消息，即使JIRA似乎運(yùn)行正常。 如果在那里有任何你不能解決的錯(cuò)誤，創(chuàng)建一個(gè)支持案例，附上你的日志文件，我們會(huì)建議你的錯(cuò)誤。
2. 如果您以前使用外部用戶管理，請(qǐng)?jiān)谛碌腏IRA實(shí)例中啟用它。
3. 如果升級(jí)時(shí)更改了機(jī)器，請(qǐng)從JIRA的“管理”部分將路徑更改為索引，附件和備份目錄。
4. 啟用電子郵件，如果您在測(cè)試期間禁用它。
5. 如果您從舊的JIRA遷移任何定制到新的JIRA，請(qǐng)確保它們已被徹底測(cè)試。
    
   1. 如果您已經(jīng)下載了新版JIRA的插件，請(qǐng)將下載的JAR文件安裝到新的JIRA版本中，并執(zhí)行其他所需的插件安裝。
   2. 如果插件有一個(gè)屬性文件，則應(yīng)用與舊屬性文件中相同的更改（不要僅復(fù)制舊的屬性文件）。
6. 確認(rèn)新服務(wù)器正常工作后，確保為新服務(wù)器標(biāo)識(shí)更新生產(chǎn)許可證，如下所示：
    
   1. 登錄到官網(wǎng)（聯(lián)系哲想軟件可登陸）。
   2. 找到適當(dāng)?shù)脑S可證。
   3. 按照新的生產(chǎn)服務(wù)器ID編輯服務(wù)器ID，并保存。
   4. 更新新服務(wù)器中的生產(chǎn)許可證。

恭喜！ 您已完成JIRA遷移/升級(jí)。