Ctrlk
RegisterLogin
For the complete documentation index, see llms.txt. This page is also available as Markdown.
Support

Configuring parameter template (PT) at hierarchy

Assign parameter templates to reference sets at hierarchy levels to apply parameter values across multiple devices under the hierarchy with download automation and inheritance options.

Use this when you need to apply a parameter template to every device under a hierarchy node, via a reference set.

You can assign a reference set to a hierarchy, and VHQ lets you assign parameter templates to that reference set. Reference sets can be inherited or directly assigned at the hierarchy level. All devices under that hierarchy which qualify for the reference set also receive parameter values from the assigned parameter templates (PT).

To configure a PT at hierarchy level, you must already have a PT (see Adding parameter template), and it must be assigned to the reference set.

Assign a reference set to a hierarchy

1

Open Hierarchy Assignment

Go to Device Management > Manage Reference Sets > Hierarchy Assignment.

2

Select the hierarchy node

Select the hierarchy and click the pencil icon. At a hierarchy node, you can assign a parameter template to reference sets directly assigned to that node, and/or to inherited reference sets. Selecting a root hierarchy only offers enabling/disabling download automation; selecting a hierarchy with children also lets you inherit reference sets from the parent (Yes/No) and enable/disable download automation.

3

Set the download schedule

Enable or disable automatic downloads for the selected hierarchy with the Download Automation checkbox, then choose a schedule:

  • Next contact: Schedule the download for the device's next heartbeat.

  • Next Available free time slot: The VHQ server identifies the next free time slot for the download.

  • Maintenance window: Schedule the download during the device's next maintenance window.

  • Download during maintenance window: Only download during the maintenance window's free time slot.

4

Assign reference sets

The Reference sets tab lists reference sets available from the hierarchy. Assign multiple reference sets to a hierarchy node and order them to determine which one qualifies for devices under that path. The Parameter templates tab activates once a reference set is selected — changes to the template's parameter values apply to all applicable devices under the hierarchy and its children.

Click Expand to view details of the qualified reference sets.

Click Save to assign the reference set to the hierarchy.

5

Assign parameter templates

The Parameter Templates tab lists all templates available to the reference sets assigned to the hierarchy. Select the template(s) to assign to devices under the hierarchy.

A popup confirms how many devices will be affected.

Click OK, then Save. Multiple hierarchy templates can be assigned to one node — since parameter templates are mutually exclusive, no ordering is needed. VHQ validates that an assigned template doesn't conflict with any hierarchy template values assigned above (if inherited) or below (if passed down). This validation only runs when Inherit from Parent Hierarchy is enabled.

If a conflict is found, VHQ shows: One or more of the parameters in the template(s) you are assigning conflicts with parameter that is already assigned. For duplicate parameters, click here — from which you can view the conflicting parameters and instances.

Guidelines

  • You can add, edit, delete, copy, and view a parameter template for an application from the Application Library screen.

  • The Parameter Template for Application screen (under Manage Downloads > Application Library > Configure) includes a Hierarchy Name(s) column, listing any hierarchies the template is assigned to (comma-separated).

  • Only regular (non-hierarchy) templates can be deleted. A hierarchy template must first be unassigned from the hierarchy level before it can be deleted.

Unassigning a template from a hierarchy's reference set restores default parameter values on affected devices. You can't overwrite parameter files, VPDX, or VPFX files while a parameter template is assigned to the hierarchy — and you can't delete a reference set while a PT is assigned to it.

Keywords

Also called: hierarchy parameter template, PT at hierarchy. Search terms: hierarchy assignment, reference set conflict.

PreviousMulti-merchant and card range parameter management
NextRetaining parameter values on changing software assignment

Last updated

Was this helpful?