Difference between revisions of "OpenZFSOnOSX"

From OpenZFS
Jump to navigation Jump to search
Line 4: Line 4:


[http://openzfsonosx.org OpenZFS on OS X] is in beta and an installer is ready for use by people who are happy to use Terminal. It's compatible with OS X 10.6 through OS X 10.9 (Snow Leopard, Lion, Mountain Lion and Mavericks).
[http://openzfsonosx.org OpenZFS on OS X] is in beta and an installer is ready for use by people who are happy to use Terminal. It's compatible with OS X 10.6 through OS X 10.9 (Snow Leopard, Lion, Mountain Lion and Mavericks).
== Support and Documentation ==
Documentation is available on
* the O3X wiki http://o3x.org/wiki or http://openzfsonosx.org/wiki
Support is available on
* the O3X forums http://o3x.org/forum or http://openzfsonosx.org/forum
* the #openzfs-osx IRC channel irc://chat.freenode.net/#openzfs-osx


== To use the official release ==
== To use the official release ==
Line 17: Line 29:
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 [http://o3x.org/wiki/Install#Installing_a_Development_Build_DMG instructions] on the wiki for using a development build DMG.
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 [http://o3x.org/wiki/Install#Installing_a_Development_Build_DMG instructions] on the wiki for using a development build DMG.


These development build DMGs sometimes will not include the very most recent commits. If in doubt, please ask in IRC:  
These development build DMGs sometimes will not include the very most recent commits. If in doubt, please ask on IRC:  


* irc://chat.freenode.net/#openzfs-osx
* irc://chat.freenode.net/#openzfs-osx
Line 33: Line 45:
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.
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.


If you normally use MacZFS 74 or ZEVO:  
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).
* you must uninstall that software before testing O3X (scripts for doing so are included with the O3X release download).
* you must uninstall O3X before reverting to ZEVO or MacZFS 74 (an uninstaller script for O3X is also included with the release download).
* 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.
Either unload the older kernel extensions or reboot before proceeding with installing O3X.

Revision as of 06:03, 16 March 2014

OpenZFS on OS X (O3X)

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

OpenZFS on OS X is in beta and an installer is ready for use by people who are happy to use Terminal. It's compatible with OS X 10.6 through OS X 10.9 (Snow Leopard, Lion, Mountain Lion and Mavericks).

Support and Documentation

Documentation is available on

Support is available on

To use the official release

Download the most recent installer from the O3X wiki and follow these instructions.

To begin testing the most recent build

The O3X wiki has instructions for installing from source.

To test without building

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 on the wiki for using a development build DMG.

These development build DMGs sometimes will not include the very most recent commits. If in doubt, please ask on IRC:

Suggested focus areas for testers

  • 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

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.

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).
  • 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.