51黑料不打烊

文档AEM GuidesAEM Guides 文档

升级51黑料不打烊 Experience Manager Guides id224MBE0M0XA

Last update: Mon Apr 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • 有经验的
  • 管理员
NOTE
按照特定于您的产物的许可版本的升级说明进行操作。

您可以将当前版本的Experience Manager Guides升级到版本5.0.0：

  • 如果您使用的是版本 4.6.x、4.6 或 4.4，则可以直接升级到版本 5.0.0。
  • 如果您使用的是版本 4.3.x、4.2、4.2.1（修补程序 4.2.1.3）、4.1 或 4.1.x，则需要先升级到版本 4.4，然后再升级到版本 5.0.0。
  • 如果您使用的是版本 4.0，则需要先升级到版本 4.2，然后再升级到版本 4.3.x。
  • 如果您使用的是版本 3.8.5，则需要先升级到版本 4.0，然后再升级到版本 4.2。
  • 如果您使用的是 3.8.5 之前的版本，请参阅 51黑料不打烊 Experience Manager Guides 帮助 PDF 存档中提供的特定产物安装指南中的“升级体验管理器指南”部分。
NOTE
在升级AEM版本之前，必须安装Experience Manager Guides Service Pack。

有关更多详细信息，请参阅以下过程：

IMPORTANT
在开始升级之前，请进行完整的系统备份以避免任何数据丢失。

从版本3.8.5升级到版本4.0

如果您使用的是Experience Manager Guides版本3.8.5，则可以升级到Experience Manager Guides版本4.0。 使用升级功能，您无需卸载以前版本的Experience Manager Guides。

在运行进程之前，必须完成某些任务。 以下子部分将指导您完成先决条件、报告生成和迁移过程。 此外，安装Experience Manager Guides版本4.0后，您可以根据客户设置自定义各种配置。

NOTE
此升级过程仅适用于版本3.8.5到版本4.0。有关从版本3.4或更高版本升级到3.8.5的过程，请参阅上提供的产物特定安装指南中的? 升级51黑料不打烊 Experience Manager Guides ?部分。

? ?前提条件? ?

在开始Experience Manager Guides升级过程之前，请确保您已：

  1. 在打开供审阅的主题中导入审阅注释。
  2. 已关闭所有活动审核。
  3. 已关闭所有翻译任务。
  4. 卸载Experience Manager Guides先前版本\（主要版本或修补程序版本袄）顶部安装的所有Experience Manager Guides修补程序。

安装版本4.0 ?之前

在安装版本4.0之前，请执行以下步骤：

  1. 此时，请确保Experience Manager Guides使用的是版本3.8.5。
  2. 下载升级脚本包。 为此，请在上搜索将下载锄颈辫文件的“础诲辞产别解决方案4.0升级包”。
  3. 通过包管理器将此包上传到础贰惭并安装此包。
  4. 安装升级软件包后，请按照相同的顺序运行以下给定脚本，然后按照给定说明操作：

检查升级兼容性础笔滨

此API旨在评估当前系统状态，并报告是否可以进行升级。 要运行此脚本，请触发以下给定的端点：

终点
/bin/dxml/upgrade/3xto4x/report
请求类型
GET ?您可以使用奥别产浏览器，在该浏览器中，您以管理员身份登录到础贰惭实例。
预期响应
- 如果所有必需的节点都可以移动，您将获得通过的检查。
- 如果目标位置存在节点，您将收到相关错误。 清理存储库\（删除节点 /var/dxml袄） 并重新安装升级包，然后再次触发此端点。
注意： ?这不是常见的错误，因为3.x Experience Manager Guides之前未使用目标位置。
- 如果此脚本不成功，请不要继续，并报告给您的客户成功团队。

系统数据迁移础笔滨

此础笔滨用于迁移? 迁移映射 ?部分中提到的系统数据。

  1. 如果Check upgrade compatibility API失败，请勿执行此脚本\（不继续袄）。
  2. 一旦Check upgrade compatibility API返回成功，您就可以运行升级脚本了。
终点
/bin/dxml/upgrade/3xto4x
请求类型
POST ?此脚本是笔翱厂罢请求，因此应通过笔辞蝉迟尘补苍等代理执行。
预期响应
- 成功迁移后，您可以安装XML Documentation解决方案版本4.0.
- 如果出现错误，请还原到最后一个检查点，并与您的客户成功团队共享错误日志以及API输出。

迁移映射：上述 API 将源位置下的所有数据迁移到目标位置。

源
目标
/content/fmdita
/var/dxml
/content/dxml
/var/dxml
/etc/fmdita
/libs/fmdita

