Changeset 3173 in MondoRescue for branches/3.0/mindi/README.pxe

Timestamp:

Jul 29, 2013, 9:08:58 AM (11 years ago)

Author:

Bruno Cornec

Message:

• Use 2 README files as embedded doc for restore boot, with function keys
• Improve #628 by adding a comment in order to connect external disks after the boot.
• Improve also boot menu visibility.

File:

• branches/3.0/mindi/README.pxe (modified) (2 diffs)

branches/3.0/mindi/README.pxe

@@ -1 @@
-$Id$
+MondoRescue supports image deployment using Pre eXecution Environment (PXE)
+Linux deployments with PXE is documented at http://syslinux.zytor.com/pxe.php
+Multiple parameters are available at restore time for PXE support:
 
-README for mondo/mindi usage with PXE
+broadcast   Network broadcast to setup on the device (e.g. 192.168.1.255)
+dhcp        The LAN interface is automatically setup from DHCP
+            (replaces ipaddr, netmask, broadcast, gateway)
+gateway     The default gateway to setup (e.g. 192.168.1.254)
+hwaddr      MAC address of the device to use to restore through (optional)
+ipaddr      IP Address to setup on the device (e.g. 192.168.1.1)
+ipdev       Device name (e.g. eth2)
+iproute     Additional static route (uses "route add" syntax with : separator)
+            (e.g. iproute="-net:192.168.8.0:netmask:255.255.255.0:dev:eth3)
+mountpoint  Mount point on the Remote Network server to use 
+            (if NFS, should be in /etc/exports of the NFS server)
+netfsmount  Server and mountpoint on which the ISO is available (optional)
+            (if SSHFS the server part can be of the form user@server)
+netfsopt    Contains options passed to the mount command (optional)
+netfspath   Local path on the remote server where image is located (optional)
+netmask     Netmask to setup on the device (e.g. 255.255.255.0)
+proto       Protocol to use for mounting the remote share 
+            (default is NFS, sshfs and smbfs are also available)
+ramdisk_size Size of the RAM disk where the initrd is exploded
+server      IP address of the Remote Network server
 
-mondorescue now supports the possibility to deploy mondo-images using the Pre eXecution Environment (PXE) standard.
-As this README only focusses on the mondorescue part, please read how to do Linux deployments with pxelinux on http://syslinux.zytor.com/pxe.php
-
-To use it, please do the following on your deployment server:
-
-Add the following line to your default file:
+To use it, on your deployment server, add the following line to your conf file:
 label mondo
         kernel vmlinuz-mondo
         append initrd=initrd-mondo load_ramdisk=1 prompt_ramdisk=0 ramdisk_size=131072 selinux=0 rw root=/dev/ram iso acpi=off apm=off devfs=nomount exec-shield=0 pxe [proto=nfs|sshfs|smbfs] [prefix=machine] [ipconf=(ipdev:ipadr:netmask:broadcast:gateway|ipdev:dhcp)] [hwaddr=M:A:C:A:D:R] [netfsmount=server:mountpoint] [netfsopt=-o option][netfspath=local_path] [ping=#] [iproute=-net:netdest:[netmask:Nm]gw:GW] ...
 
-ipdev is the device name (e.g. eth2)
-ipadr is the IP Address (e.g. 192.168.1.1)
-netmask is the Netmask (e.g. 255.255.255.0)
-broadcast is the Network broadcast (e.g. 192.168.1.255)
-gateway is the default gateway (e.g. 192.168.1.254)
-iproute is an additional static route using the route add syntax using : nstead of space to separate values
-dhcp is a keyword. Using it will provide all the previous 4 values to activate the LAN interface.
-hwaddr is the MAC address of the device you want to use to restore through
-proto is the protocol to use for mounting the remote share (default is NFS, sshfs and smbfs are also available)
-server is the ip addr of the Remote Network server
-mountpoint is the mount point on the Remote Network server to use (if NFS, should be in /etc/exports of the NFS server)
-netfsmount is the server and mountpoint on which the ISO is available, if different from the one at backup time. For SSHFS the server part can be of the form user@server.
-netfsopt may contains options passed to the mount command
-netfspath is the local path on the remote server where the image is located, if different from the one at backup time.
-local_path is the local directory under which the mage was made (with the -d option)
-ramdisk_size may have to be increase to 262144 or more on more recent distributions such as RHEL 6
 The [] mean this parameter is optional
 The () mean that you have a choice with the '|' meaning 'or'
@@ -54 +54 @@
 Please report any problem around that tool to bruno_at_mondorescue.org
 
+$Id$
+
 2013-07-25 adds support for iproute
 2011-10-09 adds support for hwaddr