ZFS on Boot - Revision history

72.200.126.145: update mimic syntax for the new 2.0 port, recommend the fancier/new encryption

2021-06-06T18:06:25Z

update mimic syntax for the new 2.0 port, recommend the fancier/new encryption

2020-02-10T07:13:52Z

‎Setting up ZFS slice 2

2020-02-10T01:21:44Z

‎Setting up ZFS slice 2

2019-11-14T09:26:51Z

Add notes about disabling and enabling SIP

2019-11-14T09:13:39Z

Add caveat and instructions that SIP may have to be disabled to bless the boot device

2019-11-14T08:12:01Z

clarify ROOT UUID can be copyed verbatim

2019-10-17T01:20:13Z

2019-10-15T06:40:39Z

2019-10-15T03:36:22Z

2019-10-15T03:15:43Z

@@ Line 53: / Line 53: @@
   # sudo zpool create -f -o ashift=12 -O casesensitivity=insensitive \
-    -O normalization=formD -O atime=off -O compression=lz4 \
+    -O normalization=formD -O atime=off -O compression=zstd \
     -O mountpoint=none -O canmount=off rpool ${NEWDISK}s2
@@ Line 59: / Line 59: @@
   # zfs create -o mountpoint=none -o canmount=off rpool/ROOT
-  # zfs create -o mountpoint=legacy -o com.apple.mimic_hfs=on rpool/ROOT/Catalina
+  # zfs create -o mountpoint=legacy -o com.apple.mimic=hfs rpool/ROOT/Catalina
   # zpool set bootfs=rpool/ROOT/Catalina rpool
@@ Line 195: / Line 195: @@
 Additional research is needed on atime, casesensitivity, and normalization (and probably more).
   # sudo zpool create -f -o ashift=12 -O casesensitivity=insensitive \
-   -O normalization=formD -O atime=off -O compression=lz4 \
+   -O normalization=formD -O atime=off -O compression=zstd \
    -O mountpoint=none -O canmount=off rpool disk1s2
@@ Line 205: / Line 205: @@
   # sudo zpool set bootfs=rpool/ROOT/Capitan rpool
-Note: com.apple.mimic_hfs may be set on the root mountpoint. Testing is still underway for ZFS Root both with or without mimic set.
+Note: com.apple.mimic=hfs may be set on the root mountpoint. Testing is still underway for ZFS Root both with or without mimic set.
 You probably want to relocate your home folder outside of the root dataset, for example rpool/HOME/username, or on ZVOL for compatibility.

@@ Line 70: / Line 70: @@
   # mkdir /Volumes/ZFSBoot
   # /Library/Filesystems/zfs.fs/Contents/Resources/mount_zfs rpool/ROOT/Catalina /Volumes/ZFSBoot
-  # rsync -laxH --progress --exclude=".Spotlight-V100" --exclude=".fseventsd" --exclude=".vol" / /Volumes/ZFSBoot/
+  # rsync -axH --progress --exclude=".Spotlight-V100" --exclude=".fseventsd" --exclude=".vol" / /Volumes/ZFSBoot/
 .. and wait.

@@ Line 70: / Line 70: @@
   # mkdir /Volumes/ZFSBoot
   # /Library/Filesystems/zfs.fs/Contents/Resources/mount_zfs rpool/ROOT/Catalina /Volumes/ZFSBoot
-  # rsync -axH --progress --exclude=".Spotlight-V100" --exclude=".fseventsd" --exclude=".vol" / /Volumes/ZFSBoot/
+  # rsync -laxH --progress --exclude=".Spotlight-V100" --exclude=".fseventsd" --exclude=".vol" / /Volumes/ZFSBoot/
 .. and wait.
@@ Line 90: / Line 90: @@
 (The uuid doesnt seem to matter, it just needs to be formatted valid, you can copy the one in the docs, it has nothing to do with your devices.)
 === Setting up boot slice 3 ===

@@ Line 5: / Line 5: @@
     Most of the commands listed below must be run as root or with '''sudo'''.
 before running the bless command you may have to disable System Integrity Protection [SIP]:
 boot into recovery mode by holding '''Cmd+R''', open Utilities > Terminal and run
@@ Line 131: / Line 132: @@
   # sudo bless --device ${NEWDISK}s3 --setBoot
   # reboot
 Additional tricks. If updating the kexts, and you want to update the boot volume as well:

← Older revision		Revision as of 09:13, 14 November 2019
Line 5:		Line 5:
	Most of the commands listed below must be run as root or with '''sudo'''.		Most of the commands listed below must be run as root or with '''sudo'''.

		+	before running the bless command you may have to disable System Integrity Protection [SIP]:
		+	boot into recovery mode by holding '''Cmd+R''', open Utilities > Terminal and run
		+	csrutil disable
		+	then reboot; to re-enable SIP boot into recovery mode by holding '''Cmd+R''', open Utilities > Terminal and run
		+	csrutil enable
		+
		+
	'''Updated for macOS Catalina '''		'''Updated for macOS Catalina '''

← Older revision		Revision as of 01:20, 17 October 2019
Line 126:		Line 126:
	# reboot		# reboot

		+
		+	Additional tricks. If updating the kexts, and you want to update the boot volume as well:
		+
		+	Mount and update ZFSBoot
		+	# mkdir /Volumes/ZFSBoot
		+	# /Library/Filesystems/zfs.fs/Contents/Resources/mount_zfs rpool/ROOT/Catalina /Volumes/ZFSBoot
		+
		+	If you prefer to update the kexts in /Volumes/ZFSBoot/Library/Extensions/
		+	# kextcache -c "/Volumes/ZFSBoot/System/Library/PrelinkedKernels/prelinkedkernel" -K "/Volumes/ZFSBoot/System/Library/Kernels/kernel" -l -- "/Volumes/ZFSBoot/System/Library/Extensions" "/Volumes/ZFSBoot/Library/Extensions/"
		+
		+	Or if you install new kexts on machine, and then update /Volumes/ZFSBoot/
		+	# rsync -ar /Library/Extensions/ /Volumes/ZFSBoot/Library/Extensions/
		+	# kextcache -c "/Volumes/ZFSBoot/System/Library/PrelinkedKernels/prelinkedkernel" -K "/System/Library/Kernels/kernel" -l -- "/System/Library/Extensions" "/Library/Extensions/"
		+
		+	Also update the tiny boot volume - find the disk it is on, in example, disk1s3. Pick kernel either on "/" or "/Volumes/ZFSBoot/"
		+	# diskutil mount disk1s3
		+	# mkdir -p /Volumes/boot/com.apple.boot.R/System/Library/Caches/com.apple.kext.caches/Startup
		+	# kextcache -c "/Volumes/boot/com.apple.boot.R/System/Library/PrelinkedKernels/prelinkedkernel" -K "/System/Library/Kernels/kernel" -l -- "/System/Library/Extensions" "/Library/Extensions/"

	----		----

@@ Line 60: / Line 60: @@
 Populate the rpool from the running system:
-  # zfs set mountpoint=/Volumes/ZFSBoot rpool/ROOT/Catalina
+  # mkdir /Volumes/ZFSBoot
-  # zfs mount rpool/ROOT/Catalina
+  # /Library/Filesystems/zfs.fs/Contents/Resources/mount_zfs rpool/ROOT/Catalina /Volumes/ZFSBoot
   # rsync -axH --progress --exclude=".Spotlight-V100" --exclude=".fseventsd" --exclude=".vol" / /Volumes/ZFSBoot/
@@ Line 80: / Line 80: @@
           <string>5A465320-626F-6F74-2064-657669636500</string>
   </dict>

@@ Line 5: / Line 5: @@
     Most of the commands listed below must be run as root or with '''sudo'''.
-''Updated for macOS Catalina ''
+'''Updated for macOS Catalina '''
 === Partitioning disk ===
@@ Line 56: / Line 64: @@
   # rsync -axH --progress --exclude=".Spotlight-V100" --exclude=".fseventsd" --exclude=".vol" / /Volumes/ZFSBoot/
 .. and wait.
 Update the Boot.plist: