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