Already a NinjaOne customer? Log in to view more guides and the latest updates.

NinjaOne Patching: Third-Party Software Patch Management for Apple macOS

Topic

This article discusses software patching for Apple macOS applications in NinjaOne and explains how to activate, configure, and view patching activity.

Environment

NinjaOne Patching

Description

NinjaOne Patch Management allows you to create patching policies that automatically scan for and apply new software patches for your macOS endpoints.

Select a topic to continue.

Pending Reboots

If a patch requires a reboot that has not yet been performed on a device, as specified in the reboot options, NinjaOne will display a Pending reboot icon. Refer to our Pending Reboots article for more information.

If a reboot is pending, the patch scan and apply functions will not occur for this device until the device completes the reboot.

Enabling Software Patch Management

You must activate software patching before you can use it to manage software patching.

  1. In NinjaOne, click AdministrationPolicies, then select a macOS policy from the Agent policies list.
3OO Mac_Nav.png
Figure 1: Administration → Policies → Agent policies (click to enlarge)
  1. Click the Software patching configuration tab, then activate the Enable software patching toggle.
ReorderPatching_MacOS_Enable.png
Figure 2: Software patching → Enable software patching (click to enlarge)

Configuring Software Patching Settings

Options in the Settings tab include scanning and patching, required software installation, and maintenance. When you finish your configuration, click Save to apply the new settings.

PP_MacGeneralSettings2.png
Figure 3: Patching configuration settings (click to enlarge)

General Settings Explained

Use the table below to learn more about each setting.

SettingDescription
Scan schedule

This parameter set determines when the device will scan for available new patches. 

  • Schedule: Use the drop-down menu to select the scan frequency.
  • Days: If your scan interval is longer than daily, select which days of the week the system should perform the scan. Devices are patched only on the days selected. If you do not select any days, NinjaOne will display an error message.
  • Time and Time Zone: Select the time of day and the appropriate time zone to perform the scan. By default scans start at 8 A.M. local device time and updates start at 5 P.M. local device time. These defaults only apply to new policies.
  • Stagger over: Set a stagger interval to distribute patch installation times across your devices and avoid simultaneous updates. For more information, refer to NinjaOne Patch Management: Load Balancing Patch Installations With the Stagger Feature.
  • Run scan immediately, if missed: Select this checkbox to run a scan immediately upon saving your settings.
  • Apply immediately: Select this checkbox to have the system apply patches immediately when it finds them in a scan. 
Update schedule

These settings specify when NinjaOne should apply the updates it finds when scanning. 

  • Schedule: Use the drop-down menu to select the update frequency.
  • Days: If your update schedule is longer than daily, select which days of the week the system should perform the update. Devices are patched only on the days selected. If you do not select any days, NinjaOne will display an error message.
  • Time and Time Zone: Select the time of day and the appropriate time zone to perform the update. By default scans start at 8 A.M. local device time and updates start at 5 P.M. local device time. These defaults only apply to new policies.
  • Stagger over: Set a stagger interval to distribute patch installation times across your devices and avoid simultaneous updates. For more information, refer to NinjaOne Patch Management: Load Balancing Patch Installations With the Stagger Feature.
  • Run update immediately, if missed: Select this checkbox to run an update immediately.
  • Maintenance Mode: Suppress Emails, SMS, and Push notifications: Select this checkbox to prevent NinjaOne from sending alerts caused by actions occurring during the update (such as device reboots). You can refine this setting by selecting the Suppress condition alerts and Suppress notification channels checkboxes. Refer to NinjaOne Platform: Maintenance Mode for more information. 
Update notifications

Select how NinjaOne notifies users when the system needs to update software that cannot be patched in the background. The current setting will show as a link in this section. Click the link for the following additional options:

  • Notify the user, then close the software and update.
  • Automatically close software and update.
  • Do not close open software.

Applications must be closed to apply an update fully. If an application is still open when NinjaOne attempts to install an update, the installation will fail, and the following error will appear in the activity log: "One or more products failed to update due to application running state."

Closing an open application can result in the loss of any unsaved data. When selecting an automatic close option, we recommend scheduling updates during off-peak hours, when users are less likely to actively use their systems.

