文档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技术运营团队请求版本升级。 有关更多信息，请参阅底部的“常见问题解答”部分（如果此页面）。 另请参阅内部版本升级常见问题解答。

准备升级

在开始内部版本升级之前，必须按照以下所述执行完整准备。
一旦系统准备好升级，则内部版本升级需要​ 至少 2小时。

内部版本升级过程需要以下资源：

  • Adobe架构师 — 了解数据库结构（现成的架构和已添加的任何其他架构、活动设计以及必须按特定顺序启动和测试的任何关键路径功能）。
  • 项目经理 — 如果版本升级涉及许多不同的实例（生产、暂存、测试）和其他第三方服务器和应用程序（数据库、SFTP站点、消息服务提供商），则由项目经理协调所有测试被视为最佳实践。
  • Adobe Campaign管理员 — 您的管理员知道服务器的配置，包括但不限于：安全性、文件夹布局、报表以及导入\导出要求。 如果没有管理员，请不要执行内部版本升级。
  • Adobe Campaign操作员（营销用户） — 成功升级取决于用户成功执行其日常任务的能力。 因此，在升级服务器的测试中应始终至少包含一个每日操作员。

规划

以下是如何规划内部版本升级的关键点：

  1. 至少保留2个小时进行升级。
  2. 为Adobe和客户员工分发联系人详细信息。
  3. 对于托管实例：Adobe和客户员工将协调升级时间和执行人员。
  4. 对于内部部署实例：客户员工管理整个流程 — 如果需要测试自定义工作流和交付逻辑方面的帮助，则应引入咨询服务。
  5. 确定并确认要升级到哪个Adobe Campaign版本 — 请参阅Adobe Campaign Classic发行说明。
  6. 确认拥有升级可执行文件。

关键人员

内部版本升级过程需要以下人员参与：

  • Adobe架构师：对于托管或混合架构，架构师必须与Adobe Campaign客户关怀团队进行协调。

  • 项目经理：

    • 对于内部部署：客户的内部项目负责人负责升级并管理生命周期测试。

    • 对于托管安装：托管团队将与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. 检查烧灼情况，如下所示：

    • 检查唯一的ID设置为​ 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服务：net stop 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 Server应用程序

  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服务：net start nlserver6

客户端控制台更新

客户端控制台必须与服务器实例位于同一内部版本上。

在安装了Adobe Campaign应用程序服务器的计算机(nlserverweb)上，下载并复制文件：

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

下次连接客户端控制台时，将显示一个窗口，通知用户有新的更新可用，并为用户提供下载和安装更新的可能性。

其他特定任务

某些配置需要特定的其他任务才能更新到新内部版本。

事务性消息传递

在Campaign实例上启用事务性消息传递（消息中心）后，您需要执行以下附加步骤以进行升级：

  1. 将消息中心生产服务器更新至所选版本。

  2. 运行升级后脚本。

  3. 运行测试并确保通过消息中心生产实例成功接收电子邮件。

  4. 升级客户端并清除缓存。

  5. 导出资源包：

    • 使用客户端包导出工具导出包
    • 导入架构包
    • 断开并重新连接客户端
    • 更新数据库
    • 断开并重新连接
    • 导入管理包
    • 导入内容包
    • 导入内容管理包
    • 断开并重新连接
    • 对工作流执行快速健康检查

  6. Publish消息中心模板，以确保服务器和消息中心实例之间的界面正常工作。

  7. 运行测试以确保通过消息中心生产实例成功接收电子邮件。

  8. 在生产环境中运行工作流测试以确保接收投放。

中间源

在中间源环境的上下文中，您需要执行以下附加步骤以进行升级：

  1. 联系Adobe客户关怀以协调中间源服务器的升级。

  2. 通过运行测试链接来验证版本是否已更新。 例如：

    code language-none 
    http://[InsertServerURL]/r/test
NOTE
中间源服务器必须始终运行与营销服务器相同的版本（或更高版本）。

发生冲突时

识别冲突

您需要检查同步结果。 此过程仅由内部部署客户执行。 对于托管客户，由托管团队负责。 查看同步结果的方法有两种：

在命令行界面中，错误通过三个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. 对代码执行“差异”。

解决冲突

要解决冲突，请应用以下流程：

  1. 在Adobe Campaign资源管理器中，转到​ 管理>配置>包管理>编辑冲突。

  2. 在列表中选择要解决的冲突。
    解决冲突有三个选项： 接受新版本、保留当前版本、合并代码（并声明为已解决）、忽略冲突（不推荐）。

何时可以接受新版本？

  • 如果您需要标准特征。
  • 如果您没有自定义项（将删除所有自定义项）

我何时可以保留当前版本？

  • 如果您有自定义项
  • 如果您不想合并
  • 如果您不需要对升级中的冲突对象进行任何修复

何时执行合并？

  • 只能合并表单、报表和Web应用程序。
  • 某些次要合并无需了解代码即可得到解决。
  • 更复杂的合并应由具有相应技能和能力的人进行。
  • 请参阅执行合并。

如果忽略冲突怎么办？

  • 冲突将依然存在
  • 将不会升级该对象
  • 长期影响：版本不兼容，客户将无法从错误修复中受益。
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. 运行diff（比较两个文件）。
  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