]>
Commit | Line | Data |
---|---|---|
4be88c15 AL |
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 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 Unix-like operating system use the `dd` command to copy the ISO image to the | |
31 | USB flash drive. First find the correct device name of the USB flash drive (see | |
32 | 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 Correct USB Device Name | |
45 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
46 | There are two ways to find out the name of the USB flash drive. The first one is | |
47 | to compare the last lines of the `dmesg` command output before and after | |
48 | plugging in the flash drive. The second 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. To be on the extra | |
62 | safe side check if 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 example. | |
71 | ||
72 | ---- | |
73 | # hdiutil convert -format UDRW -o proxmox-mailgateway_*.dmg proxmox-ve_*.iso | |
74 | ---- | |
75 | ||
76 | TIP: macOS tends to automatically add '.dmg' to the output file name. | |
77 | ||
78 | To get the current list of devices run the command: | |
79 | ||
80 | ---- | |
81 | # diskutil list | |
82 | ---- | |
83 | ||
84 | Now insert the USB flash drive and run this command again to determine which | |
85 | device node has been assigned to it. (e.g., /dev/diskX). | |
86 | ||
87 | ---- | |
88 | # diskutil list | |
89 | # diskutil unmountDisk /dev/diskX | |
90 | ---- | |
91 | ||
92 | NOTE: replace X with the disk number from the last command. | |
93 | ||
94 | ---- | |
95 | # sudo dd if=proxmox-mailgateway_*.dmg of=/dev/rdiskX bs=1m | |
96 | ---- | |
97 | ||
98 | NOTE: 'rdiskX', instead of 'diskX', in the last command is intended. It will | |
99 | increase the write speed. | |
100 | ||
101 | Instructions for Windows | |
102 | ~~~~~~~~~~~~~~~~~~~~~~~~ | |
103 | ||
104 | Using Etcher | |
105 | ^^^^^^^^^^^^ | |
106 | ||
107 | Etcher works out of the box. Download Etcher from https://etcher.io. It will | |
108 | guide you through the process of selecting the ISO and your USB Drive. | |
109 | ||
110 | Using Rufus | |
111 | ^^^^^^^^^^^ | |
112 | ||
113 | Rufus is a more lightweight alternative, but you need to use the *DD mode* to | |
114 | make it work. Download Rufus from https://rufus.ie/. Either install it or use | |
115 | the portable version. Select the destination drive and the {pmg} ISO file. | |
116 | ||
117 | IMPORTANT: Once you 'Start' you have to click 'No' on the dialog asking to | |
118 | download a different version of GRUB. In the next dialog select the 'DD' mode. | |
119 |