HP TechPulse User manual

HP TechPulse Device Software Deployment Guide

Contents

Introduction .......................................................................................................................................................................................3

Prerequisites .....................................................................................................................................................................................3

Providing UPN Suffixes to HP or a Business Partner ............................................................................................................3

Downloading the HP TechPulse Device Software ...................................................................................................................4

Configuring Proxies or Firewalls for Communication with HP TechPulse .........................................................................4

Software Prerequisites for the HP TechPulse Windows Application .................................................................................4

HP TechPulse Windows Application (HPTechPulse.exe).............................................................................................. 4

HP TechPulse Windows Application (MSI Installer) ....................................................................................................... 5

Configuring Proxy Settings for the HP TechPulse Windows Application ...........................................................................6

Configure proxy auto-configuration URL (PAC URL)..................................................................................................... 6

Configure static proxy server ........................................................................................................................................... 6

Configure settings for authenticated proxy servers (User Authentication) .............................................................. 6

Configure settings for authenticated proxy servers (Computer Authentication) .................................................... 7

Configure proxy settings with Group Policy ................................................................................................................... 7

Manual Enrollment ...........................................................................................................................................................................8

Enrolling Computers Manually ..................................................................................................................................................8

Installing the HP TechPulse Windows Application .......................................................................................................... 8

Manually Enrolling a Windows Computer Using a Company-wide PIN ....................................................................... 8

Manually Enrolling a macOS Computer Using a Company-wide PIN .......................................................................... 9

Manually Enrolling an Android Device Using a Company-wide PIN ................................................................

Automatic Enrollment .................................................................................................................................................................. 10

Automatic Enrollment of Windows Devices with Serial Number ..................................................................................... 10

Prerequisites .....................................................................................................................................................................10

Import Serial Numbers to HP TechPulse ......................................................................................................................10

Deploy the HP TechPulse Windows Application ..........................................................................................................11

Automatic Enrollment of Windows Devices with Company-wide PIN (HPTechPulse.exe) ......................................... 12

Using an Install.CMD Batch Script File for Automatic Enrollment .............................................................................12

Creating an Install.CMD Batch Script File ......................................................................................................................12

.............. 9

Enrolling Windows Devices Automatically Using the Install.CMD File .......................................................................13

Using MS Active Directory (AD) Group Policy for Automatic Enrollment .................................................................14

Using Microsoft System Center Configuration Manager (SCCM) for Automatic Enrollment ................................15

Automatic Enrollment of Windows Devices with Company-wide PIN (MSI Installer) ................................................... 19

Using Microsoft System Center Configuration Manager (SCCM) for Automatic Enrollment ................................19

Using Microsoft Intune for Automatic Enrollment ......................................................................................................27

HP TechPulse Device Software Deployment Guide

Automatic Enrollment of macOS Devices Using Jamf Pro ................................................................................................ 31

Prerequisites .....................................................................................................................................................................31

Script ..................................................................................................................................................................................31

Uninstalling the HP TechPulse Windows Application ............................................................................................................. 34

Uninstalling Manually ............................................................................................................................................................... 34

Troubleshooting: Unenrollment Failed Error When Uninstalling .............................................................................36

Uninstalling the HP TechPulse Windows Application with System Center Configuration Manager (SCCM) ............ 37

Loading the uninstall script ............................................................................................................................................37

Creating a deployment with Action set to Uninstall ...................................................................................................37

Uninstalling the HP TechPulse Windows Application with Group Policy ........................................................................ 38

Creating a Group Policy Object .......................................................................................................................................38

Removing devices enrolled using Automatic Enrollment with Serial Number ............................................................. 38

HP DaaS for Retail ......................................................................................................................................................................... 39

Prerequisites for HP Retail Peripheral Agent ...................................................................................................................... 39

Installing HP TechPulse and HP Retail Peripheral Agent .................................................................................................. 39

References ................................................................................................................................................................................. 39

Additional Information ................................................................................................................................................................. 40