Reboot options

These settings let you specify reboot behavior after NinjaOne patches a device. You can configure settings for both logged-in and logged-out users. If an end user interacts with a reboot prompt, NinjaOne will display an activity in the Device's Activity feed. Refer to Device and System Activity Notification Feed for more information.

Reboot options: Logged-in user:

Here you can configure the following settings:

  • Prompt to reboot until reboot accepted: NinjaOne will display an on-screen prompt instructing the user to reboot and allow the update to complete.
    • Use the scheduling options to determine the prompt frequency.
    • Select the Force reboot after checkbox to set the number of prompts before NinjaOne automatically reboots the device.
    • Select the Custom reboot dialog checkbox to replace the default prompt with your own text.
  • Notify the user, then reboot: Select this option to send the user a notification, then automatically reboot the machine and complete the update. Refer to NinjaOne Platform: Notification Channels for more information. Use the scheduling options to determine how long NinjaOne should wait before sending the notification and triggering the reboot. NinjaOne will display your chosen prompt schedule in this section. 
  • Automatically reboot: This option tells NinjaOne to reboot the device after the update installation is complete. Use the scheduling options to determine how long NinjaOne should wait before rebooting the device.
  • Do nothing: NinjaOne will not perform any automatic reboot actions on the device.
  • Period and Unit: If you selected Prompt the user to reboot until reboot accepted, use these fields to specify the prompt frequency. Select the checkbox to force a reboot after a specific number of prompts.
  • Custom Reboot Dialog: Select this checkbox to add custom text to the reboot prompt.

Reboot options: Not logged in user:

Here you can configure the following settings:

  • Attempt to reboot until successful: NinjaOne will keep trying to reboot the device, even if reboots fail, until it completes the action. Use the scheduling options to determine the reboot attempt frequency. 
  • Reboot immediately: NinjaOne will reboot the device as soon as the update is ready.
  • Do nothing: NinjaOne will take no action to reboot the device. 
  • Schedule: Use the drop-down menu to select the prompt frequency.
  • Time and Time Zone: Select the time of day and appropriate time zone to perform the reboot. 
ApprovalsIn this section, you can configure approval settings for all NinjaOne software not listed on the Software tab. Click the Edit link to automatically approve, reject, or require manual approval for Critical and Recommended patches. Refer to NinjaOne Dashboards: Software Inventory for more information.
Approval overrides

Here, you can set NinjaOne to override your patching policy for specific patches. Click the link to open the Overrides list, then search for the patch name. Use the second drop-down menu to select whether to approve or reject the patch.  

Examples of scenarios in which patches would appear in the Overrides section:

  • If the category approval is set to Manual, and you then approve or reject the patch for the policy.
  • If the category approval is set to Approve, and you then manually reject the patch for the policy.
  • If the category approval is set to Reject, and you then manually approve the patch for the policy.

Software Tab Actions and Settings

The Software tab is where you can select which applications you would like to include in NinjaOne's software patching. From here, you can also configure approval settings for critical and recommended patches and specify if you wish to use the current policy when installing the updates.

When you activate software patching for a product, NinjaOne downloads all updates for that product on the machines affected by the policy. Those updates remain downloaded as long as you have software patching activated for that product.

The Software Library

NinjaOne stores available applications in the Software library, which shows you the following information:

ColumnDescription
PublisherShows the vendor or organization responsible for developing and distributing the application.
SoftwareLists the official name and versioning of the specific application or package.
3PP Mac_SoftwareLibrary.png
Figure 4: The Software library (click to enlarge)

Adding Software to the Scheduled Patching List

To add new software to be installed and patched:

  1. On the policy's configuration page, navigate to Software patchingSoftwareAdd software.
3PPMac_SoftewareConfigSettings3.png
Figure 5: Software patching → Software → Add software (click to enlarge)
  1. The Software library window will open. Select the checkbox for any new software, then click Add.
Freshinstall_NewFig6.png
Figure 6: Add application from the Software library (click to enlarge)

Editing Patching Settings For Added Software

After adding new software, you can configure the approval and install settings for each patch type.

  1. Select the software (or select Select All), then click Edit.