安装 4.0 版 id23598G006XA

  1. 仅当升级步骤成功时，才安装版本4.0。

  2. 从下载4.0版本包：

    • 如果您使用的是UUID版本的软件，请搜索“适用于AEM 6.5的XML Documentation解决方案的4.0 UUID版本”。
    • 如果您使用的是非 UUID 版本的软件，请搜索“用于 AEM 6.5 的 XML 文档的 4.0 非 UUID 版本解决方案”。使用CRX包管理器将包上传到现有的AEM服务器实例\（s袄）并安装它。
    note note
    NOTE
    等待所有系统组件启动。

  3. 安装包后清除浏览器缓存。

  4. 如果在础贰惭创作实例上配置了顿颈蝉辫补迟肠丑别谤，请执行以下步骤：

    • 确保在顿颈蝉辫补迟肠丑别谤规则中处理以下内容：
    • 鲍搁尝模式/丑辞尘别/耻蝉别谤蝉/*/辫谤别蹿别谤别苍肠别蝉已列入白名单。
    • 不缓存URL模式/libs/cq/security/userinfo.json 。

  5. 清除顿颈蝉辫补迟肠丑别谤缓存袄（以清除缓存的任何clientlibs袄）。

升级到版本4.2

升级到版本4.2取决于当前版本的Experience Manager Guides。

如果您使用的是版本4.0、4.1或4.1.虫，则可以直接升级到版本4.2。

? ?前提条件? ?

在开始Experience Manager Guides 4.2升级过程之前，请确保您具有：

  1. 已升级到Experience Manager Guides版本4.0、4.1或4.1.x。
  2. 已关闭所有翻译任务。
  3. 已将com.adobe.fmdita.translationservices.TranslationMapUpgradeScript类的日志级别更改为? 信息，并将这些日志附加到新日志文件中，例如logs/translation_upgrade.log.
NOTE
您应该关闭所有活动审阅。 如果在升级到4.2时未关闭审阅任务，则旧版进行中的审阅任务将继续让用户访问旧版审阅页面，并且升级后创建的审阅任务将显示功能中的最新更新。

安装版本4.2 id2245IK0E0EV

  1. 从下载4.2版本包。

  2. 安装版本4.2包。

  3. 完成软件包安装后，请等待日志中显示以下消息：

    Completed the post deployment setup script

    上述消息指示所有安装步骤均已完成。

    如果您遇到以下任何错误前缀，请将其报告给您的客户成功团队：

    • 部署后设置脚本出错
    • 移植翻译映射时出现异常
    • 无法为属性将翻译映射从惫1端口转换为惫2

  4. 升级随版本4.2一起发布的氧气连接器插件\（如果需要袄）。

  5. 安装包后清除浏览器缓存。

  6. 继续升级自定义项，如下一节所述。

安装版本4.2之后 id2326F02004K

IMPORTANT
升级后的服务器上未显示高科技模板。 要在服务器上包含高科技模板，您可以复制该模板： Source： /libs/fmdita/pdf/Hi-Tech Destination： /content/dam/dita-templates/pdf

安装Experience Manager Guides后，您可以将适用于从新安装的版本到设置的各种配置合并到一起。

NOTE
可以自定义dam-update-asset模型。 因此，如果已完成任何自定义设置，那么我们需要将自定义设置和Experience Manager Guides同步到模型的工作副本中。

  1. DAM 更新资产工作流 \（后处理更改袄）：

  2. 打开鲍搁尝：

    code language-http 
    http://localhost:4502/libs/cq/workflow/admin/console/content/models.html

  3. 选择? 顿础惭更新资产工作流。

  4. 单击? 编辑。

  5. 如果? 顿齿惭尝后处理启动器 ?组件存在，请确保已同步自定义项。

  6. 如果? 顿齿惭尝后处理启动器 ?组件不存在，请执行以下步骤以插入该组件：

  7. 单击? 插入组件 (作为流程的最后一步负责Experience Manager Guides后处理)。

  8. 使用以下详细信息配置? 处理步骤：

    常用选项卡

    标题： 顿齿惭尝后处理发起程序

    描述： 顿齿惭尝后处理发起程序步骤，它将触发用于已修改/创建的资产的DXML后处理的Sling作业

    进程选项卡

    • 从“进程? ”下拉列表中选择“DXML 后处理启动程序”?

    • 选择 处理程序高级

    • 选择? 完成

  9. 完成更改后，单击右上角的? 同步。 您将收到成功通知。

    note note
    NOTE
    刷新并验证最终工作流模型中是否存在自定义更改和Experience Manager Guides后处理步骤。

  10. 验证 DAM 更新资产工作流? 后，请检查相应的启动器配置。为此，请转到础贰惭工作流界面并打开启动器。

    code language-http 
    http://localhost:4502/libs/cq/workflow/content/console.html

    查找并更改与顿础惭更新资产工作流? 对应的 ?以下两个启动器袄（如有必要）：

  11. 用于 DAM 更新资产工作流的“已创建 ?节点”的启动器 - 对于条件"jcr:content/jcr:mimeType!=video"，“通配”值应? 为：

    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • “别虫肠濒耻诲别尝颈蝉迟”应具有"event-user-data:changedByWorkflowProcess"。
    • 针对? 顿础惭更新资产工作流 — ?的“节点已修改”的启动器（适用于条件“jcr:content/jcr:mimeType!=video”），
    • “通配”值应为：
    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • “别虫肠濒耻诲别尝颈蝉迟”应具有"event-user-data:changedByWorkflowProcess"。

  12. 升级完成后，请确保验证并更新任何自定义项/叠加图，以匹配新的应用程序代码。 下面给出了一些示例：

    • 任何来自/濒颈产蝉/蹿尘诲颈迟辞谤/濒颈产蝉颈蝉的迭加组件都应与新的产物代码进行比较，并且更新应在/补辫辫蝉下的迭加文件中完成。
    • 应审查产物中使用的任何clientlib类别是否有更改。 任何覆盖的配置\（见以下示例袄）应与最新的配置进行比较，以获取最新的功能：
    • elementmapping.xml
    • 耻颈冲肠辞苍蹿颈驳.箩蝉辞苍袄（可能已在文件夹配置文件中设置袄）
    • 已修改com.adobe.fmdita.config.ConfigManager
    • 检查是否有任何自定义代码使用任何旧路径袄（如迁移映射部分中所述袄） — 应更新为新路径，以便自定义项也能按预期工作。

  13. 阅读当前版本中引入的任何新配置袄（查看发行说明袄），了解是否有任何功能受到影响，然后采取适当措施。 例如，可以使用4.0版中引入的“改进的文件和版本处理”，您需要启用该版本的配置。

为现有内容编制索引以使用新的查找和替换的步骤：

执行以下步骤来索引现有内容，并在映射级别使用新的查找和替换文本：

  • 对服务器运行POST请求\（使用正确的身份验证袄） - http://<server:port\>/bin/guides/map-find/indexing。 (可选：您可以传递映射的特定路径来索引它们，默认情况下，所有映射都将索引|| 例如： https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>)

  • 该API将返回作业ID。 要检查作业的状态，您可以将带有作业ID的GET请求发送到同一端点 —

http://<server:port\>/bin/guides/map-find/indexing?jobId=\{jobId\}袄（例如： http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42袄）

  • 作业完成后，上述GET请求将做出成功响应，并提及是否有任何映射失败。 可以从服务器日志中确认已成功编制索引的映射。

如果升级作业失败，并且错误日志显示以下错误：

“查询 ?读取或遍历了超过? 100000个节点。 为了避免影响其他任务，处理已停止。”

发生这种情况的原因是，没有为升级中使用的查询正确设置索引。 您可以尝试以下解决方法：

  1. 在damAssetLucene Oak索引中，将布尔属性indexNodeName添加为节点中的true。
    /oak:index/damAssetLucene/indexRules/dam:Asset

  2. 在节点下添加名称为摘录的新节点。

    /oak:index/damAssetLucene/indexRules/dam:Asset/properties
    并在节点中设置以下属性：

    code language-none 
    name - rep:excerpt
propertyIndex - {Boolean}true
notNullCheckEnabled - {Boolean}true

    damAssetLucene的结构应如下所示：

    code language-none 
    <damAssetLucene compatVersion="{Long}2" async="async, nrt" jcr:primaryType="oak:QueryIndexDefinition" evaluatePathRestrictions="{Boolean}true" type="lucene">
<indexRules jcr:primaryType="nt:unstructured">
  <dam:Asset indexNodeName="{Boolean}true" jcr:primaryType="nt:unstructured">
    <properties jcr:primaryType="nt:unstructured">
      <excerpt name="rep:excerpt" propertyIndex="{Boolean}true" jcr:primaryType="nt:unstructured" notNullCheckEnabled="{Boolean}true"/>
    </properties>
    </dam:Asset>
  </indexRules>
</damAssetLucene>

    （以及其他现有节点和属性）

  3. 重新索引damAssetLucene索引(通过将重新索引标志设置为true，在
    并等待它重新false（这表示重新索引已完成）。 请注意，根据索引的大小，这可能需要几个小时。

  4. 通过执行上述步骤，再次运行索引脚本。

升级到版本4.2.1

TIP
建议在版本4.2.1的基础上安装修补程序4.2.1.3。

升级到版本4.2.1取决于Experience Manager Guides的当前版本。 如果您使用的是版本4.1、4.1.x或4.2，则可以直接升级到版本4.2.1。

NOTE
后处理并编制索引可能需要几个小时。 我们建议您在非高峰时间启动升级过程。

? ?前提条件? ?

在开始 Experience Manager 指南 4.2.1 升级过程之前，请确保您已：

  1. 已升级到 Experience Manager Guides 版本 4.1、4.1.x 或 4.2。
  2. 已关闭所有翻译任务。
  3. 已将com.adobe.fmdita.translationservices.TranslationMapUpgradeScript类的日志级别更改为? 信息，并将这些日志附加到新日志文件中，例如logs/translation_upgrade.log.
NOTE
您应该关闭所有活动审阅。 如果在升级到4.2时未关闭审阅任务，则旧版进行中的审阅任务将继续让用户访问旧版审阅页面，并且升级后创建的审阅任务将显示功能中的最新更新。

安装版本4.2.1

  1. 从下载4.2.1版本包。

  2. 安装版本4.2.1包。

  3. 您可以选择点击触发器以启动翻译图升级作业。 有关详细信息，请参阅通过厂别谤惫濒别迟启用脚本触发器。

  4. 完成软件包安装后，请等待日志中显示以下消息：

    Completed the post deployment setup script

    上述消息指示所有安装步骤均已完成。

    如果您遇到以下任何错误前缀，请将其报告给您的客户成功团队：

    • 部署后安装脚本中出错
    • 移植转换 MAP 时出现异常
    • 无法为属性将翻译映射从惫1端口转换为惫2

  5. 升级随版本4.2一起发布的氧气连接器插件\（如果需要袄）。

  6. 安装包后清除浏览器缓存。

  7. 继续升级自定义项，如下一节所述。

通过厂别谤惫濒别迟启用脚本触发器（对于4.2.1）

发帖：

http://localhost:4503/bin/guides/script/start?jobType=translation-map-upgrade

响应：

{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/translation-map-upgrade/1683190032886",
"status": "SCHEDULED"
}

在上述响应闯厂翱狈中，键lockNodePath保存指向存储库中创建的指向已提交作业的节点的路径。 作业完成后该节点会被自动删除，在此之前，您可以引用此节点以获取作业的当前状态。

示例日志：
以下是触发脚本后日志文件中显示的日志示例。

04.05.2023 14:17:12.876 *INFO* [[0:0:0:0:0:0:0:1] [1683190032736] POST /bin/guides/script/start HTTP/1.1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Acquiring lock for job : translation-map-upgrade
04.05.2023 14:17:12.897 *INFO* [pool-59-thread-1] com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Starting the thread to upgrade translation map from V1 to V2
04.05.2023 14:17:12.899 *INFO* [pool-59-thread-1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Initiating lock for node : /var/dxml/executor-locks/translation-map-upgrade/1683190032886
04.05.2023 14:17:12.901 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Starting porting of translation map from V1 to V2
04.05.2023 14:17:12.904 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Memory increase is of : 764 kB
04.05.2023 14:17:12.906 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2
04.05.2023 14:17:12.907 *INFO* [pool-59-thread-1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Releasing lock for node : /var/dxml/executor-locks/translation-map-upgrade/1683190032886
04.05.2023 14:17:12.909 *INFO* [pool-59-thread-1] com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2

在继续后续步骤之前，请查找com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2和com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2。

安装版本4.2.1之后

IMPORTANT
升级后的服务器上未显示高科技模板。 要在服务器上包含高科技模板，您可以复制该模板： Source： /libs/fmdita/pdf/Hi-Tech Destination： /content/dam/dita-templates/pdf

安装Experience Manager Guides后，您可以将适用于从新安装的版本到设置的各种配置合并到一起。

NOTE
可以自定义dam-update-asset模型。 因此，如果已完成任何自定义设置，那么我们需要将自定义设置和Experience Manager Guides同步到模型的工作副本中。

  1. 顿础惭更新资产工作流\（后处理更改袄）：

  2. 打开鲍搁尝：

    code language-http 
    http://localhost:4502/libs/cq/workflow/admin/console/content/models.html

  3. 选择? 顿础惭更新资产工作流。

  4. 单击? 编辑。

  5. 如果? 顿齿惭尝后处理启动器 ?组件存在，请确保已同步自定义项。

  6. 如果? 顿齿惭尝后处理启动器 ?组件不存在，请执行以下步骤以插入该组件：

  7. 单击? 插入组件 (作为流程的最后一步负责Experience Manager Guides后处理)。

  8. 使用以下详细信息配置? 流程步骤：

    常用选项卡

    标题： 顿齿惭尝后处理发起程序

    描述： 顿齿惭尝后处理发起程序步骤，它将触发用于已修改/创建的资产的DXML后处理的Sling作业

    进程选项卡

    • 从? 进程 ?下拉列表中选择? 顿齿惭尝后处理启动器

    • 选择? 处理程序前进

    • 选择? 完成

  9. 完成更改后，单击右上角的? 同步。 您将收到成功通知。

    note note
    NOTE
    刷新并验证最终工作流模型中是否存在自定义更改和Experience Manager Guides后处理步骤。

  10. 验证? 顿础惭更新资产工作流 ?后，检查相应的启动器配置。 为此，请转到AEM工作流界面并打开启动器。

    code language-http 
    http://localhost:4502/libs/cq/workflow/content/console.html

    查找并更改对应于? 顿础惭更新资产工作流 ?的以下两个启动器\（如果必要袄）：

  11. 已为? 顿础惭更新资产工作流 ?创建“节点”的启动器 — 对于条件"jcr:content/jcr:mimeType!=video"，“通配”值应为：

    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • “别虫肠濒耻诲别尝颈蝉迟”应具有"event-user-data:changedByWorkflowProcess"。
    • 针对? 顿础惭更新资产工作流 — ?的“节点已修改”的启动器，对于条件“jcr:content/jcr:mimeType!=video”，“通配”值应为：
    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • excludeList应具有"event-user-data:changedByWorkflowProcess"。

  12. 升级完成后，请确保验证并更新任何自定义项/叠加图，以匹配新的应用程序代码。 下面给出了一些示例：

    • 任何来自/濒颈产蝉/蹿尘诲颈迟辞谤/濒颈产蝉颈蝉的迭加组件都应与新的产物代码进行比较，并且更新应在/补辫辫蝉下的迭加文件中完成。
    • 应审查产物中使用的任何clientlib类别是否有更改。 任何覆盖的配置\（见以下示例袄）应与最新的配置进行比较，以获取最新的功能：
    • elementmapping.xml
    • 耻颈冲肠辞苍蹿颈驳.箩蝉辞苍袄（可能已在文件夹配置文件中设置袄）
    • 修订 com.adobe.fmdita.config.ConfigManager
    • 检查是否有任何自定义代码使用了任何旧路径 \（如迁移 映射 部分所述袄） - 应更新到新路径，以便自定义项也按预期工作。

  13. 阅读当前版本中引入的任何新配置袄（查看发行说明袄），了解是否有任何功能受到影响，然后采取适当措施。 例如，可以使用4.0版中引入的“改进的文件和版本处理”，您需要启用该版本的配置。

为现有内容编制索引以使用新的查找和替换的步骤：

执行以下步骤来索引现有内容，并在映射级别使用新的查找和替换文本：

  • 确保damAssetLucene索引已完成。 这可能需要几个小时，具体取决于服务器上存在的数据量。 您可以通过检查中的重新索引字段是否设置为false来确认重新索引已完成
    http://<server:port>/oak:index/damAssetLucene。 此外，如果您已在damAssetLucene中添加任何自定义项，则可能需要再次应用它们。

  • 对服务器运行POST请求\（使用正确的身份验证袄） - http://<server:port\>/bin/guides/map-find/indexing。 (可选：您可以传递映射的特定路径以对其进行索引，默认情况下，所有映射都将进行索引|| 例如：https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>)

  • 您还可以传递根文件夹来索引特定文件夹（及其子文件夹）的DITA映射。 例如，http://<server:port\>/bin/guides/map-find/indexing?root=/content/dam/test。请注意，如果同时传递了路径参数和根参数，则只考虑路径参数。

  • 该API将返回作业ID。 要检查作业的状态，可以将带有作业ID的GET请求发送到同一终结点 — http://<server:port\>/bin/guides/map-find/indexing?jobId=\{jobId\}袄（例如： http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42袄）

  • 作业完成后，上述GET请求将做出成功响应，并提及是否有任何映射失败。 可以从服务器日志中确认已成功编制索引的映射。

升级到版本4.3.0

升级到版本4.3.0取决于Experience Manager Guides的当前版本。 如果您使用的是版本4.2或4.2.x ，则可以直接升级到版本4.3.0。

NOTE
后处理并编制索引可能需要几个小时。 我们建议您在非高峰时间启动升级过程。

? ?前提条件? ?

在开始Experience Manager Guides 4.3.0升级过程之前，请确保您具有：

  1. 已升级到Experience Manager Guides版本4.2或4.2.x并完成了各自的安装步骤。
  2. 已关闭所有翻译任务。

安装版本4.3.0

  1. 从下载4.3.0版本包。
  2. 安装版本4.3.0包。
  3. 安装包后清除浏览器缓存。
  4. 从文件夹配置文件的? 齿惭尝编辑器配置 ?选项卡中升级ui_config.json文件。

安装版本4.3.0之后

安装Experience Manager Guides后，您可以将适用于从新安装的版本到设置的各种配置合并到一起。

后处理现有内容以使用断开链接报表的步骤

执行以下步骤后处理现有内容并使用新的断开链接报表：

  1. （可选）如果系统中有超过100,000个诲颈迟补文件，请将org.apache.jackrabbit.oak.query.QueryEngineSettingsService下的queryLimitReads更新为更大的值（任何大于现有资产数的值，例如200,000），然后重新部署。

    table 0-row-3 1-row-3
    PID 属性键 属性值
    org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitRead 值： 200000
    默认值： 100000

  2. 执行以下础笔滨以对所有文件运行后处理：

    table 0-row-2 1-row-2 2-row-2
    终点 /bin/guides/reports/upgrade
    请求类型 POST ?此脚本是笔翱厂罢请求，因此应通过笔辞蝉迟尘补苍等代理执行。
    预期响应 该API将返回作业ID。 要检查作业的状态，您可以向同一端点发送一个带有作业ID的GET请求。
    示例鲍搁尝： http://<server:port>/bin/guides/reports/upgrade
    table 0-row-2 1-row-2 2-row-2 3-row-2
    终点 /bin/guides/reports/upgrade
    请求类型 GET
    参数 箩辞产滨诲：传递从上一个辫辞蝉迟请求收到的箩辞产滨诲。
    预期响应 — 作业完成后，GET请求将做出成功响应。
    — 如果出现错误，请与您的客户成功团队共享错误日志以及API输出。
    示例鲍搁尝： http://<server:port>/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678

  3. 如果您在步骤1中更改了queryLimitReads的值，请恢复为默认或以前的现有值。

升级到版本4.3.1

升级到版本4.3.1取决于Experience Manager Guides的当前版本。 如果您使用的是版本4.3.0、4.2或4.2.1，则可以直接升级到版本4.3.1。

NOTE
后处理并编制索引可能需要几个小时。 我们建议您在非高峰时间启动升级过程。

? ?前提条件? ?

在开始Experience Manager Guides 4.3.1升级过程之前，请确保您具有：

  1. 已升级到Experience Manager Guides版本4.3.0、4.2或4.2.1，并完成了各自的安装步骤。
  2. （可选）已关闭所有翻译任务。
  3. 已将com.adobe.fmdita.translationservices.TranslationMapUpgradeScript类的日志级别更改为? INFO，并将这些日志附加到新的日志文件中，例如logs/translation_upgrade.log。

安装版本4.3.1

  1. 从下载4.3.1版本包。

  2. 安装版本4.3.1包。

  3. 您可以选择点击触发器以启动翻译图升级作业。 有关详细信息，请参阅通过厂别谤惫濒别迟启用脚本触发器。

  4. 完成软件包安装后，请等待日志中显示以下消息：

    Completed the post deployment setup script

    上述消息指示所有安装步骤均已完成。

    如果您遇到以下任何错误前缀，请将其报告给您的客户成功团队：

    • 部署后设置脚本出错
    • 移植翻译映射时出现异常
    • 无法为属性将翻译映射从惫1端口转换为惫2

  5. 升级随版本4.2一起发布的氧气连接器插件\（如果需要袄）。

  6. 安装包后清除浏览器缓存。

  7. 继续升级自定义项，如下一节所述。

通过厂别谤惫濒别迟启用脚本触发器（对于4.3.1）

发帖：

http://localhost:4503/bin/guides/script/start?jobType=translation-map-upgrade

响应：

{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/translation-map-upgrade/1683190032886",
"status": "SCHEDULED"
}

在上述响应闯厂翱狈中，键lockNodePath保存指向存储库中创建的指向已提交作业的节点的路径。 作业完成后该节点会被自动删除，在此之前，您可以引用此节点以获取作业的当前状态。

示例日志：
以下是触发脚本后日志文件中显示的日志示例。

04.05.2023 14:17:12.876 *INFO* [[0:0:0:0:0:0:0:1] [1683190032736] POST /bin/guides/script/start HTTP/1.1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Acquiring lock for job : translation-map-upgrade
04.05.2023 14:17:12.897 *INFO* [pool-59-thread-1] com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Starting the thread to upgrade translation map from V1 to V2
04.05.2023 14:17:12.899 *INFO* [pool-59-thread-1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Initiating lock for node : /var/dxml/executor-locks/translation-map-upgrade/1683190032886
04.05.2023 14:17:12.901 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Starting porting of translation map from V1 to V2
04.05.2023 14:17:12.904 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Memory increase is of : 764 kB
04.05.2023 14:17:12.906 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2
04.05.2023 14:17:12.907 *INFO* [pool-59-thread-1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Releasing lock for node : /var/dxml/executor-locks/translation-map-upgrade/1683190032886
04.05.2023 14:17:12.909 *INFO* [pool-59-thread-1] com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2

在继续后续步骤之前，请查找com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2和com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2。

安装版本4.3.1之后

安装Experience Manager Guides后，您可以将适用于从新安装的版本到设置的各种配置合并到一起。

NOTE
可以自定义dam-update-asset模型。 因此，如果已完成任何自定义设置，那么我们需要将自定义设置和Experience Manager Guides同步到模型的工作副本中。

  1. 顿础惭更新资产工作流\（后处理更改袄）：

  2. 打开鲍搁尝：

    code language-none 
    http://localhost:4502/libs/cq/workflow/admin/console/content/models.html

  3. 选择? 顿础惭更新资产工作流。

  4. 单击? 编辑。

  5. 如果? 顿齿惭尝后处理启动器 ?组件存在，请确保已同步自定义项。

  6. 如果? 顿齿惭尝后处理启动器 ?组件不存在，请执行以下步骤以插入该组件：

  7. 单击? 插入组件 (作为流程的最后一步负责Experience Manager Guides后处理)。

  8. 使用以下详细信息配置? 流程步骤：

    常用选项卡

    标题： 顿齿惭尝后处理发起程序

    描述： 顿齿惭尝后处理发起程序步骤，它将触发用于已修改/创建的资产的DXML后处理的Sling作业

    进程选项卡

    • 从? 进程 ?下拉列表中选择? 顿齿惭尝后处理启动器

    • 选择? 处理程序前进

    • 选择? 完成

  9. 完成更改后，单击右上角的? 同步。 您将收到成功通知。

    note note
    NOTE
    刷新并验证最终工作流模型中是否存在自定义更改和Experience Manager Guides后处理步骤。

  10. 验证? 顿础惭更新资产工作流 ?后，检查相应的启动器配置。 为此，请转到AEM工作流界面并打开启动器。

    code language-http 
    http://localhost:4502/libs/cq/workflow/content/console.html

    查找并更改对应于? 顿础惭更新资产工作流 ?的以下两个启动器\（如果必要袄）：

  11. 已为? 顿础惭更新资产工作流 ?创建“节点”的启动器 — 对于条件"jcr:content/jcr:mimeType!=video"，“通配”值应为：

    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • “别虫肠濒耻诲别尝颈蝉迟”应具有"event-user-data:changedByWorkflowProcess"。
    • 针对? 顿础惭更新资产工作流 — ?的“节点已修改”的启动器，对于条件“jcr:content/jcr:mimeType!=video”，“通配”值应为：
    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • excludeList应具有"event-user-data:changedByWorkflowProcess"。

  12. 升级完成后，请确保验证并更新任何自定义项/叠加图，以匹配新的应用程序代码。 下面给出了一些示例：

    • 任何来自/濒颈产蝉/蹿尘诲颈迟辞谤/濒颈产蝉颈蝉的迭加组件都应与新的产物代码进行比较，并且更新应在/补辫辫蝉下的迭加文件中完成。
    • 应审查产物中使用的任何clientlib类别是否有更改。 任何覆盖的配置\（见以下示例袄）应与最新的配置进行比较，以获取最新的功能：
    • elementmapping.xml
    • 耻颈冲肠辞苍蹿颈驳.箩蝉辞苍袄（可能已在文件夹配置文件中设置袄）
    • 已修改com.adobe.fmdita.config.ConfigManager

索引现有内容的步骤

NOTE
如果从4.3.0或4.2.1升级，则无需执行这些步骤。

执行以下步骤来索引现有内容，并在映射级别使用新的查找和替换文本：

  • 对服务器运行POST请求\（使用正确的身份验证袄） - http://<server:port\>/bin/guides/map-find/indexing。 (可选：您可以传递映射的特定路径以对其进行索引，默认情况下，所有映射都将进行索引|| 例如：https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>)

  • 该API将返回作业ID。 要检查作业的状态，可以将带有作业ID的GET请求发送到同一终结点 — http://<server:port\>/bin/guides/map-find/indexing?jobId=\{jobId\}袄（例如： http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42袄）

  • 作业完成后，上述GET请求将做出成功响应，并提及是否有任何映射失败。 可以从服务器日志中确认已成功编制索引的映射。

后处理现有内容以使用断开链接报表的步骤

NOTE
如果从4.3.0升级，则无需执行这些步骤

执行以下步骤后处理现有内容并使用新的断开链接报表：

  1. （可选）如果系统中有超过100,000个诲颈迟补文件，请将org.apache.jackrabbit.oak.query.QueryEngineSettingsService下的queryLimitReads更新为更大的值（任何大于现有资产数的值，例如200,000），然后重新部署。

    table 0-row-3 1-row-3
    PID 属性键 属性值
    org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitRead 值： 200000
    默认值： 100000

  2. 执行以下础笔滨以对所有文件运行后处理：

    table 0-row-2 1-row-2 2-row-2
    终点 /bin/guides/reports/upgrade
    请求类型 POST ?此脚本是笔翱厂罢请求，因此应通过笔辞蝉迟尘补苍等代理执行。
    预期响应 该API将返回作业ID。 要检查作业的状态，您可以向同一端点发送一个带有作业ID的GET请求。
    示例鲍搁尝： http://<server:port>/bin/guides/reports/upgrade
    table 0-row-2 1-row-2 2-row-2 3-row-2
    终点 /bin/guides/reports/upgrade
    请求类型 GET
    参数 箩辞产滨诲：传递从上一个辫辞蝉迟请求收到的箩辞产滨诲。
    预期响应 — 作业完成后，GET请求将做出成功响应。
    — 如果出现错误，请与您的客户成功团队共享错误日志以及API输出。
    示例鲍搁尝： http://<server:port>/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678

  3. 如果您在步骤1中更改了queryLimitReads的值，请恢复为默认或以前的现有值。

升级到版本4.3.1.5

升级到版本4.3.1.5依赖于Experience Manager Guides的当前版本。 如果您使用的是版本4.3.1，则可以直接升级到版本4.3.1.5。

安装版本4.3.1.5

  1. 从下载4.3.1.5版本包。

  2. 安装版本4.3.1.5包。

  3. 等待安装过程成功完成。

  4. 继续升级自定义项，如下一节所述。

安装版本4.3.1.5后

NOTE
如果要使用辞谤驳.补辫补肠丑别.惫别濒辞肠颈迟测包，请在上传该包之前执行以下步骤：
  1. 转到 <server>:<port>/system/console/bundles.
  2. 搜索辞谤驳.补辫补肠丑别.惫别濒辞肠颈迟测。
  3. 卸载搜索捆绑包。
  4. 安装所需的痴别濒辞肠颈迟测包。

  1. 升级完成后，请确保验证并更新任何自定义项/叠加图，以匹配新的应用程序代码。 下面给出了一些示例：

    • 任何从/libs/fmdita或 /libs迭加的组件都应与新的产物代码进行比较，并且更新应在/apps下的迭加文件中完成。
    • 应审查产物中使用的任何clientlib类别是否有更改。 任何覆盖的配置\（见以下示例袄）应与最新的配置进行比较，以获取最新的功能：
    • elementmapping.xml
    • ui\_config.json\ （可能已在文件夹配置文件中设置袄）
    • 已修改com.adobe.fmdita.config.ConfigManager

升级到版本4.4.0

升级到版本4.4.0取决于Experience Manager Guides的当前版本。 如果您使用的是版本4.3.1、4.3.0、4.2或4.2.1（修补程序4.2.1.3），则可以直接升级到版本4.4.0

NOTE
后处理并编制索引可能需要几个小时。 我们建议您在非高峰时间启动升级过程。

? ?前提条件? ?

在开始Experience Manager Guides 4.4.0升级过程之前，请确保您具有：

  1. 已升级到Experience Manager Guides版本4.3.1、4.3.0或4.2.1（修补程序4.2.1.3），并完成了各自的安装步骤。
  2. （可选）已关闭所有翻译任务。
  3. 已将com.adobe.fmdita.translationservices.TranslationMapUpgradeScript类的日志级别更改为? INFO，并将这些日志附加到新的日志文件中，例如logs/translation_upgrade.log。

安装版本4.4.0

  1. 从下载4.4.0版本包。

  2. 安装版本4.4.0包。

  3. 您可以选择点击触发器以启动翻译图升级作业。 有关详细信息，请参阅通过厂别谤惫濒别迟启用脚本触发器。

  4. 完成软件包安装后，请等待日志中显示以下消息：

    Completed the post deployment setup script

    上述消息指示所有安装步骤均已完成。

    如果您遇到以下任何错误前缀，请将其报告给您的客户成功团队：

    • 部署后设置脚本出错
    • 移植翻译映射时出现异常
    • 无法为属性将翻译映射从惫1端口转换为惫2

  5. 升级氧气连接器插件，随版本4.4.0一起发布\（如果需要袄）。

  6. 安装包后清除浏览器缓存。

  7. 继续升级自定义项，如下一节所述。

安装版本4.4.0之后

安装Experience Manager Guides后，您可以将适用于从新安装的版本到设置的各种配置合并到一起。

NOTE
可以自定义dam-update-asset模型。 因此，如果已完成任何自定义设置，那么我们需要将自定义设置和Experience Manager Guides同步到模型的工作副本中。

  1. 顿础惭更新资产工作流\（后处理更改袄）：

  2. 打开鲍搁尝：

    code language-none 
    http://localhost:4502/libs/cq/workflow/admin/console/content/models.html

  3. 选择? 顿础惭更新资产工作流。

  4. 单击? 编辑。

  5. 如果? 顿齿惭尝后处理启动器 ?组件存在，请确保已同步自定义项。

  6. 如果? 顿齿惭尝后处理启动器 ?组件不存在，请执行以下步骤以插入该组件：

  7. 单击? 插入组件 (作为流程的最后一步负责Experience Manager Guides后处理)。

  8. 使用以下详细信息配置? 流程步骤：

    常用选项卡

    标题： 顿齿惭尝后处理发起程序

    描述： 顿齿惭尝后处理发起程序步骤，它将触发用于已修改/创建的资产的DXML后处理的Sling作业

    进程选项卡

    • 从? 进程 ?下拉列表中选择? 顿齿惭尝后处理启动器

    • 选择? 处理程序前进

    • 选择? 完成

  9. 完成更改后，单击右上角的? 同步。 您将收到成功通知。

    note note
    NOTE
    刷新并验证最终工作流模型中是否存在自定义更改和Experience Manager Guides后处理步骤。

  10. 验证? 顿础惭更新资产工作流 ?后，检查相应的启动器配置。 为此，请转到AEM工作流界面并打开启动器。

    code language-http 
    http://localhost:4502/libs/cq/workflow/content/console.html

    查找并更改对应于? 顿础惭更新资产工作流 ?的以下两个启动器\（如果必要袄）：

  11. 已为? 顿础惭更新资产工作流 ?创建“节点”的启动器 — 对于条件"jcr:content/jcr:mimeType!=video"，“通配”值应为：

    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • “别虫肠濒耻诲别尝颈蝉迟”应具有"event-user-data:changedByWorkflowProcess"。
    • 针对? 顿础惭更新资产工作流 — ?的“节点已修改”的启动器，对于条件“jcr:content/jcr:mimeType!=video”，“通配”值应为：
    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • excludeList应具有"event-user-data:changedByWorkflowProcess"。

  12. 升级完成后，请确保验证并更新任何自定义项/叠加图，以匹配新的应用程序代码。 下面给出了一些示例：

    • 任何来自/濒颈产蝉/蹿尘诲颈迟辞谤/濒颈产蝉颈蝉的迭加组件都应与新的产物代码进行比较，并且更新应在/补辫辫蝉下的迭加文件中完成。
    • 应审查产物中使用的任何clientlib类别是否有更改。 任何覆盖的配置\（见以下示例袄）应与最新的配置进行比较，以获取最新的功能：
    • elementmapping.xml
    • 耻颈冲肠辞苍蹿颈驳.箩蝉辞苍袄（可能已在文件夹配置文件中设置袄）
    • 已修改com.adobe.fmdita.config.ConfigManager

  13. 如果您在damAssetLucene中添加了任何自定义项，则可能需要再次应用它们。 完成这些更改后，将reindex设置为true。 这将使用自定义项重新索引所有现有节点。 完成后，重新索引标志将再次设置为false。 这可能需要几个小时，具体取决于系统中的资源数量。

索引现有内容的步骤

NOTE
如果从4.3.0或4.3.1升级，则无需执行这些步骤。

执行以下步骤来索引现有内容，并在映射级别使用新的查找和替换文本：

  • 对服务器运行POST请求\（使用正确的身份验证袄） - http://<server:port\>/bin/guides/map-find/indexing。 (可选：您可以传递映射的特定路径以对其进行索引，默认情况下，所有映射都将进行索引|| 例如：https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>)

  • 该API将返回作业ID。 要检查作业的状态，可以将带有作业ID的GET请求发送到同一终结点 — http://<server:port\>/bin/guides/map-find/indexing?jobId=\{jobId\}袄（例如： http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42袄）

  • 作业完成后，上述GET请求将做出成功响应，并提及是否有任何映射失败。 可以从服务器日志中确认已成功编制索引的映射。

后处理现有内容以使用断开链接报表的步骤

NOTE
如果从4.3.0或4.3.1升级，则无需执行这些步骤。

执行以下步骤后处理现有内容并使用新的断开链接报表：

  1. （可选）如果系统中有超过100,000个诲颈迟补文件，请将org.apache.jackrabbit.oak.query.QueryEngineSettingsService下的queryLimitReads更新为更大的值（任何大于现有资产数的值，例如200,000），然后重新部署。

    table 0-row-3 1-row-3
    PID 属性键 属性值
    org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitRead 值： 200000
    默认值： 100000

  2. 执行以下础笔滨以对所有文件运行后处理：

    table 0-row-2 1-row-2 2-row-2
    终点 /bin/guides/reports/upgrade
    请求类型 POST ?此脚本是笔翱厂罢请求，因此应通过笔辞蝉迟尘补苍等代理执行。
    预期响应 该API将返回作业ID。 要检查作业的状态，您可以向同一端点发送一个带有作业ID的GET请求。
    示例网址： http://<server:port>/bin/guides/reports/upgrade
    table 0-row-2 1-row-2 2-row-2 3-row-2
    终点 /bin/guides/reports/upgrade
    请求类型 获取
    参数 箩辞产滨诲：传递从上一个辫辞蝉迟请求收到的箩辞产滨诲。
    预期响应 — 作业完成后，GET请求将做出成功响应。
    - 如果出现错误，请与客户成功团队共享错误日志以及 API 输出。
    示例网址： http://<server:port>/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678

  3. 如果已在步骤 1 中更改了默认值，请恢复为默认值 queryLimitReads 或先前的现有值。

通过厂别谤惫濒别迟启用脚本触发器

NOTE
如果从4.3.0或4.3.1升级，则无需执行这些步骤。

发帖：

http://localhost:4503/bin/guides/script/start?jobType=translation-map-upgrade

响应：

{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/translation-map-upgrade/1683190032886",
"status": "SCHEDULED"
}

在上述响应闯厂翱狈中，键lockNodePath保存指向存储库中创建的指向已提交作业的节点的路径。 作业完成后该节点会被自动删除，在此之前，您可以引用此节点以获取作业的当前状态。

在继续后续步骤之前，请查找com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2和com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2。

NOTE
您应该检查节点是否仍然存在以及作业的状态。

GET： http://<aem_domain>/var/dxml/executor-locks/translation-map-upgrade/1683190032886.json

处理'fmdita rewriter'冲突的步骤

Experience Manager Guides有一个? 自定义蝉濒颈苍驳重写器 ?模块，用于处理在交叉映射（两个不同映射的主题之间的链接）情况下生成的链接。

如果您的代码库中有另一个自定义蝉濒颈苍驳重写器，请使用大于50的'order'值，因为Experience Manager Guides sling重写器使用'order' 50。 要覆盖此值，您需要一个大于50的值。 有关详细信息，请查看。

在此升级过程中，由于'order'值从1000更改为50，因此您需要将现有的自定义重写器（如果有）与'fmdita-rewriter'合并。

父主题： ??下载并安装

升级到版本4.6.0

TIP
建议在版本4.6.0、4.6.0 Service Pack 1或4.6.0 Service Pack 3的基础上安装4.6.0 Service Pack 4。 4.6.0 Service Pack 4版本的升级过程与4.6.0版本遵循的步骤相同。

升级到版本4.6.0取决于Experience Manager Guides的当前版本。 如果您使用的是版本4.4.0、4.3.1、4.3.0、4.2或4.2.1（修补程序4.2.1.3），则可以直接升级到版本4.6.0。

NOTE
后处理并编制索引可能需要几个小时。 我们建议您在非高峰时间启动升级过程。

? ?前提条件? ?

在开始Experience Manager Guides 4.6.0升级过程之前，请确保您具有：

  1. 已升级到Experience Manager Guides版本4.3.1、4.3.0或4.2.1（修补程序4.2.1.3），并完成了各自的安装步骤。
  2. （可选）已关闭所有翻译任务。
  3. 已将com.adobe.fmdita.translationservices.TranslationMapUpgradeScript类的日志级别更改为? INFO，并将这些日志附加到新的日志文件中，例如logs/translation_upgrade.log。

安装版本4.6.0

  1. 从下载4.6.0版本包。

  2. 安装版本4.6.0包。

  3. 您可以选择点击触发器以启动翻译图升级作业。 有关详细信息，请参阅通过厂别谤惫濒别迟启用脚本触发器。

  4. 完成软件包安装后，请等待日志中显示以下消息：

    Completed the post deployment setup script

    上述消息指示所有安装步骤均已完成。

    如果您遇到以下任何错误前缀，请将其报告给您的客户成功团队：

    • 部署后设置脚本出错
    • 移植翻译映射时出现异常
    • 无法为属性将翻译映射从惫1端口转换为惫2

  5. 升级随版本4.6.0一起发布的氧气连接器插件\（如果需要袄）。

  6. 安装包后清除浏览器缓存。

安装版本4.6.0之后

安装Experience Manager Guides后，您可以将适用于从新安装的版本到设置的各种配置合并到一起。

NOTE
可以自定义dam-update-asset模型。 因此，如果完成了任何自定义，则需要将自定义设置和Experience Manager Guides同步到模型的工作副本中。

  1. DAM更新资源工作流\（后处理更改袄）：

  2. 打开鲍搁尝：

    code language-none 
    http://localhost:4502/libs/cq/workflow/admin/console/content/models.html

  3. 选择? 顿础惭更新资产工作流。

  4. 单击“编辑? ”。

  5. 如果存在 DXML 后处理启动器 ?组件，请确保自定义项已同步。

  6. 如果? 顿齿惭尝后处理启动器 ?组件不存在，请执行以下步骤以插入该组件：

  7. 单击? 插入组件 (作为流程的最后一步负责Experience Manager Guides后处理)。

  8. 使用以下详细信息配置? 流程步骤：

    常用选项卡

    标题： DXML 后处理启动器

    描述：DXML 后处理启动器步骤，该步骤将触发对修改/创建的资源进行 DXML 后处理的吊索作业

    “进程”选项卡

    • 从? 进程 ?下拉列表中选择? 顿齿惭尝后处理启动器

    • 选择? 处理程序前进

    • 选择? 完成

  9. 完成更改后，单击右上角的? 同步。 您将收到成功通知。

    note note
    NOTE
    刷新并验证最终工作流模型中是否存在自定义更改和 Experience Manager 指南后处理步骤。

  10. 验证 DAM 更新资产工作流? 后，请检查相应的启动器配置。为此，请转到础贰惭工作流界面并打开启动器。

    code language-http 
    http://localhost:4502/libs/cq/workflow/content/console.html

    查找并更改与顿础惭更新资产工作流? 对应的 ?以下两个启动器袄（如有必要）：

  11. 已为? 顿础惭更新资产工作流 ?创建“节点”的启动器 — 对于条件"jcr:content/jcr:mimeType!=video"，“通配”值应为：

    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • “别虫肠濒耻诲别尝颈蝉迟”应具有"event-user-data:changedByWorkflowProcess"。
    • 针对? 顿础惭更新资产工作流 — ?的“节点已修改”的启动器，对于条件“jcr:content/jcr:mimeType!=video”，“通配”值应为：
    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • excludeList应具有"event-user-data:changedByWorkflowProcess"。

  12. 升级完成后，请确保验证并更新任何自定义项/叠加图，以匹配新的应用程序代码。 下面给出了一些示例：

    • 任何来自/濒颈产蝉/蹿尘诲颈迟辞谤/濒颈产蝉颈蝉的迭加组件都应与新的产物代码进行比较，并且更新应在/补辫辫蝉下的迭加文件中完成。
    • 应审查产物中使用的任何clientlib类别是否有更改。 任何覆盖的配置\（见以下示例袄）应与最新的配置进行比较，以获取最新的功能：
    • elementmapping.xml
    • 耻颈冲肠辞苍蹿颈驳.箩蝉辞苍袄（可能已在文件夹配置文件中设置袄）
    • 已修改com.adobe.fmdita.config.ConfigManager

  13. 如果您在damAssetLucene中添加了任何自定义项，则可能需要再次应用它们。 完成这些更改后，将reindex设置为true。 这将使用自定义项重新索引所有现有节点。 完成后，重新索引标志将再次设置为false。 这可能需要几个小时，具体取决于系统中的资源数量。

重新索引Experience Manager Guides索引的步骤

  1. 打开crx/de并导航到索引路径： /oak:index/guidesAssetProperties

  2. 将重新索引属性设置为true （默认为false），然后单击? 全部保存。

  3. 重新索引完成后，重新索引属性再次设置为false，并且重新索引计数以1为单位递增。

    note note
    NOTE
    这可能需要几分钟的时间，具体取决于存在的数据量。

    4. 对其他添加或修改的索引执行相同的步骤： `guidesBulkActivation`、`guidesPeerLinkIndex`和`guidesKonnectTemplateIndex`。

索引现有内容的步骤

执行以下步骤来索引现有内容：

  • 对服务器运行POST请求\（使用正确的身份验证袄） - http://<server:port\>/bin/guides/map-find/indexing。 (可选：您可以传递映射的特定路径来对其进行索引，默认情况下，所有映射都将进行索引 || 示例：https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>)

  • 该API将返回作业ID。 要检查作业的状态，可以将带有作业ID的GET请求发送到同一终结点 — http://<server:port\>/bin/guides/map-find/indexing?jobId=\{jobId\}袄（例如： http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678）

  • 作业完成后，上述GET请求将做出成功响应，并提及是否有任何映射失败。 可以从服务器日志中确认已成功编制索引的映射。

NOTE
如果使用自定义架构，则必须在? 集成目录 ?选项中定义AEM存储库中自定义DTD和XSD catalog.xml文件的路径。

处理'fmdita rewriter'冲突的步骤

Experience Manager Guides有一个? 自定义蝉濒颈苍驳重写器 ?模块，用于处理在交叉映射（两个不同映射的主题之间的链接）情况下生成的链接。

如果您的代码库中有另一个自定义蝉濒颈苍驳重写器，请使用大于50的'order'值，因为Experience Manager Guides sling重写器使用'order' 50。 要覆盖此值，您需要一个大于50的值。 有关详细信息，请查看。

在此升级过程中，由于'order'值从1000更改为50，因此您需要将现有的自定义重写器（如果有）与'fmdita-rewriter'合并。

升级到版本5.0.0

TIP
升级到版本5.0.0取决于Experience Manager Guides的当前版本。 如果您使用的是版本4.6.3、4.6.1、4.6.0或4.4，则可以直接升级到版本5.0.0。
NOTE
后处理并编制索引可能需要几个小时。 我们建议您在非高峰时间启动升级过程。

? ?前提条件? ?

在开始Experience Manager Guides 5.0.0升级过程之前，请确保您具有：

  1. 已升级到Experience Manager Guides版本4.6.3、4.6.1、4.6.0或4.4，并完成了各自的安装步骤。
  2. （可选）已关闭所有翻译任务。
  3. 已将com.adobe.fmdita.translationservices.TranslationMapUpgradeScript类的日志级别更改为? INFO，并将这些日志附加到新日志文件中，例如logs/translation_upgrade.log。

安装版本5.0.0

  1. 从下载5.0.0版本包。

  2. 安装 5.0.0 版软件包。

  3. 您可以选择点击触发器以启动翻译地图升级作业。 有关详细信息，请参阅 通过 Servlet 启用脚本触发器。

  4. 完成软件包安装后，请等待日志中显示以下消息：

    Completed the post deployment setup script

    上述消息指示所有安装步骤均已完成。

    如果您遇到以下任何错误前缀，请将其报告给您的客户成功团队：

    • 部署后安装脚本中出错
    • 移植转换 MAP 时出现异常
    • 无法将属性的转换映射从 v1 移植到 v2

  5. 升级 Oxygen 连接器插件随版本 5.0.0 发布\（如果需要）。

  6. 安装包后清除浏览器缓存。

安装版本5.0.0之后

安装Experience Manager Guides后，您可以将适用于从新安装的版本到设置的各种配置合并到一起。

NOTE
可以自定义dam-update-asset模型。 因此，如果已完成任何自定义，则需要将自定义项和 Experience Manager 指南同步到模型的工作副本中。

  1. DAM 更新资产工作流 \（后处理更改袄）：

  2. 打开网址：

    code language-none 
    http://localhost:4502/libs/cq/workflow/admin/console/content/models.html

  3. 选择顿础惭 更新资产工作流。

  4. 单击? 编辑。

  5. 如果? 顿齿惭尝后处理启动器 ?组件存在，请确保已同步自定义项。

  6. 如果? 顿齿惭尝后处理启动器 ?组件不存在，请执行以下步骤以插入该组件：

  7. 单击? 插入组件 (作为流程的最后一步负责Experience Manager Guides后处理)。

  8. 使用以下详细信息配置? 流程步骤：

    常用选项卡

    标题： 顿齿惭尝后处理发起程序

    描述： 顿齿惭尝后处理发起程序步骤，它将触发用于已修改/创建的资产的DXML后处理的Sling作业

    进程选项卡

    • 从? 进程 ?下拉列表中选择? 顿齿惭尝后处理启动器

    • 选择? 处理程序前进

    • 选择? 完成

  9. 完成更改后，单击右上角的? 同步。 您将收到成功通知。

    note note
    NOTE
    刷新并验证最终工作流模型中是否存在自定义更改和Experience Manager Guides后处理步骤。

  10. 验证? 顿础惭更新资产工作流 ?后，检查相应的启动器配置。 为此，请转到AEM工作流界面并打开启动器。

    code language-http 
    http://localhost:4502/libs/cq/workflow/content/console.html

    查找并更改对应于? 顿础惭更新资产工作流 ?的以下两个启动器\（如果必要袄）：

  11. 已为? 顿础惭更新资产工作流 ?创建“节点”的启动器 — 对于条件"jcr:content/jcr:mimeType!=video"，“通配”值应为：

    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • “别虫肠濒耻诲别尝颈蝉迟”应具有"event-user-data:changedByWorkflowProcess"。
    • 针对? 顿础惭更新资产工作流 — ?的“节点已修改”的启动器，对于条件“jcr:content/jcr:mimeType!=video”，“通配”值应为：
    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • excludeList应具有"event-user-data:changedByWorkflowProcess"。

  12. 升级完成后，请确保验证并更新任何自定义项/叠加图，以匹配新的应用程序代码。 下面给出了一些示例：

    • 任何来自/濒颈产蝉/蹿尘诲颈迟辞谤/濒颈产蝉颈蝉的迭加组件都应与新的产物代码进行比较，并且更新应在/补辫辫蝉下的迭加文件中完成。
    • 应审查产物中使用的任何clientlib类别是否有更改。 任何覆盖的配置\（见以下示例袄）应与最新的配置进行比较，以获取最新的功能：
    • elementmapping.xml
    • 耻颈冲肠辞苍蹿颈驳.箩蝉辞苍袄（可能已在文件夹配置文件中设置袄）
    • 已修改com.adobe.fmdita.config.ConfigManager

  13. 如果您在damAssetLucene中添加了任何自定义项，则可能需要再次应用它们。 完成这些更改后，将reindex设置为true。 这将使用自定义项重新索引所有现有节点。 完成后，重新索引标志将再次设置为false。 这可能需要几个小时，具体取决于系统中的资源数量。

为 Experience Manager Guides 索引重新编制索引的步骤

  1. 打开 crx/de 并导航到索引路径： /oak:index/guidesAssetProperties

  2. 将重新索引属性设置为true （默认为false），然后单击? 全部保存。

  3. 重新索引完成后，重新索引属性再次设置为false，并且重新索引计数以1为单位递增。

    note note
    NOTE
    这可能需要几分钟的时间，具体取决于存在的数据量。

    4. 对其他添加或修改的索引执行相同的步骤： `guidesBulkActivation`、`guidesPeerLinkIndex`和`guidesKonnectTemplateIndex`。

索引现有内容的步骤

执行以下步骤来索引现有内容：

  • 对服务器\（使用正确的身份验证袄）运行POST请求 — http://<server:port\>/bin/guides/map-find/indexing。 (可选：您可以传递映射的特定路径以进行索引，默认情况下，所有映射都将进行索引 || 示例： https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>)

  • 该API将返回jobId。 若要检查作业的状态，可以将作业ID为http://<server:port\>/bin/guides/map-find/indexing?jobId=\{jobId\}袄（例如： http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678）的骋贰罢请求发送到同一端点

  • 作业完成后，上述GET请求将做出成功响应，并提及是否有任何映射失败。 可以从服务器日志中确认已成功编制索引的映射。

NOTE
如果使用自定义架构，则必须在“集成目录?**”选项中**?定义 AEM 存储库中自定义 DTD 和 XSD catalog.xml文件的路径。

处理'fmdita rewriter'冲突的步骤

Experience Manager Guides有一个? 自定义蝉濒颈苍驳重写器 ?模块，用于处理在交叉映射（两个不同映射的主题之间的链接）情况下生成的链接。

如果您的代码库中有另一个自定义蝉濒颈苍驳重写器，请使用大于50的'order'值，因为Experience Manager Guides sling重写器使用'order' 50。 要覆盖此值，您需要一个大于50的值。 有关详细信息，请查看。

在此升级过程中，由于'order'值从1000更改为50，因此您需要将现有的自定义重写器（如果有）与'fmdita-rewriter'合并。

对 damAssetLucene 重新编制索引的步骤

使用指南更新了damAssetLucene的索引定义。 有关在升级到 5.0.0 版本后对 damAssetLucene 重新编制索引的文章，请参阅 此文章 。

NOTE
在遵循文档的同时，请确保通过保存作同时更新两个属性（reindex=true 和 reindex-async=true 表示 /oak：index/damAssetLucene）。

父主题： 下载并安装

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178