X-Git-Url: https://code.delx.au/refind/blobdiff_plain/1b45ba3611945b291e468f1b5d3b5452f99766ba..85f3218b8717046ea8516e17a51f66a979c8b0c4:/docs/refind/installing.html
diff --git a/docs/refind/installing.html b/docs/refind/installing.html
index 57dcf0b..42fbe8a 100644
--- a/docs/refind/installing.html
+++ b/docs/refind/installing.html
@@ -99,7 +99,11 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com
-If you're using Linux or Mac OS X, the easiest way to install rEFInd is to use the install.sh script. Under Linux, this script installs rEFInd to your disk's ESP. Under Mac OS X, the script installs rEFInd to your current OS X boot partition by default; but you can install to your ESP instead by passing the script the esp option.
+If you're using Linux or Mac OS X, the easiest way to install rEFInd is to use the install.sh script. This script automatically copies rEFInd's files to your ESP or other target location and makes changes to your firmware's NVRAM settings so that rEFInd will start the next time you boot. If you've booted to OS X or in EFI mode to Linux on a UEFI-based PC, install.sh will probably do the right thing, so you can get by with the quick instructions. If your setup is unusual, though, or if you want to create a USB flash drive with rEFInd on it, you should read the extra instructions for this utility.
+
+Quick install.sh Instructions
+
+Under Linux, the install.sh script installs rEFInd to your disk's ESP. Under Mac OS X, the script installs rEFInd to your current OS X boot partition by default; but you can install to your ESP instead by passing the script the --esp option.
Before running this script under Linux, you should ensure that your ESP is mounted at /boot or /boot/efi, as described in more detail in the Installing rEFInd Manually Using Linux section. (If you installed Linux in EFI mode, chances are your ESP is properly mounted.) This precaution isn't necessary under OS X.
@@ -135,15 +139,16 @@ WARNING: If you have an Advanced Format disk, *DO NOT* attempt to check the
bless status with 'bless --info', since this is known to cause disk corruption
on some systems!!
-NOTE: If you want to boot an OS via BIOS emulation (such as Windows or some
-Linux installations), you *MUST* edit the ///EFI/refind/refind.conf
-file's 'scanfor' line to include the 'hdbios' option, and perhaps
-'biosexternal' and 'cd', as well.
-
Installation has completed successfully.
-In either case, the details of the output differ depending on your existing configuration and how you ran the program. Some details that can affect how the script runs include the following:
+In either case, the details of the output differ depending on your existing configuration and how you ran the program. Unless you see an obvious warning or error, you shouldn't be concerned about minor deviations from these examples. If you run into such a situation, or if you want to install in an unusual way, read on....
+
+
+Extra install.sh Instructions
+
+
+Some details that can affect how the script runs include the following:
@@ -159,13 +164,13 @@ Installation has completed successfully.
the Terminal window. You'll need to press the Return or Enter key to
run the script.
-- Under OS X, passing the "--esp" option causes the script to install
- rEFInd to the ESP. The script finds the first ESP that's identified by
- the diskutil program and, if it's not already mounted, mounts
- it to install rEFInd. Thus, it's conceivable that install.sh
- will install rEFInd to the wrong partition if you have multiple disks
- or if a disk has multiple ESPs. If you believe this has happened, you
- may need to re-install manually.
+- Under OS X, passing the --esp option causes the script to
+ install rEFInd to the ESP. The script finds the first ESP that's
+ identified by the diskutil program and, if it's not already
+ mounted, mounts it to install rEFInd. Thus, it's conceivable that
+ install.sh will install rEFInd to the wrong partition if you
+ have multiple disks or if a disk has multiple ESPs. If you believe this
+ has happened, you may need to re-install manually.
- If you're using OS X 10.7's Whole Disk Encryption (WDE) feature, you
must install rEFInd to the ESP, so the --esp option to
@@ -175,12 +180,12 @@ Installation has completed successfully.
forum thread for a discussion of the topic.
- If you're replacing rEFIt with rEFInd on a Mac, there's a chance that
- install.sh will warn you about the presence of a file called
- /Library/StartupItems/rEFItBlesser and ask if you want to
- delete the file. This file is designed to keep rEFIt set as the boot
+ install.sh will warn you about the presence of a program
+ called /Library/StartupItems/rEFItBlesser and ask if you want
+ to delete it. This program is designed to keep rEFIt set as the boot
manager by automatically re-blessing it if the default boot manager
changes. This is obviously undesirable if you install rEFInd as your
- primary boot manager, so it's generally best to remove this file. If
+ primary boot manager, so it's generally best to remove this program. If
you prefer to keep your options open, you can answer N when install.sh asks if you want to
delete rEFItBlesser, and instead manually copy it elsewhere. If you
@@ -192,11 +197,11 @@ Installation has completed successfully.
--info to check your installation status; this combination has
been reported to cause disk corruption on some Macs!
-- If you intend to boot BIOS-based OSes, such as most Windows
- installations and some Linux installations, you must edit the
- refind.conf file, as noted near the end of the installation
- script's output. (Note that rEFInd can only boot such OSes on Macs at
- the moment.)
+- If you intend to boot BIOS-based OSes on a UEFI-based PC, you
+ must edit the refind.conf file's scanfor line
+ to enable the relevant searches. This is not necessary on Macs,
+ though; because of the popularity of dual boots with Windows on Macs,
+ the BIOS/legacy scans are enabled by default on Macs.
- Under both Linux and OS X, you can add the --drivers option to
have install.sh install all the filesystem drivers along with
@@ -207,15 +212,16 @@ Installation has completed successfully.
class="variable">devicepath option to install rEFInd to the
specified device as EFI/BOOT/bootx64.efi and
EFI/BOOT/bootia32.efi. The specified device must be a valid
- FAT partition. The idea is that you can easily create a bootable USB
- flash drive with this option: Create a proper FAT-formatted ESP on a
- disk (say, /dev/sdd1) and then type sh
- ./install --usedefault /dev/sdd1 to turn the disk into an
- emergency disk. This option can also be used to install rEFInd to an
- ESP using the alternative naming options
- described later. This latter usage will result in a bootable rEFInd
- only if no other OS has already created an NVRAM variable pointing to
- itself.
+ FAT partition. This option also tells the script to not make
+ changes to the computer's NVRAM. The idea is that you can easily create
+ a bootable USB flash drive with this option: Create a proper
+ FAT-formatted ESP on a disk (say, /dev/sdd1) and then type sh ./install --usedefault /dev/sdd1 to turn the
+ disk into an emergency disk. This option can also be used to install
+ rEFInd to an ESP using the alternative naming
+ options described later. This latter usage will result in a
+ bootable rEFInd only if no other OS has already created an NVRAM
+ variable pointing to itself.