From a5021c31ebceb6540b6623c1c92a6edceb8ffd4f Mon Sep 17 00:00:00 2001 From: "Barry K. Nathan" Date: Thu, 12 Nov 2020 10:37:22 -0800 Subject: [PATCH] README: BIg update to step 15 Between the v0.4.x changes, the v0.5.0 changes, and the v0.5.1 iMac patch updates, these directions had become very out-of-date. --- README.md | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 4036e69..291d00b 100644 --- a/README.md +++ b/README.md @@ -101,20 +101,17 @@ If you encounter "com.apple.DiskManagement.disenter error 49168" during installa - On many pre-2011 Macs, such as 2010 MacBooks, it will start crashing repeatedly with kernel panics shortly before the Setup Assistant would normally show up. Once this happens, boot from the installer USB and perform step 15 (the next step), with the `--2010` option. That will fix the kernel panic. 15. - If you're on a Late 2013 iMac, or you've replaced the 802.11n card in your 2012/2013 Mac with an 802.11ac card, you're done. - - Otherwise, press Command-Q and wait a few seconds, then the Setup Assistant should let you shut down. After you shut down, boot from the patched installer USB again (as in step 10), then open Terminal. Next, run the `patch-kexts.sh` command to add working Wi-Fi. There are several ways of formatting this command. For example, for a system volume named `Macintosh HD`, try one of the following: + - Otherwise, press Command-Q and wait a few seconds, then the Setup Assistant should let you shut down. After you shut down, boot from the patched installer USB again (as in step 10), then open Terminal. Next, run the `patch-kexts.sh` command to do post-install patching (such as fixing Wi-Fi). There are several ways of formatting this command. For example, for a system volume named `Macintosh HD`, try one of the following: - `/Volumes/Image\ Volume/patch-kexts.sh /Volumes/Macintosh\ HD` - `'/Volumes/Image Volume/patch-kexts.sh' '/Volumes/Macintosh HD'` - `"/Volumes/Image Volume/patch-kexts.sh" "/Volumes/Macintosh HD"` - You can also mix-and-match quotation/escaping formats, such as `/Volumes/Image\ Volume/patch-kexts.sh "/Volumes/Macintosh HD"` - Backslashes may work better with tab completion (see below), but many users will find quotation marks to be easier. - Don't forget that tab completion is your friend! For instance, you can type `/V/Im/p /V/Mac` at the command prompt -- that's much less typing than `/Volumes/Image\ Volume/patch-kexts.sh /Volumes/Macintosh\ HD`! - - On 2011 MacBook Pro 13" and 2011 MacBook Air, add a "--2011" option after the ".sh" and before the volume name, for example `/Volumes/Image\ Volume/patch-kexts.sh --2011 /Volumes/Macintosh\ HD`, to fix sound, brightness control, and sleep as well as Wi-Fi. (Use this "--2011" option on 2011 iMacs and Mac Minis as well.) - - If you have a 2011 Mac that has been upgraded with an 802.11ac Wi-Fi card, add a "--no-wifi" option as well, for example `/Volumes/Image\ Volume/patch-kexts.sh --2011 --no-wifi /Volumes/Macintosh\ HD` or `/Volumes/Image\ Volume/patch-kexts.sh --no-wifi --2011 /Volumes/Macintosh\ HD`. (As of micropatcher v0.5.0, WiFi hardware is autodetected and this option is used automatically if necessary.) + - If you're going to use the installation on a 2010 or older Mac (except for 2009-2010 Mac Pro), add a "--2010" command line option, for example `/Volumes/Image\ Volume/patch-kexts.sh --2010 /Volumes/Macintosh\ HD`. - Normally `patch-kexts.sh` installs the `mojave-hybrid` WiFi patch (used since micropatcher v0.2.1), but if you need to try a different WiFi patch for any reason, try adding the `--wifi=hv12v-old` (same as v0.0.6-v0.0.20) or `--wifi=hv12v-new` (same as v0.1.0 or v0.2.0) option. - - If you're going to use the installation on a 2010 or older Mac, add a "--2010" option likewise (except for 2009-2012 Mac Pros, which should use neither "--2010" nor "--2011"). - `patch-kexts.sh` tries to automatically detect whether it should create a new APFS snapshot if it is running in a live system, and it defaults to creating a new snapshot if it is running from the patched installer USB. If you need to override this, there are now `--create-snapshot` and `--no-create-snapshot` command line options, as of micropatcher v0.3.0. - It is also possible to do this step without booting from the patched installer USB -- just open Terminal and run `/Volumes/Install\ macOS\ Big\ Sur\ Beta/patch-kexts.sh` with any command line options if needed (such as `/Volumes/Install\ macOS\ Big\ Sur\ Beta/patch-kexts.sh --2011`), but do not specify a volume name, and patch-kexts.sh will automatically default to the boot drive. - - If you have a 2011 iMac that has been upgraded with a Metal GPU (especially NVidia), then try adding `--2011 --iMac` as options for `patch-kexts.sh` to install the necessary patches for Big Sur to use your Metal GPU. At this time, the `--iMac` option only works if you boot from your Big Sur installation before running `patch-kexts.sh` (as described in the previous bullet point), and not if you boot from the installer USB. 16. (This step is unnecessary for most users.) If you will be using the Big Sur installation on a different Mac (for instance, installing on a 2011 or later Mac and using it on a 2009 or 2010 Mac), it is possible that the other Mac (the one not used for installation) may try to boot off the wrong APFS snapshot. To prevent this, run zap-snapshots.sh on your System volume, to remove all but the most recent snapshot. For instance, `/Volumes/Image\ Volume/zap-snapshots.sh /Volumes/Macintosh\ HD`. (Or you can also do this if you are running low on disk space on an older beta of Big Sur.) This is basically the same as step 15, but with `zap-snapshots` instead of `patch-kexts`, and without any command line options like `--2010` or `--2011`. 17. After step 15 (and 16 if necessary), reboot into your Big Sur installation and complete the Setup Assistant if you have not already done so. Pay particular attention to the screen that asks if you want to transfer information from another Mac or PC; if you want to restore a Time Machine backup, you must do it from this screen. The previous method of restoring it from the macOS Installer USB is still visible in the Installer USB's menu, but it no longer works. 18. On Macs which do not support Metal (many 2011 and older models), make sure to enable Reduce Transparency to eliminate many seemingly random crashes, and if icons on the right-hand side of the menu bar are invisible afterward, try Dark mode. Enabling Reduce Motion will increase performance a little more, and so might Increase Contrast. (If you will be using the installation on a 2009/2010 Mac, it would be a good idea to finish the Setup Assistant on a 2011 or later Mac and enable Reduce Transparency before moving the installation over.)