260 lines
17 KiB
HTML
260 lines
17 KiB
HTML
+++
|
|
type = "article"
|
|
title = "Installation Guide"
|
|
date = "2009-09-11T16:45:55.000Z"
|
|
tags = []
|
|
+++
|
|
|
|
<div class="box-release-info-right">
|
|
<p><strong>Before Installing</strong></p>
|
|
<ul>
|
|
<li><a href="/get-haiku" title="Download Haiku from here">Download Haiku</a></li>
|
|
<li><a href="/get-haiku/burn-cd" title="How to burn your Haiku CD">Burning your Haiku CD</a></li>
|
|
<li><a href="/guides/installing/making_haiku_usb_stick/" title="How to create an Haiku USB stick">Haiku on a USB flash drive</a></li>
|
|
</ul>
|
|
</div>
|
|
|
|
<div class="intro">Welcome to the Haiku installation guide! This document will help you install Haiku on your computer, guiding you through the Haiku installation one step at a time. Depending on your hardware configuration, the installation process can take as little as 15 minutes.</div>
|
|
|
|
<h3>Preparing a Partition for Haiku</h3>
|
|
|
|
<p>Currently, Haiku cannot resize existing partitions; therefore, you either need to already have an empty partition where you can install Haiku, or you need to create one using a third party tool. If your current OS comes with a partitioning tool, try to use that. Otherwise, you can use specialized tools like the freely available <a href="http://gparted.sourceforge.net/livecd.php">GParted LiveCD</a>. A standard install of Haiku requires about 700MB of disk space, so the partition doesn't need to be huge. However, you may want to leave some room for stuff, so 2GB may be an appropriate partition size.</p>
|
|
|
|
<p>Whenever your disk has multiple partitions, you will also need a boot loader such as <a href="http://www.gnu.org/software/grub/manual/grub.html">GRUB</a> to be able to boot into Haiku (and any other systems that you may have installed in the remaining partitions). In some cases, it is also possible to use the Haiku Boot Manager.</p>
|
|
|
|
<h3>Let's Start the Installation!</h3>
|
|
|
|
<p>Insert the Haiku Installer CD into your CD-ROM drive and power up your system.</p>
|
|
|
|
<p><figure role="group">
|
|
<a id="step-1" name="step-1"></a>
|
|
<img src="/files/images/installation_guide/1-boot-splash.png" alt="Haiku boot splash screen" />
|
|
<figcaption><p class="step">1</p><p class="caption">After a few seconds, you should see the Haiku boot splash screen.</p>
|
|
</figcaption></figure></p>
|
|
|
|
<div class="alert alert-info">If any of the screens below fail to appear, try the fail safe mode options which can be enabled by holding <span class="key">SHIFT</span> before the CD starts to load. See <a href="/docs/userguide/en/bootloader.html">Boot Loader</a> for details. Please also consider reporting the issue at <a href="https://dev.haiku-os.org/">the bug tracker</a>.</div>
|
|
|
|
<p><figure role="group">
|
|
<a id="step-2" name="step-2"></a>
|
|
<img src="/files/images/installation_guide/2-mode-selection.png" alt="Choose the Installer option">
|
|
<figcaption><p class="step">2</p><p class="caption">This panel (depending on your hardware it can take a while to appear) lets you set the system language and keymap.<br />
|
|
Then you decide to either install Haiku on a partition by clicking <span class="button">Run Installer</span> or try out Haiku by booting to the desktop directly from CD by choosing <span class="button">Desktop (Live-CD)</span>. Run the Installer.</p>
|
|
</figcaption></figure></p>
|
|
|
|
<p><figure role="group">
|
|
<a id="step-3" name="step-3"></a>
|
|
<img src="/files/images/installation_guide/3-installer-notice.png" alt="Some pre-install information">
|
|
<figcaption><p class="step">3</p><p class="caption">Before the Haiku Installer starts, a notice is displayed. It contains information regarding prior partition setup (as described above) and GRUB setup (as described further down in this guide). Click on <span class="button">Continue</span> to proceed to the Installer.</p>
|
|
</figcaption></figure></p>
|
|
|
|
<p><figure role="group">
|
|
<a id="step-4" name="step-4"></a>
|
|
<img src="/files/images/installation_guide/4-no-bfs-alert.png" alt="No BFS partitions were found">
|
|
<figcaption><p class="step">4</p><p class="caption">If the following alert pops up, it just means that no partitions with the Be File System (BFS) have been found. Acknowledge with <span class="button">OK</span>.</p>
|
|
</figcaption></figure></p>
|
|
|
|
<p><figure role="group">
|
|
<a id="step-5" name="step-5"></a>
|
|
<img src="/files/images/installation_guide/5-launch-drivesetup.png" alt="Start DriveSetup" />
|
|
<figcaption><p class="step">5</p><p class="caption">When there is no BFS partition available, or if you want to use a differently formatted partition, you use the DriveSetup partitioning application. Click on <span class="button">Setup partitions…</span> to start DriveSetup.</p>
|
|
</figcaption></figure></p>
|
|
|
|
<p><figure role="group">
|
|
<a id="step-6" name="step-6"></a>
|
|
<img src="/files/images/installation_guide/6-drivesetup-initial.png" alt="The initial DriveSetup view" />
|
|
<figcaption><p class="step">6</p><p class="caption">Haiku's partition manager DriveSetup shows the disks and partitions that have been identified.</p>
|
|
</figcaption></figure></p>
|
|
|
|
<p><figure role="group">
|
|
<a id="step-7" name="step-7"></a>
|
|
<img src="/files/images/installation_guide/7-partition-select.png" alt="Select the target partition" />
|
|
<figcaption><p class="step">7</p><p class="caption">In this example, there already are two primary partitions. One of about 9 GiB using an Ext2 File System, and another one of 2 GiB with a FAT32 File System. There are also two extended partitions that are still empty. These partitions have been previously prepared using a partitioning tool.<br />
|
|
Now selecting the partition you want to install Haiku on. As soon as you click on a disk, its partition layout will be graphically represented. You can then also choose the partition by clicking on it in the layout graphic. The currently selected partition is marked by a blue border in the layout graphic.</p>
|
|
</figcaption></figure></p>
|
|
|
|
<p><figure role="group">
|
|
<a id="step-8" name="step-8"></a>
|
|
<img src="/files/images/installation_guide/8-initialize.png" alt="Select the Be File System for initialization" />
|
|
<figcaption><p class="step">8</p><p class="caption">To initialize a partition to the Be File System, make sure the right partition is selected, then use the menu <span class="menu">Partition | Format | Be File System…</span>.</p>
|
|
</figcaption></figure></p>
|
|
|
|
<p><figure role="group">
|
|
<a id="step-9" name="step-9"></a>
|
|
<img src="/files/images/installation_guide/9-initialize-warning.png" alt="Continue from the alert" />
|
|
<figcaption><p class="step">9</p><p class="caption">An alert will pop up to ask if the initialization should be started. If you are still sure you have the right partition selected, click <span class="button">Continue</span>, otherwise <span class="button">Cancel</span> the initialization.<br />
|
|
As the alert says, you can still abort initialization before writing any changes to disk later.</p>
|
|
</figcaption></figure></p>
|
|
|
|
<p><figure role="group">
|
|
<a id="step-10" name="step-10"></a>
|
|
<img src="/files/images/installation_guide/10-filesystem-name.png" alt="Fill in the file system name" />
|
|
<figcaption><p class="step">10</p><p class="caption">Now you enter the name for the new partition, or simply leave the suggested "Haiku". You can also select another blocksize; the default of 2048 should be fine for most uses, though.<br />
|
|
Click <span class="button">Initialize</span> to continue.</p>
|
|
</figcaption></figure></p>
|
|
|
|
<div class="alert alert-warning">This is the last step before the initialization is executed! All data on the selected partition will be irrecoverably lost!</div>
|
|
|
|
<p><figure role="group">
|
|
<a id="step-11" name="step-11"></a>
|
|
<img src="/files/images/installation_guide/11-write-to-disk.png" alt="Warning before writing back changes" />
|
|
<figcaption><p class="step">11</p><p class="caption">If everything still looks fine, click <span class="button">Write changes</span>, otherwise abort with the <span class="button">Cancel</span> button.</p>
|
|
</figcaption></figure></p>
|
|
|
|
<p><figure role="group">
|
|
<a id="step-12" name="step-12"></a>
|
|
<img src="/files/images/installation_guide/12-initialized.png" alt="The partition has been initialized to the Be File System" />
|
|
<figcaption><p class="step">12</p><p class="caption">The partition has been initialized with the <b>Be File System</b>. Click <span class="button">OK</span> to close this notification.</p>
|
|
</figcaption></figure></p>
|
|
|
|
<p><figure role="group">
|
|
<a id="step-13" name="step-13"></a>
|
|
<img src="/files/images/installation_guide/13-quit-drivesetup.png" alt="Quit DriveSetup" />
|
|
<figcaption><p class="step">13</p><p class="caption">You can now see the file system type and name has been updated in the list. Also, the graphical representation should now bear the correct name. The partition setup is now complete.<br />
|
|
Close <b>DriveSetup</b> by clicking on close widget on the left upper corner of the yellow window tab.</p>
|
|
</figcaption></figure></p>
|
|
|
|
<p><figure role="group">
|
|
<a id="step-14" name="step-14"></a>
|
|
<img src="/files/images/installation_guide/14-select-target.png" alt="Select target volume" />
|
|
<figcaption><p class="step">14</p><p class="caption">The Installer window re-appears and should now show an updated list of target partitions under <span class="menu">Onto</span>. Now choose your freshly initialized partition (or a pre-existing one if you already had one) as the installation target.</p>
|
|
</figcaption></figure></p>
|
|
|
|
<p><figure role="group">
|
|
<a id="step-15" name="step-15"></a>
|
|
<img src="/files/images/installation_guide/15-begin-install.png" alt="Begin the installation" />
|
|
<figcaption><p class="step">15</p><p class="caption">The volume with the name <b>Haiku</b> has been chosen as the target for installation. Click on <span class="button">Begin</span> to start the installation.</p>
|
|
</figcaption></figure></p>
|
|
|
|
<p><figure role="group">
|
|
<a id="step-16" name="step-16"></a>
|
|
<img src="/files/images/installation_guide/17-copying.png" alt="The Installer copies files" />
|
|
<figcaption><p class="step">16</p><p class="caption">The installation process collects some information before starting to copy data. This can take a few seconds.<br />
|
|
Soon after, packages start to be copied and a progress bar with a file count is displayed. While the copying is taking place, it is always possible to quit the process by clicking on the <span class="button">Stop</span> button.</p>
|
|
</figcaption></figure></p>
|
|
|
|
<p><figure role="group">
|
|
<a id="step-17" name="step-17"></a>
|
|
<img src="/files/images/installation_guide/18-install-done.png" alt="Installation is complete" />
|
|
<figcaption><p class="step">17</p><p class="caption">When the copying process is finished, you can quit the installer by clicking on <span class="button">Quit</span>. The install CD will be ejected, and the system will restart after a few seconds. Do not forget to remove the Haiku CD from your drive.</p>
|
|
</figcaption></figure></p>
|
|
|
|
|
|
<p>Note that the Installer will take no steps to integrate Haiku into an existing boot manager menu. The Haiku partition itself will be made bootable, though. From the <b>Tools</b> menu you can launch the <b>Boot Manager</b> that puts a menu in the boot sector to choose what operating system to boot.<br />
|
|
Boot Manager isn't yet tested very well and still has a few restrictions that it will complain about if they aren't met: the menu can only be installed on your first harddisk and there has to be a 2KiB space after the Master Boot Record (MBR).<br />
|
|
You don't need to run Boot Manager if you already use a bootmanager like Grub, in which case you have to add Haiku manually, or Haiku runs exclusively on your machine. The Boot Manager panel will guide you through installing or uninstalling the boot menu.</p>
|
|
|
|
<p>Please see below for how you can add Haiku to an existing GRUB installation or how to use the CD to boot into a Haiku installation without adding it to the boot manager.</p>
|
|
|
|
<h3>Adding Haiku to GRUB</h3>
|
|
|
|
<p>If you have GRUB already installed, you can add Haiku to its boot menu. Depending on what version of GRUB you use, this is done differently.</p>
|
|
|
|
<h4>GRUB 1</h4>
|
|
|
|
<p>Configure your <code>/boot/grub/menu.lst</code> by launching your favorite editor from a Terminal like this:</p>
|
|
|
|
<pre>
|
|
sudo <your favorite text editor> /boot/grub/menu.lst
|
|
</pre>
|
|
|
|
<p>You'll note that GRUB uses a different naming strategy for hard drives than Linux. With GRUB it's: <b>(hdN,n)</b>
|
|
<ul>
|
|
<li>All hard disks start with "hd".</li>
|
|
<li><b>N</b> is the hard disk number, starting with "0".</li>
|
|
<li><b>n</b> is the partition number, also starting with "0".<br />
|
|
The first logical partition always has the number "4", regardless of the number of primary partitions.</li>
|
|
</ul>
|
|
|
|
So behind the other menu entries towards the bottom of the file, add something similar to these lines:</p>
|
|
|
|
<pre>
|
|
# Haiku on /dev/sda7
|
|
title Haiku
|
|
rootnoverify (hd0,6)
|
|
chainloader +1
|
|
</pre>
|
|
|
|
<p>You can see the correct partition in GParted for example.</p>
|
|
|
|
<h4>GRUB 2</h4>
|
|
|
|
<p>Newer versions of GRUB use an extra configuration file to add custom entries to the boot menu. To add them to the top, you have to create/edit a file by launching your favorite editor from a Terminal like this:</p>
|
|
|
|
<pre>
|
|
sudo <your favorite text editor> /etc/grub.d/40_custom
|
|
</pre>
|
|
|
|
<p><b>NOTE:</b> While the naming strategy for hard disks is still as described under GRUB 1, the naming scheme for partitions has changed. GRUB's naming scheme is still: <b>(hdN,n)</b>
|
|
|
|
<ul>
|
|
<li>All hard disks start with "hd".</li>
|
|
<li><b>N</b> is the hard disk number, starting with "0".</li>
|
|
<li><b>n</b> is the partition number, which for GRUB 2 starts with "1"<br />
|
|
With GRUB 2 the first logical partition always has the number "5", regardless of the number of primary partitions.</li>
|
|
</ul>
|
|
|
|
So below the heading that must not be edited, add something similar to these lines:</p>
|
|
|
|
<pre>
|
|
# Haiku on /dev/sda7
|
|
menuentry "Haiku" {
|
|
set root=(hd0,7)
|
|
chainloader +1
|
|
}
|
|
</pre>
|
|
|
|
<p>You can see the correct partition in GParted for example.</p>
|
|
|
|
<p>Additionally you have to edit another file to actually display the boot menu:</p>
|
|
|
|
<pre>
|
|
sudo <your favorite text editor> /etc/default/grub
|
|
</pre>
|
|
|
|
<p>Here you have to comment out the line "<code>GRUB_HIDDEN_TIMEOUT=0</code>" by putting a "#" in front of it in order to actually display the boot menu.</p>
|
|
|
|
<p>Finally, you have to update the boot menu by entering:</p>
|
|
|
|
<pre>
|
|
sudo update-grub
|
|
</pre>
|
|
|
|
<h3>Not using GRUB</h3>
|
|
|
|
<p>If you use an other boot manager than GRUB, please consult its documentation on how to add a new operating system.</p>
|
|
|
|
<h3>Boot using the CD</h3>
|
|
|
|
<p>You can also use the boot CD to boot into your Haiku installation without adding it to a boot manager. To do so, hold <span class="key">SHIFT</span> before the CD begins to load. This will bring up the Boot Loader Options.</p>
|
|
|
|
<p><figure role="group">
|
|
<a id="step-2-1" name="step-2-1"></a>
|
|
<img src="/files/images/installation_guide/19-bootloader-menu.png" alt="The Boot Loader Menu" />
|
|
<figcaption><p class="step">1</p><p class="caption">To choose the installation to boot from, press <span class="key">ENTER</span> to navigate to the boot volume selection. Your installation should be listed there.</p>
|
|
</figcaption></figure></p>
|
|
|
|
<p><figure role="group">
|
|
<a id="step-2-2" name="step-2-3"></a>
|
|
<img src="/files/images/installation_guide/20-select-boot-volume.png" alt="Select the boot volume from the list" \>
|
|
<figcaption><p class="step">2</p><p class="caption">Select the volume using the <span class="key">↑</span> / <span class="key">↓</span> keys and press <span class="key">ENTER</span> again to choose it as the boot volume and return to the main boot loader menu.</p>
|
|
</figcaption></figure></p>
|
|
|
|
<p><figure role="group">
|
|
<a id="step-2-3" name="step-2-3"></a>
|
|
<img src="/files/images/installation_guide/21-continue-booting.png" alt="Continue booting to boot Haiku" />
|
|
<figcaption><p class="step">3</p><p class="caption">The selection will automatically jump to <span class="menu">Continue booting</span>. Press <span class="key">ENTER</span> again to start booting into your Haiku installation.</p>
|
|
</figcaption></figure></p>
|
|
|
|
|
|
|
|
<h3>First Boot</h3>
|
|
|
|
<p>Once fully booted, you should be greeted by a screen like this:</p>
|
|
|
|
<p><figure role="group">
|
|
<img src="/files/images/installation_guide/22-fully-booted.png" alt="The fully booted Haiku system" /></figure></p>
|
|
|
|
<p>Some background processing will still take place the first time you boot Haiku, so don't be alarmed by the disk activity. After a little while, the system should settle down. Make sure to read our <b>Welcome</b> documentation; there is a link on the Desktop.</p>
|
|
|
|
<p>Have fun and thanks a lot for trying out Haiku! We hope you'll like it! If you run into what you believe to be a bug, please file a report in <a href="https://dev.haiku-os.org/">our bug tracker</a>. Before filing a bug report, please take the time to quickly check if your issue has already been reported; it if has, then please add a comment if you have additional information, like how to reproduce the problem. If the issue hasn't been reported before, create a new ticket and provide as many useful details as you can.</p>
|