DocumentationAEMAEM Screens Guide

Device Registration

Last update: Mon Jul 12 2021 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Intermediate
  • Admin

The following page describes the device registration process in an AEM Screens project.

Registering a Device

The device registration process is done on 2 separate machines:

  • The actual device to be registered, for example your Signage Display
  • The AEM server that is used to register your device
NOTE
Once you download the latest Windows Player (.exe), from AEM 6.4 Player Downloads page, follow the steps on the player to complete the ad-hoc installation:
  1. Long-press on the top left corner to open the admin panel.
  2. Navigate to Configuration from the left action menu and enter the location address of the AEM instance in Server and click Save.
  3. Click on the Registration link from the left action menu and the steps below to complete the device registration process.

screen_shot_2018-11-26at12118pm

  1. On your device, start the AEM Screens Player. The registration UI is shown.

    screen_shot_2018-11-26at104230am

  2. In AEM, navigate to the Devices folder of your project.

    note note
    NOTE
    To get more information on creating a new project for Screens in the AEM dashboard, see Create and Manage Screens Project.

  3. Tap/click the Device Manager button in the action bar.

    screen_shot_2018-11-26at104702am

  4. Tap/click the Device Registration button on the top right.

    screen_shot_2018-11-26at104815am

  5. Select the required device (same as step 1) and tap/click Register Device.

    screen_shot_2018-11-26at105112am

  6. In AEM, wait for the device to send its registration code.

    screen_shot_2018-11-26at105150am

  7. In your device, check the Registration Code.

    screen_shot_2018-11-26at105227am

  8. If the Registration Code is the same on both machines, tap/click Validate button in AEM, as shown in the step (6).

  9. Set the desired name for the device, and click Register.

    screen_shot_2018-11-26at105357am

  10. Tap/click Finish to complete the registration process.

    screen_shot_2018-11-26at105456am

    note note
    NOTE
    The Register New allows you to register a new device.
    The Assign Display lets you directly add the device to a display.

    If you click Finish, you will need to assign the device to a display.

    screen_shot_2018-11-26at105740am

    note note
    NOTE
    To learn more about creating and managing a display for your Screens project, please refer to Creating and Managing Displays.

Assigning Device to a Display

If you have not assigned the device to a display, follow the steps below to assign your device to a display in your AEM Screens project:

  1. Select the device and click Assign Device from the action bar.

    screen_shot_2018-11-26at111026am

  2. Select the path of the display in Display/Device Config Path.

    screen_shot_2018-11-26at111252am

  3. Click Assign when you select the path.

    screen_shot_2018-11-26at111722am

  4. Click Finish once the device is assigned successfully, as shown in the figure below.

    screen_shot_2018-11-26at112041am

    Additionally, you can view the display dashboard on clicking Finish.

    screen_shot_2018-11-26at112154am

Searching a Device from the Device Manager

Once you have registered devices to your player, you can view all the devices from the Device Manager UI.

  1. Navigate to the Device Manager UI from your AEM Screens project, for instance, DemoScreens --> Devices.

  2. Select the Devices folder and click on Device Manager from the action bar.

    image

  3. The list of registered devices displays.

  4. If you have a long list of registered devices, you can now search using the search icon from the action bar

    image

    Or,

    Click / (forward slash) to invoke the search functionality.

    image

Limitations on Search Functionality

  • User will be able to search any word existing in the Device ID or Device Name.

    note note
    NOTE
    It is recommended that you create the device names in multiple words such as Boston Store Lobby rather than one single BostonStoreLobby.

  • If you create device names such as Boston Store Lobby, it allows to search for any word boston, store or lobby but if the device name is referred to as BostonStoreLobby searching boston will not show the results.

  • Wild card, * is supported for search. In case, you want to find all the devices with names starting with boston, you can use boston*.

  • If the device name is BostonStoreLobby and searching for boston will not return the result instead using boston* in your search criteria will return the result.

Limitations on Device Registration

System wide user password restrictions might cause failure in the device registration. The device registration uses a random generated password to create the device user.

If the password is restricted by the AuthorizableActionProvider configuration, creating the device user might fail.

NOTE
The current generated random password is composed of 36 ASCII characters, ranging from 33 - 122 (includes almost all special characters).
25.09.2016 16:54:03.140 *ERROR* [59.100.121.82 [1474844043109] POST /content/screens/svc/registration HTTP/1.1] com.adobe.cq.screens.device.registration.impl.RegistrationServlet Error during device registration
javax.jcr.nodetype.ConstraintViolationException: Password violates password constraint (^(?=.*\d).{7,9}$).
        at org.apache.jackrabbit.oak.spi.security.user.action.PasswordValidationAction.validatePassword(PasswordValidationAction.java:105)
        at org.apache.jackrabbit.oak.spi.security.user.action.PasswordValidationAction.onPasswordChange(PasswordValidationAction.java:76)
        at org.apache.jackrabbit.oak.security.user.UserManagerImpl.onPasswordChange(UserManagerImpl.java:308)

Additional Resources

To learn about AEM Screens Player, see AEM Screens Player.

recommendation-more-help
adce462a-f916-4dbe-9ab5-0b62cfb0f053