v7 on-premise & hybrid

執行版本編號升級

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

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

需要下列先決條件：

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

您可在以下章節找到更多資訊： 更新Adobe Campaign， 移轉至新版本.

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

準備升級

在開始組建版本升級之前，您必須執行下列所述的完整準備。
一旦系統準備好升級，就需要進行組建升級 至少 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： operator會在開發、測試和生產執行個體上執行測試。

準備組建版本升級

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

  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 shutdown：停止所有行銷活動程式
  • nlserver watchdog -svc：啟動監視程式（僅限UNIX）

執行升級

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

複製環境

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

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

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

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

  3. 執行 nms：freezeInstance.js 啟動之前，先對目標環境執行燒灼程式檔。 這將停止與外界互動的所有程式：記錄、追蹤、傳送、行銷活動工作流程等。

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

  4. 檢查燒製，如下所示：

    • 檢查唯一傳遞部分是否是ID設定為的傳遞部分 0：

      SELECT * FROM neolane.nmsdeliverypart;

    • 檢查傳遞狀態更新是否正確：

      SELECT iSate, count(*) FROM neolane.nmsdeliveryGroup By iProd;

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

      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
    注意

    請確定重新導向伺服器(webmdl)已停止，以便IIS使用的nlsrvmod.dll檔案可以換成新版本。

  2. 執行 nlserver pdump 命令。 如果沒有任務，則輸出應類似於以下內容：

    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 若要執行下列動作：

    • 同步資源
    • 更新結構
    • 更新資料庫
    注意

    此操作只應在nlserverweb應用程式伺服器上執行一次。

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

    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. 發佈訊息中心範本，以確保伺服器與訊息中心執行個體之間的介面運作正常。

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

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

中間來源

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

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

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

    http://[InsertServerURL]/r/test
注意

中間來源伺服器必須一律執行與行銷伺服器相同的版本（或更新版本）。

發生衝突時

識別衝突

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

在命令列介面中，錯誤會以三重V形'>>>'具體化，並且同步會自動停止。 警告會以雙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 Explorer中，前往 管理>設定>封裝管理>編輯衝突.

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

何時可以接受新版本？

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

何時可以保留目前版本？

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

何時執行合併？

  • 只能合併表單、報表和網頁應用程式。
  • 有些次要合併不需要瞭解程式碼就能解決。
  • 應由具備適當技能與能力的人來執行更複雜的合併。
  • 另請參閱 執行合併.

如果忽略衝突怎麼辦？

  • 衝突將持續存在
  • 將不會升級物件
  • 長期影響：版本不相容，客戶將無法受益於錯誤修正。
重要

強烈建議解決衝突。

執行合併

有不同型別的合併：

  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. 儲存您的變更：衝突現已解決。

複雜合併

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

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

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

執行複雜的合併需要開發技能。

相關主題

本頁內容