Scout Enterprise Management Suite

OU filter as a user-defined filter

You can filter by configured asset information of the devices to assign the matching devices to the appropriate OUs.

Filter rules with OU filter text

eLux® devices send an OU filter text field containing their device information to the Scout Server. You can use the OU filter text field in the Scout Report Generator and for the user-defined OU filter. It includes the following information:

Host name, OS name, OS version, serial number, supplier, device type, UEFI/BIOS, CPU speed, model, kernel version, flash type, flash size, RAM size, graphics, IDF name, MAC address.

  • A filter rule can contain one or more filter criteria.

  • A filter criterion consists of three parts:


    asset information string from OU filter text  logical operator =  value you want to filter by

Asset information elements:

ELUX_HOSTNAME=Alrin;

ELUX_OSNAME=eLux;

ELUX_OSVERSION=7.2507.0-3;

ELUX_SERIAL=7250O422542;

ELUX_SUPPLIER=WYSE;

ELUX_DEVICETYPE=ZQ Class;

ELUX_BIOS=V4.6.5.4 R1.15.0;

ELUX_CPU=3999;

ELUX_PRODUCT=ZQ Class;

ELUX_KERNEL=6.12.30unicon0;

ELUX_FLASH=16GB SATA Flash;

ELUX_FLASHSIZE=15272;

ELUX_MEMORY=8192;

ELUX_GRAPHICS=ATI AMD Radeon HD8330E;

ELUX_IDF=recovery.idf;

ELUX_MAC=7CD30A22D0AE

ELUX_IP=192.168.10.21

ELUX_NETMASK=255.255.255.0

ELUX_BROADCAST=192.168.10.255

ELUX_NETADDR=192.168.10.0

  • Use the logical operators AND and OR to link multiple filter criteria. Use capital letters for the operators.

  • Wildcards are not supported, but all matches will be found that begin with the specified string.

Examples filter rules:

[ELUX_OSNAME=eLux AND ELUX_OSVERSION=7.2507.0-3] [ELUX_DEVICETYPE=D3314-A1 OR ELUX_DEVICETYPE=ZQ Class]

Setting up a user-defined OU filter

  1. Click Options > Advanced options > Devices.

  2. Under New devices, select the Assign OU depending on OU filter option. If required, click Ico more to open the OU assignment dialog.

  3. Under Filter type, select User-defined filter (configured asset information).

  4. Create a new filter rule. [Edit the following fields:]

    Option Description
    Filter rule Create a filter rule consisting of one or more filter criteria, see above.
    Destination OU To browse the OU list, click Ico more and select the OU you want the specified devices to go.
  5. Click Add.

    The filter rule is displayed in the field below.

    Dia filter

  6. If required, add more filter rules and configure them. For further information, see Options for OU filter rules.

  7. From the list Non-matching devices, select where you want to keep the non-matching devices.

    Important:

    If you select [assigned to the default OU], all non-matching devices and even devices already assigned to other OUs are reassigned to the default OU.

  8. Review all active filter rules thoroughly to avoid unintentional assignments.

  9. Confirm with OK..

All active filter rules are processed in the specified order. On the next restart the matching devices are assigned to the OUs as defined by the OU user-defined filter. Any additionally defined subnet filter rules will not be taken into account.

Best practices

The asset information ELUX_IP corresponds to the (Peer) IP address.

When eLux endpoints connect through the Scout Cloud Gateway (SCG), the peer IP address reflects the SCG-assigned VPN IP (e.g.10.100.100.0 default range).

When devices connect directly to a Scout Server, the peer IP equals the endpoint’s local IP address

Notes The Scout IP address always reflects the endpoint’s local IP.

Example OU filter expression

If you want to assign eLux endpoints based on local network ranges (instead of SCG assigned VPN IPs), you can use a filter like this:

ELUX_NETADDR=192.168.168.0 AND ELUX_NETMASK=255.255.255.0

This will ensure OU assignments reflect the device’s true local subnet, instead of the SCG VPN IP range

Important If you are defining more complex and nested expressions by using brackets, these brackets - as control characters - need to be escaped.

Example with brackets and escaping:

\(ELUX_CPU=512 AND ELUX_MEMORY=1024\) OR \(ELUX_OSNAME=eLux AND ELUX_HOSTNAME=elux7-vm\)

OU filter as a user-defined filter