Difference between revisions of "OpenZFSOnOSX"

From OpenZFS
Jump to navigation Jump to search
m (Ilovezfs moved page MacZFS to OpenZFSOnOSX)
Line 1: Line 1:
== MacZFS ==
== OpenZFS on OS X (O3X) ==


{|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 …
|}


== OpenZFS for OS X (ZFS-OSX) ==
[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).


'''ZFS-OSX brings OpenZFS features to MacZFS'''.
== To use the official release ==


[http://openzfsonosx.org OpenZFS for OS X] 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).
[http://o3x.org/wiki/Downloads Download] the most recent installer from the [http://o3x.org/wiki O3X wiki] and follow the [http://o3x.org/wiki/Install#Installing_the_Official_Release instructions].


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


[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.  
The O3X wiki has instructions for [http://o3x.org/wiki/Install#Installing_from_Source installing from source].


=== To test without building ===
=== To test without building ===


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


These images are not designed to include the most recent fixes or enhancements. 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 in IRC:  


* irc://chat.freenode.net/#mac-zfs
* irc://chat.freenode.net/#openzfs-osx


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


A ZFS file system for your home directory
Evaluating performance of various pool configurations as well as performance on older pools.
* where ~ is the root of that file system.  


A ZFS file system containing multiple home directories.  
Identifying any abnormal behavior when used with older pools.
 
Finding incompatibilities with 3rd party software.  


=== Notes ===
=== Notes ===


ZFS-OSX is [https://github.com/zfs-osx/zfs/issues?direction=asc&sort=created&state=open not yet feature-complete].
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.
 
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.
 
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.


If you normally use MacZFS 74.3 or ZEVO:  
If you normally use MacZFS 74 or ZEVO:  


* you must uninstall that software before testing ZFS-OSX
* you must uninstall that software before testing O3X (scripts for doing so are included with the O3X release download).
* you must uninstall ZFS-OSX before reverting to ZEVO or MacZFS 74.3
* you must uninstall O3X before reverting to ZEVO or MacZFS 74 (an uninstaller script for O3X is also included with the release download).


– and [http://zevo.getgreenbytes.com/forum/viewtopic.php?p=5441#p5441 a restart of the Mac may be recommended].
Either unload the older kernel extensions or reboot before proceeding.

Revision as of 05:52, 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).

To use the official release

Download the most recent installer from the O3X wiki and follow the 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.

These development build DMGs sometimes will not include the very most recent commits. If in doubt, please ask in 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 normally use MacZFS 74 or ZEVO:

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