Deploying via SCCM with ZIP Package (.msi)

The WXP Insights agent for HP Workforce Experience Platform (WXP) can be deployed using Microsoft System Center Configuration Manager (SCCM) with the ZIP Package (.msi)  method. This approach is ideal for organizations managing installations across multiple devices, as it supports silent install parameters and enables streamlined updates and configuration through standardized MSI tools. Using MSI also enables you (IT administrators) to maintain consistency and control across deployments with minimal user interruption.

This article provides guidance for deploying the WXP Insights agent using Microsoft SCCM and the ZIP Package (.msi). The deployment process includes the following steps:

1. Downloading the Workforce Experience Platform for Windows (ZIP Package (.msi))

2. Creating an Application in SCCM

3. Distributing the Application content

4. Deploying WXP Insights Agent for Windows

Note: The following instructions are intended for Microsoft System Center Configuration Manager (SCCM) v.1902 ut may also apply to newer versions of SCCM.

Procedure

Follow the below steps to successfully deploy WXP Insights agent for Windows.

1. Downloading WXP Insights Agent for Windows (ZIP Package (.msi))

To download the WXP Insights agent:

1. Download and install the WXP Insights agent from the Download WXP Insights Software page.

   • For detailed instructions, refer to the article - Installing WXP Insights Agent Using ZIP Package (.msi)

2. Ensure the following contents of the WXPInsights.zip and WXPInsights-arm64.zip files are saved to a location accessible by SCCM.

   Note:

   For WXP Insights agent version 5.26.114, the executable files for x86 and Arm devices are renamed as follows:

   • HPInsights.zip  → WXPInsights.zip

   • HPInsights-arm64.zip →  WXPInsights-arm64.zip

   1. WXPInsights.zip Contents:

      • VC_redist.x86.exe

      • VC_redist.x64.exe

      • WXPInsightsAnalyticsDependencies.msi

      • WXPInsights.msi

      • WXPInsightsAnalytics.msi

        Note: For WXP Insights agent versions 5.26.114, the following files are also renamed:

        • HPInsightsAnalyticsDependencies.msi → WXPInsightsAnalyticsDependencies.msi

        • HPInsights.msi → WXPInsights.msi

        • HPInsightsAnalytics.msi → WXPInsightsAnalytics.msi

   2. WXPInsights-arm64.zip Contents:

      • VC_redist.arm64.exe

      • WXPInsightsAnalyticsDependencies.msi

      • WXPInsights.msi

      • WXPInsightsAnalytics.msi

        Note: For WXP Insights agent versions 5.26.114, the executable file for Arm devices is renamed toWXPInsights-arm64.zip from HPInsights-arm64.zipThe following files are also renamed:

        • HPInsightsAnalyticsDependencies.msi → WXPInsightsAnalyticsDependencies.msi

        • HPInsights.msi → WXPInsights.msi

        • HPInsightsAnalytics.msi → WXPInsightsAnalytics.msi

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

2. Creating an Application in SCCM (Creating the Necessary Applications in SCCM)

Given below are the details for creating the necessary applications to run the Workforce Experience Platform.

SCCM Applications must be created as per the target devices - Intel and Arm

• Intel Devices: Use from First application to Sixth application sections below, except second, and use contents inside WXPInsights.zip

• Arm Devices: Use 2nd, 3rd, 5th and 6th application sections below and use contents inside WXPInsights-arm64.zip

Note: For WXP Insights agent versions 5.26.114, the ZIP Package files are for Intel and Arm devices are renamed to WXPInsights.zip and WXPInsights-arm64.zip fromHPInsights.zip and HPInsights-arm64.zip respectively.

First application: Creating the VC++ redistributable (x86) application

To create a new SCCM application package to install the Workforce Experience Platform for Windows:

1. Log in to the SCCM Admin Console and start the Create Application Wizard.

2. In the SCCM Admin Console, click Software Library.

3. In the Software Library workspace, click Application Management > Applications. The existing applications are displayed.

4. Click Create Application located at the top.

5. Select Manually specify the application information, then click Next.

