DocumentationAEM 6.4Communities Guide

ASRP - Adobe Storage Resource Provider asrp-adobe-storage-resource-provider

Last update: Wed May 03 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Admin
CAUTION
AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.

About ASRP about-asrp

When AEM Communities is configured to use ASRP as its common store, user generated content (UGC) is accessible from all author and publish instances without the need for synchronization nor replication.

See also Characteristics of SRP Options and Recommended Topologies.

Requirements requirements

An additional license is required for the use of ASRP.

To configure your AEM Communities site to use ASRP for UGC, contact your account representative for:

  • Data Center URL (address of the ASRP endpoint)
  • Consumer Key
  • Secret Key
  • Report Suite ID(s)

The consumer and secret keys are shared across all report suites for a company. There is one report suite per tenant.

Configuration configuration

Select ASRP select-asrp

The Storage Configuration console allows for the selection of the default storage configuration, which identifies which implementation of SRP to use.

On author:

  • From global navigation: Tools > Communities > Storage Configuration

chlimage_1-310

  • Select Adobe Storage Resource Provider (ASRP)

  • The following information comes from the provisioning process

    • Data Center URL

      Pull-down to select the production data center identified by your account representative

    • Default Report Suite

      Enter the name of the default report suite

    • Consumer Key

      Enter the consumer key

    • Secret

      Enter the secret key

  • Select Submit

Prepare the publish instances:

After submitting the configuration, test the connection:

  • Select Test Config
    for each author and publish instance, test the connection to the data center from the Storage Configuration console

  • Finally, ensure that the site URLs for profile data are routable from the Data Center by externalizing links.

Replicate the Crypto Key replicate-the-crypto-key

The Consumer Key and Secret Key are encrypted. In order for the keys to be encrypted/decrypted properly, the primary Granite Crypto key must be the same on all AEM instances.

Follow the instructions at Replicate the Crypto Key.

For correct profile and profile image links, be sure to properly Configure the Link Externalizer.

Be sure to set the domains to be URLs that are routable from the Data Center URL (ASRP endpoint).

Time Synchronization time-synchronization

In order for authentication with the ASRP endpoint to succeed, the machines running your hosted AEM Communities must be time synchronized, such as with the Network Time Protocol (NTP).

Publishing the Configuration publishing-the-configuration

ASRP must be identified as the common store on all author and publish instances.

To make the identical configuration available in the publish environment:

  • On author:

    • Navigate from main menu to Tools > Operations > Replication

    • Select Activate Tree

    • Start Path:

      • Browse to /etc/socialconfig/srpc/

    • Uncheck Only Modified

    • Select Activate

Upgrading from AEM 6.0 upgrading-from-aem

CAUTION
If you enable ASRP on a published community site, any UGC already stored in JCR will no longer be visible as there is no synchronization of data between on-premise storage and cloud storage.

AEM Communities Extension was previously introduced in AEM 6.0 social communities as a cloud service. As of AEM 6.1 Communities, no cloud configuration is necessary, simply select ASRP from the storage configuration console.

Due to the new storage structure, it is necessary to follow the upgrade instructions when upgrading from social communities to Communities.

Managing User Data managing-user-data

For information regarding users, user profiles and user groups, often entered in the publish environment, visit

Troubleshooting troubleshooting

UGC Disappears after Upgrade ugc-disappears-after-upgrade

If upgrading from an exisitng AEM 6.0 social community site, be sure to follow the upgrade instructions, else UGC will appear to be lost.

Authentication Errors authentication-errors

If receiving authentication errors against the Data Center URL, and the AEM error.log contains messages about stale timestamps, then verify that time synchronization is happening.

It is recommended to use a tool such as the Network Time Protocol (NTP) to time synchronize all AEM author and publish servers.

New Content Does Not Appear in Searches new-content-does-not-appear-in-searches

The Adobe cloud storage infrastructure uses eventual consistency to help achieve its scaling and performance goals. For this reason, new content is not instantly available and it may take several seconds for it to appear in search results.

While the interval affecting eventual consistency is monitored, please contact your account representative if it takes longer than a few seconds for new content to appear in searches.

UGC Not Visible in ASRP ugc-not-visible-in-asrp

Make sure ASRP has been configured to be the default provider by checking the configuration of the storage option. By default, the storage resource provider is JSRP, not ASRP.

On all author and publish AEM instances, revisit the Storage Configuration console or check the AEM repository:

  • In JCR, if /etc/socialconfig

    • Does not contain an srpc node, it means the storage provider is JSRP
    • If the srpc node exists and contains node defaultconfiguration, the defaultconfiguration’s properties should define ASRP to be the default provider
recommendation-more-help
5d37d7b0-a330-461b-814d-068612705ff6