'; Device Groups | Incognito Help
Array
(
    [0] => Array
        (
            [version] => 4.3
            [language] => en
        )

    [1] => Array
        (
            [version] => 4.2
            [language] => en
        )

    [2] => Array
        (
            [version] => 4.1
            [language] => en
        )

    [3] => Array
        (
            [version] => 4.0
            [language] => en
        )

    [4] => Array
        (
            [version] => 3.5
            [language] => en
        )

    [5] => Array
        (
            [version] => 3.4
            [language] => en
        )

    [6] => Array
        (
            [version] => 3.3
            [language] => en
        )

    [7] => Array
        (
            [version] => 3.2
            [language] => en
        )

    [8] => Array
        (
            [version] => 3.1
            [language] => en
        )

    [9] => Array
        (
            [version] => 4.2
            [language] => fr
        )

    [10] => Array
        (
            [version] => 4.2
            [language] => es
        )

)
Rel: acs/topics/acs/dita/device_groups
URI: acs/topics/device_groups
=== Tags ===
Array
(
    [820] => device groups
    [821] => device groups creating device groups
    [822] => device groups walled garden
)

=== Related ===
Array
(
)

Device Groups

Device groups are containers for organizing devices that share common parameters. For example, you can group devices by region, service type, or vendor type. Devices can belong to more than one device group.

You can base membership in a device group on the device ID (device-based) or other parameter value criteria (criteria-based). You can use device groups of either type for campaigns or to associate service classes for device provisioning. Use these settings to view and manage device groups.

To do this: Follow these steps:
View device group details Click a device group
Create a device group Click Add
Search for a device group Click the search symbol (), type search terms, and press Enter.
Search fields In table view, type search terms in any of the available column heading fields and press Enter.
Switch to table view/grid view Click the table symbol ()/grid symbol ().
Go back one screen Click the back symbol ().
Return to the main screen of the service Click the hub symbol ().
Note: The service searches for an exact match. If you need to search for a partial match, type a wildcard (*) for the character(s) you do not know.

Walled Garden Device Group

The Walled Garden device group is a pre-existing default container for newly discovered devices that are unknown to ACS.

Devices do not need to be removed from the Walled Garden device group in order to assign them to additional device groups.

Tip: You can create a service class with default parameter configurations and associate it to the Walled Garden device group. The service will apply these default parameters to devices as they discover to the service for the first time.

Creating Device Groups

Devices can either be statically assigned to device groups by device ID or dynamically assigned based on parameter and value query criteria. Use these settings to create device groups.

To do this: Follow these steps:
Save changes Click Save
Device Creates a device-based device group. You can assign specific devices to this group type using the ACS GUI, ACS Event Procedures, or scripts over the ACS North Bound API. Use this type of device group when you plan to associate a services class for monitoring parameters.
Criteria Creates a criteria-based device group. You can filter device membership for this group type using criteria. For example, OUI=0000CA. To create the criteria, you can use the AND and OR operators with any combination of these filters: OUI, PRODUCTCLASS, SUBSCRIBERID, SERIAL, MAC, FIRMWARE, IP, IMEI (LTE only), and IMSI (LTE only). A single criteria-based device group can support only AND or OR, not both in the same group.
Note: You can create and edit custom search terms using the CLI which you can then use as a filter. For further information, refer to the ACS CLI reference.

Device groups can represent anything that an operator can represent through either a device list or dynamic criteria described above. For example, you can create a device group that represents a region by populating it with all the devices in that region, as long as you have a way to identify the devices in the region.

You can create criteria-based device groups using device divisions. For example, assume the criterion 'OUI eq FFFFFF OR productclass eq MockDevice' matches the entire device population. When a user creates a campaign based on this device group, if the user is an:

  • administrator: the entire device population is matched

  • entity user: only the devices belonging to the division/entity match for the campaign

Note: Administrators can also create device groups based on division. For example, division eq Vancouver.

Device Group Details

Use these settings to view and manage the device group.

To do this: Follow these steps:
Save changes Click Save
View device memberships Click Devices
Add a device to the device group Click Devices. In the action bar, click Add, and select the device group(s). Then, in the action bar, click Add Selected.
Remove a device from the device group Click Devices, and select the device(s). Then, in the action bar, click Removed Selected.
View associated service classes Click Service Classes
Associate a service class to the device group Click Service Classes. In the action bar, click Add, and select the service class(es). Then, in the action bar, click Add Selected.
Remove a service class association from the device group Click Service Classes and select the service class(es). Then, in the action bar, click Removed Selected.
Delete this device group Click Delete.
Top