From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from firstgate.proxmox.com (firstgate.proxmox.com [212.224.123.68]) by lore.proxmox.com (Postfix) with ESMTPS id C4FBE1FF380 for ; Fri, 19 Apr 2024 11:06:22 +0200 (CEST) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id 5703E3537; Fri, 19 Apr 2024 11:05:49 +0200 (CEST) From: Christoph Heiss To: pve-devel@lists.proxmox.com Date: Fri, 19 Apr 2024 11:05:17 +0200 Message-ID: <20240419090519.291775-12-c.heiss@proxmox.com> X-Mailer: git-send-email 2.44.0 In-Reply-To: <20240419090519.291775-1-c.heiss@proxmox.com> References: <20240419090519.291775-1-c.heiss@proxmox.com> MIME-Version: 1.0 X-SPAM-LEVEL: Spam detection results: 0 AWL -0.448 Adjusted score from AWL reputation of From: address BAYES_00 -1.9 Bayes spam probability is 0 to 1% DMARC_MISSING 0.1 Missing DMARC policy KAM_ASCII_DIVIDERS 0.8 Email that uses ascii formatting dividers and possible spam tricks KAM_DMARC_STATUS 0.01 Test Rule for DKIM or SPF Failure with Strict Alignment SPF_HELO_NONE 0.001 SPF: HELO does not publish an SPF Record SPF_PASS -0.001 SPF: sender matches SPF record URIBL_SBL_A 0.1 Contains URL's A record listed in the Spamhaus SBL blocklist [185.199.110.153, 185.199.108.153, 185.199.109.153, 185.199.111.153] Subject: [pve-devel] [RFC PATCH docs 11/13] installation-media: move to common docs X-BeenThere: pve-devel@lists.proxmox.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Proxmox VE development discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Proxmox VE development discussion Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Errors-To: pve-devel-bounces@lists.proxmox.com Sender: "pve-devel" Signed-off-by: Christoph Heiss --- pve-installation-media.adoc | 132 ------------------------------------ pve-installation.adoc | 2 +- 2 files changed, 1 insertion(+), 133 deletions(-) delete mode 100644 pve-installation-media.adoc diff --git a/pve-installation-media.adoc b/pve-installation-media.adoc deleted file mode 100644 index a1c9402..0000000 --- a/pve-installation-media.adoc +++ /dev/null @@ -1,132 +0,0 @@ -[[installation_prepare_media]] -Prepare Installation Media --------------------------- -ifdef::wiki[] -:pve-toplevel: -endif::wiki[] - -Download the installer ISO image from: {website}en/downloads/proxmox-virtual-environment/iso - -The {pve} installation media is a hybrid ISO image. It works in two ways: - -* An ISO image file ready to burn to a CD or DVD. - -* A raw sector (IMG) image file ready to copy to a USB flash drive (USB stick). - -Using a USB flash drive to install {pve} is the recommended way because it is -the faster option. - -Prepare a USB Flash Drive as Installation Medium -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -The flash drive needs to have at least 1 GB of storage available. - -NOTE: Do not use UNetbootin. It does not work with the {pve} installation image. - -IMPORTANT: Make sure that the USB flash drive is not mounted and does not -contain any important data. - - -Instructions for GNU/Linux -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -On Unix-like operating system use the `dd` command to copy the ISO image to the -USB flash drive. First find the correct device name of the USB flash drive (see -below). Then run the `dd` command. - ----- -# dd bs=1M conv=fdatasync if=./proxmox-ve_*.iso of=/dev/XYZ ----- - -NOTE: Be sure to replace /dev/XYZ with the correct device name and adapt the -input filename ('if') path. - -CAUTION: Be very careful, and do not overwrite the wrong disk! - - -Find the Correct USB Device Name -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -There are two ways to find out the name of the USB flash drive. The first one is -to compare the last lines of the `dmesg` command output before and after -plugging in the flash drive. The second way is to compare the output of the -`lsblk` command. Open a terminal and run: - ----- -# lsblk ----- - -Then plug in your USB flash drive and run the command again: - ----- -# lsblk ----- - -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 macOS -~~~~~~~~~~~~~~~~~~~~~~ - -Open the terminal (query Terminal in Spotlight). - -Convert the `.iso` file to `.dmg` format using the convert option of `hdiutil`, -for example: - ----- -# hdiutil convert proxmox-ve_*.iso -format UDRW -o proxmox-ve_*.dmg ----- - -TIP: macOS tends to automatically add '.dmg' to the output file name. - -To get the current list of devices run the command: - ----- -# diskutil list ----- - -Now insert the USB flash drive and run this command again to determine which -device node has been assigned to it. (e.g., /dev/diskX). - ----- -# diskutil list -# diskutil unmountDisk /dev/diskX ----- - -NOTE: replace X with the disk number from the last command. - ----- -# sudo dd if=proxmox-ve_*.dmg bs=1M of=/dev/rdiskX ----- - -NOTE: 'rdiskX', instead of 'diskX', in the last command is intended. It will -increase the write speed. - -Instructions for Windows -~~~~~~~~~~~~~~~~~~~~~~~~ - -Using Etcher -^^^^^^^^^^^^ - -Etcher works out of the box. Download Etcher from https://etcher.io. It will -guide you through the process of selecting the ISO and your USB flash drive. - -Using Rufus -^^^^^^^^^^^ - -Rufus is a more lightweight alternative, but you need to use the *DD mode* to -make it work. Download Rufus from https://rufus.ie/. Either install it or use -the portable version. Select the destination drive and the {pve} ISO file. - -IMPORTANT: Once you 'Start' you have to click 'No' on the dialog asking to -download a different version of GRUB. In the next dialog select the 'DD' mode. - -ifdef::wiki[] -Boot your Server from the USB Flash Drive -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Connect the USB flash drive to your server and make sure that booting from USB -is enabled (check your servers firmware settings). Then follow the steps in the -xref:chapter_installation[installation wizard]. - -endif::wiki[] diff --git a/pve-installation.adoc b/pve-installation.adoc index 274d9ad..f492ad0 100644 --- a/pve-installation.adoc +++ b/pve-installation.adoc @@ -29,7 +29,7 @@ ifndef::wiki[] include::pve-system-requirements.adoc[] -include::pve-installation-media.adoc[] +include::proxmox-docs-common/installation-media.adoc[] endif::wiki[] -- 2.44.0 _______________________________________________ pve-devel mailing list pve-devel@lists.proxmox.com https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel