add pve-usbstick.adoc, fix mediawiki importer
authorDietmar Maurer <dietmar@proxmox.com>
Wed, 5 Oct 2016 07:57:47 +0000 (09:57 +0200)
committerDietmar Maurer <dietmar@proxmox.com>
Wed, 5 Oct 2016 07:57:47 +0000 (09:57 +0200)
Makefile
debian/tree/pve-docs-mediawiki/pve-docs-mediawiki-import
pve-installation.adoc
pve-usbstick.adoc [new file with mode: 0644]

index ccd6473..2d122d5 100644 (file)
--- a/Makefile
+++ b/Makefile
@@ -101,6 +101,7 @@ GEN_SCRIPTS=                                        \
        gen-pve-firewall-vm-opts.pl
 
 INSTALLATION_SOURCES=                          \
+       pve-usbstick.adoc                       \
        pve-installation.adoc
 
 SYSADMIN_PARTS=                                        \
@@ -156,6 +157,7 @@ PVE_ADMIN_GUIDE_SOURCES=                    \
        attributes.txt
 
 WIKI_IMPORTS=                                                                  \
+       section-pve-usbstick-plain.html                                         \
        $(addsuffix -plain.html, $(addprefix sysadmin-, ${SYSADMIN_PARTS}))     \
        $(addsuffix -plain.html, $(addprefix chapter-, ${CHAPTER_LIST}))        \
        $(addsuffix .5-plain.html, ${CONFIG_LIST})                              \
@@ -185,6 +187,9 @@ all: index.html
 sysadmin-%-plain.html: %.adoc
        asciidoc -s -a wiki -a 'leveloffset=-1' ${ADOC_STDARG} -o $@ $*.adoc
 
+section-%-plain.html: %.adoc
+       asciidoc -s -a wiki -a 'leveloffset=-1' ${ADOC_STDARG} -o $@ $*.adoc
+
 chapter-sysadmin.html chapter-sysadmin-plain.html: ${SYSADMIN_SOURCES}
 
 chapter-%.html: %.adoc ${PVE_COMMON_DOC_SOURCES}
index 9055710..e65aab0 100755 (executable)
@@ -68,6 +68,14 @@ my $docs = {
        title => "High Availability",
        category => $cat_refdoc,
     },
+    'chapter-pve-installation-plain.html' => {
+       title => "Installation",
+       category => $cat_refdoc,
+    },
+    'section-pve-usbstick-plain.html' => {
+       title => "Install from USB Stick",
+       category => $cat_refdoc,
+    },
     'sysadmin-getting-help-plain.html' => {
        title => "Getting Help",
        category => $cat_refdoc,
@@ -84,10 +92,6 @@ my $docs = {
        title => "Logical Volume Manager (LVM)",
        category => $cat_refdoc,
     },
-    'sysadmin-pve-installation-plain.html' => {
-       title => "Installation",
-       category => $cat_refdoc,
-    },
     'sysadmin-pve-package-repos-plain.html' => {
        title => "Package Repositories",
        category => $cat_refdoc,
index 75dd987..8321992 100644 (file)
@@ -151,6 +151,9 @@ ifdef::wiki[]
 link:/wiki/Install_Proxmox_VE_on_Debian_Jessie[Install Proxmox VE on Debian Jessie]
 -----------------------------------------------------------------------------------
 
+link:/wiki/Install_from_USB_Stick[Install from USB Stick]
+---------------------------------------------------------
+
 endif::wiki[]
 
 ifndef::wiki[]
@@ -171,8 +174,9 @@ apt-get install proxmox-ve
 You can find a detailed step by step howto on the
 {webwiki-url}Install_Proxmox_VE_on_Debian_Jessie[wiki].
 
-endif::wiki[]
+include::pve-usbstick.adoc[]
 
+endif::wiki[]
 
 ifdef::wiki[]
 
diff --git a/pve-usbstick.adoc b/pve-usbstick.adoc
new file mode 100644 (file)
index 0000000..cd263db
--- /dev/null
@@ -0,0 +1,121 @@
+Install from USB Stick
+----------------------
+include::attributes.txt[]
+
+The {pve} 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 {pve}.
+
+
+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/iso-images-pve
+
+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 UNUX 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-ve_*.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-ve_*.dmg proxmox-ve_*.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-ve_*.dmg of=/dev/rdiskN bs=1m
+----
+
+
+Instructions for Windows
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+In order to copy the ISO, rename it first. Just rename the downloaded
+file from proxmox-ve_*.iso to proxmox-ve_*.raw.
+
+Download the SUSE Studio ImageWriter from https://en.opensuse.org/SDB:Live_USB_stick
+
+If this doesn't work, alternative use the OSForsenics 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