]> code.delx.au - refind/blobdiff - docs/refind/installing.html
0.4.5 release
[refind] / docs / refind / installing.html
index 0b2886436ad40eb25e66912799a699ce1740298a..5c71b28c29e7f495ecb0188e84b12c9b8583799d 100644 (file)
@@ -15,7 +15,7 @@
 href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com</a></p>
 
 <p>Originally written: 3/14/2012; last Web page update:
-5/20/2012, referencing rEFInd 0.4.0</p>
+8/12/2012, referencing rEFInd 0.4.5</p>
 
 
 <p>I'm a technical writer and consultant specializing in Linux technologies. This Web page is provided free of charge and with no annoying outside ads; however, I did take time to prepare it, and Web hosting does cost money. If you find this Web page useful, please consider making a small donation to help keep this site up and running. Thanks!</p>
@@ -135,6 +135,11 @@ 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.</pre>
 
@@ -169,11 +174,30 @@ Installation has completed successfully.</pre>
     href="https://sourceforge.net/p/refind/discussion/general/thread/5c7d0195/">this
     forum thread</a> for a discussion of the topic.</li>
 
+<li>If you're replacing rEFIt with rEFInd on a Mac, there's a chance that
+    <tt>install.sh</tt> will warn you about the presence of a file called
+    <tt>/Library/StartupItems/rEFItBlesser</tt> and ask if you want to
+    delete the file. This file 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
+    you prefer to keep your options open, you can answer <tt
+    class="userinput">N</tt> when <tt>install.sh</tt> asks if you want to
+    delete rEFItBlesser, and instead manually copy it elsewhere. If you
+    subsequently decide to go back to using rEFIt as your primary boot
+    manager, you can restore rEFItBlesser to its place.</li>
+
 <li>If you're using OS X and an Advanced Format disk, heed the warning that
     <tt>install.sh</tt> displays and <i><b>do not</b></i> use <tt>bless
     --info</tt> to check your installation status; this combination has
     been reported to cause disk corruption on some Macs!</li>
 
+<li>If you intend to boot BIOS-based OSes, such as most Windows
+    installations and some Linux installations, you <i>must</i> edit the
+    <tt>refind.conf</tt> 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.)</li>
+
 </ul>
 
 <p>In any event, you should peruse the script's output to ensure that everything looks OK. <tt>install.sh</tt> displays error messages when it encounters errors, such as if the ESP is mounted read-only or if you run out of disk space. You may need to correct such problems manually and re-run the script. In some cases you may need to fall back on manual installation, which gives you better control over details such as which partition to use for installation.</p>
@@ -421,11 +445,15 @@ $ <b>ioreg -l -p IODeviceTree | grep firmware-abi</b>
 
 <ul>
 
-<li><b><a href="http://tianocore.git.sourceforge.net/git/gitweb.cgi?p=tianocore/edk2;a=blob_plain;f=EdkShellBinPkg/FullShell/X64/Shell_Full.efi;hb=HEAD">shell.efi</a></b>&mdash;This
+<li><b><a
+    href="http://tianocore.git.sourceforge.net/git/gitweb.cgi?p=tianocore/edk2;a=blob_plain;f=EdkShellBinPkg/FullShell/X64/Shell_Full.efi;hb=HEAD">shell.efi</a></b>&mdash;This
     file, placed in the ESP's <tt>efi/tools</tt> directory, adds the
     ability to launch a text-mode EFI shell from rEFInd. Note that the
     download link is to a 64-bit binary that must be renamed before rEFInd
-    will recognize it.</li>
+    will recognize it. Additional shell download links appear on the <a
+    href="https://wiki.archlinux.org/index.php/Unified_Extensible_Firmware_Interface#UEFI_Shell_download_links">Arch
+    Linux wiki,</a> and on other sites; try a Web search if the shell you
+    find doesn't work to your satisfaction.</li>
 
 <li><b>gptsync.efi</b>&mdash;This program creates a <a
     href="http://www.rodsbooks.com/gdisk/hybrid.html">hybrid MBR</a> from