The current device classifier uses static XML file wherein you define checks, rules, and profiles based on MAC, DHCP, and
HTTP TLVs in wireless devices. The static XML file is converted to a text file and integrated with the image. When you enable
the device classified functionality using device classifier command, the contents in the text file is read and populated into the device classifier structures.
Note
|
The subsequent device classification is based on the populated device classifier structures.
|
Presently, if you find any unclassified devices in a controller, the static XML file is updated with the new rules, checks,
and profiles to get the devices classified. You will need to wait till the subsequent release as the static XML file is integrated
with the image and cannot be changed from the controller.
Workflow: To Classify Unclassified Devices with Dynamic XML File
-
The dynamic XML filename must be dc_user_profiles.xml .
Note
|
Files with any other name are not read and parsed even if they have the correct schema.
|
-
Copy the sample dynamic XML file to your system using the following command:
copy {flash:} {ftp: | tftp:}
-
Provide a new version for the dynamic XML file:
<Version>1.1</Version>
-
Edit the dynamic XML file with the new rules, checks, and profiles as defined in the schema after examining the TLV values
of the unclassified devices.
Note
|
To check the TLV values, use the following command:
show wireless client mac-address mac detail
|
-
Copy the dynamic XML file to the device flash using the following command:
copy {ftp: | tftp:} {flash:}
Once the file is copied to the device file system, the newly connected clients are classified according to the new profiles
defined in the dynamic XML file. You need to reconnect the already unclassified devices to send the DHCP and HTTP TLVs, and
then classify them according to the new profiles. The already classified devices remain as classified until they are reconnected.
Dynamic XML File
The device classifier dynamic XML support enhancement addresses this problem for device classifier dynamic XML file.
With the introduction of dynamic XML support, you are provided with a new dynamic device classifier XML file support.
Note
|
The filename will be dc_user_profiles.xml and you can update the dynamic XML file with the new rules, checks, and profiles based on the devices connected and according
to the provided schema.You can then copy this XML file to the device file system to enable better device classification without
the need to upgrade the device to a new release.
|
The static XML file support is still available. If a device is connected, its TLVs are checked with the dynamic XML user profiles
first and if it matches it is classified as per that profile. If you search for non-static XML profiles and if it matches
it is classified as per that profile.
Note
|
The sample dynamic XML file is available in the device at flash:dc_profile_dir/.. You can consider the following sample dynamic XML file schema and copy this to your system using copy {flash:} {ftp: | tftp:} command, and append or replace the content with your own profiles, rules, and checks:
<?xml version="1.0" encoding="UTF-8"?>
<DeviceList>
<CopyRight>Copyright (c) 2021-2022 by Cisco Systems, Inc. All rights reserved.</CopyRight>
<Version>1.0</Version>
<Device>
<DeviceType>Sample_Profile_1</DeviceType>
<RuleName>Sample_Rule_1</RuleName>
<RuleOperator>OR</RuleOperator>
<RuleCertaintyMetric>20</RuleCertaintyMetric>
<Check>
<Protocol>DHCP</Protocol>
<TLV-Type>12</TLV-Type>
<TLV-Value-Type>String</TLV-Value-Type>
<TLV-Value>test</TLV-Value>
</Check>
<Check>
<Protocol>HTTP</Protocol>
<TLV-Type>3</TLV-Type>
<TLV-Value-Type>Integer</TLV-Value-Type>
<TLV-Value>23</TLV-Value>
</Check>
</Device>
<Device>
<DeviceType>Sample_Profile_2</DeviceType>
<RuleName>Sample_Rule_2</RuleName>
<RuleOperator>AND</RuleOperator>
<RuleCertaintyMetric>30</RuleCertaintyMetric>
<Check>
<Protocol>DHCP</Protocol>
<TLV-Type>12</TLV-Type>
<TLV-Value-Type></TLV-Value-Type>
<TLV-Value>test</TLV-Value>
</Check>
<Check>
<Protocol>MAC</Protocol>
<TLV-Value-Type>String</TLV-Value-Type>
<TLV-Value>Cisco</TLV-Value>
</Check>
</Device>
</DeviceList>
Each time you copy a new dynamic XML file, the older user profiles are erased completely and newer profiles are populated.
After copying the dynamic XML files, only the newly connected clients are classified based on the new dynamic file whereas
the already classified devices still remain as classified with older profiles until they are reconnected.
|
MAC OUI-Based Profiles
The Organizational Unique Identifier (OUI) of a MAC address is part of the MAC address that identifies the vendor of the network
adapter. The OUI is the first three bytes of the six-byte field and administered by the IEEE.
To define MAC-based profiles in the dynamic XML file, see https://standards-oui.ieee.org/.
For example, if the Client MAC address is 7035.094d.000, then OUI is 0x703509. You can find the corresponding entry in the https://standards-oui.ieee.org/ as follows:
70-35-09 (hex) Cisco Systems, Inc
703509 (base 16) Cisco Systems, Inc
80 West Tasman Drive
San Jose CA 94568
US
Feedback