Tracking the status of the Android OEMConfig profile
The administrator can track the status of the OEMConfig profile that is applied to the device on IBM® MaaS360® Portal.
IBM MaaS360 uses the app feedback channel to track the status of OEM configurations. This feedback enables administrators to identify issues and make necessary changes before redeploying the app settings. The administrator can access all OEM configurations that are sent by the device, including filtering and sorting capabilities, and the ability to view the status of the OEMConfig profile at a parameter level.
- The tracking of feedback status is based on the response that is received from the parameter or a set of parameters that are configured for the device, which varies across different OEMs.
- The dashboard is displayed for non-federated customers only.
- From the IBM MaaS360 Portal Home page, select . The Android OEMConfig page is displayed.
- Click View option from the open and close list of options for any device. Go to the Assignments tab and click View Details. The Configuration status dashboard is displayed.
- Select . The Android OEMConfig page is displayed.
- Click Track status from the open and close list of options for any device. The Configuration status dashboard is displayed.
- Select .
- The distributed apps details page is displayed. Go to App configuration and select View Details. The Configuration status dashboard is displayed.
Enabling the App Configuration settings
To track the configuration status report, the administrator must select the Enable feedback for app configuration checkbox. If the configuration setting is enabled to receive the feedback, the devices can share the distributed App configuration or OEMConfig status. To know more about enabling the feedback for app configurations, see Configuring app settings in the IBM MaaS360 Portal.
Viewing the Configuration status dashboard
- Search or Sorting: You can perform search or sort operation for actions based on criteria such as configuration parameter name.
- Filter: You can filter the actions based on configuration status (failure, successful, or feedback pending).
The following image displays the overall status of the configuration at a parameter level.
The following table explains the configuration profile status on a device.
| Field | Description | Additional Information |
|---|---|---|
| Device in Scope | Number of devices the configuration profiles was distributed to | Different configuration settings are assigned to the devices. The devices send the feedback stating that whether the configuration is successful, failed, or feedback pending. |
| Configuration | Number of configurations set in the profile | The configurations are set at a parameter level and the status report is generated at each parameter level. The path of the configuration parameter is also displayed. |
| Status on Device | Successful | Number of configurations that are applied successfully to all devices. |
| Failed | Number of configurations that are not applied on one or more devices. For example, if a attribute is not configured correctly to the device, it gives a failed status. The administrator must check the error message on the Message tab to edit the configuration profile and republish the configuration. | |
| Feedback Pending | Number of configurations for which feedback is not sent by the devices. For example, if the feedback is pending, the administrator can check the Device refreshed on field to validate the device login time stamp. |
View the Configuration status on the device dashboard
Expand the accordion next to the Status on devices field to view the status of the device configuration at the parameter level. The device dashboard displays the number of devices to which the parameter sends the feedback along with status message.
The Configuration status on device dashboard displays two tabs: Devices and Messages.
The following table explains the corresponding tab under the Devices tab.
| Field | Description |
|---|---|
| Device | The device name for which the configuration is set. |
| Configuration Status | The status of the configuration whether it is failed, successful, or feedback pending. |
| Message | The message received from the app on the status of the feedback. For example, if the status is failed, then an error occurred in the key message is displayed for the messages column in the dashboard. |
| Status updated on | The date on which the status of the device is updated. |
| Device refreshed on | The date and time of the device status is refreshed. |
The Messages tab displays the details of the status that are reported by the app. For example, if a device reports both successful and failed status, the messages tab displays the number of devices that are configured successfully and the number of devices that are failed.
| Field | Description |
|---|---|
| Message type | The type of message that is displayed for the device configuration. For example, if the status is successful, then the message type shows info. If the status is failed, then the message type shows error. |
| Message | The status message of the configuration whether it is failed, successful, or feedback pending. |
| No of devices | The number of devices for which the message is displayed. Click the device count to go to the Devices tab filtered on that particular message. |
Viewing the configuration status at a device level
Click View overall status for this device
icon to go to
the Configuration status on device dashboard.
The dashboard displays the aggregated status of the device. For example, if there are multiple configurations set for a device, in this dashboard, the different parameters that were sent to the device and the status report of the individual parameters for that device is displayed.
You can filter the actions based on criteria such as status of the individual parameter whether the configuration is failed, successful, or pending feedback. You can also perform search for actions based on criteria such as parameter name.
- Configuration: The configuration name along with the path.
- Status: The status of the individual key that is set for the device.
- Message: The status message of the configuration whether it is failed, successful, or feedback is pending. For example, if for a device multiple config are assigned, the message for each config at a parameter level is displayed.
- Status updated on: The date and time period on which the status of the device is updated.
Device actions for OEMConfig status
When new configuration changes are applied to an app, MaaS360 retrieves the configuration feedback and displays the status across all devices and applications. The feedback allows administrators to detect errors and troubleshoot any issues. You can use the device-level action Enable App Config Status to enable the app config feedback for the device.
Selecting Disable App Config Status disables the app config feedback for the device and doesn’t display the status for the app config or OEMConfig.
The configuration feedback is not immediately available when the configuration is deployed to devices. MaaS360 takes up to 24 hours to retrieve feedback from Google. You can use the device-level action Force App Config Feedback to request immediate retrieval of app configuration feedback. This action is allowed only three times for a device over a period of 24 hours. To know more about enabling, disabling, and force config feedback, see Android device actions.