NetLock RMMNetLock RMM Docs
III — How-To Guides

Set up patch management for a group

Approve patches globally, then configure per-policy rollout rules for a Windows group.

Set up patch management for a group

Patch management in NetLock RMM is configured in two places, and patching works only when both are set up. The /patch-management page is the global approval queue: which patches are allowed on any device at all. The Policy Settings editor's Patch Management tab is the per-policy rollout: when and how these particular devices install the approved patches. This guide covers both, using a Windows group as the worked example.

Patch Management page, Update Approval tab, with a pending list

Before you start

  • A policy already exists and is routed to the target Windows group via an automation (see Guide H.4).
  • At least one Windows device is online in that group.
  • Patches have been detected and sit in the Pending state on the Patch Management page. If the list is empty, agents have not yet reported their update inventory; wait a sync cycle.
  • Required permissions: patch_management_enabled for the approval page, plus policies_enabled and the policy edit flag for the rollout configuration.

Steps

Stage 1 — Approve patches globally

  1. Open Patch Management from the navigation. The Update Approval tab is the default.
  2. Filter by Windows and browse the Pending patches.
  3. Select a manageable first set. Critical security updates from the previous month are a safe start. Avoid bulk-approving every pending patch on day one.
  4. Click Approve. The selected patches move into the Approved state. The server flags every device for a resync so agents pick up the updated approval list on their next poll.

Use the other actions as needed:

  • Reject: explicitly block a patch; devices never install it.
  • Defer: postpone a patch for a number of days (default 7).
  • Reset to Pending: revert any state decision back to pending for later review.

Approvals are global and apply to all devices. Scoping to devices and groups happens in stage 2.

Stage 2 — Configure the per-policy rollout

  1. Open Policies from the navigation and click Manage on the policy that routes to your Windows group.
  2. Open the Patch Management tab in the Policy Settings editor. The tab is split into Global and per-platform sub-tabs; pick Windows.
  3. Under the Windows sub-tab, fill in at least these three sub-tabs for a minimal rollout:
    • General: enable patching for Windows and select which sources participate (at minimum OS-Mandatory, optionally Winget and Chocolatey).
    • Schedule: pick the allowed patch days (default Monday to Friday) and a maintenance window. Outside the window the agent will not start an install; the one exception is the catch-up run described in Chapter 6.12, which runs the first check after the policy arrives, or after a missed window, right away.
    • Reboot: decide whether the agent may reboot, whether it prompts the user, how long the prompt is visible, and what happens on a device where nobody is signed in. This is the only place in the product where reboot behaviour is configured.
  4. Optionally fill in Approval & Filtering (narrow approved patches by severity or source), Deployment Rings (stage the rollout across Pilot → Early → Broad), Notifications, and Retry.
  5. Save the policy.

Verify it worked

  • On the Patch Management page's Update Approval tab, the patches you approved show the Approved state and the Installed and Pending columns begin moving as devices pick up the change.
  • On a target device's detail view in Devices, the line Last patch run: <time> – <outcome> appears after the first scheduled run that reached the install stage, and the device's Updates tab shows per update whether it was installed or why the last scheduled run held it back. Scheduled runs do not create entries in Events; the only event a scheduled run writes is the Patch management event recorded once when an outstanding restart blocks the run.
  • The Patch history tab on the Patch Management page and on the device lists each scheduled run of an agent 3.3.0.5 or later next to the Patch Now jobs. Its details show per update whether it was installed, failed with the error Windows Update or the package manager reported, or was held back and why.
  • The Update History tab on the Patch Management page shows the install outcomes per patch per device.