6. Type the following in the respective fields, then click Next:

   • Name: VC++ Redistributable (x86)

   • Publisher:  Microsoft

   • Version: 14.XX.XXXXX.X (replace with the version of the VC_redist.x86.exe file you are deploying)

7. Click Next to accept the defaults for the Application Catalog entry.

8. Click Add to create a new Deployment Type and select Script Installer.

9. Manually specify the deployment type information, which will automatically be selected, then click Next.

10. Type VC++ Redist (x86) silent install as the name for the Deployment Type and click Next.

11. In the Content Location, specify the Network path (UNC name) to the vc_redist.x86.exe file.

12. In the Installation Program, specify the following command:

    vc_redist.x86.exe /install /quiet /norestart

13. In the Uninstall Program, specify the following command, then click Next:

    vc_redist.x86.exe /uninstall /quiet /norestart

14. Click Add Clause to specify the detection rules and enter the following rules; then click OK and Next to proceed.

    • Setting Type: Registry

    • Hive: HKEY_LOCAL_MACHINE

    • Key: SOFTWARE\Microsoft\VisualStudio\14.0\VC\Runtimes\x86

    • Select This registry setting must exist on the target system to indicate the presence of this application

15. To specify the User Experience settings, select the following settings, then 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

    • Device Restart Behavior: No specific action

16. Click Next to accept the defaults for software dependencies.

17. Confirm the deployment details, then click Next.

18. When the completion screen is displayed, click Close.

19. In the Create Application Wizard, click Next to proceed.

20. Confirm the settings and click Next.

21. When the completion screen is displayed, click Close.

Second application: Creating the VC++ redistributable (Arm64) package

To create a new SCCM application package to install the Workforce Experience Platform for Windows:

1. Log in to the SCCM Admin Console and start the Create Application Wizard.

2. In the SCCM Admin Console, click Software Library.

3. In the Software Library workspace, click Application Management > Applications, then click Create Application.

4. Select Manually specify the application information and click Next.

5. Type the following in the respective fields and click Next:

   1. Name: VC++ Redistributable (Arm64)

   2. Publisher: Microsoft

   3. Version: 14.XX.XXXXX.X (replace with the version of the VC_redist.x64.exe file you are deploying)

6. Click Next to accept the defaults for the Application Catalog entry.

7. Click Add to create a new Deployment Type, then select Script Installer.

8. Manually specify the deployment type information, which will automatically be selected, and click Next.

9. Type VC++ Redist (Arm64) silent install as the name for the Deployment Type, and click Next.

10. In the Content Location, specify the Network path (UNC name) to the vc_redist.arm64.exe file.

11. In the Installation Program, specify the following command:

    vc_redist.arm64.exe /install /quiet /norestart

12. In the Uninstall Program, specify the following command, then click Next:

    vc_redist.arm64.exe /uninstall /quiet /norestart

13. To specify the detection rules, click Add Clause, and enter the following rules, then click**OK** and Next to proceed:

    1. Setting Type: Registry

    2. Hive: HKEY_LOCAL_MACHINE

    3. Key: SOFTWARE\Microsoft\VisualStudio\14.0\VC\Runtimes\Arm64

    4. Select This registry setting must exist on the target system to indicate the presence of this application

14. To specify the User Experience settings, select the following settings, then click Next:

    1. Installation behavior: Install for system

    2. Logon requirement: Whether or not a user is logged on

    3. Installation program visibility: Hidden

    4. Maximum allowed run time (minutes): 20

    5. Device Restart Behavior: No specific action

15. Click Next to accept the defaults for software dependencies.

16. Confirm the deployment details, then click Next.

17. When the completion screen is displayed, click Close.

18. In the Create Application wizard, click Next to proceed.

19. Confirm the settings, then click Next.

20. When the completion screen is displayed, click Close.

Third application: Creating the WXP Insights package

To create the WXP Insights package:

1. Log in to the SCCM Admin Console and start the Create Application Wizard. 

2. In the SCCM Admin Console, click Software Library.

3. In the Software Library workspace, click Application Management > Applications, then click Create Application at the top.

4. Select Windows Installer (*.msi file), specify the UNC path to the HP Insights.msi file, then click Next.

