文件CampaignCampaign Classic v7 文件

[僅限內部部署/混合]{class="badge yellow" title="僅適用於內部部署和混合部署"}

執行建置升級 performing-a-build-upgrade

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

本節將深入介紹升級程式，以及識別和解決衝突的步驟。

組建版本升級必須謹慎進行，必須事先充分考慮其影響，並且程式必須以高度的紀律性完成。 若要確保升級成功，請確定只有專家使用者才能執行下列步驟。 此外，我們強烈建議您在開始任何升級前，先聯絡Adobe客戶服務。

需要下列先決條件：

  • 瞭解Campaign架構
  • 系統與伺服器端知識
  • 管理許可權與許可權

您可在下列章節中找到更多資訊： 更新Adobe Campaign、移轉至新版本。

對於託管和混合式執行個體，您必須向Adobe技術營運團隊請求組建升級。 如需詳細資訊，請參閱底部的「常見問題」區段（若此頁面）。 另請參閱組建版本升級常見問答集。

準備升級

在開始組建版本升級之前，您必須依照以下所述執行完整準備。
一旦系統準備好要升級，組建升級至少需要​ 1}2小時。

組建版本升級程式需要下列資源：

  • Adobe架構師 — 瞭解資料庫結構（現成可用的結構描述和已新增的任何其他結構描述、行銷活動設計，以及必須依特定順序啟動和測試的任何關鍵路徑功能）。
  • 專案管理員 — 如果組建升級涉及許多不同的執行個體（生產、測試、測試）和其他協力廠商伺服器和應用程式（資料庫、SFTP站台、傳訊服務提供者），則由專案管理員協調所有測試被視為最佳實務。
  • Adobe Campaign管理員 — 您的管理員知道伺服器的設定，包括但不限於：安全性、資料夾配置、報告以及匯入\匯出需求。 沒有您的管理員，請勿執行組建升級。
  • Adobe Campaign操作員（行銷使用者） — 成功的升級仰賴使用者成功執行其每日任務的能力。 因此，在升級伺服器的測試中，請務必加入至少一個每日操作員。

規劃

以下是如何規劃組建版本升級的關鍵點：

  1. 至少保留2小時進行升級。
  2. 為Adobe和客戶員工分配聯絡詳細資訊。
  3. 對於託管例項：Adobe和客戶員工將協調升級時間以及執行人員。
  4. 對於內部部署執行個體：客戶員工管理整個流程 — 如果需要測試自訂工作流程和傳送邏輯的協助，則應引入諮詢服務。
  5. 決定並確認您要升級至哪個Adobe Campaign版本 — 請參閱Adobe Campaign Classic發行說明。
  6. 確認擁有升級可執行檔。

重要人員

組建版本升級程式需要以下人員參與：

  • Adobe架構師：針對託管或混合式架構，架構師必須與Adobe Campaign Client Care協調。

  • 專案經理：

    • 對於內部部署：客戶的內部專案主管會領導升級並管理生命週期測試。

    • 針對託管安裝：託管團隊將與Adobe Campaign客戶服務團隊和客戶合作，協調所有執行個體的升級時間表。

  • Adobe Campaign管理員：

    • 對於內部部署安裝：管理員會執行升級。

    • 對於託管安裝：託管團隊會執行升級。

  • Adobe Campaign operator\marketing user：此操作員會在開發、測試和生產執行個體上執行測試。

準備組建版本升級

在開始進行組建版本升級之前，內部部署客戶需要執行下列準備：

  1. 請確保在升級之前可以匯出任何開發工作，並匯出為套件。

  2. 針對來源和目標環境的所有執行處理，執行資料庫的完整備份。

  3. 取得伺服器組態檔的最新版本。

  4. 下載最新的組建。 了解更多。

在開始組建升級之前，您還需要知道所有有用的命令列：

  • nlserver pdump：列出執行中的處理序
  • nlserver pdump -who：列出作用中使用者端工作階段
  • nlserver監視器 — missing：列出遺失的屬性
  • nlserver啟動process@instance-name：啟動處理序
  • nlserver stop process@instance-name：停止處理序
  • nlserver重新啟動process@instance-name：重新啟動處理序
  • nlserver關機：停止所有Campaign處理序
  • nlserver watchdog -svc：啟動監視器（僅限UNIX）