Gathering the HP TechPulse Windows Application logs (HPreport logs) ....................................................................... 40

HP Managed Services Regional Support .............................................................................................................................. 40

Appendix ......................................................................................................................................................................................... 41

Client Enrollment Command Line Parameters ................................................................................................................... 41

HP TechPulse Device Software Deployment Guide

Introduction

Enrolling devices with HP TechPulse may be done manually or automatically using various options. Enrollment options provided in this guide include the following:

• Manually Enrolling Devices

• Automatically Enrolling Devices Using an Install.CMD Batch File

• Automatically Enrolling Devices Using Microsoft Active Directory

• Automatically Enrolling Devices Using SCCM

HP Service Experts or your Business Partner are available for consultation regarding any of these options.

WARNING: Do not skip the Prerequisites Section of this guide.

Prerequisites

Before enrolling any devices with HP TechPulse, ensure that you have completed the prerequisites in the sections below.

Providing UPN Suffixes to HP or a Business Partner

WARNING: A valid UPN suffix is required for silent enrollment. Failure to provide UPN suffixes to an HP

Service Expert or Business Partner will prevent devices from silently enrolling.

Silent enrollment uses User Principal Name (UPN) suffixes, so domain-joined devices must have a valid UPN. If the device is not domain-joined, the device can be silently enrolled without a valid UPN. Follow these steps to get UPN suffixes for each domain or subdomain using a Windows computer:

1. Open a command prompt, then type WhoAmi /UPN. Press Enter to get the UPN.

2. Send the UPN suffix to your HP Service Expert or Business Partner. For example, if the UPN is user@contoso.com, then send contoso.com to your service expert.

3. For multi-level domain environments, repeat these steps on another device located in another domain or subdomain, then send the UPN suffixes to your HP Service Expert or Business Partner.

HP TechPulse Device Software Deployment Guide

Downloading the HP TechPulse Device Software

HP TechPulse Device Software is required for both manual and automatic enrollment. For manual enrollment, download the software on the local computer. For automatic enrollment, download the software to a location accessible by all computers on the network.

1. Download the HP TechPulse Device Software from https://www.hpdaas.com/software

2. For Windows computers, there are 2 types of installers:

a. Download the HP TechPulse Windows Application (HPTechPulse.exe) by clicking the Download

button next to HP TechPulse Windows Application and selecting HPTechPulse.exe from the dropdown. The HPTechPulse.exe file will be downloaded. See the

Application (HPTechPulse.exe) section for details about the HPTechPulse.exe file.

b. Download the HP TechPulse Windows Application (MSI Installer) by clicking the Download button

next to HP TechPulse Windows Application and selecting MSI from the dropdown, a zip file named “HPTechPulse.zip” will be downloaded. See the section below for the contents of the HPTechPulse.zip file and how to deploy it.

3. For Apple computers, download the macOS Application (APMAgent.PKG file). For Android devices, download the HP TechPulse Android App from Google Play.

HP TechPulse Windows Application (MSI Installer)

HP TechPulse Windows

Configuring Proxies or Firewalls for Communication with HP TechPulse

For information about configuring proxies and firewalls, refer to the

Configuring a Proxy or Firewall

Software Prerequisites for the HP TechPulse Windows Application

HP TechPulse Windows Application (HPTechPulse.exe)

Deploying the HPTechPulse.exe causes the HP TechPulse Windows Application to:

1. Install the HP TechPulse package including the VC++ Redistributable

document.

2. Download and install of HP Touchpoint Analytics package, including the HP Touchpoint Analytics – Dependencies package, and the HP TechPulse Updater Windows Task Scheduler task.

The HP TechPulse Windows Application (HPTechPulse.exe) consists of the following separate installation packages, with each package having its own independent version, pre-requisites (as visible in the Add/Remove programs on a Windows device), and a Windows Task Scheduler task.

Package Name Prerequisites Download Package Size (MB)

HP TechPulse

HP Touchpoint Analytics Client (Installed by the HP TechPulse package)

