Windows IoT: Manually Enrolling IOT Devices Using Company PIN

Introduction

The HP Workforce Experience Platform (WXP) enables organizations to enroll Android devices manually using a Company PIN. This method is useful when automatic enrollment is not feasible or when setting up individual devices. By installing the WXP app from Google Play and entering the provided PIN, you (IT administrators and authorized users) can securely connect devices to the platform and enable data collection for WXP

The focus for this type of installation is users who are looking to deploy and manage the HP Insights application from centralized server-based environments (Thin Client) using the accessibility of the manual Company PIN while using the bundled executable Windows files offered by setup.exe.

This article provides step-by-step guidance to manually enroll IOT devices:

1. Obtain a Company PIN

2. Disable HP Write Manager

3. Download and run the HP Insights setup.exe file to install the agent

4. Enroll Devices Using Company PIN

5. Re-enable HP Write Manager.

Note: To enroll the HP Insights agent on Windows IoT operating systems, the auto-update feature needs to be disabled. Disabling the auto update feature can be completed in one of the following methods:

• During first time enrollment as shown in the Downloading HP Insights Windows Application (setup.exe) section.

• Existing devices with the agent already installed as shown in the Disabling Auto Updates on Existing Devices section below.

This functionality is supported by HP Insights agent version 4.23.88.0 and onwards.

Note:  Only computers running Windows 10 version 1809 or higher can be enrolled with HP Insights services.

Obtain the Company PIN

To obtain the Company PIN:

1. Log in to WXP. The Home page is displayed.

2. From the left menu of WXP, click Settings > Preferences.

3. On the Preferences tab, scroll down the Company PIN section and copy the pin.

If you are logging in as an HP Partner, go to Customers > Companies > Company Details > Preferences. Note that the customer must accept the partner invitation before you can view the company details.

Disable HP Write Manager

Prior to downloading and installing the HP Insights agent on the thin client device, the HP Write Manager must be disabled to allow the auto-update to be properly disabled.

To disable the HP Write Manager:

1. While in the Control Panel, select the HP Write Manager Configuration application.

2. From this application, the option should be visible to enable or disable the manager.

3. Once disabled, restart the thin client device and proceed with the below installation steps.

Note:

1. Changes following disabling the HP Write Manager are considered permanent system configurations. This protects the contents of and decreases wear on the thin client by redirecting and caching writes in an overlay.

2. When installing the HP Insights agent, it might be necessary to temporarily change some environmental variables to point to the thin client device (C:) instead of the RAM drive (Z:). The RAM drive might be too small for the temporary files cached during the installation of some applications.

To change the environmental variables:

1. Right click the Start button, and then select System from the menu.

   1. Pressing the Windows key + X will also bring up the System menu.

2. Select Advanced system settings, and then select Environmental Variables.

3. Change the value of the TEMP and TMP variables to C: \Temp.

If deemed necessary and the variables have been changed, they will need to be changed back to their original values after HP Insights client installation.

Download HP Insights for Windows Application (Setup.exe)

To download HP Insights for Windows Application:

1. Download the HP Insights device software from https://workforceexperience.hp.com/software.

   • See Downloading the HP Insights for Windows Application

   • Ensure the following contents of the HPInsights.zip file are saved to an accessible location.

     • VC++ Redistributable (x86)

     • HP Insights Manager Application

     • VC++ Redistributable (x64)

     • HP Insights Analytics Agent - Dependencies

     • HP Insights Analytics Agent package

   • For details about the setup.exe installer, see HP Insights for Windows Application (Setup.exe Installer)

     • The HPInsights.zip does not contain the file setup.exe. The setup.exe can be downloaded from https://workforceexperience.hp.com/software.

   • Note: The HP Insights Analytics Agent - Dependencies package cannot be installed on non-HP manufactured PCs, including Virtual Machines.

Enroll Devices Using Company PIN

To manually enroll Windows devices using a company PIN:

1. Run the HPInsights.exe as an Admin to start the installation; then, click Next.

2. Check the box “I accept the Terms and Conditions of the End User License Agreement.” Then, click Install. The installation wizard guides you through the process.

3. After the installation is completed, click Close.

4. If a new version of the HP Insights agent is available, a popup will appear asking the user if he or she wants to upgrade to the new version. Click Yes or No to continue. 

   1. Note: If the user chooses Yes, installation may take about two (2) minutes to complete, depending on the user’s bandwidth.

5. For an HP device, click Yes when a Check Device Registration dialog box appears asking for permission to check the device's serial number to see if it is registered for any HP services. For a non-HP device, click No.

6. Click on Enroll with PIN when the next popup appears.

7.  From the device owner dropdown list, select Company if the computer is owned by a company or Personal if the computer is owned by an individual person; then, click Next.

   1. Please note that the selection between Company and Personal enables different HP Insights data collection:

      1. Company enables all HP Insights data collection.

      2. Personal will limit the data collection that HP Insights can collect, specifically with personal information (last signed in user, software inventory, location, etc.).

   2. If the device owner changes the selection from Personal to Company, removal and re-enrollment of the HP Insights agent will be required.

8. When prompted, enter the company PIN with the below command line, then click Enroll.

   1. setup.exe /silent ZTEMODE=1 CPIN=XXXX DisableAutoUpdate=True

      1. This updates a registry entry that will be used by TA-Installer (HP Insights Updater) to determine whether to auto update HP Insights and the TA client.

   2. For more information on command line parameters, please see HP Insights for Windows Application Command Line Parameters (Setup.exe).

9. When the enrollment confirmation window appears, click Agree.

A confirmation window appears with a success message.

Note: In the Windows System Tray, HP Insights Agent will show as enrolled.

If the enrollment is unsuccessful, reach out to HP support. To identify your proper HP support contact, please sign into https://workforceexperience.hp.com and view the Help and Support page.

Re-Enable HP Write Manager

Once the HP Insights agent has been successfully enrolled, the HP Write Manager can be enabled to make the permanent system configuration:

1. Open the HP Write Manager Configuration application.

2. From the application, select the option to enable the manager.

3. Restart the thin client device to save the permanent system configuration.

Related Resources

For additional information, refer to the following articles:

• Overview of Workforce Experience Platform

• WXP Getting Started Guide

• Prerequisites for Installing Windows Agent

Contact Us

For any assistance, create a support case or email [email protected]