Difference between revisions of "OpenZFSOnOSX"

From OpenZFS
Jump to navigation Jump to search
 
(12 intermediate revisions by the same user not shown)
Line 1: Line 1:
== OpenZFS on OS X (O3X) ==
[[file:o3x-logo.png | link=https://openzfsonosx.org]]


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


[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).
The first installer release of [https://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.8 and 10.9 (Mountain Lion and Mavericks).
 
== Support and Documentation ==
 
Documentation is available on
 
* O3X wiki https://openzfsonosx.org/wiki or http://o3x.org/wiki
Support is available on
 
* O3X forums https://openzfsonosx.org/forum or http://o3x.org/forum
 
* #openzfs-osx IRC channel irc://chat.freenode.net/#openzfs-osx


== To use the official release ==
== To use the official release ==


[http://o3x.org/wiki/Downloads Download] the most recent installer from the [http://o3x.org/wiki O3X wiki] and follow these [http://o3x.org/wiki/Install#Installing_the_Official_Release instructions].
[https://openzfsonosx.org/wiki/Downloads Download] the most recent installer from the [https://openzfsonosx.org/wiki O3X wiki] and follow the instructions for [https://openzfsonosx.org/wiki/Install#Installing_the_official_release installing the official release].


=== To begin testing the most recent build ===
== To begin testing the most recent build ==


The O3X wiki has instructions for [http://o3x.org/wiki/Install#Installing_from_Source installing from source].
The O3X wiki has instructions for [https://openzfsonosx.org/wiki/Install#Installing_from_source installing from source].


=== To test without building ===
== 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 [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 instructions for [https://openzfsonosx.org/wiki/Install#Installing_a_development_build_DMG installing a development build DMG] on the wiki.


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


=== Suggested focus areas for testers ===
== Suggested focus areas for testers ==


* Evaluating performance of various pool configurations as well as performance on older pools.
* Evaluating performance of various pool configurations as well as performance on older pools.
Line 29: Line 41:
* Finding incompatibilities with 3rd party software.
* 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.
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.

Latest revision as of 05:23, 25 May 2014

O3x-logo.png

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

The first installer release of 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.8 and 10.9 (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 the instructions for installing the official release.

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

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.