文档AEM GuidesAEM Guides 文档

升级Adobe Experience Manager Guides id224MBE0M0XA

Last update: Wed Nov 06 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

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

您可以将当前版本的Experience Manager Guides升级到版本4.6.0 Service Pack 1：

  • 如果您使用的是版本4.6.0，则可以直接升级到4.6.0 Service Pack 1。
  • 如果您使用的是版本4.4、4.3.1或4.3.0 ，则需要在升级到4.6.0 Service Pack 1之前升级到4.6.0版。
  • 如果您使用的是版本4.2、4.2.1（修补程序4.2.1.3）、4.1或4.1.x，则需要在升级到版本4.6.0之前升级到版本4.4。
  • 如果您使用的是版本4.0，则需要先升级到版本4.2，然后再升级到版本4.3.x。
  • 如果您使用的是版本3.8.5，则在升级到版本4.2之前需要升级到版本4.0。
  • 如果您使用的版本低于3.8.5，请参阅Adobe Experience Manager Guides帮助PDF存档上提供的产品特定安装指南中的“升级Experience Manager Guides”部分。
NOTE
在升级Experience Manager Guides版本之前，必须安装AEM Service Pack。

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

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

从版本3.8.5升级到版本4.0 id2256DK003E1

如果您使用的是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的过程，请参阅Experience Manager Guides帮助PDF存档上提供的产品特定安装指南中的​ 升级Adobe 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. 下载升级脚本包。 为此，请在Adobe软件分发门户上搜索“XML Documentation解决方案4.0升级包”，该门户将下载zip文件。
  3. 通过包管理器将此包上传到AEM并安装此包。
  4. 安装升级软件包后，请按照相同的顺序运行以下给定脚本，然后按照给定说明操作：

检查升级兼容性API

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

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

系统数据迁移API

此API用于迁移​ 迁移映射 ​部分中提到的系统数据。

  1. 如果Check upgrade compatibility API失败，请勿执行此脚本\（不继续\）。
  2. 一旦Check upgrade compatibility API返回成功，您就可以运行升级脚本了。
