pmg-installation-media.adoc

   1 [[installation_prepare_media]]
   2 Prepare Installation Media
   3 --------------------------
   4
   5 Download the installer ISO image from: {website}en/downloads/category/proxmox-mail-gateway
   6
   7 The {pmg} installation media is a hybrid ISO image. It works in two ways:
   8
   9 * An ISO image file ready to burn to a CD or DVD.
  10
  11 * A raw sector (IMG) image file ready to copy to a USB flash drive (USB stick).
  12
  13 Using a USB flash drive to install {pmg} is the recommended way, because it is
  14 the faster option.
  15
  16 Prepare a USB Flash Drive as an Installation Medium
  17 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18
  19 The flash drive needs to have at least 1 GB of storage available.
  20
  21 NOTE: Do not use UNetbootin. It does not work with the {pmg} installation image.
  22
  23 IMPORTANT: Make sure that the USB flash drive is not mounted and does not
  24 contain any important data.
  25
  26
  27 Instructions for GNU/Linux
  28 ~~~~~~~~~~~~~~~~~~~~~~~~~~
  29
  30 On a Unix-like operating system, you can use the `dd` command to copy the ISO
  31 image to the USB flash drive. To do this, find the device name of the USB
  32 flash drive (see below), then run the `dd` command.
  33
  34 ----
  35 # dd bs=1M conv=fdatasync if=./proxmox-mailgateway_*.iso of=/dev/XYZ
  36 ----
  37
  38 NOTE: Be sure to replace /dev/XYZ with the correct device name and adapt the
  39 input filename ('if') path.
  40
  41 CAUTION: Be very careful, and do not overwrite the wrong disk!
  42
  43
  44 Find the USB Device Name
  45 ^^^^^^^^^^^^^^^^^^^^^^^^
  46 There are multiple ways to find out the name of the USB flash drive. One is
  47 to compare the last lines of the `dmesg` command output before and after
  48 plugging in the flash drive. Another way is to compare the output of the
  49 `lsblk` command. Open a terminal and run:
  50
  51 ----
  52 # lsblk
  53 ----
  54
  55 Then plug in your USB flash drive and run the command again:
  56
  57 ----
  58 # lsblk
  59 ----
  60
  61 A new device will appear. This is the one you want to use. As an additional
  62 precaution, check that the reported size matches your USB flash drive.
  63
  64
  65 Instructions for macOS
  66 ~~~~~~~~~~~~~~~~~~~~~~
  67
  68 Open the terminal (query Terminal in Spotlight).
  69
  70 Convert the .iso file to .img using the convert option of `hdiutil`, for
  71 example:
  72
  73 ----
  74 # hdiutil convert -format UDRW -o proxmox-mailgateway_*.dmg proxmox-ve_*.iso
  75 ----
  76
  77 TIP: macOS tends to automatically add '.dmg' to the output filename.
  78
  79 To get the current list of devices, run the command:
  80
  81 ----
  82 # diskutil list
  83 ----
  84
  85 Now insert the USB flash drive and run this command again to determine which
  86 device node has been assigned to it. (e.g., /dev/diskX).
  87
  88 ----
  89 # diskutil list
  90 # diskutil unmountDisk /dev/diskX
  91 ----
  92
  93 NOTE: replace X with the disk number from the last command.
  94
  95 ----
  96 # sudo dd if=proxmox-mailgateway_*.dmg of=/dev/rdiskX bs=1m
  97 ----
  98
  99 NOTE: 'rdiskX', instead of 'diskX', in the last command is intended. This will
 100 increase the write speed.
 101
 102 Instructions for Windows
 103 ~~~~~~~~~~~~~~~~~~~~~~~~
 104
 105 Using Etcher
 106 ^^^^^^^^^^^^
 107
 108 Etcher works out of the box. Download Etcher from https://etcher.io. It will
 109 guide you through the process of selecting the ISO and your USB drive.
 110
 111 Using Rufus
 112 ^^^^^^^^^^^
 113
 114 Rufus is a more lightweight alternative, but you need to use the *DD mode* to
 115 make it work. Download Rufus from https://rufus.ie/. Either install it or use
 116 the portable version. Select the destination drive and the {pmg} ISO file.
 117
 118 IMPORTANT: After you 'Start', you have to click 'No' on the dialog asking to
 119 download a different version of GRUB. In the next dialog select the 'DD' mode.
 120