wiki/deploy/prepare.md

171 lines
8.9 KiB
Markdown
Raw Normal View History

2021-11-15 15:39:52 +00:00
---
title: Preparation
description:
published: true
2022-09-28 12:57:22 +00:00
date: 2022-09-28T12:57:20.646Z
2021-11-15 15:39:52 +00:00
tags:
editor: markdown
dateCreated: 2021-11-15T15:39:49.074Z
---
# Prepare the host computer
2021-11-22 20:58:31 +00:00
## Meet the requirements
2021-11-21 15:51:28 +00:00
These instructions are valid for most computers that ship with Linux, Windows or macOS.
2022-01-07 14:30:37 +00:00
Phyllome OS targets [x86-64 systems](https://en.wikipedia.org/wiki/X86-64) supporting hardware-assisted virtualization, with a strong preference for those providing IOMMU-based virtualization as well (AMD Vi or Intel VT-d).
2021-11-19 21:21:11 +00:00
2022-09-28 12:57:22 +00:00
> *Sitting idle, Phyllome OS consumes approximately 1 CPU core and 1.5 GB of RAM. This requirement scales up with the number of virtual machines running on any dedicated host: the more the virtual machines are running, the more ressources Phyllome OS will use*
2021-11-18 14:06:10 +00:00
{.is-info}
2022-09-28 12:57:22 +00:00
> *A CPU that supports hardware-assisted virtualization is not be enough, as the motherboard also requires to support this feature. Laptop motherboards seem to be lagging behind desktop motherboards when it comes to supporting this feature. As a result of this, **desktop motherboards** are usually better candidates for Phyllome OS*
2021-11-21 15:51:28 +00:00
{.is-warning}
### Minimum requirements for Phyllome OS Desktop
2021-11-27 14:51:36 +00:00
* A **x86-64** computer
* **Hardware-assisted virtualization** enabled, first generation
2021-11-22 20:57:56 +00:00
* For AMD-based configurations, it means that AMD V is available and enabled (*see next section below to learn how to enable this feature*)
* For Intel-based configurations, it means that Intel VT-x is available and enabled
2021-11-18 14:06:10 +00:00
* **2-core** processor
2021-11-21 13:40:05 +00:00
* **4 GB** of RAM
2021-11-18 14:06:10 +00:00
* **SSD**-based storage device to store disk images and Phyllome OS
2022-09-28 12:57:22 +00:00
> *For Intel-based configurations, you can check if your model supports **Intel VT-x** by following [this link](https://ark.intel.com/content/www/us/en/ark/search/featurefilter.html?productType=873&2_VTX=true).*
2021-11-19 21:21:11 +00:00
{.is-info}
### Recommended requirements for Phyllome OS Desktop
2021-11-18 14:06:10 +00:00
* **x86-64** computer that supports the second generation of hardware-assisted virtualization features
2021-11-27 14:51:36 +00:00
* **Hardware-assisted virtualization** enabled, second generation
2021-11-21 15:51:28 +00:00
* For AMD-based configurations, it means that AMD Vi is available and enabled
2021-11-19 21:21:11 +00:00
* For Intel-based configurations, it means that Intel VT-d is available and enabled.
2022-01-07 14:33:10 +00:00
* **4-core** processor
2021-11-18 14:06:10 +00:00
* **16 GB** of RAM
* **NVME**-based storage device to store disk images and Phyllome OS
* Two graphics cards or a graphics card that supports vfio-mdev or SR-IOV
2022-09-28 12:57:22 +00:00
> *For Intel-based configurations, you can check if your model supports **Intel VT-d** by following [this link](https://ark.intel.com/content/www/us/en/ark/search/featurefilter.html?productType=873&0_VTD=True).*
2021-11-19 21:21:11 +00:00
{.is-info}
2021-11-22 20:58:31 +00:00
## Enable hardware-assisted virtualization
2022-01-07 14:33:10 +00:00
Unfortunately, even on supported computer platforms, hardware-assisted virtualization is rarely turned on by default. In other words, it is not enough for a computer platform to support hardware-assisted virtualization: it needs to be explicitly enabled.
2021-11-21 15:51:28 +00:00
2022-01-07 14:33:10 +00:00
The process to activate this feature requires accessing the firmware configuration tool for your motherboard, which is part of your BIOS or UEFI. This process, which differs depending on your current OS, is described in the following section.
2021-11-21 15:51:28 +00:00
> *Did you know that the Open Virtual Machine Firmware (OVMF), which is based on [TianoCore](https://www.tianocore.org/), is the default firmware for EFI-based virtual machines? Its configuration utility can be accessed using the <kbd>Esc</kbd> key.*
{.is-info}
2022-01-07 14:33:10 +00:00
![uefi_tianocore_first-screen.png](/uefi_tianocore_first-screen.png)
2021-11-21 15:51:28 +00:00
*The TianoCore splash screen*
2021-11-21 15:51:28 +00:00
### Accessing the firmware
The process to access the main motherboard firmware configuration utility differ depending on which operating system is currently installed on your computer.
#### Windows 8 and newer: command-line instructions
2021-11-17 22:13:31 +00:00
Press the <kbd>Win</kbd> and <kbd>X</kbd> keys simultaneously to make a context menu appears. Then press <kbd>Shift</kbd> and <kbd>a</kbd> to politely ask Windows to open `Powershell` using elevated privileges, and click on the `Yes` button to bypass the User Account Control pop-up. Finally, input the following command inside the command prompt and press `enter`.
```
shutdown /fw /r
```
2021-11-21 15:51:28 +00:00
#### Windows 8 and newer: a visual walk-through
2021-11-17 22:13:31 +00:00
2021-11-21 15:51:28 +00:00
* Open the start-up menu and write "start-up", then select *Change advanced start-up options*
2021-11-17 22:13:31 +00:00
![screenshot_win10pro_2021-11-17_223413.png](/windows-access-firmware/screenshot_win10pro_2021-11-17_223413.png)
2021-11-21 15:51:28 +00:00
* Under the *Advanced start-up* section, click on *Restart now*
2021-11-17 22:13:31 +00:00
![screenshot_win10pro_2021-11-17_220109.png](/windows-access-firmware/screenshot_win10pro_2021-11-17_220109.png)
2021-11-21 15:51:28 +00:00
* Select *Troubleshoot*
2021-11-17 22:13:31 +00:00
![screenshot_win10pro_2021-11-17_224620.png](/windows-access-firmware/screenshot_win10pro_2021-11-17_224620.png)
2021-11-21 15:51:28 +00:00
* Then select *Advanced options*
2021-11-17 22:13:31 +00:00
![screenshot_win10pro_2021-11-17_225032.png](/windows-access-firmware/screenshot_win10pro_2021-11-17_225032.png)
2021-11-21 15:51:28 +00:00
* Select *UEFI Firmware Settings*
2021-11-17 22:13:31 +00:00
![screenshot_win10pro_2021-11-17_220153.png](/windows-access-firmware/screenshot_win10pro_2021-11-17_220153.png)
2021-11-21 15:51:28 +00:00
* Hit *Restart*
2021-11-17 22:13:31 +00:00
![screenshot_win10pro_2021-11-17_220200.png](/windows-access-firmware/screenshot_win10pro_2021-11-17_220200.png)
2021-11-25 13:45:32 +00:00
* Go to the section [Modify the firmware configuration](/deploy/prepare#modify-the-firmware-configuration) to learn what to do next.
2021-11-21 15:51:28 +00:00
#### macOS-based computers
2021-11-17 22:13:31 +00:00
2021-11-21 13:42:11 +00:00
Hardware-assisted virtualization is a hit or miss on Apple computers, as there is no way to access the firmware configuration tool on these computers. Apple users can go to the [install section](https://wiki.phyllo.me/deploy/medium) directly, create a USB stick and hope that hardware-assisted virtualization will be supported.
2021-11-17 22:13:31 +00:00
2021-11-21 15:51:28 +00:00
#### Other computers
2021-11-17 22:13:31 +00:00
Make sure the targeted computer is shut down.
During the POST phase, you need to press a certain key to access the firmware configuration tool for your motherboard, which is part of your BIOS or UEFI.
2021-11-21 15:51:28 +00:00
Just after pressing the <kbd>power</kbd> button, hit the right key to access the firmware configuration tool, usually <kbd>F2</kbd> or <kbd>Del</kbd>, but it may be another keystroke on your model.
2021-11-17 22:13:31 +00:00
2022-09-28 12:57:22 +00:00
> *Do not hesitate to repeatedly press the pertinent key as soon has your computer has started, to make sure it is registered*
2021-11-18 11:54:32 +00:00
{.is-info}
2021-11-17 22:13:31 +00:00
### Modify the firmware configuration
2021-11-25 13:28:36 +00:00
Unfortunately, most firmware configuration tool do differ, and the steps here might not be identical on your current platform. In general, the sought after features are found under the *Security* tab.
2021-11-25 13:28:36 +00:00
For an AMD-based computer, you need to look for references to *AMD SVM*, AMD V or AMD Vi. For an Intel-based computer, you need to look for *Intel VT-x* and *Intel VT-d*. It is also possible that the feature will be referred simply to as *Virtualization*. In that case, you may not know if it actually refers to IOMMU-based hardware-assisted virtualization.
2021-11-17 22:13:31 +00:00
Make sure you enable these options and choose to *save and exit* the configuration tool, which will reboot your computer.
2021-11-17 22:13:31 +00:00
2021-11-25 13:39:12 +00:00
#### A visual walk-through for Intel-based NUC
2021-11-25 13:28:36 +00:00
Here is a visual walk-through for an Intel NUC computer.
* After you have pressed the <kbd>F2</kbd> key on boot, this screen should appear.
![efi-1.png](/inte-efi/efi-1.png)
* Go to the *Security* tab. Under the *Security Features* menu, you will find two options, *Intel Virtualization Technology* and *Intel VT for Directed I/O (VT-d)*.
![efi-2.png](/inte-efi/efi-2.png)
* Check these boxes
![efi-4.png](/inte-efi/efi-4.png)
Then *save and exit* the configuration tool, which will reboot your computer.
2022-09-28 12:57:22 +00:00
> *While you are there, you could also change the boot order, to make sure that your computer will boot from an attached USB thumb drive first when it will be time to try out Phyllome OS.*
2021-11-19 21:21:11 +00:00
{.is-info}
2021-11-17 22:13:31 +00:00
2021-11-25 13:39:36 +00:00
#### Modify the boot order permanently
2021-11-25 13:37:36 +00:00
2021-11-25 13:42:21 +00:00
This section will show you how to modify the boot order permanently, so you can boot from a USB flash drive attached to your computer, a necessary step to install or use Phyllome OS as a live system.
2021-11-25 13:37:36 +00:00
* Go to the *Boot* tab
![efi_boot-order-1.png](/inte-efi/efi_boot-order-1.png)
* Under the *UEFI Boot Priority* menu, you may notice that Fedora, which is installed on the internal storage device, is in the first position
![efi_boot-order-2.png](/inte-efi/efi_boot-order-2.png)
* Move the USB Flash Drive to the first position instead, as shown in the screenshot below
![efi_boot-order-3.png](/inte-efi/efi_boot-order-3.png)
2021-11-25 13:39:12 +00:00
* That's it. Save changes and exist. Note that it is advisable to revert these changes after a successful installation, or to only change the bootloader temporary.
2021-11-25 13:37:36 +00:00
2022-09-28 12:57:22 +00:00
> ***Failing to activate hardware-assisted virtualization** will make running virtual machines extremly **slow**, or not possible at all. If, for some reasons, it cannot be activated on your computer, for example because of a lack of hardware support, you would be better off picking a Linux distribution which doesn't require it, such as [Debian](https://www.debian.org/distrib/).*
2021-11-17 22:13:31 +00:00
{.is-warning}
---
2022-01-11 15:58:38 +00:00
*If the activation is successful, you can go to [**the next section**](https://wiki.phyllo.me/deploy/medium) to prepare an installation medium.*