• VC++ Redistributable 14.0.24212.0 (Installed by the HP TechPulse package)

• .NET Framework 4.5 or backward compatible higher version (Included in Windows 10)

HP Touchpoint Analytics – Dependencies (Installed by the HP Touchpoint Analytics package)

~30

~35

HP TechPulse Device Software Deployment Guide

HP TechPulse Windows Application (MSI Installer)

WARNING: For devices that are already enrolled to HP TechPulse using the HP TechPulse Windows Application (HPTechPulse.exe), do not deploy the HP TechPulse Windows Application (MSI Installer) to those devices.

The HP TechPulse Windows Application MSI Installer is primarily for customers who want to conserve network bandwidth.

The VC++ Redistributable (x86), VC++ Redistributable (x64), and the HP Touchpoint Analytics Client Dependencies packages must be installed first, followed by the HP Touchpoint Analytics Client package and finally the HP TechPulse package. If the packages are installed in this order, the HP Touchpoint Analytics Client package will not be downloaded from the internet during initial deployment of HP TechPulse Windows Application.

The HP TechPulse Windows Application (MSI Installer) consists of the following separate installation packages, with each package having its own independent version, pre-requisites (as visible in the Add/Remove programs on a Windows device), and a Windows Task Scheduler task:

Package

Package Name Prerequisites Package Names

Size (MB)

HP TechPulse1

HP Touchpoint Analytics Client1 VC++ Redistributable

HP Touchpoint Analytics Client Dependencies

VC++ Redistributable 14.0.24212.0 (x86) and above

Version 14.25.28508.3 included in HPTechPulse.zip file.

VC++ Redistributable 14.0.24212.0 (x64) and above

Version 14.25.28508.3 included in HPTechPulse.zip file (cannot be installed on 32-bit OS)

1, 2

• VC++ Redistributable

14.0.24212.0 (x86)

• .NET Framework 4.5 or backward compatible higher version (Included in Windows

10)

14.0.24212.0 (x64)

None HPTouchpointAnalyticsDependencies.

None vc_redist.x86.exe

None vc_redist.x64.exe

HPTechpulse.msi ~10

HPTouchPointAnalytics.msi ~17

~12

msi

~14

Included in the HPTechPulse.zip file.

HP TechPulse Device Software Deployment Guide

Configuring Proxy Settings for the HP TechPulse Windows Application

Information in this section contains advanced information intended for IT Professionals.

If your devices connect through a proxy for internet access, the HP TechPulse Windows Application will automatically detect the proxy server based on the proxy auto-discovery, proxy auto-configuration or static proxy settings on the device. If the proxy server cannot be automatically detected, you may need to specify a static proxy server or proxy auto-configuration URL for the HP TechPulse Windows Application.

To configure the HP TechPulse Windows Application to connect to a specific proxy auto-configuration URL (PAC URL) or static proxy server, the following registry keys can be set on the device prior to installing the HP TechPulse Windows Application. You can include the registry keys in the batch script file used to deploy the HP TechPulse Windows Application.

Configure proxy auto-configuration URL (PAC URL)

To specify a PAC URL for the HP TechPulse Windows Application, use the following command in a batch script to add the required registry key. Replace the device to utilize to discover the proxy server.

REG ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Hewlett-Packard\HP Touchpoint Manager\GPO\ProxyPath" /v AutoConfigProxy /t REG_SZ /d http://autoconfigurl /f

http://autoconfigurl with the proxy auto-configuration URL you want the

Example:

REG ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Hewlett-Packard\HP Touchpoint Manager\GPO\ProxyPath" /v AutoConfigProxy /t REG_SZ /d http://autocache.proxyserver.net/proxy.pac /f

Configure static proxy server

To specify a static proxy server for the HP TechPulse Windows Application, use the following command in a batch script to add the required registry key. Replace the communicate through:

REG ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Hewlett-Packard\HP Touchpoint Manager\GPO\ProxyPath" /v StaticProxy /t REG_SZ /d proxy:port /f

Example:

