pmg-usbstick.adoc

   1 [[create_bootable_usb]]
   2 Install from USB Stick
   3 ----------------------
   4
   5 The {pmg} installation media is now a hybrid ISO image, working in two
   6 ways:
   7
   8 * An ISO image file ready to burn on CD
   9
  10 * A raw sector (IMG) image file ready to directly copy to flash media
  11   (USB Stick)
  12
  13 Using USB sticks is faster and more environmental friendly and
  14 therefore the recommended way to install {pmg}.
  15
  16
  17 Prepare a USB flash drive as install medium
  18 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  19
  20 In order to boot the installation media, copy the ISO image to a USB
  21 media.
  22
  23 First download the ISO image from
  24 https://www.proxmox.com/en/downloads/category/proxmox-mail-gateway
  25
  26 You need at least a 1 GB USB media.
  27
  28 NOTE: Using UNetbootin or Rufus does not work.
  29
  30 IMPORTANT: Make sure that the USB media is not mounted and does not
  31 contain any important data.
  32
  33
  34 Instructions for GNU/Linux
  35 ~~~~~~~~~~~~~~~~~~~~~~~~~~
  36
  37 You can simply use `dd` on UNIX like systems. First download the ISO
  38 image, then plug in the USB stick. You need to find out what device
  39 name gets assigned to the USB stick (see below). Then run:
  40
  41 ----
  42 dd if=proxmox-mailgateway_*.iso of=/dev/XYZ bs=1M
  43 ----
  44
  45 NOTE: Be sure to replace /dev/XYZ with the correct device name.
  46
  47 CAUTION: Be very careful, and do not overwrite the hard disk!
  48
  49
  50 Find Correct USB Device Name
  51 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  52
  53 You can compare the last lines of 'dmesg' command before and after the
  54 insertion, or use the 'lsblk' command. Open a terminal and run:
  55
  56 ----
  57 lsblk
  58 ----
  59
  60 Then plug in your USB media and run the command again:
  61
  62 ----
  63 lsblk
  64 ----
  65
  66 A new device will appear, and this is the USB device you want to use.
  67
  68
  69 Instructions for OSX
  70 ~~~~~~~~~~~~~~~~~~~~
  71
  72 Open the terminal (query Terminal in Spotlight).
  73
  74 Convert the .iso file to .img using the convert option of hdiutil for example.
  75
  76 ----
  77 hdiutil convert -format UDRW -o proxmox-mailgateway_*.dmg proxmox-mailgateway_*.iso
  78 ----
  79
  80 TIP: OS X tends to put the .dmg ending on the output file automatically.
  81
  82 To get the current list of devices run the command again:
  83
  84 ----
  85 diskutil list
  86 ----
  87
  88 Now insert your USB flash media and run this command again to
  89 determine the device node assigned to your flash media
  90 (e.g. /dev/diskX).
  91
  92 ----
  93 diskutil list
  94
  95 diskutil unmountDisk /dev/diskX
  96 ----
  97
  98 NOTE: replace X with the disk number from the last command.
  99
 100 ----
 101 sudo dd if=proxmox-mailgateway_*.dmg of=/dev/rdiskN bs=1m
 102 ----
 103
 104
 105 Instructions for Windows
 106 ~~~~~~~~~~~~~~~~~~~~~~~~
 107
 108 Download Etcher from https://etcher.io , select the ISO and your USB Drive.
 109
 110 If this doesn't work, alternatively use the OSForensics USB
 111 installer from http://www.osforensics.com/portability.html
 112
 113
 114 Boot your server from USB media
 115 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 116
 117 Connect your USB media to your server and make sure that the server
 118 boots from USB (see server BIOS). Then follow the installation wizard.