Steps to configure Automatic Download

1. Application Developer or SE creates the Application (Package) along with a Manifest file. Package Manifest needs to have the following information

1. File to be downloaded to the VHQ(.TGZ or .ZIP).
2. Package Name
3. Package Version
4. Software Dependency: The minimum version of each dependent Package
5. Model Dependency: List of models supported.
6. List of files. For each file
   • Filename/Size/Hash
7. Manifest Hash/Control Hash
8. Parameter Definitions: Defines all the parameters supported by a Package.

    NOTE: Parameter files should be uploaded in the Application Library.

   
   It should define:
   • Parameter Name
   • Data Type: String/Numeric/Boolean/DateTime/Binary
   • Default Value (if any)
   • Validation Rules

2. VHQ User imports Application (Package) to VHQ to configure the Application on VHQ. The Import process will read the manifest file and setup the necessary properties in the database.
VHQ User defines Parameter Templates for the Application.

• Parameter Template defines values for all or some of the Parameters (defined as part of Parameter Definition) for a Specific Application\.

3.VHQ User defines Reference Set with

• Parameter template can be configured at the Application level. In such a case the parameter values defined in the template apply to the devices which get this Application.
• The Values of the specific Parameters can be overridden/edited device level also.
• VHQ User can edit the Parameter values
  • Collection of Software Packages. Order of download.
  • List of Device Models which require this package.
  • Device selection criteria using attributes of a device.
• Reference sets to be associated with
  • Hierarchy: Packages can be associated at any levels in a hierarchy tree.
  • Specific Device (Direct Assignment or Package Assignment): Packages can be associated with specific devices.
• Downloads occur in response to a periodic request from the device.

Determining when a device needs an update requires two sets of information. The request shall have both the device profile and a list of all device files. The profile is used by VHQ to match the device with a reference device. When there is no reference device match, VHQ responds to the device that no download is required. When a match occurs, VHQ compares the device file list with the items contained in the reference device. If there are no differences in the file comparison VHQ responds that no download is required. When a mismatch does occur, VHQ will issue a schedule download action to the device. The schedule for the download is set by VHQ based on system availability. When the device receives the schedule download action, periodic updates are suspended until the scheduled download is completed.

If a device reboots after a scheduled download, VHQ will receive an update request with the device’s current profile. If the device profile attributes used for matching a reference device have changed since the scheduled download and the content of the matched reference device is different from the content of the reference device used for the original schedule, VHQ shall send a cancel download command and new schedule download. 

Device Assignment Report

You can view the information about the assigned devices in Device Assignment Report. The Device assignment report includes the Device Serial Number, Device ID, Device Hierarchy Path, Device Model, Device Reference Set, Device Packages, Direct Assignment enabled, and Assigned Reference Set. The report also includes whether the device has been assigned reference set through direct assignment or hierarchy.

• Go to Device Management > Manage Reference Set > Device Assignment Report.