empayre/fleet
14
0
Fork 0
mirror of https://github.com/empayre/fleet.git synced 2024-11-06 17:05:18 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
a8318452dd
fleet/docs/Using-Fleet/MDM-macOS-updates.md

80 lines
4.6 KiB
Markdown
Raw Normal View History

Break up MDM docs to be smaller articles for improved readability. (#10538) - Broke up the single MDM doc into multiple ones organized by category - Changed any links to point to the new docs --------- Co-authored-by: Noah Talerman <noahtal@umich.edu> Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2023-03-17 19:34:35 +00:00
# macOS updates
## End user macOS update reminders via Nudge
_Available in Fleet Premium_
End users can be reminded and encouraged to update macOS (via [Nudge](https://github.com/macadmins/nudge)).
MDM docs: Update macOS updates - Add table to make Nudge behavior more readable - Add image to better illustrate end user experience
2023-03-31 14:05:53 +00:00
![Nudge window](https://raw.githubusercontent.com/fleetdm/fleet/main/docs/images/nudge-window.png)
Break up MDM docs to be smaller articles for improved readability. (#10538) - Broke up the single MDM doc into multiple ones organized by category - Changed any links to point to the new docs --------- Co-authored-by: Noah Talerman <noahtal@umich.edu> Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2023-03-17 19:34:35 +00:00
MDM docs: Update macOS updates - Add table to make Nudge behavior more readable - Add image to better illustrate end user experience
2023-03-31 14:05:53 +00:00
A Fleet admin can set a minimum version and deadline for Fleet-enrolled hosts. If an end user's machine is below the minimum version, the Nudge window above will periodically appear to encourage them to upgrade. The end user has the option to defer the update, but as the deadline approaches, the Nudge window appears more frequently.
Break up MDM docs to be smaller articles for improved readability. (#10538) - Broke up the single MDM doc into multiple ones organized by category - Changed any links to point to the new docs --------- Co-authored-by: Noah Talerman <noahtal@umich.edu> Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2023-03-17 19:34:35 +00:00
MDM docs: Update macOS updates - Add table to make Nudge behavior more readable - Add image to better illustrate end user experience
2023-03-31 14:05:53 +00:00
When the end user machine is below the minimum version, Nudge applies the following behavior:
| | > 1 day before deadline | < 1 day before deadline | past deadline |
| ------------------------------------ | ----------------------- | ----------------------- | --------------------- |
| Nudge window frequency | Once a day at 8pm GMT | Once every 2 hours | Immediately on login |
| End user can defer | ✅ | ✅ | ❌ |
| Nudge window is dismissable | ✅ | ✅ | ❌ |
### How to set up
To set the macOS updates settings in the UI, visit the **Controls** section and then select the **macOS updates** tab.
Break up MDM docs to be smaller articles for improved readability. (#10538) - Broke up the single MDM doc into multiple ones organized by category - Changed any links to point to the new docs --------- Co-authored-by: Noah Talerman <noahtal@umich.edu> Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2023-03-17 19:34:35 +00:00
MDM docs: Update macOS updates - Add table to make Nudge behavior more readable - Add image to better illustrate end user experience
2023-03-31 14:05:53 +00:00
To set the macOS updates settings via CLI, use the configurations listed [here](https://fleetdm.com/docs/using-fleet/configuration-files#mdm-macos-updates).
Break up MDM docs to be smaller articles for improved readability. (#10538) - Broke up the single MDM doc into multiple ones organized by category - Changed any links to point to the new docs --------- Co-authored-by: Noah Talerman <noahtal@umich.edu> Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2023-03-17 19:34:35 +00:00
MDM docs: Update macOS updates - Add table to make Nudge behavior more readable - Add image to better illustrate end user experience
2023-03-31 14:05:53 +00:00
### Requirements
- Fleet Premium or Ultimate
- [Fleetd](https://fleetdm.com/docs/using-fleet/orbit) with Fleet Desktop enabled
Break up MDM docs to be smaller articles for improved readability. (#10538) - Broke up the single MDM doc into multiple ones organized by category - Changed any links to point to the new docs --------- Co-authored-by: Noah Talerman <noahtal@umich.edu> Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2023-03-17 19:34:35 +00:00
MDM docs: Update macOS updates - Add table to make Nudge behavior more readable - Add image to better illustrate end user experience
2023-03-31 14:05:53 +00:00
### End user experience
Break up MDM docs to be smaller articles for improved readability. (#10538) - Broke up the single MDM doc into multiple ones organized by category - Changed any links to point to the new docs --------- Co-authored-by: Noah Talerman <noahtal@umich.edu> Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2023-03-17 19:34:35 +00:00
MDM docs: Update macOS updates - Add table to make Nudge behavior more readable - Add image to better illustrate end user experience
2023-03-31 14:05:53 +00:00
After the user clicks "update" in the Nudge window, they will be taken to the standard Apple software update screen:
Break up MDM docs to be smaller articles for improved readability. (#10538) - Broke up the single MDM doc into multiple ones organized by category - Changed any links to point to the new docs --------- Co-authored-by: Noah Talerman <noahtal@umich.edu> Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2023-03-17 19:34:35 +00:00
MDM docs: Update macOS updates - Add table to make Nudge behavior more readable - Add image to better illustrate end user experience
2023-03-31 14:05:53 +00:00
![Apple software update screen on macOS 12](https://user-images.githubusercontent.com/5359586/228936740-2e8acf2e-6523-4710-9b3f-8243398bd98e.png)
Break up MDM docs to be smaller articles for improved readability. (#10538) - Broke up the single MDM doc into multiple ones organized by category - Changed any links to point to the new docs --------- Co-authored-by: Noah Talerman <noahtal@umich.edu> Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2023-03-17 19:34:35 +00:00
MDM docs: Update macOS updates - Add table to make Nudge behavior more readable - Add image to better illustrate end user experience
2023-03-31 14:05:53 +00:00
Here, the user would follow Apple's standard two-step process for macOS updates:
1. Download the macOS update. This occurs in the background and does not interrupt the end user's work.
2. Initiate the update which does prevent the end user from using the host for a time.
Break up MDM docs to be smaller articles for improved readability. (#10538) - Broke up the single MDM doc into multiple ones organized by category - Changed any links to point to the new docs --------- Co-authored-by: Noah Talerman <noahtal@umich.edu> Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2023-03-17 19:34:35 +00:00
MDM docs: Update macOS updates - Add table to make Nudge behavior more readable - Add image to better illustrate end user experience
2023-03-31 14:05:53 +00:00
On Intel Macs, Fleet triggers step 1 (downloading the macOS update) programmatically when a new version is available. This way, when the user arrives on the software update screen, they only need to initiate step 2.
Break up MDM docs to be smaller articles for improved readability. (#10538) - Broke up the single MDM doc into multiple ones organized by category - Changed any links to point to the new docs --------- Co-authored-by: Noah Talerman <noahtal@umich.edu> Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2023-03-17 19:34:35 +00:00
MDM docs: Update macOS updates - Add table to make Nudge behavior more readable - Add image to better illustrate end user experience
2023-03-31 14:05:53 +00:00
> On Macs with Apple Silicon (e.g. M1), downloading the macOS update may require end user action. Apple doesn't support downloading the update programmatically on Macs with Apple silicon.
Break up MDM docs to be smaller articles for improved readability. (#10538) - Broke up the single MDM doc into multiple ones organized by category - Changed any links to point to the new docs --------- Co-authored-by: Noah Talerman <noahtal@umich.edu> Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2023-03-17 19:34:35 +00:00
MDM docs: Update macOS updates - Add table to make Nudge behavior more readable - Add image to better illustrate end user experience
2023-03-31 14:05:53 +00:00
Step 2 (installing the update) always requires end user action.
Break up MDM docs to be smaller articles for improved readability. (#10538) - Broke up the single MDM doc into multiple ones organized by category - Changed any links to point to the new docs --------- Co-authored-by: Noah Talerman <noahtal@umich.edu> Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2023-03-17 19:34:35 +00:00
Update MDM-macOS-updates.md (#12717) Added statement around support for RSRs under the "known issues" section of macos updates. --------- Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2023-07-12 21:17:31 +00:00
### Known issues
#### Apple Rapid Security Responses (RSRs)
Currently, end user macOS update reminders via Nudge don't support RSR versions (ex. "13.4.1 (a)").
You can use custom MDM commands in Fleet to trigger built-in macOS update reminders for RSRs. Learn which MDM commands to use in the Apple docs [here](https://support.apple.com/guide/deployment/rapid-security-responses-dep93ff7ea78/web).
#### Mac is up to date
Break up MDM docs to be smaller articles for improved readability. (#10538) - Broke up the single MDM doc into multiple ones organized by category - Changed any links to point to the new docs --------- Co-authored-by: Noah Talerman <noahtal@umich.edu> Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2023-03-17 19:34:35 +00:00
MDM docs: Update macOS updates - Add table to make Nudge behavior more readable - Add image to better illustrate end user experience
2023-03-31 14:05:53 +00:00
Sometimes after the end user clicks "update" on the Nudge window, the end user's Mac will say that macOS is up to date when it isn't. This known issue can create a frustrating experience for the end user. Ask the end user to follow the steps below to troubleshoot:
Break up MDM docs to be smaller articles for improved readability. (#10538) - Broke up the single MDM doc into multiple ones organized by category - Changed any links to point to the new docs --------- Co-authored-by: Noah Talerman <noahtal@umich.edu> Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2023-03-17 19:34:35 +00:00
1. From the Apple menu in the top left corner of your screen, select **System Settings** or **System Preferences**.
2. In the search bar, type "Software Update." Select **Software Update**.
3. Type "Command (⌘)-R" to check for updates. If you see an available update, select **Restart Now** to update.
4. If you still don't see an available update, from the Apple menu in the top left corner of your screen, select **Restart...** to restart your Mac.
5. After your Mac restarts, from the Apple menu in the top left corner of your screen, select **System Settings** or **System Preferences**.
6. In the search bar, type "Software Update." Select **Software Update** and select **Restart Now** to update.
## End user macOS update via built-in macOS notifications
Built-in macOS update reminders are available for all Fleet instances. To trigger these reminders, run the ["Schedule an OS update" MDM command](https://developer.apple.com/documentation/devicemanagement/schedule_an_os_update).
<meta name="pageOrderInSection" value="1502">
Match style guide in MDM doc titles (#10751)
2023-03-24 19:27:41 +00:00
<meta name="title" value="MDM macOS updates">
Website: Add meta descriptions to Fleet documentation. (#12586) #11986 Changes: - Added meta descriptions to Fleet documentation pages. --------- Co-authored-by: Rachael Shaw <r@rachael.wtf>
2023-07-13 16:57:17 +00:00
<meta name="description" value="Learn how to manage macOS updates and set up end user reminders with Fleet MDM.">
Reference in New Issue Copy Permalink