Parameter synchronization (download) to devices
Download and synchronize parameters to devices in VHQ using automated downloads that evaluate parameter precedence, build parameter files in multiple formats, and verify synchronization status.
What is parameter synchronization?
The Downloads/Synchronize phase evaluates and builds the list of parameters to download in the appropriate format. VHQ checks the parameters configured at the device level against the server, and if the matching criteria are met, synchronization takes place. If synchronization fails, VHQ prepares a package bundling the applications, parameter form view file, and parameter templates, and sends it to the device with the appropriate GID.
Once parameters are configured and saved (or activated), VHQ evaluates, builds, and downloads a parameter file containing the parameters and their values, in a format based on the parameter definition file.
Evaluating parameters and their values
VHQ builds and downloads parameters using the following order of precedence:
Parameter values configured at the device level.
Parameter values configured for parameter templates (PT).
Default parameter values as defined in PDX.
A device-level value always takes precedence; if none is configured, the PT value applies; if neither is configured, the PDX default applies.
Identifying the parameter change set
As part of automated downloads, VHQ detects when a software update is required and sends the download instructions (the management plan) to the device, which then downloads the updates. Every software update also includes instructions to download all parameters for the applications in that update.
The device confirms successful download and application of parameters — VHQ records this as the synchronized date. When a user later configures or edits parameters and saves (or activates) the changes, VHQ records this as the activation date. Parameters with an activation date later than the synchronized date are identified as changed parameters.
Building the parameter file
VHQ builds a parameter file for download, containing either only changed parameters or all parameters, depending on what the application/OS can consume. The format and content are determined by the Parameter File > Format value in the Parameter Definition File:
Config.sys and Config.$$$ formats are compressed into a .ZIP file, with one folder per GID.
ADKH format files are built per the structure in Parameter File > OutFileFormat.
Supported download formats are POINT, ADKH, ADK-INF, CONFIG$$$, and CONFIGSYS. ADK-INF, the newer ADK Info Svc Import/Export format, supersedes all other ADK formats — it uses a structured, fully-pathed format compatible with both SQLite (relational) and properties-db (hierarchical) database types, rather than the simpler compound-name format properties-db alone supported.
Download and verify
VHQ prepares download instructions for the parameter files. For example, if a package has 2 applications, each with 2 parameter files, the management plan includes instructions to download:
The software package.
Parameter File #1 and #2 for Application #1.
Parameter File #1 and #2 for Application #2.
The device processes the instructions, downloads each file, applies the parameters, and reports status. VHQ updates the synchronization status accordingly — you can view the sync status per application and the detailed status per parameter file.
Was this helpful?