MgsDHCP: Retrieve location list from DHCP server options
IT Asset Management
(Cloud)
Prerequisites
- This algorithm relies on you having specified a known option number with a prioritized list of inventory beacons on each DHCP scope in your enterprise.
- Values may be distinct in each scope.
- The inventory beacons listed in the value should be those that you wish inventory devices within the DHCP scope to access. For instructions on how to configure the DHCP server option, see the next page.
This algorithm prioritizes inventory beacons according to lists of inventory beacons that you have specified in a DHCP property. Whenever the installation or upload components need to prioritize distribution or reporting locations, NetSelector sends a DHCP broadcast requesting the value of the DHCP property corresponding to the option number specified as a parameter to the algorithm. The value returns a list of one or more inventory beacons in priority order.
where:
- limit is an optional integer setting the maximum number of inventory beacons to which priorities will be assigned by this algorithm. If limit is not specified (empty), all servers listed in the DHCP server option will be prioritized.
- discardForeign is an optional boolean represented by the
case-insensitive strings
true
orfalse
. The default isfalse
.- If
false
or omitted, the algorithm assigns a lower priority to inventory beacons that are not prioritized by the algorithm. - If
true
, the algorithm sets the priorities of any inventory beacons that are not prioritized by the algorithm to the string literalinvalid
. The launcher component and the upload component will not use such inventory beacons for transfers.
- If
- option is an optional integer identifying the option configured on the DHCP server that contains the failover inventory beacon information. Valid values are 0 to 255. The default is 123.
For example:
MgsDHCP(,true,123)
Example of MgsDHCP algorithm results
For DHCP server option set to ds-prs-01.tmnis.org,ds-prs-02.tmnis.org
.
Location | AutoPriority | discard-Foreign | Incoming priority | Resulting priority |
---|---|---|---|---|
ds-cls-01 |
true |
false |
1 |
2 |
ds-prs-01 |
false |
Don't care |
4 |
4 |
ds-cls-02 |
true |
false |
2 |
3 |
ds-prs-02 |
true |
Don't care |
3 |
1 |
In the above example:
- The fact that
AutoPriority
has been set tofalse
fords-prs-01
prevents it from being given the highest priority, despite its pre-eminent position in the DHCP option listing. It must preserve its incoming priority value. - The inventory beacons
ds-cls-01
andds-cls-02
are not prioritized in the DHCP option. Therefore, depending on the value ofAutoPriority
, they are either sent to the end of the priority queue (maintaining the relative ordering they had on entry), or excluded.
IT Asset Management (Cloud)
Current