Skip to main content

Automated deployment and auto-completion of the Setup Wizard

Daniel Gonçalves

Introduction

Amino released a Setup Wizard application for H-series devices with Firmware 25.3.2022.9R to help users configure their devices during the initial setup process.

The Setup Wizard automatically launches on the H200 under the following circumstances:

  1. The device is being set up for the first time.
  2. A Factory Data Reset was performed on the device.
  3. The device's firmware is upgraded from a version that did not include the Setup Wizard (25.3.2021.X or older) to a version that includes it (25.3.2022.9R and newer).

It is possible to automatically provide this data using configuration settings so that the setup wizard is not shown. This is useful for deployments where a fully automated process is required with no user intervention.

This article describes the parameters required to perform automatic configuration via Orchestrate, DHCP-VCI-INI, or USB configuration.

 

Prerequisites

Firmware 25.3.2022.9R or newer

 

Summary

Please note that when launched, the Setup Wizard default behavior is to prompt you to provide the following information for the device:

  • Default Language

  • Date/Time from NPT Server or set manually

  • Time Zone

After you complete these prompts, the H200 will launch the default application configured for the device.

 

Auto-completion of the Setup Wizard 

By providing this data using INI configuration parameters the device will skip the setup wizard process. The INI settings that must be provided are shown below:

  • default.system_language: value must be a 3 char ISO 639-3 language code (e.g. 'eng', 'spa', 'nld').
  • default.datetime.time_zone: value must be in TZ Database Name Format (e.g. "America/New_York")
  • ntp.server: value must be a NTP server hostname/IP used for NTP time sync (e.g. "pool.ntp.org 10.0.1.100")
  • datetime.ntp_sync: value must be "1"

These parameters may be specified using any of the supported provisioning mechanisms, i.e. via Orchestrate, DHCP VCI configuration of INI parameters, or by specifying in USB configuration.

Once the H-series applies the INI settings via its configuration method, the Setup Wizard will automatically complete and launch the default application for the device without requiring any input from the user.

 

References 

None

 

Related to

Related articles