终点
/bin/dxml/upgrade/3xto4x
请求类型
POST ​此脚本是一个POST请求，因此应通过Postman等代理执行。
预期响应
- 成功迁移后，您可以安装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. 从Adobe软件分发门户下载4.0版本包：

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

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

  4. 如果在AEM创作实例上配置了Dispatcher，请执行以下步骤：

    • 确保在Dispatcher规则中处理以下内容：
    • URL模式/home/users/*/preferences已列入白名单。
    • 不缓存URL模式/libs/cq/security/userinfo.json 。

  5. 清除Dispatcher缓存\（以清除缓存的任何clientlibs\）。

升级到版本4.2 id22A3F500SXA

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

如果您使用的是版本4.0、4.1或4.1.x，则可以直接升级到版本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. 从Adobe软件分发门户下载4.2版本包。

  2. 安装版本4.2包。

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

    Completed the post deployment setup script

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

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

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

  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. 打开URL：

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

  3. 选择​ DAM更新资产工作流。

  4. 单击​ 编辑。

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

  6. 如果​ DXML后处理启动器 ​组件不存在，请执行以下步骤以插入该组件：

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

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

    常用选项卡

    标题： DXML后处理发起程序

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

    进程选项卡

    • 从​ 进程 ​下拉列表中选择​ DXML后处理启动器

    • 选择​ 处理程序前进

    • 选择​ 完成

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

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

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

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

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

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

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

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

    • 任何来自/libs/fmditor/libsis的叠加组件都应与新的产品代码进行比较，并且更新应在/apps下的叠加文件中完成。
    • 应审查产品中使用的任何clientlib类别是否有更改。 任何覆盖的配置\（见以下示例\）应与最新的配置进行比较，以获取最新的功能：
    • elementmapping.xml
    • ui_config.json\（可能已在文件夹配置文件中设置\）
    • 已修改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 upgrade-version-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 Guides 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. 从Adobe软件分发门户下载4.2.1版本包。

  2. 安装版本4.2.1包。

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

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

    Completed the post deployment setup script

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

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

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

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

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

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

通过Servlet启用脚本触发器 enable-trigger-serverlet

POST：

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"
}

在上述响应JSON中，键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. DAM更新资产工作流\（后处理更改\）：

  2. 打开URL：

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

  3. 选择​ DAM更新资产工作流。

  4. 单击​ 编辑。

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

  6. 如果​ DXML后处理启动器 ​组件不存在，请执行以下步骤以插入该组件：

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

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

    常用选项卡

    标题： DXML后处理发起程序

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

    进程选项卡

    • 从​ 进程 ​下拉列表中选择​ DXML后处理启动器

    • 选择​ 处理程序前进

    • 选择​ 完成

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

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

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

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

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

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

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

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

    • 任何来自/libs/fmditor/libsis的叠加组件都应与新的产品代码进行比较，并且更新应在/apps下的叠加文件中完成。
    • 应审查产品中使用的任何clientlib类别是否有更改。 任何覆盖的配置\（见以下示例\）应与最新的配置进行比较，以获取最新的功能：
    • elementmapping.xml
    • ui_config.json\（可能已在文件夹配置文件中设置\）
    • 已修改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 upgrade-version-4-3

升级到版本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. 从Adobe软件分发门户下载4.3.0版本包。
  2. 安装版本4.3.0包。
  3. 安装包后清除浏览器缓存。
  4. 从文件夹配置文件的​ XML编辑器配置 ​选项卡中升级ui_config.json文件。

安装版本4.3.0之后

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

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

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

  1. （可选）如果系统中有超过100,000个dita文件，请将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. 执行以下API以对所有文件运行后处理：

    table 0-row-2 1-row-2 2-row-2
    终点 /bin/guides/reports/upgrade
    请求类型 POST ​此脚本是一个POST请求，因此应通过Postman等代理执行。
    预期响应 该API将返回作业ID。 要检查作业的状态，可以将带有作业ID的GET请求发送到同一端点。
    示例URL： 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
    参数 jobId：传递从上一个post请求收到的jobId。
    预期响应 — 作业完成后，GET请求将做出成功响应。
    — 如果出现错误，请与您的客户成功团队共享错误日志以及API输出。
    示例URL： 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 upgrade-version-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. 从Adobe软件分发门户下载4.3.1版本包。

  2. 安装版本4.3.1包。

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

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

    Completed the post deployment setup script

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

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

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

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

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

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

通过Servlet启用脚本触发器 enable-trigger-serverlet-4-3-1

POST：

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"
}

在上述响应JSON中，键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. DAM更新资产工作流\（后处理更改\）：

  2. 打开URL：

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

  3. 选择​ DAM更新资产工作流。

  4. 单击​ 编辑。

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

  6. 如果​ DXML后处理启动器 ​组件不存在，请执行以下步骤以插入该组件：

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

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

    常用选项卡

    标题： DXML后处理发起程序

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

    进程选项卡

    • 从​ 进程 ​下拉列表中选择​ DXML后处理启动器

    • 选择​ 处理程序前进

    • 选择​ 完成

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

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

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

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

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

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

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

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

    • 任何来自/libs/fmditor/libsis的叠加组件都应与新的产品代码进行比较，并且更新应在/apps下的叠加文件中完成。
    • 应审查产品中使用的任何clientlib类别是否有更改。 任何覆盖的配置\（见以下示例\）应与最新的配置进行比较，以获取最新的功能：
    • elementmapping.xml
    • ui_config.json\（可能已在文件夹配置文件中设置\）
    • 已修改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个dita文件，请将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. 执行以下API以对所有文件运行后处理：

    table 0-row-2 1-row-2 2-row-2
    终点 /bin/guides/reports/upgrade
    请求类型 POST ​此脚本是一个POST请求，因此应通过Postman等代理执行。
    预期响应 该API将返回作业ID。 要检查作业的状态，可以将带有作业ID的GET请求发送到同一端点。
    示例URL： 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
    参数 jobId：传递从上一个post请求收到的jobId。
    预期响应 — 作业完成后，GET请求将做出成功响应。
    — 如果出现错误，请与您的客户成功团队共享错误日志以及API输出。
    示例URL： 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 upgrade-version-4-3-1-5

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

安装版本4.3.1.5

  1. 从Adobe软件分发门户下载4.3.1.5版本包。

  2. 安装版本4.3.1.5包。

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

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

安装版本4.3.1.5之后

NOTE
如果要使用org.apache.velocity包，请在上传该包之前执行以下步骤：
  1. 转到 <server>:<port>/system/console/bundles.
  2. 搜索org.apache.velocity。
  3. 卸载搜索捆绑包。
  4. 安装所需的Velocity包。

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

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

升级到版本4.4.0 upgrade-version-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. 从Adobe软件分发门户下载4.4.0版本包。

  2. 安装版本4.4.0包。

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

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

    Completed the post deployment setup script

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

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

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

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

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

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

安装版本4.4.0之后

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

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

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

  2. 打开URL：

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

  3. 选择​ DAM更新资产工作流。

  4. 单击​ 编辑。

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

  6. 如果​ DXML后处理启动器 ​组件不存在，请执行以下步骤以插入该组件：

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

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

    常用选项卡

    标题： DXML后处理发起程序

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

    进程选项卡

    • 从​ 进程 ​下拉列表中选择​ DXML后处理启动器

    • 选择​ 处理程序前进

    • 选择​ 完成

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

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

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

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

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

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

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

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

    • 任何来自/libs/fmditor/libsis的叠加组件都应与新的产品代码进行比较，并且更新应在/apps下的叠加文件中完成。
    • 应审查产品中使用的任何clientlib类别是否有更改。 任何覆盖的配置\（见以下示例\）应与最新的配置进行比较，以获取最新的功能：
    • elementmapping.xml
    • ui_config.json\（可能已在文件夹配置文件中设置\）
    • 已修改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个dita文件，请将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. 执行以下API以对所有文件运行后处理：

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

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

通过Servlet启用脚本触发器 enable-trigger-serverlet-4-4-0

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

POST：

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"
}

在上述响应JSON中，键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有一个​ 自定义sling重写器 ​模块，用于处理在交叉映射（两个不同映射的主题之间的链接）情况下生成的链接。

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

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

父主题： ​​下载并安装

升级到版本4.6.0 upgrade-version-4-6-0

TIP
建议在版本4.6.0的基础上安装4.6.0 Service Pack 1 。4.6.0 Service Pack 1版本的升级过程与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. 从Adobe软件分发门户下载4.6.0版本包。

  2. 安装版本4.6.0包。

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

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

    Completed the post deployment setup script

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

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

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

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

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

安装版本4.6.0之后

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

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

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

  2. 打开URL：

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

  3. 选择​ DAM更新资产工作流。

  4. 单击​ 编辑。

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

  6. 如果​ DXML后处理启动器 ​组件不存在，请执行以下步骤以插入该组件：

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

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

    常用选项卡

    标题： DXML后处理发起程序

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

    进程选项卡

    • 从​ 进程 ​下拉列表中选择​ DXML后处理启动器

    • 选择​ 处理程序前进

    • 选择​ 完成

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

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

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

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

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

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

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

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

    • 任何来自/libs/fmditor/libsis的叠加组件都应与新的产品代码进行比较，并且更新应在/apps下的叠加文件中完成。
    • 应审查产品中使用的任何clientlib类别是否有更改。 任何覆盖的配置\（见以下示例\）应与最新的配置进行比较，以获取最新的功能：
    • elementmapping.xml
    • ui_config.json\（可能已在文件夹配置文件中设置\）
    • 已修改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有一个​ 自定义sling重写器 ​模块，用于处理在交叉映射（两个不同映射的主题之间的链接）情况下生成的链接。

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

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

父主题： 下载并安装

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