source: trunk/mindi/README.pxe

Last change on this file was 808, checked in by bruno, 13 years ago

merge -r793:807 $SVN_M/branches/stable
src => common for the moment it's easier to manage merges

  • Property svn:keywords set to Id
File size: 3.4 KB
Line 
1$Id: README.pxe 808 2006-09-22 21:12:37Z bruno $
2
3README for mondo/mindi usage with PXE
4
5mondorescue now supports the possibility to deploy mondo-images using the Pre eXecution Environment (PXE) standard.
6As 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
8To use it, please do the following on your deployment server:
9
10Add the following line to your default file:
11label mondo
12        kernel vmlinuz-mondo
13        append initrd=initrd-mondo load_ramdisk=1 prompt_ramdisk=0 ramdisk_size=36864 rw root=/dev/ram iso_mode acpi=off apm=off devfs=nomount exec-shield=0 pxe [prefix=machine] [ipconf=(ipdev:ipadr:netmask:broadcast:gateway|ipdev:dhcp)] [nfsmount=server:mountpoint] [ping=#] ...
14
15ipdev is the device name (e.g. eth2)
16ipadr is the IP Address (e.g. 192.168.1.1)
17netmask is the Netmask (e.g. 255.255.255.0)
18broadcast is the Network broadcast (e.g. 192.168.1.255)
19gateway is the default gateway (e.g. 192.168.1.254)
20dhcp is a keyword. Using it will provide all the previous 4 values to activate the LAN interface.
21server is the ip addr of the NFS server
22mountpoint is the mount point on the NFS server to use (should be in /etc/exports of the NFS server)
23
24The initrd and kernel file come from the first bootable media
25created by mondoarchive. To get them, please issue:
26
27# mount /path/to/mondorescue-1.iso /mnt/cdrom -o loop
28# cp -a /mnt/cdrom/vmlinuz /var/tftpboot/vmlinuz-mondo
29# cp -a /mnt/cdrom/initrd.img /var/tftpboot/initrd-mondo
30# umount /mnt/cdrom
31
32Thus 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.
33(You need to have backup your data using the NFS option of mondoarchive)
34
35If 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.
36Without 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.
37
38During 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 nfsmount option. The structure on both server under the mountpoint has to be the same.
39
40Please report any problem around that tool to bruno@mondorescue.org
41
422006-06-10 nfsmount added to allow redeployment from another NFS server
432006-06-02 ipdev added to allow redeployment on another interface
442005-12-18 new ipconf and ping option
452005-12-14 detailed explanations on where to find initrd and kernel
Note: See TracBrowser for help on using the repository browser.