com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro 'next_previous_link3' is unknown.

Getting Device Details to Monitor Devices

WSO2 EMM stores and maintains the details of the registered devices so that the devices are monitored continuously. For this to happen the server has to constantly communicate with the device based on the configured frequency. This section describes how you can configure WSO2 EMM to get the device details and store it in the server databases for monitoring purposes.

Configuring WSO2 EMM to get device details and monitor devices

To achieve this, a task needs to run in the background of the WSO2 EMM server. This task will add operations to the devices, such as device_info, device_location and application_list. You need to configure WSO2 EMM to get this task running in the back ground as mentioned below:

  1. Open the cdm-config.xml that is in the <EMM_HOME>/repository/conf directory.
  2. Configure the fields under the <TaskConfiguration> tag.
    • Enable: Assign true as the value to get the task running on the WSO2 EMM server background.
    • Frequency: Define the frequency, at which the server should receive the details of the devices registered with WSO2 EMM.
    • Operations: Defines the Operations such as, device_info, device_location and application_list.

      If you wish to define more operations when retrieving the details of the devices, you can ad them under the operations tag.

    • Operation: The field used to define each operation for the task.
    • Name: The operation code. For example, the operation code to retrieve the device information is device_info.
    • RecurrentTimes: Define how often the operation should be added to the task. 
      Example: If you define the value as 5, it indicates that you need to add the operation at every 5th run of the task.
    Sample Configuration
    <TaskConfiguration>
       <Enable>true</Enable>
       <Frequency>30000</Frequency>
       <Operations>
          <Operation>
             <Name>DEVICE_INFO</Name>
             <RecurrentTimes>1</RecurrentTimes>
          </Operation>
          <Operation>
             <Name>APPLICATION_LIST</Name>
             <RecurrentTimes>5</RecurrentTimes>
          </Operation>
          <Operation>
             <Name>DEVICE_LOCATION</Name>
             <RecurrentTimes>1</RecurrentTimes>
          </Operation>
       </Operations>
    </TaskConfiguration>
     Click here for more information on adding an additional operation

    Add a new operation within the <operations> tag. 

    <TaskConfiguration>
       <Enable>true</Enable>
       <Frequency>30000</Frequency>
       <Operations>
          <Operation>
             <Name>{Define the operation code}</Name>
             <RecurrentTimes>{Integer}</RecurrentTimes>
          </Operation>
          <Operation>
             <Name>DEVICE_INFO</Name>
             <RecurrentTimes>1</RecurrentTimes>
          </Operation>
          <Operation>
             <Name>APPLICATION_LIST</Name>
             <RecurrentTimes>5</RecurrentTimes>
          </Operation>
          <Operation>
             <Name>DEVICE_LOCATION</Name>
             <RecurrentTimes>1</RecurrentTimes>
          </Operation>
       </Operations>
    </TaskConfiguration>

    Example: Adding an operation to get the device temperature.

    <TaskConfiguration>
       <Enable>true</Enable>
       <Frequency>30000</Frequency>
       <Operations>
          <Operation>
             <Name>DEVICE_TEMPERATURE</Name>
             <RecurrentTimes>3</RecurrentTimes>
          </Operation>
          <Operation>
             <Name>DEVICE_INFO</Name>
             <RecurrentTimes>1</RecurrentTimes>
          </Operation>
          <Operation>
             <Name>APPLICATION_LIST</Name>
             <RecurrentTimes>5</RecurrentTimes>
          </Operation>
          <Operation>
             <Name>DEVICE_LOCATION</Name>
             <RecurrentTimes>1</RecurrentTimes>
          </Operation>
       </Operations>
    </TaskConfiguration>

For more information on when and how the device communicates to get the pending operations and share the device details, see Getting Pending Android Device Operations.

com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro 'next_previous_links2' is unknown.