Nightfall Agent Deployment with JAMF MDM

This document explains the process of installing Nightfall AI agent using JAMF.

The JAMF installation consists of the following steps.

Prerequisites

  • Target macOS devices are onboarded.

  • You have received and unpacked the Nightfall Endpoint Agent payload.

1

Step 1 - Upload Device Profiles to Jamf Pro

  1. Unpack the zip file provided and locate the .mobileconfig files under the .\\Profiles\\ folder

  2. Log in to your Jamf Pro account.

  3. Navigate to Computers > Configuration Profiles.

  4. Click the New button.

  5. Configure the settings for your configuration profile.

  6. Click the Upload button and upload NightfallAI_ApplicationSystemEvents.mobileconfig.

  7. In the Scope tab, add the target devices or device groups to which this profile should be deployed.

  8. Click Save.

  9. Repeat steps 3-6 for NightfallAI_Notification.mobileconfig and NightfallAI_PPPC.mobileconfig.

Once assigned, profiles will be automatically deployed as part of the next Jamf inventory cycle.

2

Step 2 - Upload and Add Pre-Installation Check Script

This script checks if the required profiles are installed and that the endpoint agent is at the desired version.

  1. Unpack the zip file provided and locate the mdm_pre_installation_check_script.sh file under the .\\mdm_scripts\\ folder

  2. On Jamf Pro, navigate to Computers > Scripts.

  3. Click the New button.

  4. Enter a display name for the script (e.g., "Nightfall AI Pre-Installation Check").

  5. Click on the Script tab

  6. Paste the contents of mdm_pre_installation_check_script.sh into the script editor.

  7. Click Save.

3

Step 3 - Upload and Add the Pre-Installation Script

This script configures the target machine and prepares it to connect to your Nightfall instance once the package is deployed.

  1. Locate the mdm_pre_installation_script.sh file under the .\\mdm_scripts\\ folder

  2. On Jamf Pro, navigate to Computers > Scripts.

  3. Click the New button.

  4. Enter a display name for the script (e.g., "Nightfall AI Pre-Installation Script").

  5. Paste the contents of mdm_pre_installation_script.sh into the script editor.

  6. Click Save.

4

Step 4 - Upload the Nightfall App Package

  1. Navigate to Settings > Packages.

  2. Click the New button.

  3. Enter a display name for the package (e.g., "Nightfall AI Agent").

  4. Click the Choose File button and upload nightfall-ai-agent-signed.pkg.

  5. Click Save.

5

Step 5 - Create a Policy and Add scripts and package

  1. Navigate to Computers > Policies.

  2. Click the New button.

  3. Enter a display name for the policy (e.g., "Deploy Nightfall AI").

  4. Click General from the left pane & configure the Trigger and Execution Frequency as needed.

  5. Click Package from the left pane & click on configure

  6. Add Nightfall AI Agent package

  7. Click on Scripts from the left pane & click on configure

  8. Add Pre-Install Check Script and Pre-Install Script. Ensure the Priority is Before and the sequence is [ The scripts must be run once & in sequence to prepare the machine for the package install. ] -

    1. Pre-Install Check Script

    2. Pre-Install Script

  9. Click on Scope and determine the Target, Limitations, and Exclusions per need.

  10. Click Save.

Last updated