Deploying WXP Insights Agent for macOS via Jamf Pro

This article covers the configuration and deployment of the WXP Insights agent for macOS using Jamf Pro on macOS devices.

Prerequisites

Obtain a company-wide PIN from Workforce Experience Platform.
1. From the left menu of WXP, click Settings > Preferences. The Preferences tab is displayed
2. In the Preferences tab, scroll down to the Company PIN section and copy the pin.
Download the agent from the Download WXP Insights Agent Software page.
Download and install the Jamf Pro Installer.pkg.
Copy and save the necessary script(s) based off of the below options to configure the application in Jamf Pro console:
- If device does not need the option to hide the menu bar, copy the Enrollment.shscript text below.
- If device needs the option to hide the menu bar, copy the Enrollment_Tray.sh script text below.
- If device has already been enrolled with the WXP Insights agent or auto-upgraded to macOS version 2.23.6 and wishes to have the menu bar icon to be hidden, copy the ShowTray.sh and HideTray.sh script text below.

Note: If device is enrolled, see the Enrolled Devices installation section below.

Scripts to Configure the Application in Jamf Pro Console

Enrollment.sh
- This script will enroll the device without user interaction through silent enrollment.
- The CPIN will need to be updated within the script.

Enrollment_Tray.sh (Applicable from macOS application version 2.23.6)
- This script will enroll the device without user interaction through silent enrollment.
- This will hide the tray (menu bar).
- The CPIN will need to be updated within the script.

ShowTray.sh (Applicable from macOS application version 2.23.6)
- This script will show the tray (menu bar) icon.
- This script is required for devices that have already enrolled the WXP Insights agent.

HideTray.sh (Applicable from macOS application version 2.23.6)
- This script will hide the tray (menu bar) icon.
- This script is required for devices that have already enrolled the WXP Insights agent.

Enrollment.sh Script

Note: In the below script, replace PIN with the actual company PIN.

#!/bin/bash
APPLICATION_SUPPORT_DIRECTORY=/etc/APMAgent
PIN=#########

if [ -d $APPLICATION_SUPPORT_DIRECTORY ]
then
echo "Directory Exists"
else
echo "Directory Does not exist, creating directory"
mkdir "$APPLICATION_SUPPORT_DIRECTORY"
fi
echo "{\"PIN\":\"$PIN\"}" > "$APPLICATION_SUPPORT_DIRECTORY/enrollment.json"

if [ "$APPLICATION_SUPPORT_DIRECTORY\enrollment.json" ]
then
echo "Successfully stored Data at
$APPLICATION_SUPPORT_DIRECTORY/enrollment.json"
cat "$APPLICATION_SUPPORT_DIRECTORY/enrollment.json"
exit 0
else
echo "Unable to store Data"
exit 1
fi
exit 1

Enrollment_Tray.sh Script

Note: In the below script, replace PIN with the actual company PIN.

#!/bin/bash
APPLICATION_SUPPORT_DIRECTORY=/etc/APMAgent
PIN=#########
if [ -d $APPLICATION_SUPPORT_DIRECTORY ]
then
echo "Directory Exists"
else
echo "Directory Does not exist, creating directory"
mkdir "$APPLICATION_SUPPORT_DIRECTORY"
fi
echo "{\"PIN\":\"$PIN\",\"HideTray\":\"true\"}" > "$APPLICATION_SUPPORT_DIRECTORY/enrollment.json"
if [ "$APPLICATION_SUPPORT_DIRECTORY\enrollment.json" ]
then
echo "Successfully stored Data at
$APPLICATION_SUPPORT_DIRECTORY/enrollment.json"
cat "$APPLICATION_SUPPORT_DIRECTORY/enrollment.json"
exit 0
else
echo "Unable to store Data"
exit 1
fi
exit 1

ShowTray.sh Script

#!/bin/bash
APPLICATION_SUPPORT_DIRECTORY=/etc/APMAgent
if [ -d $APPLICATION_SUPPORT_DIRECTORY ]
then
echo "Directory Exists"
else
echo "Directory Does not exist, creating directory"
mkdir "$APPLICATION_SUPPORT_DIRECTORY"
fi
echo "{\"HideTray\":\"false\"}" > "$APPLICATION_SUPPORT_DIRECTORY/enrollment.json"
if [ "$APPLICATION_SUPPORT_DIRECTORY\enrollment.json" ]
then
echo "Successfully create enrolment json at
$APPLICATION_SUPPORT_DIRECTORY/enrollment.json"
cat "$APPLICATION_SUPPORT_DIRECTORY/enrollment.json"
exit 0
else
echo "Unable to store PIN"
exit 1
fi
exit 1

HideTray.sh Script

#!/bin/bash
APPLICATION_SUPPORT_DIRECTORY=/etc/APMAgent
if [ -d $APPLICATION_SUPPORT_DIRECTORY ]
then
echo "Directory Exists"
else
echo "Directory Does not exist, creating directory"
mkdir "$APPLICATION_SUPPORT_DIRECTORY"
fi
echo "{\"HideTray\":\"true\"}" > "$APPLICATION_SUPPORT_DIRECTORY/enrollment.json"
if [ "$APPLICATION_SUPPORT_DIRECTORY\enrollment.json" ]
then
echo "Successfully create enrolment json at
$APPLICATION_SUPPORT_DIRECTORY/enrollment.json"
cat "$APPLICATION_SUPPORT_DIRECTORY/enrollment.json"
exit 0
else
echo "Unable to store PIN"
exit 1
fi
exit 1

Uploading and Configuring the Application in Jamf Pro Console

Configuring the WXP Insights agent differs depending on whether the device is enrolled or unenrolled in the agent. The instructions for both iterations can be found below:

Unenrolled Devices

In the Jamf Pro console, select Computers > Management Settings.
Under Computer Management, select Packages.
In the Packages window, click New to add the WXP Insights agent package previously downloaded.
- Display Name: Enter the name of the package
- Category: Select Applications
- Filename: Upload the WXP Insights macOS Application package file
Click Save.
In Computer Management section, select Scripts.
In the Scripts window, click New to add the HP Insights install script.
- Display Name: Enter the name the script
- Category: Scripts
Click Save.
Select the Script tab and copy the script selected above. Ensure the in the script is replaced with the actual company PIN.
Select the Options tab.
- In Priority, select After.
Click Save.
Select the Computers tab and click Policies.
Click New.
1. In the General section:
  - Display Name: Enter the name of the policy
  - Check Enabled
  - Category: Select Applications
  - Trigger: Check Enrollment Complete and Recurring Check-i
2. In the Packages section, click Configure.
  - Select the package previously created.
  - Distribution Point: Select Each computer's default distribution point.
  - Action: Select Install
3. In the Scripts section, click Configure.
  - Select the script previously created.
  - Priority: Select After
  - In the Scope tab, target the devices per your needs.
  - In the Self-Service tab, check Make the policy available in Self Service
  - Self Service Display Name: Enter the name and a description of the package
  - Button Name: You can also add in an icon
Click Save.

Enrolled Devices

If the device has already had the WXP Insights agent installed and the user would like to toggle hiding the menu bar application, the user can proceed by running the ShowTray.sh or HideTray.sh scripts in the console. The process will be the same as listed above with Devices that Have not Been Enrolled; however, when entering the scripts, input sudo bash ./ShowTray.sh or sudo bash ./HideTray.sh respectively.

Note: When using ShowTray.sh or HideTray.sh, providing the PIN is not necessary.

Contact Us

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

Documentation Index