pmg-usbstick.adoc: new file

diff --git a/pmg-admin-guide.adoc b/pmg-admin-guide.adoc
index 09efc0e617e0fa10db5a6fbf49b45d5cc50c1a9b..f320ce8b0e2eb470908309693a8ab68d2e58615c 100644 (file)
--- a/pmg-admin-guide.adoc
+++ b/pmg-admin-guide.adoc
@@ -41,9 +41,6 @@ TODO
 // FIXME
 
 
-[[create_bootable_usb]]
-create_bootable_usb
-
 [[mail_server_config]]
 mail_server_config
 

diff --git a/pmg-installation.adoc b/pmg-installation.adoc
index 101c61012094dee2a1801842eb890c6482bc5bac..b53b98989e67fd61decea89e7ad6679585274dfc 100644 (file)
--- a/pmg-installation.adoc
+++ b/pmg-installation.adoc
@@ -209,6 +209,9 @@ installation using the following command:
  zpool add <pool-name> log </dev/path_to_fast_ssd>
 
 
+include::pmg-usbstick.adoc[]
+
+
 Install {pmg} on Debian
 -----------------------
 

diff --git a/pmg-usbstick.adoc b/pmg-usbstick.adoc
new file mode 100644 (file)
index 0000000..ed34fb6
--- /dev/null
+++ b/pmg-usbstick.adoc
@@ -0,0 +1,118 @@
+[[create_bootable_usb]]
+Install from USB Stick
+----------------------
+
+The {pmg} installation media is now a hybrid ISO image, working in two
+ways:
+
+* An ISO image file ready to burn on CD
+
+* A raw sector (IMG) image file ready to directly copy to flash media
+  (USB Stick)
+
+Using USB sticks is faster and more environmental friendly and
+therefore the recommended way to install {pmg}.
+
+
+Prepare a USB flash drive as install medium
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In order to boot the installation media, copy the ISO image to a USB
+media.
+
+First download the ISO image from
+https://www.proxmox.com/en/downloads/category/proxmox-mail-gateway
+
+You need at least a 1 GB USB media.
+
+NOTE: Using UNetbootin or Rufus does not work.
+
+IMPORTANT: Make sure that the USB media is not mounted and does not
+contain any important data.
+
+
+Instructions for GNU/Linux
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You can simply use `dd` on UNIX like systems. First download the ISO
+image, then plug in the USB stick. You need to find out what device
+name gets assigned to the USB stick (see below). Then run:
+
+----
+dd if=proxmox-mailgateway_*.iso of=/dev/XYZ bs=1M
+----
+
+NOTE: Be sure to replace /dev/XYZ with the correct device name.
+
+CAUTION: Be very careful, and do not overwrite the hard disk!
+
+
+Find Correct USB Device Name
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+You can compare the last lines of 'dmesg' command before and after the
+insertion, or use the 'lsblk' command. Open a terminal and run:
+
+----
+lsblk
+----
+
+Then plug in your USB media and run the command again:
+
+----
+lsblk
+----
+
+A new device will appear, and this is the USB device you want to use.
+
+
+Instructions for OSX
+~~~~~~~~~~~~~~~~~~~~
+
+Open the terminal (query Terminal in Spotlight).
+
+Convert the .iso file to .img using the convert option of hdiutil for example.
+
+----
+hdiutil convert -format UDRW -o proxmox-mailgateway_*.dmg proxmox-mailgateway_*.iso
+----
+
+TIP: OS X tends to put the .dmg ending on the output file automatically.
+
+To get the current list of devices run the command again:
+
+----
+diskutil list
+----
+
+Now insert your USB flash media and run this command again to
+determine the device node assigned to your flash media
+(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-mailgateway_*.dmg of=/dev/rdiskN bs=1m
+----
+
+
+Instructions for Windows
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+Download Etcher from https://etcher.io , select the ISO and your USB Drive.
+
+If this doesn't work, alternatively use the OSForensics USB
+installer from http://www.osforensics.com/portability.html
+
+
+Boot your server from USB media
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Connect your USB media to your server and make sure that the server
+boots from USB (see server BIOS). Then follow the installation wizard.
\ No newline at end of file