Skip to content

AEM Author Refresh Procedure

Step-by-step Procuedure (Author)

  1. The sync process may take 12 hours or more to complete. It's best to start over a weekend, say after the TarMk Maintenance.

a. On the TARGET machine, run /apps/local/VT/scripts/sync_datastores with the source and target instances specified. This can run with both SOURCE and TARGET running.

$ /apps/local/VT/scripts/sync_datastores prod pprd
2021-03-10T14:13:27 [INFO] Begin rsync job: /apps/mounts/cmsbinary/prod/datastore -> /apps/mounts/cmsbinary-nonprod/pprd/datastore
2021-03-10T14:13:27 [INFO] rsync -va /apps/mounts/cmsbinary/prod/datastore/ /apps/mounts/cmsbinary-nonprod/pprd/datastore/
2021-03-10T14:13:28 [INFO] Switching to log in /apps/cms/var/logs/sync_datastores.JxPTK
  1. Shut down TARGET instances
aem-sequencer stop
  1. Move (or remove) CRX

If you have the space available, rename /apps/cms/var/data/aem64-author/crx-quickstart, otherwise remove it.

  1. Untar latest production backup to TARGET
cd /apps/cms/var/data/aem64-author
tar xvf /apps/mounts/cmsbinary/prod_segmentstore/{cmsa-prod-01}/crx-quickstart-{date}.tar

Reconfigure the datastore

NOTE: This must be done before the instance is started!

  1. Modify /apps/cms/var/data/aem64-author/crx-quickstart/launchpad/config/org/apache/jackrabbit/oak/plugins/blob/datastore/FileDataStore.config with the proper path element. (It should be something like path="/apps/mounts/cmsbinary-nonprod/pprd/datastore")

Reconfigure SAML

The saml configuration lives in a file under com/adobe/granite/auth/saml/SamlAuthenticationHandler

[13:41:39] cms@cmsa-dvlp-01:aem64-author$ ls /apps/cms/var/data/aem64-author/crx-quickstart/launchpad/config/com/adobe/granite/auth/saml/SamlAuthenticat
ionHandler/
730eb122-abca-4454-a256-23c0b9e60e90.config

You should find a single config file under that directory, in this case 730eb122-abca-4454-a256-23c0b9e60e90.config. Edit this file, and set key serviceProviderEntityId with the FQDN of the TARGET server.

Start the Instance

  1. Start the AUTHOR instance on TARGET

aem-sequencer start Log in to CRX/DE (${TARGET}/crx/de/index.jsp eg. https://cmsa-dvlp-01.db.vt.edu/crx/de/index.jsp) as admin or into "CRX Explorer" (${TARGET}/crx/explorer/index.jsp) {remember this will have the SOURCEs password}

  • Go to Replication Agents on author (${TARGET}/miscadmin#/etc/replication/agents.author)

Replication Agents on author

  • Update or Deactivate Publish 02 and Publish 03 by double-clicking on the row.

    • Under Settings -> Edit (yes, edit is a button that changes when you hover over it).

    Publish 02

    • On the Transport tab, change the URI and Password

    Replication Agent Settings

    • The password is stored in Vault (See "Change Passwords" in the next step)

  • Update the passwords - Common Procedure to both instance types.

Instance Specific Configuration

Reconfigure Email

  • Log into the console (eg https://cmsa-pprd-01.db.vt.edu/system/console/configMgr)
  • Search for "Day CQ Link Externalizer"
  • Click on the pencil to edit.
  • Change all names from author.ensemble.vt.edu to (for example) cmsa-pprd-01.db.vt.edu
  • Save the changes.

Turn off Mail Service

  • Log into the console (eg https://cmsa-pprd-01.db.vt.edu/system/console/configMgr)

  • Search for "Day CQ Mail Service"

  • Note: this is different from the "Day CQ Mailing Service"

  • Click the pencil to edit.

  • Delete the configuration (and confirm).

Remove AWS CloudFront Cache Invalidation

On Non-production instances, we do not want to accidentally remove pages from the CF caches (re-rendering them can be expensive and lead to performance problems).

  • Open AEM Web Console Configuration
  • Search (Ctrl-F) for awscloudfrontserviceimpl.name
  • Remove all instances of edu.vt.cms.services.impl.AWSCloudFrontServiceImpl.AWS_CF_DOMAINS.name by clicking the - (minus) button after the field.
  • Save the changes.