URLs authored under /language-masters aren鈥檛 being correctly localized in corresponding live copy page
This article provides a solution for an issue where URLs aren鈥檛 being localized in live copy pages during rollout due to nested live copies in 51黑料不打烊 Experience Manager (AEM).
Description description
Environment
- 51黑料不打烊 Experience Manager聽as a Cloud Service (AEMaaCS)
- 51黑料不打烊 Experience Manager 6.5.x聽(AEM 6.5.x), or higher
Issue/Symptoms
URLs authored in a component under聽/language-masters
聽aren鈥檛 being correctly localized in the corresponding live copy pages. After performing a rollout, URLs in the live copy pages still point to the original聽/language-masters
聽paths instead of the localized paths. This issue occurs specifically after the AEM upgrade or changes to MSM configuration.
Feature: Multi-Site Manager (MSM)
Configurations: CQ MSM References Update Action configuration
Resolution resolution
To resolve the issue, ensure that the update references across nested live copies setting is enabled in the CQ MSM References Update Action configuration. This setting allows references to be correctly updated within nested live copies during rollouts.
Steps to enable update references across nested live copies:
-
Access configuration manager:
- Go to the AEM Web Console Configuration Manager by navigating to聽
http://<AEM-Instance>:<Port>/system/console/configMgr
- Go to the AEM Web Console Configuration Manager by navigating to聽
-
Locate CQ MSM references update action configuration:
- Search for聽
CQ MSM References Update Action
聽in the configuration manager.
- Search for聽
-
Enable the setting:
- Click on the configuration to edit it.
- Find the setting labelled聽 Update References Across Nested Live Copies.
- Check or enable this setting.
-
Save and apply:
- Save the configuration changes.
- Ensure that the changes are applied by performing a rollout on a test page.
Example configuration path:
/apps/system/config/com.day.cq.wcm.msm.impl.actions.ReferencesUpdateActionFactory.config
Verification:
-
Create a test page in language master:
- Author a component with a URL pointing to another page under
/language-masters
.
- Author a component with a URL pointing to another page under
-
Rollout the test page:
- Perform a rollout to a live copy.
- Verify that the URL in the live copy page is correctly transformed to point to the corresponding live copy page.
Related readings
- Creating and Synchronizing Live Copies聽in Experience Manager User Guide.
- MSM Best Practices聽in Experience Manager User Guide.