Troubleshoot issues in parallel publishing to Brand Portal

Brand Portal is configured with AEM Assets to have approved brand assets seamlessly ingested (or published) from AEM Assets author instance. Once configured, AEM Author uses a replication agent to replicate the selected asset(s) to Brand Portal cloud service for approved usage by Brand Portal users. Multiple replication agents are used AEM 6.2 SP1-CFP5, AEM CFP, and onwards to allow high-speed parallel publishing.


Adobe recommends upgrading to AEM to ensure that AEM Assets Brand Portal is successfully configured with AEM Assets. A limitation in AEM 6.4 gives an error while configuring AEM Assets with Brand Portal and replication fails.

On configuring cloud service for brand portal under /etc/cloudservice, all necessary users and token are auto-generated and saved in the repository. Cloud service configuration is created, service users required for replication and replication agents to replicate content are also created. This creates four replication agents. So when you publish numerous assets from AEM to Brand Portal, these are queued and distributed among these replication agents through Round Robin.

However, publishing can fail intermittently due to- large sling jobs, increased Network and Disk I/O on AEM Author instance, or slowed performance of AEM Author instance. It is, therefore, advised to test the connection with the replication agent(s) prior to begin publishing.

Troubleshoot failures in first time publishing: validating your publish configuration

To validate your publish configurations:

  1. Check the error logs
  2. Check whether the replication agent is created
  3. Test connection

Tail logs while creating Cloud Service

Check tail logs. Check whether the replication agent is created or not. If the replication agent creation fails, edit the cloud service by making minor changes in cloud service. Validate and check again whether the replication agent is created or not. If not, re-edit the service.

If on repeatedly editing the cloud service it is not configured properly, report a daycare ticket.

Test connection with replication agents

View log, if errors are found in replication log:

  1. Contact Adobe Support.

  2. Retry clean-up and create publish configuration again.

Clean-up existing Brand Portal publish configurations

Most of the times when publishing is not working, the reason can be that the user who is publishing (for example: mac-<tenantid>-replication doesn’t have the latest private key, and hence publish fails with “401 unauthorized” error and no other error is reported in replication agent logs. You might want to avoid troubleshooting and create a new configuration instead. For the new configuration to work properly, clean up the following from AEM author setup:

  1. Go to localhost:4502/crx/de/ (considering you are running author instance on localhost:4502:
    i. delete /etc/replication/
    ii. delete /etc/cloudservices/mediaportal/<config_name>

  2. Go to localhost:4502/useradmin:
    i. search for user mac-<tenantid>replication
    ii. delete this user

Now the system is all cleaned up. Now you can attempt creating a new cloudservice config and still use the already existing JWT application in There is no need to create a new application, rather just the public key needs to be updated from the newly created cloud config.

Developer connection JWT application tenant visibility issue

If on, all the orgs (tenants) for which the current users hold system administrator are listed. If you don’t find the org name here or you can’t create an application for a required tenant here, please check if you have sufficient (system administrator) rights to do this.

There is one known issue on this user interface that for any tenant only top 10 applications are visible. When you create the application, stay on that page and bookmark the URL. You don’t need to go to the listing page of the application and find the application that you created. You can hit this bookmarked URL directly and update/delete the application whenever needed.

The JWT application might not be listed appropriately. It is, therefore, advised to note/bookmark the URL while creating JWT application.

Running Configuration stops working

If a replication agent (which was publishing to brand portal just fine) stops processing publish jobs, check replication logs. AEM has auto-retry built-in, so if a particular asset publish fails, it is retried automatically. If there is some intermittent issue like network error, it might succeed during re-try.

If there are continuous publish failures and queue is blocked, then you should check test connection and try to solve the errors that are being reported.

Based on the errors, you are advised to log a support ticket, so that Brand Portal engineering team can help you resolve issues.

Configure replication agents to avoid connection timeout error

Usually the publishing job fails with a timeout error if there are multiple pending requests in the replication queue. To resolve this issue, ensure that the replication agents are configured to avoid timeout.

Perform the following steps to configure the replication agents:

  1. Log in to your AEM Assets author instance.
  2. From the Tools panel, navigate to Deployment > Replication.
  3. In the Replication page, click Agents on author. You can see the four replication agents of your Brand Portal tenant.
  4. Click the replication agent URL to open the agent details.
  5. Click Edit to modify the replication agent settings.
  6. In Agent Settings , click the Extended tab.
  7. Select the Close Connection check box.
  8. Repeat steps 4 through 7 to configure all the four replication agents.
  9. Restart the server.

On this page