| 1 | $Id: README.pxe 3036 2012-09-29 18:57:16Z bruno $
|
|---|
| 2 |
|
|---|
| 3 | README for mondo/mindi usage with PXE
|
|---|
| 4 |
|
|---|
| 5 | mondorescue now supports the possibility to deploy mondo-images using the Pre eXecution Environment (PXE) standard.
|
|---|
| 6 | 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
|
|---|
| 7 |
|
|---|
| 8 | To use it, please do the following on your deployment server:
|
|---|
| 9 |
|
|---|
| 10 | Add the following line to your default file:
|
|---|
| 11 | label mondo
|
|---|
| 12 | kernel vmlinuz-mondo
|
|---|
| 13 | 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] [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=#] ...
|
|---|
| 14 |
|
|---|
| 15 | ipdev is the device name (e.g. eth2)
|
|---|
| 16 | ipadr is the IP Address (e.g. 192.168.1.1)
|
|---|
| 17 | netmask is the Netmask (e.g. 255.255.255.0)
|
|---|
| 18 | broadcast is the Network broadcast (e.g. 192.168.1.255)
|
|---|
| 19 | gateway is the default gateway (e.g. 192.168.1.254)
|
|---|
| 20 | dhcp is a keyword. Using it will provide all the previous 4 values to activate the LAN interface.
|
|---|
| 21 | hwaddr is the MAC address of the device you want to use to restore through
|
|---|
| 22 | proto is the protocol to use for mounting the remote share (default is NFS, sshfs is also available)
|
|---|
| 23 | server is the ip addr of the Remote Network server
|
|---|
| 24 | mountpoint is the mount point on the Remote Network server to use (if NFS, should be in /etc/exports of the NFS server)
|
|---|
| 25 | 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.
|
|---|
| 26 | netfsopt may contains options passed to the mount command
|
|---|
| 27 | netfspath is the local path on the remote server where the image is located, if different from the one at backup time.
|
|---|
| 28 | local_path is the local directory under which the mage was made (with the -d option)
|
|---|
| 29 | rmadisk_size may have to be increase to 262144 or more on more recent distributions such as RHEL 6
|
|---|
| 30 | The [] mean this parameter is optional
|
|---|
| 31 | The () mean that you have a choice with the '|' meaning 'or'
|
|---|
| 32 |
|
|---|
| 33 | The initrd and kernel file come from the first bootable media
|
|---|
| 34 | created by mondoarchive. To get them, please issue:
|
|---|
| 35 |
|
|---|
| 36 | # mount /path/to/mondorescue-1.iso /mnt/cdrom -o loop
|
|---|
| 37 | # cp -a /mnt/cdrom/vmlinuz /var/tftpboot/vmlinuz-mondo
|
|---|
| 38 | # cp -a /mnt/cdrom/initrd.img /var/tftpboot/initrd-mondo
|
|---|
| 39 | # umount /mnt/cdrom
|
|---|
| 40 |
|
|---|
| 41 | Thus the PXE ROM will boot mondo's kernel and mondo's initrd in memory and will append all the right configuration options (as you find in isolinux.cfg on the first bootable media) to which you need to add the keyword pxe.
|
|---|
| 42 | (You need to have backup your data using the NFS option of mondoarchive)
|
|---|
| 43 |
|
|---|
| 44 | If you used the -p option of mondoarchive, you may specify the real name of mondo images to use during restore. To do that use prefix=machine on the initrd line, after the pxe keyword, to load the ISO images saved with -p machine.
|
|---|
| 45 | Without prefix keyword, the name of the images used during archiving with the -p option will be used (they may differ). If -p wasn't used then the name mondorescue-1.iso, ... will be used.
|
|---|
| 46 |
|
|---|
| 47 | During boot mondorestore will start your NFS configuration and mount mondo's content from the network rather than from a physical media. You may alter the IP configuration stored from the original machine by passing the ipconf option describing respectively the IP address, netmask, broadcast and default gateway you want to setup for the machine, separated by ':'. Or alternatively, you may specify the dhcp keyword so that a DHCP request is made to get those information. In the 2 cases, you have to mention on which physical interface those parameters should apply. On some configurations, you may also want to increase the number of ping queries made before the NFS mount, which is of 3 by default, using the ping option and give the number you want. If you have a different NFS server for the deployment than for the archiving, you can also precise it through the netfsmount option. The structure on both server under the mountpoint has to be the same.
|
|---|
| 48 |
|
|---|
| 49 | CAVEAT: the limit to the number of char on the append line is 255. Use symlinks to reduce the size of your path if needed.
|
|---|
| 50 |
|
|---|
| 51 | NOTE: If you don't have selinux=0 on the boot line, you may have issues restoring extended attributes on your filesystem and thus be unable to log on at next reboot after restore.
|
|---|
| 52 |
|
|---|
| 53 | Please report any problem around that tool to bruno_at_mondorescue.org
|
|---|
| 54 |
|
|---|
| 55 | 2011-10-09 adds support for hwaddr
|
|---|
| 56 | 2009-12-05 nfsopt added tp allow for custom options at mount time
|
|---|
| 57 | 2009-09-09 Changed to netfs for multi protocol support (nfs, sshfs, ...)
|
|---|
| 58 | 2009-05-07 nfspath added to allow redeployment from another NFS directory
|
|---|
| 59 | 2006-06-10 nfsmount added to allow redeployment from another NFS server
|
|---|
| 60 | 2006-06-02 ipdev added to allow redeployment on another interface
|
|---|
| 61 | 2005-12-18 new ipconf and ping option
|
|---|
| 62 | 2005-12-14 detailed explanations on where to find initrd and kernel
|
|---|