3PPMac_EditingPatchingSettings.png
Figure 7: Editing added software (click to enlarge)

In the Edit software window, configure the following options:

OptionDescription
Critical patchesSpecify automatic installation behavior for critical patches. Select Approve, Manual, or Reject. Refer to the Patch Approval Options section of this article to learn more.
Recommended patchesSpecify automatic installation behavior for recommended patches. Select Approve, Manual, or Reject. Refer to the Patch Approval Options section of this article to learn more.
Install if application not presentAfter adding software, you can configure NinjaOne to automatically install many supported applications if they are not already found on devices in the policy. Select Yes to automatically install the application on machines where it is missing. If you select No, the installer for that software shows in the Rejected software tab. You can approve the installation at a later time.
Enable self-serviceMake the application available to allowed end users in the End-user portal. The end users must be the assigned owners of the applicable devices.
Win3PP_UI_EditSoftwareModal.png
Figure 8: The Edit software window (click to enlarge)

Patch Approval Options

You can select one of three options for Critical and Recommended patches:

  • Approve: Automatically approves all patches for the next update cycle.
  • Manual: Patches in this category appear in a "pending" state, requiring manual approval or rejection (for either the devices or the entire policy).
  • Reject: Automatically rejects all patches for that category.

Viewing Patch Scan and Installation Attempts

NinjaOne provides multiple ways to view patches installed on your system, patches pending installation, or patches that failed to install.

Viewing by Status in NinjaOne Dashboard

You can view patches found and patches installed in the System dashboard's PatchingSoftware patches tab. Use the flyout menu to filter by patch status (Pending, Approved, Rejected, Installed, or Failed). Once a patch has attempted to install during an update cycle, you can view its details in the Software tab of the dashboard.

Win3PP_UI_SoftwareTab.png
Figure 9: Dashboard → Patching → Software patches (click to enlarge)

Viewing Patches by Release Date

Check the Release date column to learn the patch release date. If the manufacturer does not provide the release date, NinjaOne will use the first detected date instead.

3PP Mac ReleaseDates.png
Figure 10: The Release Date column in the patch list (click to enlarge)

Viewing Applicable Devices for a Patch

At the System or Organization dashboard level, you can click the number in the Devices column to list the devices to which the patch status applies. For example, clicking the number for a patch in the Approved tab shows the devices for which it is approved (but not yet installed).

3PP Mac Pending Patches.png
Figure 11: Dashboard → Pending patches (click to enlarge)

Viewing Installed Applications

  1. After you configure patching, the applications will appear when you select Expand all. An N/A install status indicates that the manufacturer does not support installation for that software. Refer to the list of supported products below for more information about which options support installations.

    3PP_UI_NASoftware.png
    Figure 12: Unsupported software in the Software list (click to enlarge)

Manually Scanning For or Applying Updates

You can run a manual patching cycle at any time.

On a Single Device

You can run a manual patch scan and update cycle on demand from any endpoint. To do so, navigate to the Device overview, place your cursor over the Play action button, and select PatchingSoftware scan (to scan for new patches) or Software update (to apply existing patches).

3PP_Mac_SelectSingle.png
Figure 13: Run → Patching → Software update (click to enlarge)

On Multiple Devices

To scan and apply patches on multiple devices:

  • The devices must be the same type.
  • You must activate software patching for the policy that governs the device.
  • Selected devices must be online.

Procedure

  1. In the Devices tab, select the checkboxes for the devices on which to run the scan and update cycle.
  2. Place your cursor over the Run button, then navigate to PatchingSoftware updateSoftware scan (to scan for new patches) or Software update (to apply existing patches). NinjaOne will show the software patching status at the device level. If you have patches set to approve or reject manually, you can take those actions from the Device overview.
3PP_Mac_SelectMulti.png
Figure 14: Run → Patching (click to enlarge)

Supported Software

For a full index of supported Apple macOS software titles, refer to NinjaOne Patching: Supported Software Catalog (Apple macOS).

Additional Resources

For a list of frequently-asked questions about software patching, refer to NinjaOne Patching: Software Patch Management FAQ.

FAQ

Next Steps