[DOCS-11753] macOS 10.13 (APFS) may not be crash safe Created: 30/May/18 Updated: 30/Oct/23 Resolved: 15/Jun/18 |
|
| Status: | Closed |
| Project: | Documentation |
| Component/s: | Server |
| Affects Version/s: | None |
| Fix Version/s: | Server_Docs_20231030 |
| Type: | Task | Priority: | Major - P3 |
| Reporter: | Michael Cahill (Inactive) | Assignee: | Kay Kim (Inactive) |
| Resolution: | Fixed | Votes: | 0 |
| Labels: | installation, macos-high-sierra | ||
| Remaining Estimate: | Not Specified | ||
| Time Spent: | Not Specified | ||
| Original Estimate: | Not Specified | ||
| Issue Links: |
|
||||||||||||||||||||
| Participants: | |||||||||||||||||||||
| Days since reply: | 5 years, 36 weeks, 6 days ago | ||||||||||||||||||||
| Epic Link: | DOCS: 4.0 Server | ||||||||||||||||||||
| Description |
DescriptionWe do not yet have stable testing on macOS 10.13, which uses Apple's new APFS filesystem. In particular, tests of WiredTiger's crash safety fail when run against the macOS 10.13 test system available in Evergreen. Community users and some MongoDB engineers have been running MongoDB on macOS 10.13 for months without seeing major issues, but the test failures suggest that data may be lost if mongod is not shutdown cleanly, or if the system is powered down while mongod is busy. Scope of changes (files that need work and how much)Add an admonition (Warning?) that mongod processes with datafiles on an APFS (10.13+) filesystem may lose data during unclean shutdowns (e.g. power failure, or system shutdown while mongod is busy). Possibly point to
May need a second linked DOCS ticket to update this admonition if a fix is released Impact to other docs outside of this productWe might consider having a warning on the Cloud Manager and Ops Manager OSX Agent Installation pages w.r.t. 10.13+. The Troubleshooting pages may be another option. MVP (work and date?)At minimum, admonition on OSX installation pages. Depending on whether 4.0 includes a fix, may want to then proceed to update the FAQ and production notes. Coordinate with cloud team on where best to update OpsManager/CloudManager docs. Resources (e.g. Scope Docs, Invision)See Linked Tickets |
| Comments |
| Comment by Michael Cahill (Inactive) [ 01/Jun/18 ] |
Yes.
We would backport the fix to whatever versions of MongoDB are supported on APFS.
Maybe. This is one of the questions I'd like to put to an Apple engineer.
According to https://support.apple.com/en-us/HT208033, "When you install macOS High Sierra on the Mac volume of a solid-state drive (SSD) or other all-flash storage device, that volume is automatically converted to APFS." So if we wanted to give any advice, it would probably be more along the lines of "stick with 10.12 if you need crash safety from MongoDB". Also note that some searching suggests that later updates to 10.13 (specifically 10.13.4) fix some APFS bugs (e.g., https://github.com/docker/for-mac/issues/2625). We don't yet have solid information about whether upgrading resolves the issues we have seen in testing.
That would be my advice at the moment until |
| Comment by Michael Cahill (Inactive) [ 30/May/18 ] |