如何將JIRA應(yīng)用程序遷移到另一臺服務(wù)器

本文檔介紹了如何在不同的服務(wù)器硬件上遷移/升級到JIRA應(yīng)用程序，或者在不同的服務(wù)器環(huán)境中執(zhí)行以下一項或多項操作：

• 將運行JIRA應(yīng)用程序的新操作系統(tǒng)，
• 用于存儲索引和/或附件的新位置，或
• 將存儲JIRA應(yīng)用程序數(shù)據(jù)的新數(shù)據(jù)庫或數(shù)據(jù)庫系統(tǒng)。

如果在遷移過程中升級到較新版本的JIRA應(yīng)用程序，請參閱升級JIRA應(yīng)用程序以獲取有關(guān)升級前需要完成的必備任務(wù)的信息。

如果您將操作系統(tǒng)從Windows更改為Linux或反之，請記住您需要在文件路徑（'/'到'\'或'\'到'/'）中反轉(zhuǎn)“斜線”“）。

1. 在開始之前

• 檢查許可-確認(rèn)您的許可證支持期限仍然有效。
• 檢查已知問題 -使用JIRA知識庫搜索新版本中會影響到您的任何問題。
• 檢查兼容性：
   
  • 確認(rèn)您的操作系統(tǒng)，數(shù)據(jù)庫，其他適用的平臺和硬件仍然符合JIRA應(yīng)用程序的要求。
  • 確保源實例和目標(biāo)實例最初設(shè)置為具有相同的時區(qū)，以避免出現(xiàn)日期和時間字段的問題。
  • 如果您已經(jīng)安裝了JIRA應(yīng)用程序附件（即JIRA應(yīng)用程序未附帶），請驗證它們是否兼容。 您可以從Atlassian Marketplace上的加載項主頁上找到加載項的兼容性信息。您也可以按照此處所述的步驟進行操作：檢查應(yīng)用程序更新的附加兼容性，以使Universal Add-on Manager能夠幫助您。

我們強烈建議首先在測試環(huán)境中執(zhí)行遷移。 不要遷移生產(chǎn)JIRA服務(wù)器應(yīng)用程序，直到您確信測試環(huán)境升級已經(jīng)成功。

• 如果您的測試環(huán)境存在任何您無法解決的問題，請在我們的支持站點上創(chuàng)建問題，以便我們?yōu)槟峁椭?/span>
• 如果您在生產(chǎn)JIRA服務(wù)器應(yīng)用程序的遷移過程中遇到任何問題，請不要讓您的用戶開始使用此服務(wù)器。 代替：
   
  • 繼續(xù)使用舊的JIRA服務(wù)器應(yīng)用程序 - 這將有助于確保您不會丟失生產(chǎn)數(shù)據(jù)。
  • 同時在我們的支持網(wǎng)站上創(chuàng)建一個問題，以便我們幫助您解決遷移問題。

某些防病毒或其他Internet安全工具可能會干擾遷移，并阻止該進程成功完成。 如果您遇到或預(yù)期遇到防病毒/ Internet安全工具遇到此類問題，請在繼續(xù)進行JIRA應(yīng)用程序遷移之前先禁用此工具。

2. 備份

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

在升級過程中，您將從現(xiàn)有的JIRA安裝（通過XML備份）導(dǎo)出JIRA的數(shù)據(jù)庫，然后將此備份恢復(fù)為新的JIRA安裝。為了確保XML備份中的數(shù)據(jù)與系統(tǒng)中的最新數(shù)據(jù)一致，您必須暫時限制對JIRA的訪問，以便用戶無法更新數(shù)據(jù)。 有關(guān)更多信息，請參閱防止用戶在備份頁面訪問JIRA應(yīng)用程序。

 小心! 不一致的XML備份無法恢復(fù)！

2.2 備份你的數(shù)據(jù)庫

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

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

2.3備份你的JIRA主目錄

1.  關(guān)閉JIRA.

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

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

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

• 您的附件目錄 - 請參閱您的JIRA版本文檔中的“配置文件附件”頁面。
• •索引目錄 - 請參閱您的JIRA版本的文檔中的搜索索引頁面。

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

2.5備份你的JIRA安裝目錄

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

3. 設(shè)置新的JIRA應(yīng)用程序安裝

如果您正在運行“關(guān)鍵任務(wù)”JIRA服務(wù)器應(yīng)用程序，我們強烈建議您在測試環(huán)境中執(zhí)行本指南的其余步驟（例如，使用單獨的測試JIRA應(yīng)用程序數(shù)據(jù)庫和JIRA應(yīng)用程序主目錄副本） 升級為生產(chǎn)使用。

3.1安裝新版本的JIRA應(yīng)用程序

首先，您必須從新安裝JIRA應(yīng)用程序開始，不管是當(dāng)前版本還是新版本。 如果在此過程中升級JIRA應(yīng)用程序，請參閱升級JIRA應(yīng)用程序以獲取有關(guān)升級前需要完成的必備任務(wù)的信息。

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

3.2將您的新JIRA應(yīng)用程序指向您的現(xiàn)有JIRA應(yīng)用程序主目錄（的副本）

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

設(shè)置分配：

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

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

3.3將新版本的JIRA應(yīng)用程序連接到一個新的空數(shù)據(jù)庫

創(chuàng)建一個新的，空的數(shù)據(jù)庫，新的JIRA安裝將用來存儲其數(shù)據(jù)。

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

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

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

3.4將現(xiàn)有的JIRA應(yīng)用程序配置遷移到新安裝

如果您已經(jīng)修改了現(xiàn)有JIRA安裝的配置文件中的屬性，請在新的JIRA安裝中進行相同的修改。但是，因為配置文件中的屬性可能在版本之間發(fā)生了變化，所以不能簡單地從現(xiàn)有安裝中復(fù)制配置文件，并替換新安裝中的等效文件。

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

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

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

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

3.5開始你的新的JIRA應(yīng)用程序版本

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

不要重新啟動舊的JIRA安裝

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

不過，我們建議您不要刪除舊JIRA安裝的任何方面（或備份組件），除非您確信已升級的JIRA安裝正常運行。

3.6將舊數(shù)據(jù)導(dǎo)入新的JIRA應(yīng)用程序

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

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

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

4. 遷移后檢查和任務(wù)

強烈建議您在啟動新的JIRA應(yīng)用程序?qū)嵗髨?zhí)行以下檢查和任務(wù)： 

1. 檢查您的服務(wù)器日志是否出現(xiàn)錯誤消息，即使JIRA應(yīng)用程序似乎運行正常。 如果在那里有任何你不能解決的錯誤，創(chuàng)建一個支持案例，附上你的日志文件，我們會建議你的錯誤。
2. 如果您以前使用外部用戶管理，請在新的JIRA應(yīng)用程序?qū)嵗袉⒂盟?/span>
3. 如果在升級時更改機器，請將路徑從應(yīng)用程序的“JIRA管理”部分更改為索引，附件和備份目錄。
4. 啟用電子郵件，如果您在測試期間禁用它。
5. 如果您將自定義設(shè)置從新舊JIRA應(yīng)用程序遷移到新JIRA應(yīng)用程序，請確保已完全測試它們。
    
   1. 如果您已經(jīng)下載了新的JIRA應(yīng)用程序版本的插件，請將安裝下載的JAR文件安裝到您的新版本中，并執(zhí)行其他所需的插件安裝。
   2. 如果插件有一個屬性文件，則應(yīng)用與舊屬性文件中相同的更改（不要僅復(fù)制舊的屬性文件）。

恭喜！ 您已完成您的JIRA應(yīng)用程序遷移/升級。