importURLMappings 錯誤

這個主題說明 importURLMappings 指令錯誤的回復程序。

如果在執行 importURLMappings 時發生錯誤,您可以檢查 JazzInstallDir/server/repotools-jts_importURLMappings.log 檔案。

對映檔中遺漏對映項目

如果您發現原始對映檔遺漏項目,例如其中一個 CLM 應用程式的 source-target 配對,請採取下列步驟:

  1. 關閉伺服器。
  2. 建立只含有遺漏項目的新對映檔。
  3. 重新執行 repotools-jts -importUrlMappings 指令來套用新的對映檔。

對映的目標 URL 發生錯誤

如果目標 URL 發生錯誤,請採取下列更正程序。 更正會累加,亦即,只要伺服器已關閉,隨時都可以更正。 您可以對多個項目進行更正,但只能新增發生錯誤的項目。 請不要包含您認為對映正確的 URL。假設原始對映檔中有下列項目:
...
source=https://myOriginalUrl
target=https://myTargetUrlWithATypo
...
  1. 關閉伺服器。
  2. 建立含有更正對映的新對映檔。請勿將這個項目新增至原始對映檔。 這個項目如下所示:
    source=https://myTargetUrlWithATypo
    target=https://myCorrectTargetUrl
  3. 重新執行 repotools-jts -importUrlMappings 指令來套用新的對映檔。

對映的來源 URL 發生錯誤

程序類似前一節,但稍微複雜,因為您必須分別執行兩項更正對映。 假設原始對映檔中有下列項目:

...
source=https://myOriginalUrlWithATypo
target=https://myTargetUrl
...
  1. 建立含有下列更正對映的新對映檔。 這個對映檔的目的是要移開目標 myTargetUrl。
    source=https://myTargetUrl
    target=dummy://aDummyUrl
  2. 重新執行 repotools-jts -importUrlMappings 指令來套用新的對映檔。如下所示套用正確對映:
    source=https://myOriginalUrl
    target=https://myTargetUrl

請勿嘗試將這些對映合併在一個檔案中。必須分開套用上述更正對映,系統才能明確地自行更正。

不小心將對映檔中的來源和目標對調

例如,開始位置如下:

...
source=https://myTargetUrl
target=https://mySourceUrl
...
重要: 此情況只能透過一般回復程序來回復。

如果要補救這種狀況,您必須遵循一般回復規則。 問題在於這種對映表示位於 https://myTargetUrl 的應用程式也位於 https://mySourceUrl。 因為這是應用程式已存在的位置,導致語義不明確,無法復原。

您在對映中的語法錯誤

請更正錯誤,並重新執行 importURLMappings。

指令失敗並產生 CRJAZ2436E

叢集中不支援伺服器重新命名。在離線和線上進行重新命名期間,Jazz™ Team Server 和 CLM 應用程式伺服器必須維持非叢集型態。

指令失敗並產生 CRJAZ2449E

升級已啟動,但卻未完成。一般而言,如果在完成線上升級之前就嘗試重新命名,就會發生此情況。RM 有一項線上移轉作業,必須在完成離線升級之後執行。請完成線上升級。如需詳細資料,請參閱 roadmap_clm_upgrade.html。請關閉伺服器,並重試 importURLMappings。

指令產生 CRJAZ2425W 警告

這項警告指出對映事件檔沒有包含任何新的對映。如果同一對映檔匯入兩次,或者沒有更新所產生的原始對映事件檔,來指定目標 URL,就可能發生此情況。請驗證對映檔引數指向正確的檔案,並且驗證檔案內容。

指令顯示 CRJAZ2197E 訊息

importURLMappings 日誌中有錯誤的訊息是 CRJAZ2197E,或者在您執行 importURLMappings 之後啟動伺服器時,出現 CRJAZ2197E 訊息。

此訊息指出這部伺服器的公用 URI 已設為 https://jts.source.example.org:9443/jts。在配置伺服器之後,無法將它變更為 https://jts.target.example.org:9443/jts。如果伺服器已移至新位置 https://jts.target.example.org:9443/jts,請遵循指示來重新命名伺服器。

只要 importURLMappings 執行失敗,它應該會將 JTS teamserver.properties 中的 URL 回復成其原始值。如果沒有這樣做,您可以手動更新 teamserver.properties,來包含原始 URL,並重新執行 importURLMappings 或重新啟動伺服器。


意見