Unknown macro: {next_previous_link3}
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »

In this tutorial, you are enrolling your Android device also known as Bring Your Own Device (BYOD) with WSO2 IoT Server. WSO2 IoTS supports devices on Android version 4.2.x to 7.0 (Android Jelly Beans to Nougat). If you want to enroll a Corporate-Owned, Personally Enabled (COPE) device, you need to configure WSO2 IoT Server is the system service application and install the configured Android agent on the device.

The following subsections explain how you can work with the Android device type:

 

Before you begin

  1. Android restricts third-party apps and less secure apps from being installed on the device. Therefore, you need to configure your device to disable this restriction as the WSO2 IoT Server device management agent application acts as a third-party application.

      Click here for more information on how to enable third party application installations.

    Follow the steps given below:

    1. Navigate to Setting > Security.
    2. Enable the Unknown sources option.
  2. Start WSO2 IoT Server by starting the two profiles in the following order:

    1. Start the core profile, which corresponds to the WSO2 Connected Device Management Framework (WSO2 CDMF) profile.

      cd <IOTS_HOME>/bin
      ./iot-server.sh

      The default port assigned for the core is 9443.

    2. Start the analytics profile, which corresponds to the WSO2 Data Analytics Server profile.

      ./analytics.sh

      The default port assigned for analytics is 9445.

Enroll an Android device

Follow the instructions given below to enroll an Android device:


Try it out

You can view device details and carry out operations on your device, after successfully enrolling it with WSO2 IoTS. Let's take a look at how you can do it:

  1. Navigate to the Device Management page to view all the created devices.

     Click here for more information on navigating to the Device Management page.
    1. Sign in to the Device Management console.
    2. Click the icon.
    3. Click Device Management.
  2. Click the view icon on the Android device you enrolled.
    Example:

  3. You will be directed to the device details page where you can view the device information and try out operations on a device.
    Example:

     View device details

    The details of each registered devices will be shown on separate pages within the Device page.


    Description
    Device Details

    The following device information will be retrieved automatically when you register with IoTS.

    DeviceThis shows the name the user has given his/her device (e.g., Kim's iPhone).
    OwnershipIndicates if the device is your own device/Bring Your Own Device (BYOD) or if it's a Corporate-Owned, Personally Enabled (COPE) device.
    For the device to be a COPE device, WSO2 IoT Server must be configured to use the system server application.
    StatusIndicates if the device is active, inactive or removed from WSO2 IoTS.
    Policy ComplianceIf your device does not comply with certain criteria in the enforced policy, the aspects in which your device is none compliant will be highlighted under this section.
    Device LocationProvide the location of your device.
    Installed ApplicationA list of all the applications that have been installed on your device and the memory consumption by each application will be listed under this section.
    Operation LogA list of all the operations that have been carried out by you and its current status.
    The operation logs shows the following statuses:
    • IN-PROGRESS - The operation is processing on the IoT server side and has not yet been delivered to the device.
    • PENDING - The operation is delivered to the device but the response from the device is pending.
    • COMPLETED - The operation is delivered to the device and the server has received a response back from the device.
    • ERROR - An error has occurred while carrying out the operation.
     Device operations

    The default operations that are available for Android devices are accessible for BYOD devices. The COPE devices can only carry out selected operations. If you want to enable the COPE devices to carry out more operations or if you want to limit BYOD devices from carrying out selected operations, you can do so via policies.

    Click on the operation you wish to carry out and provide the required details (if requested) to apply the selected operation on your device.

    OperationDescription
    Device Lock
    Ability to lock a device via the IoT Server.
    Device Unlock
    Ability to unlock the device via the IoT Server
    Location
    Ability to receive the location of the device.
    Mute Device
    Ability to enable the silent profile on a device via the IoT Server.
    Enterprise Wipe
    Ability to unregister a device from IoTS.
    Clear Password

    Ability to remove a device lock via the IoT Server.

    For Android 7.0 (API 24) and higher devices

    Clear password for device admins now apply to profile owners. Device admins can no longer clear passwords that are already set.

    Change Lock-Code

    Ability to change the provided passcode or lock-code.

    For Android 7.0 (API 24) and higher devices

    Change lock code for device admins now apply to profile owners. Device admins can no longer change lock codes that are already set. Device admins can still set a lock code, but only when the device has no password, PIN, or pattern.

    Ring
    Ability to ring the device via the IoT Server.
    Message
    Ability to send a message to the device via the IoT Server. The IoTS admin can use
    this device operation to send group messages or even private messages to the IoTS users.
    Wipe Data
    Ability to carry out a factory reset operation on your own device via the IoT Server. The user will have
    to provide the PIN, which he/she entered when registering to IoTS, to be able to wipe his/her device.
    Reboot
    Ability to reboot or restart your Android device.
    Upgrade Firmware

    Ability to upgrade the firmware to a newer version, over-the-air (OTA)

    For more information, see Upgrading Firmware of an Android Device.

    Logcat
    Ability to push logcat of the device to the analytics server. Logcat displays messages in real time and keeps a history so you can view the old messages.

    System service application operations

    WSO2 IoT Server provides a separate service application that can be signed by a firmware signing key and installed on the devices as a system application alongside the Android agent application. This enables you to have better control over the devices registered with WSO2 IoT Server. to install the system service application on the devices, you need to integrate it with WSO2 IoT Server. For more information, see Integrating the Android System Service Application.

    You can perform the following operations if you have the system service application installed on your Android device.

    • Schedule firmware upgrades on the device.
    • Reboot or restart your device.
    • Install and update applications in silent mode that is without the user's confirmation via the system service application.
    • Hard lock an Android device, where the Administrator permanently locks the device.
    • Unlock a device that was hard locked.
  • No labels