wiki/deploy/prepare.md

127 lines
5.1 KiB
Markdown
Raw Normal View History

2021-11-15 15:39:52 +00:00
---
title: Preparation
description:
published: true
2021-11-18 14:07:46 +00:00
date: 2021-11-18T14:07:43.767Z
2021-11-15 15:39:52 +00:00
tags:
editor: markdown
dateCreated: 2021-11-15T15:39:49.074Z
---
> Section under construction
{.is-warning}
# Prepare the host computer
2021-11-18 14:06:10 +00:00
## Meet the requirements
2021-11-18 14:06:10 +00:00
These instructions are valid for x86-64 computers that do ship with Linux, Windows or macOS.
2021-11-18 14:06:10 +00:00
Phyllome OS targets x86 systems with hardware-assisted virtualization, with a strong preference for those providing IOMMU as well (AMD Vi or Intel VT-d).
2021-11-18 14:06:10 +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 a dedicated OS.
{.is-info}
### Minimum requirements for Phyllome OS Desktop
2021-11-18 14:06:10 +00:00
* **x86-64** computer that supports the first generation of hardware-assisted virtualization features
* For AMD-based configurations, it means that AMD V is available and enabled
* 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
* **8 GB** of RAM
* **SSD**-based storage device to store disk images and Phyllome OS
* Any graphics card (Linux or macOS guests only)
### 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
* For AMD-based configurations, it means that AMD Vi is available and enabled
* For Intel-based configurations, it means that Intel VT-d is available and enabled
2021-11-18 14:06:10 +00:00
* **8-core** processor
* **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
2021-11-17 22:13:31 +00:00
## Enable hardware-assisted virtualization
### Access the firmware
2021-11-18 11:54:32 +00:00
*The Open Virtual Machine Firmware (OVMF), which is based on the TianoCore firmware, is the default firmware for EFI-based virtual machines. It can be accessed using the <kbd>Esc</kbd> key.*
2021-11-18 11:54:32 +00:00
![uefi_tianocore_first-screen.png](/uefi_tianocore_first-screen.png)
2021-11-17 22:13:31 +00:00
* **Since Windows 8**: 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
```
* **Since Windows 8**: a visual walk-through
* Open the start-up menu and write `start-up`, then select *Change advanced start-up options*
![screenshot_win10pro_2021-11-17_223413.png](/windows-access-firmware/screenshot_win10pro_2021-11-17_223413.png)
* Under the *Advanced start-up* section, click on `Restart now`
![screenshot_win10pro_2021-11-17_220109.png](/windows-access-firmware/screenshot_win10pro_2021-11-17_220109.png)
* Select `Troubleshoot`
![screenshot_win10pro_2021-11-17_224620.png](/windows-access-firmware/screenshot_win10pro_2021-11-17_224620.png)
* Then select `Advanced options`
![screenshot_win10pro_2021-11-17_225032.png](/windows-access-firmware/screenshot_win10pro_2021-11-17_225032.png)
* Select `UEFI Firmware Settings`
![screenshot_win10pro_2021-11-17_220153.png](/windows-access-firmware/screenshot_win10pro_2021-11-17_220153.png)
* Hit `Restart`
![screenshot_win10pro_2021-11-17_220200.png](/windows-access-firmware/screenshot_win10pro_2021-11-17_220200.png)
* **macOS-based computers**
Hardware-assisted virtualization is a hit or miss on Apple computers, as there is no way to access the firmware on these computers. Apple users can jump to the section *Make sure that hardware-assisted virtualization is enabled* to check whether this feature is activated or not on their particular model.
* **Other computers**
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-18 11:54:32 +00:00
Just after pressing the `power-on` button, hit the right key to access the firmware configuration tool, usually <kbd>F2</kbd> or <kbd>Del</kbd>, but it depends on your model.
2021-11-17 22:13:31 +00:00
2021-11-18 14:07:46 +00:00
> Do not hesitate to repeatedly press the pertinent key to make sure it is registered.
2021-11-18 11:54:32 +00:00
{.is-info}
2021-11-17 22:13:31 +00:00
> Hardware manufacturers could not agree on a common keystroke to access the firmware configuration tool, so, if the given keys do not work out for you, please have a look at the documentation provided by the manufacturer of your computer.
2021-11-18 11:54:32 +00:00
{.is.info}
### Modify the firmware configuration
`to be done`
2021-11-18 14:07:46 +00:00
## Make sure that hardware-assisted virtualization is enabled
`to be done`
2021-11-17 22:13:31 +00:00
* **Windows**
* **macOS**
* **Linux**
> Failing to activate hardware-assisted virtualization will make running virtual machines extremly slow, if possible at all. If, for some reasons, it cannot be activated on your computer, you would be better off picking a Linux distribution which doesn't require it, such as [Debian](https://www.debian.org/distrib/).
{.is-warning}
---
*If the activation is successful, you can go to the next section [to prepare an installation medium](https://wiki.phyllo.me/deploy/medium).*