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 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.
Downloading the Windows Application (setup)
Download and install the Windows Agent from https://workforceexperience.hp.com/software
For detailed instructions, refer to the article - Install Windows Agent Using the Setup Method.
Download the scripts file from here.
Place the following downloaded contents in local folder 1:
setup.exesetuparm.exehp-insights-installer-script.ps1
And in another folder, place the file named
hp-insights-remediation-script-sccm.ps1Use the same folder hierarchy while keeping these folders at SCCM Server content delivery locations.
Note:
Open both scripts and replace ENTER_COMPANY_PIN with the actual company pin and save.
To configure proxy or update settings for the HP Insights Device Software, create a batch script to add the required registry keys and specify the batch script in the Installation Program.
By default, HP Insights will enroll after auto-updating. To enable enrollment without auto-updating add UPDATEBEFOREENROLL=0, like this in hp-insights-installer-script.ps1 at line 15:
$arguments = "/silent HIDETRAY=True CPIN=$PIN_VALUE UPDATEBEFOREENROLL=0"
Creating an Application in SCCM
Log in to 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: HP Insights 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 Next.
Click Add to create a new Deployment Type and select Script Installer.
Manually specify the deployment type information, which will be selected automatically.
Click Next.
For the Deployment Type, enter the name as “HP Insights Windows Application silent install.”
Click Next.
In the Content Location, specify the Network path (UNC name) to the .exe file. For example,
\\WIN-Server-PC\Softwares\HP\Installation\In the Installation Program, specify the command as:
powershell.exe -ExecutionPolicy Bypass -noninteractive -nologo -File “hp-insights-installer-script.ps1”In the Uninstall Program, specify the command as: None.
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 HP Insights application binaries, then click OK.
Click Next to proceed and update the following:
Setting Type: Registry
Hive: Click Browse… and select
HKEY_LOCAL_MACHINE\SOFTWARE\Hewlett-Packard\HP Touchpoint Manager\Agent
Click OK.
To specify the User Experience settings, select the below settings and click Next.
Installation behavior: Install for system
Logon requirement: Whether or not a user is logged in
Installation program visibility: Hidden
Maximum allowed run time (minutes): 20
Click Next until close button is displayed.
Click Close.
Modifying the Platform's Windows Application Settings
To modify the application settings before copying the package to SCCM distribution points:
From left menu of the SCCM Admin Console, click Software Library > Application Management > Applications.
In the right menu, right-click the new HP Insights 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.
Distributing 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 of 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.
Verifying Content Status on Distribution Points
In large environments where DPs are geographically dispersed, the recommended best practice is 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.
Deploying Windows Agent with SCCM
Log in to the SCCM Admin Console and click Software Library.
In the Software Library workspace, right click on HP Insights Windows Application.
Click Deploy.
Click Browse…next to Collection.
Click User Collections or Device Collections depending on deployment strategy and select the target devices and user for installation.
Click OK and then Next.
Ensure the Distribution point is shown in window. Click Next.
In Deployment Setting, select Action as Install and then next Required.
Click Next and then Next.
In User Experience setting, select the dropdown for Hide in Software Center and all notifications as “User Notifications: setting.”
Click Next until Close button is displayed.
Click Close.
Verifying 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, enter 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: Indicates 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.
Creating a New SCCM Application for Re-enrollment (Free Plans)
To ensure correct enrollment in case migration from a Free Plan, create a new application in SCCM:
Log in to 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 and then click Next.
Enter the following and click Next:
Name: HP Insights Windows Application Remediation
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 Next.
Click Add to create a new Deployment Type and select “Script Installer.”
Manually specify the Deployment Type information, which is selected automatically.
Click Next.
For the Deployment Type, enter the name as “HP Insights Windows Application Remediation silent install.”
Click Next.
In the Content Location, specify the Network path (UNC name) to the .exe file. For example,
\\WIN-Server-PC\Softwares\HP\Installation\In the Installation Program, specify the following command
powershell.exe -ExecutionPolicy Bypass -noninteractive -nologo -File “hp-insights-installer-script.ps1”In the Uninstall Program, specify None.
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 HP Insights application binaries, then click OK.
Click Next to proceed and update the following:
Setting Type: Registry
Hive: Click on Browse… button and select
HKEY_LOCAL_MACHINE\SOFTWARE\Hewlett-Packard\HP Touchpoint Manager\AgentDummyReg
Click Ok.
Specify the following User Experience settings, and click Next.
Installation behavior: Install for system
Logon requirement: Whether or not a user is logged on
Installation program visibility: Hidden
Maximum allowed run time (minutes): 20
Click Next until close button is displayed.
Click Close.
General Guideline: Modify, Distribute and Deploy HP Insights Windows Application Remediation same way as HP Insights Windows Application.
Important:
If the customer or IT Administrator is enforcing strict PowerShell execution policies (such as AllSigned, RemoteSigned, or other restricted execution policies), the provided uninstall PowerShell script hp-insights-remediation-script-sccm.ps1and hp-insights-installer-script.ps1 must be digitally signed before deployment. In such environments:
The IT Administrator must sign the provided PowerShell uninstall script with an approved code-signing certificate.The signed script must be used when configuring the application deployment in Intune or SCCM.
The IT Administrator must ensure that the corresponding code-signing certificate (or its issuing CA certificate) is present in the Trusted Root Certification Authorities or Trusted Publishers store under the Local Computer certificate store on all target devices.
Failure to meet these requirements may result in the uninstall script being blocked by the system execution policy.
Contact Us
For any assistance, create a support case or email support@wxp.hp.com