Using a Scan to Config profile

A Scan to Config profile allows a user to scan a QR code with an Android device to configure the Velocity client with host profiles, global settings, scripts, or additional files. By default, the configuration files are hosted by the Velocity Console and sent over HTTP.

When you create a Scan to Config profile, it should contain ALL of the files that the device needs. When the Velocity client applies a Scan to Config profile, all other profiles (including the Demo profile) are erased. If there are other files in the Android/data/com.wavelink.velocity/files directory that are not included in the Scan to Config profile, those are also erased.

By default, the Console uses the hostname for the localhost that it can determine and picks a port. You can change the hostname to an IP address or change the port if there are conflicts or if you choose to host the profile on a web server somewhere else.

The Version field allows you to track changes to your Scan to Config profile. Increment the version number when you make changes to the profile. To see which version of the Scan to Config profile a device already has, tap the Scan to Config button in the Velocity client and find the version number at the top of the screen.

To create a Scan to Config profile: 

1.Create the host profiles and global settings that you want to include in the Scan to Config profile and deploy them.

For information about creating host profiles, see Creating and saving a project. For information on deploying, see Deploying a project.

2.From the list of profiles, click New Project in the top-right corner of the screen.

3.Enter a Project Name. You can also provide a Company Name, which is used solely for sorting projects.

4.Click Scan to Config.

The project opens.

5.Click the Add button to add host profiles, global settings, scripts, or other files that you want to distribute to the device. Make sure you only add one global settings file.

6.Configure the version number, port, or hostname for the profile, if desired.

7.After you have added all the files, click Save.

To host a Scan to Config profile from the Velocity Console: 

1.Open a Scan to Config profile.

2.Make sure all the files you want on the device are in the file list and the profile has been saved.

3.Click Show barcode.

The QR code is displayed. When you scan the barcode with a Velocity client, the files in the profile are downloaded to the device and a list appears at the bottom of the Console screen, showing which files have been downloaded and how many times they've been downloaded.

The Console continues hosting the files as long as the barcode is shown. Once you click Stop hosting, the files are no longer available to devices.

To apply a Scan to Config profile on a device: 

1.On an Android device, open the Velocity client.

2.Tap the Scan to Config button at the top of the screen.

3.Scan the QR code or type the URL in the field and tap Get configuration.

The client connects to the Console, erases any existing files in the files directory, and downloads the host profiles, global settings file, and any other files included in the profile.

To host a Scan to Config profile on another web server: 

1.Create a Scan to Config profile that includes all the host profiles, global settings, scripts, or other files. For the hostname and port, provide the details for the web server you plan to host the files on.

When you save the Scan to Config profile, it copies all the files to a Scan to Config profile directory and creates a manifest file in the following location: 

C:\Users\[username]\AppData\Local\Wavelink\Velocity Console\Projects\[name of the Scan to Config profile]\

2.Copy all of the contents of the Scan to Config profile directory to a directory on your web server. Make a note of the URL for the manifest.wlcfg file. If the devices have a scanner that can read QR codes, you use a QR code generator to create a QR code for the URL.

3.On the device, tap the Scan to Config button at the top of the screen.

4.Scan the QR code you generated in step 2 or provide the URL of the manifest.wlcfg file on your server. Tap Get Configuration.

The client connects to the server, erases any existing files in the files directory, and downloads the host profiles, global settings file, and any other files included in the profile.

Since the files are hosted on another server, you can print the QR code and continue to configure devices even when the Velocity Console is closed.