5. Verify the imported information and click Next.

6. Confirm the name of the application, then update the Installation Program command to:

   msiexec /i WXPInsights.msi CPIN=companypin HIDETRAY=True /qn /norestart /l*v tp-log.txt

Note: For WXP Insights agent versions 5.26.114,  msi file name has changed to WXPInsights.msi. It was below for previous version.

HPInsights.msi

Replace the placeholder companypin with the actual company PIN for your WXP Insights tenant.

To obtain the company PIN, log in to WXP. From the left menu of WXP, click Settings > Preferences. In the Preferences tab, scroll to the Company PIN section and copy the pin.

Note: To configure proxy settings for the Workforce Experience Platform for Windows, create a batch script to add the required regkeys and specify the batch script in the Installation Program. The HIDETRAY=True command must be written as specified in capital lettering. This command hides the WXP Insights system tray icon and all notifications.

1. Set Install behavior to Install for system.

2. Select the following User Experience setting, then click Next.

   1. Device Restart Behavior: No specific action

3. Click Next to confirm the settings for the application.

4. Confirm the settings, then click Next.

5. When the completion screen is displayed, click Close.

Note: The WXP Insights Analytics Client - Dependencies package cannot be installed on non-HP manufactured PCs, including virtual machines.

Modifying the WXP Insights package

To modify the WXP Insights package application settings:

1. In the left column of the SCCM Admin console, select Software Library > Application Management > Applications.

2. In the right pane, right-click the new WXP Insights application, then click Properties.

3. Select the Distribution Settings, tab, then select Automatically download content when packages are assigned to distribution points, then click OK.

4. Select the Deployment Types tab, then select the WXP Insights agent for Windows Installer (*.msi file) entry and click Edit.

5. Select the Programs tab, in the Uninstall program field, and specify the following command: None

   For uninstallation, refer to article - Uninstalling the WXP Insights Agent for Windows with SCCM or Microsoft Intune

6. Select the Detection Method tab and delete the existing detection for the MSI Product Code.

7. Click Add Clause and enter the following rules, then click OK and Next to proceed:

   • Setting Type: Registry

   • Hive: Click Browse… and select HKEY_LOCAL_MACHINE\SOFTWARE\Hewlett-Packard\HP Touchpoint Manager\Agent

   • Click OK.

8. Select the User Experience tab, and ensure the following settings are configured.

   • 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 Devices

   • Device Restart Behavior: No specific action

9. Select the Dependencies tab, then click Add.

   • In Dependency Group Name, type VC++ Redistributable (x86) as the group name.

   • Click Add and select the VC++ Redistributable (x86) app from the list of dependency apps, select the checkbox next to these applications, and click OK. 

   • Ensure that Auto Install is selected.

   • Click OK to create the dependency group.

10. Repeat Step 9 above by adding the second dependency VC++ Redistributable (Arm64)

11. Click Apply, then click OK to close the WXP Insights application Properties.

Fourth Application: Creating the VC++ redistributable (x64) package

To create a new SCCM application package to install the Workforce Experience Platform for Windows:

1. Log into the SCCM Admin Console and start the Create Application Wizard.

2. In the SCCM Admin Console, click Software Library.

3. In the Software Library workspace, click Application Management > Applications, then click Create Application at the top.

4. Select Manually specify the application information and click Next.

5. Type the following in the respective fields and click Next:

   • Name: VC++ Redistributable (x64)

   • Publisher:  Microsoft

   • Version: 14.XX.XXXXX.X (replace with the version of the VC_redist.x64.exe file you are deploying)

6. Click Next to accept the defaults for the Application Catalog entry.

7. Click Add to create a new Deployment Type, then select Script Installer.

8. Manually specify the deployment type information, which will automatically be selected, and click Next.

9. Type VC++ Redist (x64) silent install as the name for the Deployment Type, and click Next.

10. In the Content Location, specify the Network path (UNC name) to the vc_redist.x64.exe file.

11. In the Installation Program, specify the following command:

    vc_redist.x64.exe /install /quiet /norestart