執行升級

以下程式僅由​ 內部部署 ​客戶執行。 對於託管客戶，由託管團隊負責。 若要將Adobe Campaign更新為新組建版本，以下說明詳細程式。

複製環境

以下說明如何複製Adobe Campaign環境，以便將來源環境還原到目標環境，從而得到兩個相同的工作環境。

要執行此操作，請遵循下列步驟：

  1. 在來源環境的所有執行個體上建立資料庫復本。

  2. 在目標環境的所有執行個體上還原這些復本。

  3. 在啟動之前，請在目標環境中執行​ nms：freezeInstance.js ​燒錄指令碼。 這將停止所有與外界互動的流程：記錄、追蹤、傳送、行銷活動工作流程等。

    code language-none 
    nlserverjavacsriptnms:freezeInstance.js–instance:<dev> -arg:run

  4. 檢查燒灼化，如下所示：

    • 檢查唯一傳遞部分是否為識別碼設為​ 0 ​的部分：

      code language-none 
      SELECT * FROM neolane.nmsdeliverypart;

    • 檢查交貨狀態更新是否正確：

      code language-none 
      SELECT iSate, count(*) FROM neolane.nmsdeliveryGroup By iProd;

    • 檢查工作流程狀態更新是否正確：

      code language-none 
      SELECT iState, count (*) FROM neolane.xtkworkflowGROUP BY iState;
SELECT iStatus, count (*) FROM neolane.xtkworkflowGROUP BY iStatus;

關閉服務

若要以新版本取代所有檔案，必須關閉nlserverservice的所有執行個體。

  1. 關閉下列服務：

    • Web服務(IIS)： iisreset /stop
    • Adobe Campaign服務： 網路停止nlserver6
    note note
    NOTE
    請確定重新導向伺服器(webmdl)已停止，以便IIS使用的nlsrvmod.dll檔案可以取代為新版本。

  2. 執行​ nlserver pdump ​命令，驗證沒有作用中的工作。 如果沒有工作，則輸出應類似於以下內容：

    code language-none 
    C:\<installation path>\bin>nlserverpdump HH:MM:SS > Application Server for Adobe Campaign version x.x (build xxx) dated xx/xx/xxxx No tasks

  3. 檢查Windows工作管理員，確認所有處理程式都已停止。

升級Adobe Campaign伺服器應用程式

  1. 執行​ Setup.exe ​檔案。 如果您需要下載此檔案，請存取下載中心。

  2. 選取安裝模式： 更新 ​或​ 修復。

  3. 按一下​ 下一步。

  4. 按一下​ 完成：安裝程式會複製新檔案。

  5. 作業完成後，按一下​ 完成。

同步資源

  1. 開啟命令列。

  2. 執行​ nlserver config -postupgrade -allinstances ​以執行下列動作：

    • 同步資源
    • 更新方案
    • 更新資料庫
    note note
    NOTE
    此操作只應在nlserverweb應用程式伺服器上執行一次。

    若要僅同步處理一個資料庫，請執行以下命令：

    code language-none 
    nlserver config -postupgrade -instance: <instance_name>

  3. 檢查同步是否已產生任何錯誤或警告。

重新啟動服務

需要重新啟動下列服務：

  • Web服務(IIS)： issreset /start
  • Adobe Campaign服務： 網路啟動nlserver6

使用者端主控台更新

使用者端主控台必須與伺服器執行個體位於相同的組建上。

在安裝Adobe Campaign應用程式伺服器的電腦上(nlserverweb)，下載並複製檔案：

Setup-client-7.xxxx.exe in [path of the application]\datakit\nl\en\jsp

下次連線使用者端主控台時，會出現一個視窗，通知使用者是否有新的更新可用，並提供他們下載和安裝更新的可能性。

其他特定任務

某些設定需要特定的其他任務才能更新到新的組建。

交易型訊息傳遞功能

