Difference between revisions of "OpenZFSOnOSX"

From OpenZFS
Jump to navigation Jump to search
m (http://zevo.getgreenbytes.com/forum/viewtopic.php?p=5438#p5438)
 
(22 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== MacZFS ==
[[file:o3x-logo.png | link=https://openzfsonosx.org]]


{|cellpadding="20"
'''OpenZFS on OS X brings OpenZFS features to Apple's OS X'''.
| [[file:MacZFS-logo.png | link=http://maczfs.org]]
| http://maczfs.org
The April 2013 release of MacZFS is stable, but lacks the feature set that's associated with OpenZFS …
|}


== ZFS-OSX ==
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).


'''ZFS-OSX brings OpenZFS features to MacZFS'''.
== Support and Documentation ==


[https://github.com/zfs-osx ZFS-OSX] is a well-developed alpha that is ready for testing by people who are happy to use Terminal. It's designed for use with Mac OS X 10.6 – OS X 10.9 (Snow Leopard, Lion, Mountain Lion and Mavericks).
Documentation is available on


=== To begin testing the most recent build ===
* O3X wiki https://openzfsonosx.org/wiki or http://o3x.org/wiki
Support is available on


[http://zerobsd.tumblr.com/post/62586498252/os-x-with-zfs ZeroBSD | OS X with ZFS] offers an approach to obtaining the most recent code, building from that code and installing the built software.  
* O3X forums https://openzfsonosx.org/forum or http://o3x.org/forum


=== To test without building ===
* #openzfs-osx IRC channel irc://chat.freenode.net/#openzfs-osx


Disk images are ocasionally added to http://lundman.net/ftp/osx.zfs/ – aim for the most recent .dmg file. The image will contain built software – binaries, kernel extensions (KEXTs) and so on – that may be used with or without installation.
== To use the official release ==


These images are not designed to include the most recent fixes or enhancements. If in doubt, please ask in IRC:  
[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].


* irc://chat.freenode.net/#mac-zfs
== To begin testing the most recent build ==


=== The simplest approach ===
The O3X wiki has instructions for [https://openzfsonosx.org/wiki/Install#Installing_from_source installing from source].


Expect a user-friendly package – for use with Apple's Installer.app – before the end of 2013.
== 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 [https://openzfsonosx.org/wiki/Install#Installing_a_development_build_DMG installing a development build DMG] on the wiki.


A ZFS file system for your home directory
These development build DMGs sometimes will not include the very most recent commits. If in doubt, please ask on IRC:
* where ~ is the root of that file system.  


A ZFS file system containing multiple home directories.  
* irc://chat.freenode.net/#openzfs-osx


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


ZFS-OSX is [https://github.com/zfs-osx/zfs/issues?direction=asc&sort=created&state=open not yet feature-complete].  
* Evaluating performance of various pool configurations as well as performance on older pools.


Alpha software should not be used with data that is of significant value. Be thorough with your backups and please remember that ZFS alone is not a substitute for a good backup strategy.
* Identifying any abnormal behavior when used with older pools.


If you're limited to Leopard, or if you require the most stable MacZFS at this time, then instead of ZFS-OSX: consider relatively old version 74.3 of MacZFS.
* Finding incompatibilities with 3rd party software.


If you normally use MacZFS 74.3 or ZEVO:
== Notes ==


* you must uninstall that software before testing ZFS-OSX;
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.
* you must uninstall ZFS-OSX before reverting to ZEVO or MacZFS 74.3


– and in either case, a restart of the Mac may be recommended.
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.

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.