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.

MgsBandwidth (int limit, boolean discardForeign, int option)
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 or false. The default is false.
    • 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 literal invalid. The launcher component and the upload component will not use such inventory beacons for transfers.
  • 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
true

1

2
invalid

ds-prs-01

false

Don't care

4

4

ds-cls-02

true

false
true

2

3
invalid

ds-prs-02

true

Don't care

3

1

In the above example:
  • The fact that AutoPriority has been set to false for ds-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 and ds-cls-02 are not prioritized in the DHCP option. Therefore, depending on the value of AutoPriority, 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