REG ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Hewlett-Packard\HP Touchpoint Manager\GPO\ProxyPath" /v StaticProxy /t REG_SZ /d webproxy.corp.domain.com:8080 /f

proxy:port with the proxy:port you want the device to

Configure settings for authenticated proxy servers (User Authentication)

To configure the HP TechPulse Windows Application to work with an authenticated proxy, you must be using HP TechPulse Windows Application version 3.20.455 (released on April 15, 2020) or higher. Use the following commands in a batch script to add the required registry key:

REG ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Hewlett-Packard\HP Touchpoint Manager" /v EnableUserAuthProxy /t REG_SZ /d True /f

Note that Negotiate (Kerberos, NTLM) and NTLM authentication are supported. Basic and Digest authentication are not supported by the HP TechPulse Windows Application.

HP TechPulse Device Software Deployment Guide

Configure settings for authenticated proxy servers (Computer Authentication)

REG ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Hewlett-Packard\HP Touchpoint Manager" /v EnableComputerAuthProxy /t REG_SZ /d True /f

Note that Negotiate (Kerberos, NTLM) and NTLM authentication are supported. Basic and Digest authentication are not supported by the HP TechPulse Windows Application.

Configure proxy settings with Group Policy

To apply PAC URL or static proxy settings for the HP TechPulse Windows Application using Group Policy, a set of Group Policy Administrative Templates (.ADMX and .ADML files) are available. Download the

Policy Administrative Templates.

HP TechPulse Group

HP TechPulse Device Software Deployment Guide

Note

Manual Enrollment

Enrolling Computers Manually

WARNING: Computers must be connected to the Internet to complete these steps.

Installing the HP TechPulse Windows Application

Note: Only computers running Windows 10 (Version 1809) or higher can be enrolled with HP TechPulse.

Follow these steps to install the HP TechPulse Windows Application.

1. Download the HP TechPulse Windows Application from https://www.hpdaas.com/software.

2. Double-click HPTechPulse.exe to start the installation, then click Next.

3. Check the box “I accept the Terms and Conditions of the End User License Agreement,” then select Install.

The installation wizard guides you through the process.

4. After the installation is completed, click Close.

Manually Enrolling a Windows Computer Using a Company-wide PIN

Follow these steps to manually enroll Windows devices using a company-wide PIN. If you do not know your company-wide PIN, sign into

1. After the HP TechPulse Windows Application is installed, enrollment begins automatically. Click Next to begin enrollment.

2. Select Company if the computer is owned by a company or Personal if the computer is owned by an individual person, then click

hpdaas.com and view the Settings > Preferences page.

Next.

3. Select PIN as the enrollment method.

4. When prompted, enter the company-wide PIN, then click Enroll.

The company-wide PIN can be obtained by signing into hpdaas.com and viewing the Settings > Preferences page.

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

A confirmation window appears. “Device Is Enrolled” is displayed If the computer has been successfully enrolled.

: In the Windows System Tray, HP TechPulse will show as enrolled.

HP TechPulse Device Software Deployment Guide

Note

Manually Enrolling a macOS Computer Using a Company-wide PIN

Follow these steps to manually enroll macOS computers using a company-wide PIN. If you do not know your company-wide PIN, sign into

1. Download and install the macOS Device Software from https://www.hpdaas.com/software.

2. After the macOS software is installed, HP TechPulse enrollment automatically begins. Click Enroll to proceed.

3. Select Company if the computer is owned by a company or Personal if the computer is owned by an individual person, then click

: If “Personal” is chosen, some HP TechPulse functionality will not be enabled.

4. Enter the company-wide PIN, then click Next. The company-wide PIN can be obtained by signing into hpdaas.com and viewing the Settings

> Preferences page.

5. When the enrollment confirmation window appears, click Yes to authorize company-owned computers. Or, click either

A confirmation window appears, and Device Is Enrolled is displayed If the computer is successfully enrolled.

Remember, computers must be connected to the Internet during enrollment.

6. If you prefer, click Details for more information about the enrollment.

