JumpCloud is a platform for remotely managing devices, applications, and configurations on an organizational level. You will find instructions for remotely enabling necessary permissions and installing Insightful on macOS company-managed devices.
This document provides a step-by-step guide for deploying custom configuration profile policy and Insightful deployment to end users. Prerequisites are to have targeted users and devices enrolled through JumpCloud and connected.
Step 1: Deploy a Configuration profile
A Configuration profile is a settings file used to configure devices. Deploying it on your employees' MacOS devices will ensure that the necessary permissions are enabled for Insightful to function properly.
You can find instructions for obtaining the configuration profile in our article on How to handle macOS permissions remotely via configuration profiles.
Log in to the JumpCloud Admin Portal.
Go to DEVICE MANAGEMENT → Policy Management.
3. In the All tab, click (+).
4. On the New Policy panel, select the Mac tab.
5. Select MDM Custom Configuration Profile from the list, then click configure.
6. (Optional) Edit the Policy Name to enter a new name for the custom configuration profile policy or keep the default. In addition, you can add a description of the configuration policy per your demands.
7. By scrolling down on the same page, under Settings, click Upload file.
8. Select the .mobileconfig file(s) our Support Team provided and click Open.
9. (Optional) Select the Device Groups tab, then select one or more device groups on which to apply the policy.
10. (Optional) Select the Devices tab, then select one or more devices on which to apply the policy.
11. Click Save.
Step 2: Deploy the installation script
After deploying a configuration profile, go back to the Home page.
Navigate to the Commands Section:
In the left-hand menu, go to Commands under the Device Management section.
3. Create a New Command:
Click the + Add New Command button.
4. Fill in the following details:
Name: Give your command a descriptive name, eg. Insightful deployment
Command Type: Select
macOS.Execution User: Choose the root user under which the script will run (
rootis for administrative privileges or a specific user).
5. Command: In the next steps you will find instructions for creating your own installation script.
Put #!/bin/bash in the first line of the script.
Go to your Insightful admin dashboard:
Go to the Employees tab.
Click on the Add New Employee button.
Select Company Computers.
Select macOS.
Copy the code you see using Copy Code.
Paste the code in the second line of the Command field in JumpCloud.
Please note that the script on the screenshot above is just the example script with grayed-out parts, while you should create yours per instructions in the previous step.
Timeout: Set a timeout for the script execution (optional).
Launch Event: You can choose Run as Scheduled and choose at which time you want to execute the command and install Insightful or you can choose Run at Next JumpCloud Login.
6. Save the Command:
Click Save to store the command.
Step 3: Associate the Command with a Device or Group:
After saving, click on the created command.
2. Switch to the Device Group or Devices and select the macOS device(s) or group(s) where you want to run the script:
3. Run the Command:
Once the command is associated with a device or group, you can run it manually:
Go to the Commands section.
Find the command you created and click Run Now:
4. Check Results:
After running the command, you can view the results in the Commands section.
JumpCloud will show the output of the script and whether it succeeded or failed.