Configuring Screens Replication Agents

This following page describes how to configure Screens Replication Agents.

Objective

The Screens Replication Agent is responsible for bringing commands data such as, user, password, rebootSchedule, maxNumberOfLogFilesToKeep, and many more such values from publish to author. It is essential to configure this so that the author can show the device ping.

NOTE

To learn more about Screens Replication Agents, see Screens Replication Agents and Commands.

You must complete both the sections to complete the configuration for Screens Replication Agent:

  1. Enabling Users and Updating the Password
  2. Updating Settings for Screens Replication Agent

Enabling Users and Updating the Password

Follow the steps below to enable users and update the password for screens-receiver-user:

NOTE

For security reasons, it is recommended to avoid using the admin password for screens-receiver-user.

  1. Navigate to your AEM Author instance.

  2. Click on tools --> Security --> Users.

    image

  3. Search for screens-receiver-user.

  4. Select the screens-receiver-user and click on Enable from the action bar.

    image

  5. Click on OK to confirm.

    image

    Once you have enabled the user, you will see the screens-receiver-user as Enabled under the Status field.

    image

  6. Select the screens-receiver-user and click on Properties from the action bar.

    image

  7. Click on Change Password under Account settings from the Details tab, as shown in the figure below.

    image

  8. Enter a new password in the Change Password dialog box and click on Save.

    NOTE

    You should enter the existing admin user password in Your Password field.

    image

  9. Click on Save & Close.

  10. Select the screens-receiver-user and click on Activate from the action bar.

    image

  11. Click on OK to confirm.

    image

  12. Select the screens-receiver-user and click on Disable from the action bar.

    IMPORTANT

    Disabling screens-receiver-user only disables this user from the author instance and all the users in the publish instance still remain active. Do not click on Deactivate from the action bar, as deactivating will remove the user from the publish instances too.

    image

  13. Click on OK to confirm.

Updating Settings for Screens Replication Agent

Follow the section below to update settings in Screens Replication agent:

IMPORTANT

You must complete the following steps on ALL existing screens replication agents.

  1. Navigate to your AEM instance.

  2. Click on tools --> Deployment --> Replication.

    image

  3. Click on Agents on author.

    image

  4. Search for the all Screens Replication agents on author and click the link, as shown in the figure below.

    NOTE

    Search for all Screens Replication agents. The Screens Replication Agent name will include a letter S in the title.

    image

  5. Click on Edit.

    image

  6. Check Enabled from the Settings tab.

    image

  7. Navigate to Transport tab from the Agent Settings dialog box and update the User to screens-receiver-user and enter the same password that you set before in step (8) of Enabling Users and Updating the Password.

    image

  8. Click on OK.

  9. Once you complete the preceding steps, you can click on Test Connection to verify the connection.

    image

    If the connection verification is successful, you have completed configuring Screens Replication Agent.

On this page