7. On the left, click About > Update to check for HP TechPulse software updates. Be sure the box is checked to Automatically download and install updates.

hpdaas.com and view the Settings > Preferences page.

Next.

Yes or No for individually owned computers, depending on company policies.

: In the Mac Notification Center, HP TechPulse will show enrolled

Manually Enrolling an Android Device Using a Company-wide PIN

Follow these steps to manually enroll Android devices using a company-wide PIN. If you do not know your company-wide PIN, sign into

1. Search for the “HP TechPulse” app in Google Play.

2. Click Install to proceed, then click Open after the app is installed.

3. Select Company if the computer is owned by a company or Personal if the computer is owned by an individual person, then click

: If “Personal” is chosen, some HP TechPulse functionality will not be enabled.

4. Enter the company-wide PIN, then click Next. The company-wide PIN can be obtained by signing into hpdaas.com and viewing the Settings

> Preferences page.

5. Select OK to accept the End User License Agreement.

6. When prompted, select Allow to allow HP TechPulse to access the device’s location.

7. On the Usage Data Access screen, select the HP TechPulse app and toggle on Allow usage tracking to allow HP TechPulse to collect usage data from the device.

8. A Setup Complete screen appears, and Success! is displayed If the device is successfully enrolled.

hpdaas.com and view the Settings > Preferences page.

Next.

HP TechPulse Device Software Deployment Guide

Note

Automatic Enrollment

There are two methods to perform automatic enrollment of Windows devices to HP TechPulse:

• Automatic Enrollment with Serial Number can only be used if your devices meet the prerequisites in the Automatic Enrollment with Serial Number section below. This method is recommended if your devices will be enrolled to more than one HP TechPulse tenants or if the HP TechPulse Windows Application will be installed into a Windows 10 Custom Image.

• Automatic Enrollment with Company-wide PIN is recommended if your devices will only be enrolled to a single HP TechPulse tenant and you will be deploying the HP TechPulse Windows Application from GPO or a deployment tool such as SCCM.

: If you are currently using this enrollment method, there is no need to use the Automatic

Enrollment with Serial Number method.

Automatic Enrollment of Windows Devices with Serial Number

Prerequisites

The following prerequisites must be satisfied to use Automatic Enrollment with Serial Number:

• HP-manufactured PC shipped on or after January 1, 2018.

• HP-manufactured PC must be running Windows 10 1703 or higher. Pro, Enterprise or Education editions

only, Windows 10 Home editions are not supported by this feature.

• This feature is only supported on HP TechPulse Windows Application (HPTechPulse.exe) version 3.20.495 and above.

Import Serial Numbers to HP TechPulse

: To import serial numbers using the Automatic Enrollment with Serial Number method,

Obtain the serial numbers for the devices you want to enroll. Then proceed with the steps below:

1. Sign into www.hpdaas.com

2. Go to Devices.

3. Click Add.

4. Select the company tenant from the drop-down list that you want these devices to be added to and click

5. Select Auto Enrollment and click Next.

6. Choose Upload File to import multiple Serial Numbers using a .CSV file or choose Enter Manually to enter

you must sign into HP TechPulse using the Partner Admin or Partner Specialist Role.

Next.

serial numbers one-by-one, then click

Next.

7. If Upload File was chosen, click Browse to upload a .CSV file containing the serial numbers of devices to enroll. To obtain a sample .CSV file, click on the link: file must be in the exact same format as described in the sample .CSV file.

8. If Enter Manually was chosen, enter the Serial Number and an Alias (optional) for the device(s) to enroll.

9. Click Add.

Click here to download the sample file

. The uploaded

HP TechPulse Device Software Deployment Guide

10. The serial numbers imported will show up in the Pending Enrollment list. The status of the device will be displayed as

11. You must wait for the status to display as Ready before your devices can be automatically enrolled to HP TechPulse.

12. If the status of the device is displayed as Error, the device cannot be enrolled using the Automatic Enrollment with Serial Number method. The Number.

Deploy the HP TechPulse Windows Application

