Skip to content

Commit

Permalink
README: forgot to mention that install-setvars asks for password
Browse files Browse the repository at this point in the history
I forgot to mention that install-setvars.sh uses sudo to get root permissions,
so it typically asks for the user account password.

*Now* v0.2.0 is done.
  • Loading branch information
barrykn authored Sep 23, 2020
1 parent 98261de commit 14548cc
Showing 1 changed file with 1 addition and 1 deletion.
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ Unknown status:
4. (Optional if you are reusing a USB stick which was already patched using micropatcher v0.2.0 or later) Use Disk Utility to erase the USB stick using "Mac OS Extended (Journaled)" format and "GUID Partition Map" scheme. In order for this patcher to run optimally, the USB stick must use GUID Partition Map and not Master Boot Record. (This is a new requirement as of micropatcher v0.2.0.) Note that the volume name does not particularly matter, since it will be renamed by `createinstallmedia` in the next step.
5. Use `createinstallmedia` as usual to create a bootable USB stick with the installer and recovery environment, as you would on a supported Mac. (This patcher is easier to use if the installer USB stick is not renamed after `createinstallmedia` is used, but it can still work if the USB stick has been renamed.)
6. Run `micropatcher.sh` to patch the USB stick. If the USB stick has been renamed or micropatcher.sh is otherwise unable to find the USB stick, then try specifying the pathname of the USB stick to micropatcher.sh. The easiest way to do that is to open a Terminal window, drag and drop micropatcher.sh into the Terminal window, go back to Finder, choose Computer from the Go menu, drag and drop the USB stick into the Terminal window, then press Return.
7. Another program also needs to be patched onto the USB stick, so run `install-setvars.sh`. If necessary, the same Finder/Terminal drag-and-drop instructions that work in step 6 for `micropatcher.sh` will also work in this step for `install-setvars.sh`. (By the way, if you want the patched USB stick to configure your Mac to boot in Verbose Mode, run `install-setvars.sh -v` instead of just `install-setvars.sh`. However, the "Verbose" in "Verbose Mode" is not a joke, and most users will want to avoid this.)
7. Another program also needs to be patched onto the USB stick, so run `install-setvars.sh`. If necessary, the same Finder/Terminal drag-and-drop instructions that work in step 6 for `micropatcher.sh` will also work in this step for `install-setvars.sh`. Unlike `micropatcher.sh`, `install-setvars.sh` needs root permissions (since it accesses the normally hidden EFI partition on the USB stick), so it uses `sudo` to obtain root permissions. Typically this means it will ask for your user account password when it starts. (By the way, if you want the patched USB stick to configure your Mac to boot in Verbose Mode, run `install-setvars.sh -v` instead of just `install-setvars.sh`. However, the "Verbose" in "Verbose Mode" is not a joke, and most users will want to avoid this.)
8. Since Disk Utility in Big Sur may have new bugs, this may be a good time to use Disk Utility in High Sierra/Mojave/Catalina to do any partitioning or formatting you may need.
9. (Optional if you have already done this step using micropatcher v0.2.0 or later) Restart the Mac while holding down the Option key to use the Startup Selector. The installer USB will actually show up as *two* different drives with the same icon, "Install macOS Big Sur Beta" (or similar) and "EFI Boot". (If you have multiple "EFI Boot" drives and cannot tell which one is the one on the installer USB, try unplugging the installer USB, observing the set of icons on the screen, then plugging the installer USB back in and watching how the icons change.) Start up from "EFI Boot". Within a few seconds, although most likely in under a second, the Mac will suddenly power down. This indicates that the setvars EFI utility has finished making the necessary changes to the Mac's NVRAM settings. (These changes include disabling SIP, disabling authenticated root, and enabling TRIM on non-Apple SSDs.)
10. Turn the Mac back on (or reboot it if you skipped step 9), with the Option key down again, to use the Startup Selector again. This time, boot from "Install macOS Big Sur Beta" (or similar).
Expand Down

0 comments on commit 14548cc

Please sign in to comment.