12. In the Uninstall Program, specify the following command, then click Next:

    vc_redist.x64.exe /uninstall /quiet /norestart

13. To specify the detection rules, click Add Clause, and enter the following rules, then click OK and Next to proceed:

    • Setting Type: Registry

    • Hive: HKEY_LOCAL_MACHINE

    • Key: SOFTWARE\Microsoft\VisualStudio\14.0\VC\Runtimes\x64

    • Select This registry setting must exist on the target system to indicate the presence of this application

14. To specify the User Experience settings, select the following settings, then click Next:

    • Installation behavior: Install for system

    • Logon requirement: Whether or not user is logged on

    • Installation program visibility: Hidden

    • Maximum allowed run time (minutes): 20

    • Device Restart Behavior: No specific action

15. Click Next to accept the defaults for software dependencies.

16. Confirm the deployment details, then click Next.

17. When the completion screen is displayed, click Close.

18. In the Create Application Wizard, click Next to proceed.

19. Confirm the settings, then click Next.

20. When the completion screen is displayed, click Close.

Fifth Application: Creating the WXP Insights Analytics Client – Dependencies package

To create the WXP Insights Analytics client - dependencies package:

1. Log in to the SCCM Admin Console and start the Create Application Wizard.

2. In the SCCM Admin Console, click Software Library.

3. In the Software Library workspace, click Application Management > Applications, then click Create Application at the top.

4. Select Windows Installer (*.msi file), specify the UNC path to the WXPInsightsAnalyticsDependencies.msi file, then click Next.

5. Verify the imported information then click Next.

6. Confirm the name of the application, then update the Installation Program command to:

   msiexec /i WXPInsightsAnalyticsDependencies.msi /q /norestart

   1. Note: For WXP Insights agent versions 5.26.114, the msi name has changed to WXPInsightsAnalyticsDependencies.msi fromHPInsightsAnalyticsDependencies.msi

7. Set Install behavior to Install for system.

8. Select the following User Experience setting, then click Next.

   1. Device Restart Behavior: No specific action.

9. Click Next to confirm the settings for the application.

10. Confirm the settings, then click Next.

11. When the completion screen is displayed, click Close.

Note: The HP Insights Analytics Client - Dependencies package cannot be installed on non-HP manufactured PCs, including virtual machines.

Sixth Application: Creating the WXP Insights Analytics Client package

To create the WXP Insights Analytics client package:

1. Log in to the SCCM Admin Console and start the Create Application Wizard.

2. In the SCCM Admin Console, click Software Library.

3. In the Software Library workspace, click Application Management > Applications, then click Create Application at the top.

4. Select Windows Installer (*.msi file), specify the UNC path to the WXPInsightsAnalytics.msi file, then click Next.

5. Verify the imported information and click Next.

6. Confirm the name of the application, then update the Installation Program command to:

   msiexec /i WXPInsightsAnalytics.msi /qn /norestart /l*v ta-log.txt

   1. Note: For WXP Insights agent versions 5.26.114, msi name has changed to WXPInsightsAnalytics.msi fromHPInsightsAnalytics.msi

7. Set Install behavior to Install for system.

8. Select the following User Experience setting, then click Next.

   1. Device Restart Behavior: No specific action.

9. Click Next to confirm the settings for the application.

10. Confirm the settings, then click Next.

11. When the completion screen is displayed, click Close.

Modifying the WXP Insights Analytics Client package

To modify the WXP Insights Analytics Client package:

1. In the left column of the SCCM Admin Console, click Software Library > Application Management > Applications.

2. In the right pane, right-click the new WXP Insights Analytics Client application, then click Properties.

3. Select the Distribution Settings tab, then select Automatically download content when packages are assigned to distribution points, then click OK.

4. Select the Deployment Types tab, then select the WXP Insights Analytics Client – Windows Installer (*.msi file) entry, then click Edit.

5. Select the Detection Method tab and delete the existing detection for the MSI Product Code.