WARNING: If the status of the device does not display as Ready in the Pending Enrollment tab, the devices will not enroll to HP TechPulse.

1. Download the HP TechPulse Windows Application (HPTechPulse.exe). For help, see

TechPulse Device Software.

2. Install the HP TechPulse Windows Application using the following command:

HPTechPulse.exe /silent ZTEMODE=0

Validating.

Logs page will display the reason for the error on that Serial

Downloading the HP

3. If deploying the HP TechPulse Windows Application using an install.cmd batch script file, using MS AD Group Policy, or using MS SCCM, follow the steps in the section below, but use the ZTEMODE=0 parameter above instead of the CPIN=<Company-wide PIN> parameter.

4. If installing the HP TechPulse Windows Application in a Windows 10 Custom Image, start the device with the Reference Image to Audit Mode and install the HP TechPulse Windows Application using the HPTechPulse.exe /silent ZTEMODE=0 command, then capture the Reference Image. For more information about installing the HP TechPulse client in a Windows 10 Custom Image, refer to the

Installing HP TechPulse Device Software into a Windows 10 Custom Image document.

The HP TechPulse Windows Application will be silently installed and will await enrollment once installed. Once the device status changes to connectivity, the device will automatically enroll to HP TechPulse.

If the device was powered on prior to the device status changing to Ready on the Pending Enrollment tab, the HP TechPulse Windows Application will re-attempt enrolment every 24 hours or upon device restart.

Ready on the Pending Enrollment tab and the device has internet

Automatic Enrollment with Company-wide PIN

HP TechPulse Device Software Deployment Guide

Automatic Enrollment of Windows Devices with Company-wide PIN (HPTechPulse.exe)

This method requires the company-wide PIN. To obtain the company-wide PIN to enroll the device, please sign into www.hpdaas.com

Using an Install.CMD Batch Script File for Automatic Enrollment

and go to Settings > Preferences.

WARNING: Computers must be connected to the Internet for automatic enrollment.

This section provides three different methods for automatically enrolling Windows devices with HP TechPulse, which includes using an install.cmd batch script file, using MS AD Group Policy, or using MS SCCM. The Install.cmd batch script file can be used once to enroll a single device or with AD Group Policy to enroll multiple devices simultaneously.

Creating an Install.CMD Batch Script File

Follow these steps to create an Install.CMD batch script File. These steps will also be used for Using AD Group Policy for Automatic Enrollment.

1. Download the HP TechPulse Windows Application (HPTechPulse.exe). For help, see

TechPulse Device Software.

2. Download the sample batch script file from: ftp://ftp.hp.com/pub/caps-

softpaq/HP_DaaS/DaaS%20Client%20Scripts/GPO/Install/install.zip

3. Extract the install.zip file. The Install.CMD batch script file will be extracted.

4. Place the HPTechPulse.exe file and Install.CMD batch script file in a location that is accessible by all computers on the network. Or, place the files on a USB drive for computers that are not able to connect to the network.

5. Using a text editor such as Notepad, open the Install.CMD.

6. The following code will be displayed in the body of the Install.cmd batch script file:

Downloading the HP

REG QUERY "HKLM\SOFTWARE\Hewlett-Packard\HP Touchpoint Manager\Agent" /v "DeviceEnrolled" | Find "True"

If %ERRORLEVEL% == 0 goto end If %ERRORLEVEL% == 1 goto install goto end :install \\<NetworkShare>\ HPTechPulse.exe /silent CPIN=<Company-wide PIN> goto end :end

7. Replace <NetworkShare> with the location of the batch script file.

8. Replace the <Company-wide PIN> with the company-wide PIN.

Do not include the brackets.

9. If copying the Install.CMD file from a USB drive to a local computer, replace <NetworkShare> with a local path such as C:\Temp where files will be copied.

10. Save the Install.CMD file.

WARNING: Network paths cannot contain spaces in the file path. Otherwise, HP TechPulse device enrollment will fail.

+ 30 hidden pages