Overhaul Install from USB flash drive

improve phrasing, align style of CLI commands, OSX is now macOS, Rufus
with dd mode is preferred to etcher

Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>
This commit is contained in:
Aaron Lauterer 2020-02-11 09:55:41 +01:00 committed by Thomas Lamprecht
parent 426fbd5ffb
commit 6d16d74122

View File

@ -1,121 +1,120 @@
Install from USB Stick Install from a USB flash drive
---------------------- ------------------------------
ifdef::wiki[] ifdef::wiki[]
:pve-toplevel: :pve-toplevel:
endif::wiki[] endif::wiki[]
The {pve} installation media is a hybrid ISO image, working in two ways: The {pve} installation media is a hybrid ISO image. It works in two ways:
* An ISO image file ready to burn on CD * An ISO image file ready to burn to a CD or DVD.
* A raw sector (IMG) image file ready to directly copy to flash media * A raw sector (IMG) image file ready to copy to a USB flash drive (USB stick).
(USB Stick)
Using USB sticks is faster and more environmental friendly and Using a USB flash drive to install {pve} is the recommended way because it is
therefore the recommended way to install {pve}. the faster option.
Prepare a USB flash drive as installation medium
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Prepare a USB flash drive as install medium Download the installer ISO image from:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
In order to boot the installation media, copy the ISO image to a USB
media.
First download the ISO image from
https://www.proxmox.com/en/downloads/category/iso-images-pve https://www.proxmox.com/en/downloads/category/iso-images-pve
You need at least a 1 GB USB media. The flash drive needs to have at least 1GB of storage available.
NOTE: Using UNetbootin or Rufus does not work. NOTE: Do not use UNetbootin. It does not work with the {pve} installation image.
IMPORTANT: Make sure that the USB media is not mounted and does not IMPORTANT: Make sure that the USB flash drive is not mounted and does not
contain any important data. contain any important data.
Instructions for GNU/Linux Instructions for GNU/Linux
~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~
You can simply use `dd` on UNIX like systems. First download the ISO On Unix-like operating system use the `dd` command to copy the ISO image to the
image, then plug in the USB stick. You need to find out what device USB flash drive. First find the correct device name of the USB flash drive (see
name gets assigned to the USB stick (see below). Then run: below). Then run the `dd` command.
---- ----
dd if=proxmox-ve_*.iso of=/dev/XYZ bs=1M # dd if=proxmox-ve_*.iso of=/dev/XYZ bs=1M
---- ----
NOTE: Be sure to replace /dev/XYZ with the correct device name. NOTE: Be sure to replace /dev/XYZ with the correct device name.
CAUTION: Be very careful, and do not overwrite the hard disk! CAUTION: Be very careful, and do not overwrite the wrong disk!
Find Correct USB Device Name Find the correct USB device name
^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
There are two ways to find out the name of the USB flash drive. The first one is
You can compare the last lines of 'dmesg' command before and after the to compare the last lines of the `dmesg` command output before and after
insertion, or use the 'lsblk' command. Open a terminal and run: plugging in the flash drive. The second way is to compare the output of the
`lsblk` command. Open a terminal and run:
---- ----
lsblk # lsblk
---- ----
Then plug in your USB media and run the command again: Then plug in your USB flash drive and run the command again:
---- ----
lsblk # lsblk
---- ----
A new device will appear, and this is the USB device you want to use. A new device will appear. This is the one you want to use. To be on the extra
safe side check if the reported size matches your USB flash drive.
Instructions for OSX Instructions for macOS
~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~
Open the terminal (query Terminal in Spotlight). Open the terminal (query Terminal in Spotlight).
Convert the .iso file to .img using the convert option of hdiutil for example. Convert the .iso file to .img using the convert option of `hdiutil` for example.
---- ----
hdiutil convert -format UDRW -o proxmox-ve_*.dmg proxmox-ve_*.iso # hdiutil convert -format UDRW -o proxmox-ve_*.dmg proxmox-ve_*.iso
---- ----
TIP: OS X tends to put the .dmg ending on the output file automatically. TIP: macOS tends to automatically add '.dmg' to the output file name.
To get the current list of devices run the command again: To get the current list of devices run the command:
---- ----
diskutil list # diskutil list
---- ----
Now insert your USB flash media and run this command again to Now insert the USB flash drive and run this command again to determine which
determine the device node assigned to your flash media device node has been assigned to it. (e.g., /dev/diskX).
(e.g. /dev/diskX).
---- ----
diskutil list # diskutil list
# diskutil unmountDisk /dev/diskX
diskutil unmountDisk /dev/diskX
---- ----
NOTE: replace X with the disk number from the last command. NOTE: replace X with the disk number from the last command.
---- ----
sudo dd if=proxmox-ve_*.dmg of=/dev/rdiskX bs=1m # sudo dd if=proxmox-ve_*.dmg of=/dev/rdiskX bs=1m
---- ----
NOTE: 'rdiskX', instead of 'diskX', in the last command is intended, NOTE: 'rdiskX', instead of 'diskX', in the last command is intended. It will
this will increase write speed increase the write speed.
Instructions for Windows Instructions for Windows
~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~
Download Etcher from https://etcher.io , select the ISO and your USB Drive. Download Rufus from https://rufus.ie/. Either install it or use the portable
version. Select the destination drive and the {pve} ISO file.
If this doesn't work, alternatively use the OSForensics USB Once you click 'Start' a dialog asking to download a different version of GRUB
installer from http://www.osforensics.com/portability.html will show up. Click 'No'. In the next dialog select the 'DD' mode.
An alternative to Rufus is Etcher. Download Etcher from https://etcher.io. It
will guide you through the process of selecting the ISO and your USB Drive.
Boot your server from USB media Boot your server from the USB flash drive
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Connect your USB media to your server and make sure that the server Connect the USB flash drive to your server and make sure that booting from USB
boots from USB (see server BIOS). Then follow the installation wizard. is enabled (check your servers BIOS). Then follow the steps in the installation
wizard.