ASRP - Adobe Storage Resource Provider

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

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

Select ASRP

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

On AEM Author instance:

• From global navigation, navigate to Tools > Communities > Storage Configuration and 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.
• Select Submit.

Prepare the publish instances:

• Replicate the crypto key
• Replicate the configuration

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.

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

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.

Externalize Links

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

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

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 AEM Author instance:

• Navigate from main menu to Tools > Operations > Replication
• Select Activate Tree
• Start Path: browse to /conf/global/settings/communities/srpc/
• Deselect Only Modified
• Select Activate

Upgrading from AEM 6.0

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

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

• User Synchronization
• Managing Users and User Groups

Troubleshooting

UGC Disappears after Upgrade

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

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.

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

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

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

UGC Not Visible in ASRP

Make sure that the 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 /conf/global/settings/communities:

• Does not contain an srpc node, it means that the storage provider is JSRP.
• If the srpc node exists and contains defaultconfiguration node, the defaultconfiguration’s properties define ASRP to be the default provider.