This documentation is for WSO2 IoT Server 3.1.0. View the documentation for the latest release.
Grouping Devices - IoT Server 3.1.0 - WSO2 Documentation
||
Skip to end of metadata
Go to start of metadata

In this tutorial, you add your enrolled device or devices to a group. Grouping allows you to monitor and view device data of many devices in one go. This way you can view any abnormal behavior of the devices at a glance and take necessary actions to prevent it.

For example, sharing the devices in your lobby with your technician. For this purpose, you can create a group named lobby, add the devices in the lobby to the created group, and share the group with the technician. Now the technician is able to view the devices in the group, analyze the data gathered by the devices and come to a conclusion on the devices that need attention.

By default, WSO2 IoT Server has a group created named Bring Your Own Device (BYOD). It groups all the devices that are owned by device users.

Let's get started!


Add a device group

Start off by creating a new device group in WSO2 IoT Server:

  1. Click Add under GROUPS to add a new group.

  2. Provide the required details and click Add.

    • Group Name: Type the group name.

    • Description: Type a short description for the group.


Add devices to the group

Follow the steps given below to add the device/s to the group that you created:

  1. Click View under GROUPS.
  2. Click on the group you want to add the devices.
  3. Click Assign from My Devices.
  4. Click Select to select the devices you need to add to a group and click Add To Group.
  5. Select the group from the drop-down list and click Add device to group.

The groups that appear in the drop down list are the groups you create using add a device group.

To confirm that the devices were added to the group, go to the group management page, click on the device group, and check if the devices were added.


Sharing Groups with User Roles

You need to share the device group you created with other users so that they can access the device type too. 

Follows the steps given below:

  1. Sign in to the WSO2 IoTS device management console.

  2. Click View under GROUPS.
  3. Click the share icon on the group you want to share.
  4. Share the groups with user roles:
    • Share the group with existing user roles by entering the role name or names and clicking Share.
    • Need to create a new role and share the group? Click New Role and create the new role. Next, navigate to the group management page, click the share icon, enter the name of the role you just created, and click Share.
    • Want to share the group with more roles but want them to be merged as a new role? Enter the names of the roles you want to share the group, click New Role from Selection, and enter the name of the new role you are creating. Click Yes if you want to add new users to the role you just created or click No to finish sharing the group.

      The permissions of the roles you selected will be merged to create the permissions for the new role.

  5. If you need to add more user/s to the selected roles, select Yes in the confirmation message that appears and you are directed to the User Management screen. Else select No and you are done with sharing the group with the selected user roles. 


Update group details

Follow the steps given below, to update the group name or description.

  1. Click View under GROUPS.
  2. Click the  icon on your device group.
  3. Update the details and click Update.

Remove a group

Follow the steps given below, to delete a group from WSO2 IoT Server.

  1. Click View under GROUPS.
  2. Click the  icon.
  3. Click Yes, to confirm that you want to delete the group.
  • No labels