Introduction
The HP Insights Network Readiness Tool for Windows devices enables you (IT administrators) to confirm that the network is set up correctly before installing the HP Insights Windows Application (also called the Windows Agent) for the HP Workforce Experience Platform (WXP).
Firewall policies of organizations may block the installation of the HP Insights Windows Application, which is needed to use WXP. Running the tool before installation helps you fix problems related to firewalls, proxies, or restricted endpoints.
This article provides a step-by-step guide for the following topics:
Running the Network Readiness Tool:
Without a Proxy Server
With a Proxy Server (Autodetect)
With a Static Proxy Server
Target Audience
Primary audience:
IT administrators and support personnel who set up and manage the platform (All roles).
HP Partners who use the platform to manage their customers.
Internal and external developers who integrate with the platform.
Secondary audience: Decision-makers, such as Product Managers, Sales team, and C-suite executives.
Step 1. Downloading and Launching the Readiness Tool
Access the URL - https://workforceexperience.hp.com/software. The Download HP Insights Software page is displayed.
Download the latest version of the HP Insights Network Readiness Tool to a Windows device. A zipped folder is downloaded to your system.
Unzip the folder to extract the files. The files within the folder are displayed.
Launch the tool by double-clicking the file named
HPInsightsNetworkReadinessTool.exe
. The UI for the tool is displayed.
Step 2. Obtaining the UPN Suffix for Silent Enrollment
When the Readiness Tool is launched, it automatically obtains the User Principal Name (UPN) suffix for the logged-in user and display it on the top-right corner of the screen.
(Optional) For silent enrollment, the UPN suffix must be sent to HP support.
The default UPN suffix for WXP company tenant is automatically configured based on your Primary Contact. If corrections or additions are required, contact HP support.
To identify the correct support, sign in to WXP and access the Help and Support page.
For detailed instruction to obtain the UPN, refer to this article - Obtaining UPN Domain-Suffix.
Step 3. Running the Network Readiness tool
Depending on your scenario, use one of the following options:
Running the tool without a Proxy Server
Running the tool with a Proxy Server (Autodetect)
Running the tool with a Static Proxy Server
Running the Network Readiness Tool without a Proxy Server
If your devices are not connected to internet through a proxy server, run the tests with direct internet access.
In the Readiness tool, access the Basic tab.
Select
No
for the question - Does your network have a proxy?Click Run Tests. The result of each test is displayed.
If all tests Pass, the network is properly configured to use the Workforce Experience Platform.
If one or more tests Fail, refer to the Troubleshooting section.
Running the Network Readiness Tool with a Proxy Server (Autodetect)
If your devices are connected to internet through a proxy server, run the tool with the proxy option configured. This determines how the Windows Agent discovers your proxy server. The tool runs through three sets of test scenarios (WPAD, IE proxy settings, and Direct internet access) until a scenario passes.
In the Readiness tool, access the Basic tab.
Select
Yes
for the question - Does your network have a proxy?By default, the Autodetection option is selected for the Proxy detection mode.
Web Proxy Autoconfiguration Protocol (WPAD)
Internet Explorer Proxy Settings:
Proxy Autoconfiguration URL
Static Proxy
If the proxy cannot be discovered, the tests will run with direct internet access.
Click Run Tests.
If all tests Pass for a scenario, the network is correctly configured to use WXP.
If one or more tests Fail, refer to the Troubleshooting section below.
Running the Network Readiness Tool with a Static Proxy Server
To configure the Windows Agent to use a static proxy server, follow these steps to run all tests through a static proxy server:
In the Readiness tool, access the Basic tab.
Select
Yes
for question - Does your network have a proxy?For Proxy detection mode, select the option Specify proxy.
Enter the static proxy server address, such as: http://autocache.proxy.com:8080.
Click the Run Tests button.
If all tests Pass, the network is properly configured to use the Workforce Experience Platform.
If one or more tests Fail, refer to the Troubleshooting section below.
Troubleshooting
Below are some of the common failure reasons and their corrective measures:
If the failed tests show the error (407) Proxy Authentication Required, ensure that:
All required domains and ports for WXP are listed as
Allowed
when using a proxy server that requires authentication.For additional information, refer to the following article - Configuring Domains to Allow Communication for WXP for a complete list of required domains and ports.
If the failed tests show the error The operation has timed out, ensure the following:
The device has a working internet connection.
The correct option is selected in the tool for the question - Does your network have a proxy?
There is no content filtering within the network that is blocking access to the required domains.
There are no Domain Name System (DNS) resolution issues that is preventing the domain names from being resolved.
All domains and ports required for WXP are listed as
Allowed
if using a proxy server that requires authentication.Refer to the article - Configuring Domains to Allow Communication for WXP for a complete list of required domains and ports
Exporting the Network Readiness Tool Logs
After running the tests, if there are failures that require additional analysis, follow these steps to export the Network Readiness Tool logs:
Click Export. A Comma Separated Values (CSV) file is generated in the same directory as the Readiness Assessment Tool.
Send this .CSV file to HP Support. To identify your proper HP support contact, please sign in to HP Workforce Experience and view the Help and Support page.
Related Resources
For additional information, refer to the following articles:
Contact Us
For any assistance, create a support case or email `[email protected]`.