6. Click Add Clause and enter the following rules, then click OK and Next to proceed:

   • Setting Type: File System

   • Type: File

   • Path: %ProgramFiles(x86)%\ HP\HP Touchpoint Analytics Client

   • File or folder name: TouchpointAnalyticsClientService.exe

   • Select the check box for The file system setting must satisfy the following rule to indicate the presence of this application.

     • Property: Version

     • Operator: Greater than or equal to

     • Value: <replace with the version of the WXPInsightsAnalytics.msi being deployed>

     • Associated with a 32-bit app on 64-bit clients: Yes

7. Select the User Experience tab, and ensure the following settings are configured:

   • 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

   • Device Restart Behavior: No specific action

8. Select the Dependencies tab, then click Add.

   • In Dependency Group Name, type VC++ Redistributable (x64) as the group name.

   • Click Add and select the VC++ Redistributable (x64) app from the list of dependency apps.

   • Select the checkbox next to these applications, then click OK.

   • Ensure that Auto Install is selected.

   • Click OK to create the dependency group.

9. Repeat Step 8 above by adding the second dependency (WXP Insights Analytics Client - Dependencies) and third dependency (HP Insights Manager Application), and fourth dependency VC++ Redistributable (Arm64), each with its own Dependency group name.

10. Click Apply, then click OK to close the WXP Insights Analytics application Properties.

3. Distributing the Content to Distribution Points (DPs)

To distribute WXP Insights agent for Windows and dependencies content to the SCCM DPs:

1. In the left column of the SCCM Admin console, click Software Library > Application Management > Applications.

2. In the right pane, right-click the new WXP Insights application > Distribute Content.

3. In the Distribute Content Wizard on the General page, click Next.

4. Review the content to distribute, then click Next.

5. A meter will appear showing distribution progress. Review the actions taken, then click Close.

6. Repeat the same steps above for the VC++ Redistributable (x86), VC++ Redistributable (x64), WXP Insights Analytics Client, and WXP Insights Analytics Client - Dependencies applications.

Verifying Content Status on Distribution Points (DPs)

In large environments where DPs are geographically dispersed, it is best practice to verify the content status before deploying Workforce Experience Platform for Windows.

To verify the content status:

1. In the SCCM Admin console, click Monitoring > Distribution Status > Content Status.

2. Right-click each application: VC++ Redistributable (x86), VC++ Redistributable (x64), WXP Insights, WXP Insights Analytics Client, WXP Insights Analytics Client – Dependencies applications, then click the View Status.

3. Verify the package has been successfully copied to all DPs before proceeding.

4. Deploying WXP Insights Agent with SCCM

Deploying WXP Insights Manager with SCCM:

1. In the left column of the SCCM Admin console, click Software Library > Application Management > Applications.

2.  In the right pane, right-click the new WXP Insights agent.

3. In the Deploy Software Wizard, click Browse next to collections.

4. Then select the Device Collection(s) to which the package will be deployed.

5. Click OK, then click Next.

6. Click Next to accept the content destination settings.

7. Select Required for the WXP Insights application, then click Next.

8. 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.

9. Select the Detection Method tab and delete the existing detection for the MSI Product Code.

10. Click Add Clause and enter the following rule, then click OK.

11.  User notifications: Hide in Software Center and all notifications.

12. Click Next to proceed.

13. Click Next to accept the default alert options.

14. Confirm the settings for the deployment, then click Next.

15. Review the actions taken, then click Close.

Deploying the WXP Insights Analytics Client Application with SCCM

To deploy the WXP Insights Analytics for Windows Application in SCCM:

1. In the left column of the SCCM Admin Console, click Software Library > Application Management > Applications. All existing applications are displayed.

2. In the right pane, right-click the new WXP Insights Analytics Client application.

3. In the Deploy Software Wizard, click Browse next to Collections.

4. Select the device collection(s) to which the package will be deployed, then click OK.

5. Click Next.

6. Click Next to accept the content destination settings.

7. Select Required for the WXP Insights agent, then click Next.

8. 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.

9. Select the following User Experience setting, then click Next:

   1. User notifications: Hide in Software Center and all notifications.

10. Click Next to accept the default alert options.

11. Confirm the settings for the deployment, then click Next.

12. Review the actions taken, then click Close.

Contact Us

For any assistance, create a support case or email support@wxp.hp.com

—