Introduction
The HP Insights Windows Application (also referred to as the Windows Agent) for the HP Workforce Experience Platform (WXP) can be deployed using Microsoft System Center Configuration Manager (SCCM) with the setup.exe installer method. This approach is ideal for organizations managing installations across multiple devices, as it uses the bundled executable files provided by setup.exe to streamline deployment and configuration. Using setup.exe also enables you (IT administrators) to maintain consistency and control across deployments with minimal user interruption.
This article provides a step-by-step guide to deploy Windows Agent with SCCM (setup.exe):
Provide the UPN suffixes to the designated HP Service Expert or Business Partner
Obtain the company PIN:
Log in to WXP. From the left menu, click Settings > Preference.
On the Preferences tab, scroll to the Company PIN section and copy the pin.
Distribute the application content to distribution points (DPs)
Note: The instructions are for Microsoft System Center Configuration Manager (SCCM) v.1902 but may also apply to newer versions of SCCM.
Download the Windows Application (setup.exe)
Download and install the Windows Agent from https://workforceexperience.hp.com/software
Save the contents of the .zip file to a location accessible by SCCM.
For detailed instructions, refer to the article - Install Windows Agent Using setup.exe.
Installation packages:
Minimum supported .NET Framework 4.6.2
Microsoft VC++ redistributable package (x86)
HP insights Application (HPInsights.msi)
Microsoft VC++ redistributable package (x86) is a pre-requisite to HP Insights Application
Microsoft VC++ redistributable package (x64)
HP Insights Analytics - Dependencies (HPInsightsAnalyticsDependencies.msi)
HP Insights Analytics Package (HPInsightsAnalytics.msi)
Must be installed with Microsoft VC++ redistributable package (x64), HP Touchpoint Analytics Client - Dependencies and Manager Application, in that order.
Note: The HP Touchpoint Analytics Client dependencies package cannot be installed on non-HP manufactured PCs, including virtual machines.
Create an Application in SCCM
Log into the SCCM Admin Console and start the Create Application Wizard.
In the SCCM Admin Console, click Software Library.
In the Software Library workspace, click Application Management > Applications > Create Application.
Select Manually specify the application information.
Click Next.
Type the following in the respective fields, click Next, and enter the following details:
Name: Windows Application
Publisher: HP Inc.
Version: 5.xx.xxx (replace with the version of the .exe file being deployed)
Click Next to accept the defaults for the Application Catalog entry.
Click Add to create a new Deployment Type and select Script Installer.
Manually specify the deployment type information, which will automatically be selected.
Click Next.
Type “Windows Application silent install” as the name for the Deployment Type.
Click Next
In the Content Location, specify the Network path (UNC name) to the .exe file.
In the Installation Program, specify the following command by replacing XXXXX with the actual Company Pin:
Setup.exe / silent HIDETRAY=True CPIN=XXXXX
XXXXX = Company-wide PIN
To configure the proxy or update settings for the software, create a batch script to add the required registry keys and specify the batch script in the Installation Program. "HIDETRAY=True" is an optional switch but is recommended by HP.
By default, the platform will enroll after auto-updating. To enable enrollment without auto-updating, add UPDATEBEFOREENROLL=0, like this:
Setup.exe / silent HIDETRAY=True CPIN=XXXXX UPDATEBEFOREENROLL=0
In the Uninstall Program, specify the following command: powershell.exe -executionpolicy bypass -windowstyle hidden -noninteractive -nologo -file "Uninstall.ps1"
Select the checkbox for Run installation and uninstall the program as a 32-bit process on 64-bit clients.
Click Next.
To specify the detection rules, click Add Clause and enter the following rules to detect the existence of the client binaries, then click OK.
Click Next to proceed and update the following:
Setting Type: File System
Path: %ProgramFiles(x86)%\Hewlett-Packard\HP Touchpoint Manager\Agent
File or folder name: LHAgent.exe
Select the check box for "This file or folder is associated with a 32-bit application on 64-bit systems."
Select the check box for “The file system setting must exist on the target system to indicate the presence of this application.”
To specify the User Experience settings, select the below settings and click Next.
Installation behavior: Install for system
Logon requirement: Whether a user is logged on
Installation program visibility: Hidden
Maximum allowed run time (minutes): 20
Click Next to accept the defaults for software dependencies.
Confirm the deployment details and click Next.
When the completion screen is displayed, click Close.
In the Create Application wizard, click Next to proceed.
Confirm the settings and click Next.
When the completion screen is displayed, click Close.
Modify the platform's Windows application settings
To modify the application settings before copying the package to SCCM distribution points:
Go to the left column of the SCCM Admin Console, click Software Library > Application Management > Applications.
In the right menu, right-click the new Windows application and click Properties.
Select the Distribution Settings tab, then select Automatically download content when packages are assigned to distribution points.
Click OK.
Click Apply, then OK to close the application properties.
Distribute the Application Content to Distribution Points (DPs)
In the left column of the SCCM Admin Console, click Software Library > Application Management > Applications.
In the right menu, right-click the new Windows Application > Distribute Content.
In the Distribute Content Wizard on the General page, click Next.
Review the content to distribute and click Next.
When a meter appears showing distribution progress, review the actions taken, and click Close.
Verify content status on distribution points
In large environments where DPs are geographically dispersed, it is best practice to verify the content status before deploying the platform's Windows application. To verify the content status:
In the SCCM Admin Console, click Monitoring > Distribution Status > Content Status.
Right-click the Windows Application, then click View Status.
Verify the package has been successfully copied to all DPs before proceeding.
Deploy Windows Agent with SCCM
In the left column of the SCCM Admin Console, click Software Library > Application Management> Applications.
In the right menu, right-click the new Windows Application.
In the Deploy Software Wizard, click Browse next to Collections.
Select the Device Collection(s) to which the package is deployed.
Click OK, then click Next.
Click Next to accept the content destination settings.
Select Required for the Windows application; click Next.
To accept the default deployment schedule and deploy as soon as possible after the available time, click Next; otherwise, specify a schedule for the deployment as needed.
Select the following User Experience setting.
User notifications: Hide in Software Center and all notifications
Click Next.
To accept the default alert options, click Next.
Confirm the settings for the deployment and click Next.
Review the actions taken, then click Close
Verify the Deployment of Windows Agent
Check the date and time of the application deployment. To verify:
In the left column of the SCCM Admin Console, click Monitoring > Deployments.
In the search field at the top, type Windows application. Click the Windows application deployment in the search results. A graph will appear at the bottom right, showing the number of computers from the SCCM collection with the software installed. Statuses include:
Successful
Not Installed
Error
Unknown state: This means that the computers have most likely not connected to SCCM to receive the Windows application deployment package yet
The platform's Windows application installation can also be verified on the target computer.
To verify the deployment on the target computer:
On the end-user computer, open Program and Features in the Control Panel; the platform and HP Touchpoint Analytics Client should be installed.
If the system tray icon was not hidden during the deployment, click the system tray icon and select Status; the device enrollment status should show as Enrolled.
Related Resources
For additional information, refer to the following articles:
Contact Us
For any assistance, create a support case or email [email protected]