Troubleshooting

  • Patches stay at 0 installed. Check that a policy with Patch Management → Windows → General enabled is actually assigned to the device. If the device's detail view shows - as assigned policy, the automation is missing. On Linux, open the job or the scheduled run in Patch Management → Patch history: the item details and the note carry apt's E: lines or dnf's error lines (No match for argument, Error:, Problem:), as does the agent's Error.txt. A package that apt keeps back because the upgrade would remove another package is listed as Skipped with the packages a full upgrade would remove; enable Allow package removal (full upgrade) in the policy's Linux tab to install it. On Fedora and RHEL-based systems a package excluded by excludepkgs in dnf.conf, or a version the repository no longer offers, fails with dnf's message while the other approved packages are installed.

  • Patches approved but devices ignore them. Check the policy's Approval & Filtering sub-tab. A filter there can block a globally approved patch.

  • My scheduled run never happens. First check where you are looking. With agent 3.3.0.5 or later, every scheduled run that reached the installation is an entry in the device's Patch history tab and on the Patch history tab of the Patch Management page, with the result of each update and the reason an update was held back or failed (see Chapter 7.5). Runs skipped for disk space, informational mode, a disabled policy, missing patch settings or an incomplete maintenance window are listed there as Skipped.

    Waiting for an allowed day or for the maintenance window creates no entry; the Scheduled patching line in the device's detail view on /devices shows it with the next possible run. Further traces are the Last patch run line, the chips on the device's Updates tab, and the Last scheduled run column on the Devices Not Up To Date tab; with an older agent they are the only ones.

    The agent decides every five minutes whether a scheduled run may start and checks the following stages in this order. Go through them from the top; the first stage that fails is the reason. Agents 3.3.0.5 and later report the waiting stages in the Scheduled patching line.

    1. Patch settings on the device. The device has received the policy's patch settings. The detail view names the assigned policy (not -) and the Scheduled patching line does not say The device has not received its patch management settings yet. Until the agent has reported anything, the detail view shows the schedule facts of the device's policy (mode, allowed days, window, catch-up), so you can compare them with what you expect. If the policy is missing, fix the automation and wait for the next sync.

    2. Platform mode is Managed. Informational only reports: Last patch run: … – informational mode, nothing installed. Disabled skips without a run; the Scheduled patching line shows Patch management is disabled in the policy of this device. Check Patch Management → Windows → General in the policy.

    3. Allowed patch day. The default is Monday to Friday. On an unticked day no scheduled run happens, not even as a catch-up run. The line shows Waiting for an allowed patch day with the next possible run. Check Schedule → Allowed patch days. A typical example is a policy saved on Friday evening and checked on Saturday morning.

    4. Maintenance window or catch-up. Inside the window the run starts at the agent's next check. Outside the window a run starts only as a catch-up: the first check after the policy arrives on the device, or the first check after a missed window, runs right away even outside the window (Catch up a missed maintenance window on the platform's Schedule sub-tab, on by default). From equal to To means no time restriction. The line shows Waiting for the maintenance window with the next possible run, or The maintenance window of the policy is incomplete, no run is scheduled when it cannot read the From/To pair. Nothing runs until the window is corrected.

    5. One run per window occurrence. After a run the agent installs nothing more until the next window opens (once per day for a 24/7 window), whatever the outcome of that run was. The line shows Already ran in the current maintenance window with the next possible run. If that run installed nothing, the reason is in one of the following stages.

    6. Free disk space. With Check minimum free disk space before patching on, a device below the threshold is skipped: Last patch run: … – skipped, insufficient disk space. This skip does not use up the window; the agent tries again at its next check.

    7. Windows: no outstanding restart. While a restart from an earlier update run is outstanding, a scheduled run installs no Windows updates: Last patch run: … – restart pending, Windows updates held back. Winget and Chocolatey updates are still installed in such a run (agent 3.3.0.11 or later), and the tooltip of the line names how many of them were installed, failed or held back.

      The device shows the Restart pending since … banner with the note that scheduled runs install no Windows updates until the device has restarted, together with the restart behaviour of its policy, and the blocked run is recorded once as an event of type Patch management on the device.

      With Ask user a device where nobody is signed in asks nobody; the If nobody is signed in option on the Reboot sub-tab decides whether such a device restarts in the maintenance window, immediately, or not at all (the default). With the default the restart has to happen another way (a user or the Console restarts the device, or you change the option), and scheduled runs keep installing no Windows updates until then. Patch Now still installs Windows updates too.

    8. Windows Update query. The agent asks Windows Update for the available updates. When the query times out, fails or returns no result, the run is recorded as completed and its note (the tooltip of the Last patch run line) says that the query for available updates failed and no update was installed. Windows Update itself, not the policy, is the place to look then.

    9. Per-update filters. The run happened (completed or nothing pending) but a specific update is still missing: open the device's Updates tab, where the chip on each update names the reason from the last scheduled run: Blocked by severity filter, Blocked by update type filter, Not approved, Deployment ring until …, Retry after …, Waiting for restart, Not offered in last run. nothing pending means Windows Update offered nothing that the policy's sources cover. A deployment ring set to Immediate only removes the waiting time after an update's release; the allowed days, the maintenance window and the one-run-per-window rule still apply. Only Patch Now bypasses the schedule, the rings and the retry budget.

    On the device itself, a 3.3.0.5 agent writes every change of its schedule decision and every run outcome to Logs\Patch_Management.txt in the Comm Agent folder (C:\ProgramData\0x101 Cyber Security\NetLock RMM\Comm Agent\) without debug mode; state changes and outcomes only, so the file stays small. The full detail of every five-minute check needs debug mode: create an empty debug.txt in the Comm Agent folder and restart the service, as described in Guide — Debug an agent. The agent's run bookkeeping lives in patch_cycle_state.json under C:\ProgramData\NetLock RMM\Agent\ (Linux: /var/lib/netlock-rmm/); a missing or empty file means that no scheduled run has reached the install stage yet.

  • Winget or Chocolatey updates are not installed by the scheduled run, although Patch Now installs them. Patch Now only proves that the installer works on the device. The scheduled run has further places where it holds an application update back, and each one leaves a trace. Open the device's Patch history tab, open the last scheduled runs with a double-click and check in this order:

    1. The notice Winget and Chocolatey updates were not checked in this run because Windows updates are waiting for a restart. The agent on the device is older than 3.3.0.11. Update the agent; until then, make sure the device restarts on the same day (Reboot sub-tab) or use Patch Now.
    2. Items with source Winget or Chocolatey and the reason Retry after …. The update failed in earlier runs and the retry budget is used up: after the policy's Retry count (default 3) failed attempts the agent waits seven days before it tries again; the attempts are kept in patch_retry.json under C:\ProgramData\NetLock RMM\Agent\. The Failed items of the earlier runs carry the installer's result in Details. Patch Now ignores the budget, and a successful installation resets it.
    3. The note The winget upgrade query failed, so application updates from winget were not attempted (or the same wording for Chocolatey). The package manager could not be queried when the run started, for example because winget is not usable from the agent's system account; the device then also carries the event winget is not usable from the agent's system account (see the entry below). The Updates tab keeps the rows of the last successful inventory, so the list looks current although the query fails. The rows of that source show Package manager query failed in the last run (agent 3.3.0.11 or later). Patch Now with Patch All runs the same query and shows the failure in the job's note.
    4. Items with the reason Deferred to a later run. Install all pending patches before rebooting is off on the Reboot sub-tab, so the run installs one update and the others follow in later runs.
    5. No Winget or Chocolatey items and no notice. The package manager reported nothing to upgrade when the run queried it, even if the Updates tab lists updates from an earlier inventory. Such rows show Not offered in last run (agent 3.3.0.11 or later).

    The Last run chip on the device's Updates tab shows these decisions for Winget and Chocolatey updates as well (agent 3.3.0.11 or later), in the same way as for Windows updates; a Retry after … chip names the time of the next allowed attempt. The device's patch status is no indication either way: software updates only count toward it when the compliance scope on the Patch Management Settings tab includes the Winget and Chocolatey sources (see Chapter 7.4).

  • The device shows the event winget is not usable from the agent's system account. The agent runs as the system account. There it uses winget through PowerShell 7 and Microsoft's module Microsoft.WinGet.Client, and winget.exe when the module is not available. With agent 3.3.0.12 or later the event has the type Patch management and is raised when neither of the two works. As long as that is the case, application updates from winget are not detected or installed on the device, and App Hub actions for winget apps with Requires Elevation fail. The event is raised once per cause, not repeatedly, however often the causes alternate. The same cause is reported again only after winget worked in between and at least a day has passed since its last event. Each event opens one alert, which ends when the event is read or hidden.

    The Cause: line of the event names the step that failed, and the winget.exe: line what the fallback did:

    Cause: begins withMeaningWhat to do
    PowerShell 7 install: … the download … failedThe device could not download the PowerShell 7 installer package from GitHub.Allow HTTPS from the device to raw.githubusercontent.com, github.com and release-assets.githubusercontent.com, or install PowerShell 7 on the device yourself (x64, ARM64 or x86 MSI from Microsoft, default location).
    PowerShell 7 install: … no Windows Installer package … could be downloadedNone of the PowerShell 7 releases the agent looked at offers an MSI for the device's architecture.Install PowerShell 7 on the device yourself.
    PowerShell 7 install: … does not carry a valid signatureThe downloaded package was not signed by Microsoft and was not installed.Check whether a proxy or a security product changes downloads on the way to the device; install PowerShell 7 yourself.
    PowerShell 7 install: … msiexec exit …Windows Installer did not install the package.Install the PowerShell 7 MSI by hand on the device to see the installer's own message.
    PowerShell 7: PowerShell 7 at … is not usedStandard users can write to the PowerShell 7 folder or to pwsh.exe, so the agent does not start it.Restore the default permissions of C:\Program Files\PowerShell\7, for example by reinstalling PowerShell 7.
    Microsoft.WinGet.Client module checkPowerShell 7 did not answer when the agent asked for the installed module.Start C:\Program Files\PowerShell\7\pwsh.exe on the device and check that it opens; repair or reinstall PowerShell 7 if it does not.
    Microsoft.WinGet.Client install from PSGalleryThe module could not be installed from the PowerShell Gallery. The cause names what each of the two installation commands reported (Install-PSResource, then Install-Module).Allow HTTPS to www.powershellgallery.com and cdn.powershellgallery.com, or run Install-PSResource -Name Microsoft.WinGet.Client -Repository PSGallery -Scope AllUsers -TrustRepository in an elevated PowerShell 7 on the device (Install-Module Microsoft.WinGet.Client -Scope AllUsers on a PowerShell older than 7.4).
    …: PowerShell 7.x ended with a fatal error (exit …) after any of the stepspwsh.exe itself ended while the agent looked for, installed or loaded the module, for example with exit 0xC0000005. This is not an error of the module or of the PowerShell Gallery. The cause carries the PowerShell version and the beginning of PowerShell's own error report; the complete output is in Error.txt of the Comm Agent on the device.Repair or reinstall PowerShell 7 with Microsoft's MSI package and restart the device. Check whether a security product on the device interferes with pwsh.exe. Then run the Install-PSResource command of the row above in an elevated PowerShell 7 on the device. If PowerShell ends there as well, the Windows Application event log has the entries Application Error and .NET Runtime for pwsh.exe, which name the failing component.
    …: the check ended before winget ran, exit … or …: the check ended while the module was loaded, exit …The module is installed, but the check ended with exit 0xC0000409 or 0xC0000135. With the first text winget itself could not be started from the system account, which is a state of App Installer on the device, not of PowerShell. With the second text the process already ended while it loaded the module.Install the pending Windows updates and bring App Installer up to date (Microsoft Store, or Repair-WinGetPackageManager -AllUsers in an elevated PowerShell 7 window of an administrator). If the event stays, send its text to support.
    Microsoft.WinGet.Client module import or winget source query (Get-WinGetSource)The module is installed but does not answer from the system account. The cause carries the error, the module version and the Windows build.Install the pending Windows updates and the current module version (Install-Module Microsoft.WinGet.Client -Scope AllUsers -Force). If the event stays, send its text to support.

    The line winget.exe: no usable answer for more than 24 hours means that winget.exe starts on the device but, for longer than a day, has only run into its time limit or answered in a form the agent cannot read with certainty. Run winget upgrade --source winget in an administrator session on the device to see what it prints, and check the device's network path to the winget source.

    Windows Server and LTSC editions without App Installer. These editions come without App Installer, the package that contains winget.exe; the event then shows winget.exe: not found on this device (App Installer is not installed). The agent does not install App Installer and does not repair its registration. Without it the updates inventory lists no winget updates for the device, and the agent has no fallback when the module cannot be used. To install or repair it, sign in as an administrator and run in an elevated PowerShell 7 window: Install-Module Microsoft.WinGet.Client -Scope AllUsers, then Repair-WinGetPackageManager -AllUsers. Do not run this through a NetLock RMM job or the remote shell: both run as the system account, where Microsoft's cmdlet refuses -AllUsers.

    The agent tries again by itself 60 minutes after a failed attempt (6 hours after an attempt in which PowerShell 7 ended with a fatal error, because every such attempt leaves a crash entry in the Windows Application event log), and right away once PowerShell 7 exists at its default location; a service restart is not needed. It only uses PowerShell 7 from C:\Program Files\PowerShell\7. An installation elsewhere (Microsoft Store, zip archive, dotnet tool) is neither used nor changed; the agent installs its own copy next to it. It installs the newest PowerShell 7 release Microsoft publishes as a Windows Installer package, at present the 7.6 LTS line. A Microsoft.WinGet.Client older than 1.12.440 stays in place, and the agent installs the current version next to it.

    PowerShell 7 and the module are only installed on devices that use winget through the agent (agent 3.3.0.12 or later): the policy has Install application patches (Winget) ticked in Informational or Managed mode, Patch Now runs with winget updates, a winget app with Requires Elevation is installed, updated or removed through App Hub or a software deployment, or such an app has automatic updates switched on. On every other device the updates inventory uses PowerShell 7 and the module if they are already there and winget.exe otherwise. Where winget.exe does not answer from the system account either, or answers in a form the agent cannot read with certainty, the winget rows on the Updates tab stay as they are (none on a new device) until one of the conditions applies. When winget.exe reports nothing to upgrade, the rows are removed with the second sync in a row that says so.

    Agents up to 3.3.0.11 report the event with the type job and repeat it every six hours.

  • A Windows update is Failed with a time limit, or Skipped because Windows is still installing. An update has 6 hours for its download and installation, and a run starts no installation while Windows has another one in progress (agent 3.3.0.12 or later). Both, and the 60-minute limit of older agents, are described in Chapter 7.7.

  • Reboots happen at unexpected times. Review Patch Management → Windows → Reboot and Schedule in the policy. Reboot prompts follow the schedule's maintenance window.

  • SLA chips show Overdue. Adjust the SLA thresholds on the Patch Management Settings tab if the defaults (7 / 15 / 30 / 60 days by severity) do not fit your environment.