Difference between revisions of "OpenZFS on OS X"

From OpenZFS on OS X
Jump to: navigation, search
(Created page with "'''OpenZFS on OS X brings OpenZFS features to Apple's OS X'''. The first installer release of [http://openzfsonosx.org OpenZFS on OS X] is ready for use by people who are co...")
 
 
(17 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 +
[[Category:About O3X]]
 
'''OpenZFS on OS X brings OpenZFS features to Apple's OS X'''.  
 
'''OpenZFS on OS X brings OpenZFS features to Apple's OS X'''.  
  
The first installer release of [http://openzfsonosx.org OpenZFS on OS X] is ready for use by people who are comfortable with administering ZFS from the Terminal or who are willing to learn to do so. It's compatible with OS X 10.6 through OS X 10.9 (Snow Leopard, Lion, Mountain Lion and Mavericks).
+
The installer release of OpenZFS on OS X is ready for use by people who are willing to learn to administer ZFS from the Terminal, or who already know how to do so.  
  
== Support and Documentation ==
+
==Compatibility==
 +
 
 +
OS X 10.8 through macOS 10.15.
 +
 
 +
'''macOS 11 under development'''
 +
 
 +
== Support and documentation ==
  
 
Documentation is available on
 
Documentation is available on
  
* O3X wiki (where you are now) http://o3x.org/wiki or http://openzfsonosx.org/wiki
+
* O3XWiki (where you are now) http://o3x.org/wiki or https://openzfsonosx.org/wiki
 
   
 
   
 
Support is available on
 
Support is available on
  
* O3X forums http://o3x.org/forum or http://openzfsonosx.org/forum
+
* O3X forums http://o3x.org/forum or https://openzfsonosx.org/forum
  
* #openzfs-osx IRC channel irc://chat.freenode.net/#openzfs-osx
+
* #openzfs-macos IRC channel ircs://irc.libera.chat:6697/%23openzfs-macos
  
 
== To use the official release ==
 
== To use the official release ==
  
[[Downloads|Download]] the most recent installer and follow the instructions for [Install#Installing_the_Official_Release|installing the official release].
+
[[Downloads|Download]] the most recent installer and follow the instructions for [[Install#Installing_the_official_release|installing the official release]].
  
 
== To begin testing the most recent build ==
 
== To begin testing the most recent build ==
Line 23: Line 30:
 
Follow the instructions for [[Install#Installing_from_Source|installing from source]].
 
Follow the instructions for [[Install#Installing_from_Source|installing from source]].
  
== To test without building ==
+
== Suggested focus areas for testers ==
  
Development Build DMGs are added to http://lundman.net/ftp/osx.zfs/ – download the most recent signed .dmg file if you are on OS X 10.9, unsigned if you are on an earlier version of OS X. The disk image will contain built software – binaries, kernel extensions (KEXTs) and so on – that may be used with or without installation. Follow the instructions for [[Installing_a_Development_Build_DMG|installing a development build DMG]].
+
* Identifying integration issues with OS X.
  
These development build DMGs sometimes will not include the very most recent commits. If in doubt, please ask on IRC:
+
* Finding incompatibilities with 3rd party software.
  
* irc://chat.freenode.net/#openzfs-osx
+
* Stress testing.
  
== Suggested focus areas for testers ==
+
* Security auditing.
 
+
* Evaluating performance of various pool configurations as well as performance on older pools.
+
 
+
* Identifying any abnormal behavior when used with older pools.
+
 
+
* Finding incompatibilities with 3rd party software.
+
  
 
== Notes ==
 
== Notes ==
  
When using beta software with data of significant value, be especially diligent with your backup procedures. Remember that ZFS alone is not a substitute for a good backup strategy.
+
Please remember that ZFS alone is not a substitute for a good backup strategy.
 
+
If you have MacZFS 74 or ZEVO installed:
+
  
* you must uninstall that software before testing O3X (scripts for doing so are included with the O3X release download).
+
If you have ZEVO or MacZFS installed
* you must uninstall O3X before reverting to ZEVO or MacZFS 74 (an uninstaller script for O3X is also included with the release download).
+
  
Either unload the older kernel extensions or reboot before proceeding with installing O3X.
+
* you must uninstall that software '''and reboot''' before installing O3X (scripts for doing so are included with the O3X release download).
 +
* you must uninstall O3X if you choose to revert to ZEVO or MacZFS - an uninstaller script for O3X is also included with the release download.

Latest revision as of 03:25, 27 May 2021

OpenZFS on OS X brings OpenZFS features to Apple's OS X.

The installer release of OpenZFS on OS X is ready for use by people who are willing to learn to administer ZFS from the Terminal, or who already know how to do so.

Compatibility[edit]

OS X 10.8 through macOS 10.15.

macOS 11 under development

Support and documentation[edit]

Documentation is available on

Support is available on

To use the official release[edit]

Download the most recent installer and follow the instructions for installing the official release.

To begin testing the most recent build[edit]

Follow the instructions for installing from source.

Suggested focus areas for testers[edit]

  • Identifying integration issues with OS X.
  • Finding incompatibilities with 3rd party software.
  • Stress testing.
  • Security auditing.

Notes[edit]

Please remember that ZFS alone is not a substitute for a good backup strategy.

If you have ZEVO or MacZFS installed

  • you must uninstall that software and reboot before installing O3X (scripts for doing so are included with the O3X release download).
  • you must uninstall O3X if you choose to revert to ZEVO or MacZFS - an uninstaller script for O3X is also included with the release download.