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

NinjaOne Patching: Linux Policy Setup

Topic

This article describes the patch management features available for Linux endpoints managed by NinjaOne. It also explains how to activate, configure, and view patching activity.

Environment

  • NinjaOne Patching
  • Linux

Description

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

Policies: Linux Patch Management (NinjaOne Inc. 01:42)

Select a topic to continue.

System Considerations

Your device must meet the following criteria to scan for and apply patches:

  • NinjaOne needs a minimum of 100 MB of available disk space to scan for and apply patches. If the device does not have the required space, you will receive an activity notification that the disk is full and the scan and apply cannot take place. The NinjaOne agent evaluates free space by analyzing the following top-level directories on the device:
    • /
    • /opt
    • /var
    • /home
  • Linux patching supports all Linux distributions that the NinjaOne agent supports. For more information, refer to NinjaOne Agent: System Requirements and OS Support.
  • NinjaOne displays patches in the DevicesPatching. You can view all activities and errors on the System Activities page. Refer to NinjaOne NMS: Device Dashboard Navigation and Management for more information. 

Activating Patch Management

To activate patching for your Linux endpoints, perform the following steps:

1. In NinjaOne, click Administration → Policies, then choose a Linux policy from the Agent policies list.

Linux_UI_Nav.png
Figure 1: Administration → Agent policies (click to enlarge)
  1. The policy's management page will open. Click the Patching option, then activate the Status toggle. Changes are not applied to devices until you save the policy.

Linux_UI_EnablePatching.png
Figure 2: Enabling patching (click to enlarge)

Configuring Patch Management Settings

Patch management options include schedules for scanning and patching, as well as required software installation and maintenance. When you finish your configuration, click Save to apply the new settings.

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

Patching 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 choose 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, the system 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 Patching: Load Balancing Patch Installations With the Stagger Feature.
  • Run scan immediately, if missed: Run a scan immediately if NinjaOne misses a previous scan.
Update schedule

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

  • Schedule: Use the drop-down menu to choose the update frequency.
  • Days: If your update 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, the system 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 update immediately, if missed: Run an update cycle immediately if NinjaOne misses a previous update cycle.
  • Maintenance Mode: Suppress Emails/SMS/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. 
Pre-automation execution and Post-automation execution

This setting lets you add automations which will run prior to (pre) or after (post) patch installation.

  • Use pre-patching scripts to validate prerequisites or prepare the system before patching begins.
  • Use post-patching scripts to perform cleanup or verification tasks afterward.

Click Add to select automations from the Automation Library. Refer to NinjaOne Policies: Scheduled Automations to learn more. Select the Cancel the patch update if the pre-script returns a failure message checkbox to automatically cancel the patching job if the pre-script fails.

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.

  • Automatically reboot: This option tells NinjaOne to simply reboot the device after the update installation completes. 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.
General approvalsIn this section, you can configure approval settings for critical and unassigned patches. Patches associated with a known CVE are critical patches. All other patches are unassigned.
Approval overrides

You can set NinjaOne to override your patching policy for specific patches. Click Add to open the Edit approval overrides dialog box, 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 under 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.

Viewing Patches at the Device Level

You can view device-specific OS patch information on any Linux device governed by a policy with OS patching activated. To do so, navigate to Dashboard → Patching → OS patches tab. Use the flyout menu to filter by patch status (PendingApproved, Rejected, Installed, or Failed).

LinuxUI_PatchStatusMenu.png
Figure 4: Dashboard → Patching → Patch status categories (click to enlarge)

Failed Patch Information

When viewing Failed patches, place your cursor over the Install status column to display a tooltip explaining the reason for the installation failure. 

Linux_FailedPatch_Tooltip_2.png
Figure 5: Failed patch information (click to enlarge)

Release Date Information

NinjaOne displays patch release dates in the Patch List's Release Date column. If the vendor does not provide a release date, the patch views will display the date NinjaOne first detected the patch.

FAQ

Next Steps