在您的Campaign執行個體上啟用異動訊息（訊息中心）時，您需要執行下列額外步驟以進行升級：

  1. 將Message Center生產伺服器更新至所選版本。

  2. 執行升級後指令碼。

  3. 執行測試並確保透過訊息中心生產執行個體成功收到電子郵件。

  4. 升級使用者端並清除快取。

  5. 匯出套件：

    • 使用使用者端套件匯出工具匯出套件
    • 匯入結構描述套件
    • 中斷使用者端連線並重新連線
    • 更新資料庫
    • 中斷連線並重新連線
    • 匯入管理員套件
    • 匯入內容封裝
    • 匯入內容管理套件
    • 中斷連線並重新連線
    • 執行工作流程的快速健康狀態檢查

  6. Publish Message Center範本，確保伺服器與Message Center執行個體之間的介面運作正常。

  7. 執行測試以確保透過訊息中心生產執行個體成功接收電子郵件。

  8. 在生產環境中執行工作流程測試，以確保接收傳遞。

中間來源

在中間來源環境中，您需要執行這些額外的步驟以進行升級：

  1. 聯絡Adobe客戶服務以協調中間來源伺服器的升級。

  2. 執行測試連結以驗證版本是否已更新。 例如：

    code language-none 
    http://[InsertServerURL]/r/test
NOTE
中間來源伺服器必須一律執行與行銷伺服器相同的版本（或更新版本）。

發生衝突時

識別衝突

您需要檢查同步處理結果。 此程式僅由內部部署客戶執行。 對於託管客戶，由託管團隊負責。 檢視同步化結果的方式有兩種：

在命令列介面中，錯誤會以三個V形'>>>'具體化，而且同步會自動停止。 警告會以雙>形箭號具體化，同步處理完成後必須加以解析。 升級後結束時，命令提示字元中會顯示摘要。 如下所示：

YYYY-MM-DD HH:MM:SS.749Z 00002E7A 1 info log =========Summary of the update==========
YYYY-MM-DD HH:MM:SS.749Z 00002E7A 1 info log <instance name> instance, 6 warning(s) and 0 error(s) during the update.
YYYY-MM-DD HH:MM:SS.749Z 00002E7A 1 warning log The document with identifier 'mobileAppDeliveryFeedback' and type 'xtk:report' is in conflict with the new version.
YYYY-MM-DD HH:MM:SS.749Z 00002E7A 1 warning log The document with identifier 'opensByUserAgent' and type 'xtk:report' is in conflict with the new version.
YYYY-MM-DD HH:MM:SS.750Z 00002E7A 1 warning log The document with identifier 'deliveryValidation' and type 'nms:webApp' is in conflict with the new version.
YYYY-MM-DD HH:MM:SS.750Z 00002E7A 1 warning log Document of identifier 'nms:includeView‘ and type 'xtk:srcSchema' updated in the database and found in the file system. You will have to merge the two versions manually.

如果警告與資源衝突有關，則需要使用者注意才能解決。

postupgrade_ServerVersionNumber_TimeOfPostupgrade.log ​檔案包含同步處理結果。 預設可在下列目錄中取得： installationDirectory/var/<instance-name>/postupgrade。 錯誤和警告屬性會指出錯誤和警告。

分析衝突

如何找到衝突？

在相關伺服器的postupgrade.log或Campaign使用者端介面（「管理>設定>封裝管理>編輯衝突」）中，可能會發現衝突。

識別碼為「stockOverview」且型別為「nms：webApp」的檔案與新版本發生衝突。

如果發現衝突，請檢查以下條件是否相符：

  • 客戶是否已修改或自訂物件？
  • 物件在產品中變更了嗎？

若兩者都不適用，則為誤判。 如果這兩個條件都適用，就會發現真正的衝突。

客戶是否已修改物件？

  1. 識別衝突的物件。
  2. 詢問客戶是否修改了物件。
  3. 物件是否有任何不尋常之處？
  4. 上次修改日期是在物件的程式碼中設定嗎？
  5. 檢查衝突中的XML程式碼是否有「_conflict」屬性。 這看起來像自訂嗎？

在新組建中物件是否已變更？

  1. 有「常見疑點」嗎？ 內建Web應用程式或報表（例如：「deliveryValidation」、「deliveryOverview」、「budget」）。
  2. 檢查變更記錄檔是否有任何更新。
  3. 詢問Adobe Campaign專家。
  4. 對程式碼執行「diff」。

解決衝突

若要解決衝突，請套用下列程式：

  1. 在Adobe Campaign總管中，移至​ 管理>設定>封裝管理>編輯衝突。

  2. 在清單中選取要解決的衝突。
    有三個選項可解決衝突： 接受新版本、保留目前的版本、合併程式碼（並宣告為已解決）、忽略衝突（不建議）。

何時可以接受新版本？

  • 如果您想要標準特徵。
  • 如果您沒有自訂（將會移除所有自訂）

何時可以保留目前的版本？

  • 如果您有自訂
  • 如果您不想合併
  • 如果您不需要升級時衝突物件的任何修正

何時執行合併？

  • 只有表單、報表和網頁應用程式可以合併。
  • 有些微幅合併無需瞭解程式碼即可解決。
  • 應由具備適當技能與能力的人執行更複雜的合併。
  • 請參閱執行合併。

如果忽略衝突怎麼辦？

  • 衝突將持續存在
  • 將不會升級物件
  • 長期影響：版本不相容，客戶將無法受益於錯誤修正。
IMPORTANT
強烈建議您解決衝突。

執行合併 perform-a-merge

有不同型別的合併：

  1. 輕鬆合併：自訂元素和新元素很小且沒有關聯，不需要編碼。
  2. 無變更：接受新版本、僅上次變更更新日期、僅註解、標籤、空格或新行。 範例：意外儲存。
  3. 微不足道的變更：只變更了一行。 範例： xpathToLoad
  4. 複雜合併：需要編碼時。 需要開發技能。 請參閱複雜合併。

如何合併？

  1. 取得全部三個版本：原始版本、新版本和自訂版本。
  2. 執行原始版本和新版本之間的「差異」。
  3. 隔離變更。
  4. 如果沒有變更，請保留目前版本以解決。

在哪裡可以找到程式碼？

  1. 內建程式碼儲存在datakit資料夾的XML檔案中。 尋找符合衝突物件的XML檔案。 範例： installationDirectory\datakit\nms\fra\form\recipient.xml
  2. 擷取原始版本：透過下載中心或其他未升級的產品安裝。
  3. 擷取新版本：透過下載中心或客戶安裝的檔案。
  4. 擷取自訂版本：從Campaign使用者端中擷取物件的原始程式碼。

如何進行差異？

  1. 安裝文字或合併編輯器，例如Notepad ++、AraxisMerge、WinMerge。
  2. 在編輯器中開啟原始檔案和新檔案。
  3. 執行差異（比較兩個檔案）。
  4. 找出任何差異。

如何合併？

  1. 從自訂版本開始。
  2. 套用變更。
  3. 將衝突宣告為已解決，以解決衝突。
  4. 檢查無回歸。

如果您選擇手動解決衝突，請按照以下步驟進行：

  1. 在視窗的下半部，搜尋​ conflict_string ​以找出有衝突的實體。 與新版本一起安裝的實體包含新引數，符合先前版本的實體包含自訂引數。
  2. 刪除您不想要保留的版本。 刪除您要保留之實體的​ conflict_argument ​字串。
  3. 移至您已解決的衝突。 按一下​ 動作 ​圖示並選取​ 宣告為已解決。
  4. 儲存變更：衝突現已解決。

複雜合併 complex-merges

  1. 瞭解變更的作用：對變更進行反向工程、檢查變更記錄，並與Adobe Campaign專家聯絡。
  2. 決定如何處理變更。
  3. 瞭解自訂的功用：對變更進行反向工程

以下是執行複雜合併的步驟：

  1. 從變更集復製程式碼的位元
  2. 貼上至自訂版本
  3. 測試自訂的不回歸
  4. 測試變更的功能
  5. 執行使用者驗收測試
  6. 在測試環境中執行
IMPORTANT
執行複雜的合併需要開發技能。

相關主題

recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1