Changeset 3173


Ignore:
Timestamp:
Jul 29, 2013, 9:08:58 AM (6 years ago)
Author:
bruno
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.
Location:
branches/3.0/mindi
Files:
5 edited

Legend:

Unmodified
Added
Removed
  • branches/3.0/mindi/README.bootparam

    r3168 r3173  
    1 At restore time, multiple parameters are available to modify how the restore will act:
     1Multiple parameters are available at restore time to modify its behaviour:
    22
    3 nuke
    4     To format and restore all files automatically
     3nuke        To format and restore all files automatically
     4interactive To restore some/all files interactively
     5compare     To compare the archives with your filesystem
     6expert      To boot to a command-line prompt (expert mode)
     7RESTORE     To format and restore all files automatically
    58
    6 interactive
    7     To restore some/all files interactively
    8 
    9 compare
    10     To compare the archives with your filesystem
    11 
    12 expert
    13     To boot to a command-line prompt (expert mode)
    14 
    15 RESTORE
    16     To format and restore all files automatically
    17 
    18 --------------
    19 
    20 debug
    21     Call mondorestore with -K99
    22 
    23 denymods="mod1 mod2"
    24     Add those modules to the list of modules to NOT load
    25 
    26 donteject
    27     mondorestore will not eject the CD; this is useful if, for instance, your PC's case has a concealed CD-ROM drive
    28 
    29 excludedevs="dev1 dev2"
    30     Exclude those devices from retoration process (no LVM action done such as pvcreate, and no partitioning. Those devices are removed from /tmp/mountlist.txt and /tmp/i-want-my-lvm)
    31 
    32 forcemods="mod1 mod2"
    33     Add those modules to the list of modules to load systematically
    34 
    35 net
    36     Activate network support
    37 
    38 nodmraid
    39     Do not try to start dmraid support
    40 
    41 nohw
    42     Do not call the mindi-rsthw script which try to restore also your BIOSes configuration (ProLiant only for now)
    43 
    44 nolvm
    45     Do not try to start LVM support
    46 
    47 nomd
    48     Do not try to start mdadm support
    49 
    50 nompath
    51     Do not try to start multipath support
    52 
    53 nopart
    54     Do not try to partition drives at restore time
    55 
    56 noresize
    57     Do not resize partitions using a multiplication factor of (New disk size)/(Old disk size) to use your unallocated hard disk space
    58 
    59 obdr
    60     Call mondorestore with -o and the tape device
    61 
    62 obdrmods="mod1 mod2"
    63     Remove these modules in order to be able to reset the tape dvice using it and place it in sequential mode. A default list of modules is aloready embedded so this should only be used if the list is unsufficient. Please report that usage to dev team.
    64 
    65 pre=/path/to/script
    66     Execute a pre-configuration script before calling mondorestore. Could be an NFS shared script e.g., or a script located in the initrd. Eg: pre=/tmp/isodir/my-pre.sh. Note that the script should be executable.
    67 
    68 post=/path/to/script
    69     Execute a final script before rebooting the machine at the end of the restoration. Could be an NFS shared script e.g., or a script located on the restored disk or in the initrd. Eg: post=/tmp/isodir/my-post.sh. Note that the script should be executable.
    70 
    71 quiet
    72     Do not print information msgs in order to allow for easier tracking of error messages at boot time
    73 
    74 serial=/dev/ttySx
    75     When using a serial console, associate it to the tty device so it works correctly at restore time. By default set up /dev/ttyS0 as serial console. Pass the value of your serial console if different. You may also want to pass console=ttySx so your kernel can deal with it. serial takes precedence over console for mindi.
    76 
    77 textonly
    78     do not call any Newt library routines; this is unattractive but valuable if you find your Newt library has bugs in it or on ia64
    79 
    80 usb=/dev/xxx
    81     Use that USB device name as the place to look for backup content. The way drivers are loaded may lead that to the fact you have a different device name at restore time, compared to the one you used at backup time, making mondorestore unable to use the right device natively. This helper corrects that. Pass to it the device name, not the partition name. Example: usb=/dev/sdb
    82 
    83 -----------------
     9debug       Call mondorestore with -K99
     10denymods    List of modules to NOT load (using denymods="mod1 mod2")
     11donteject   mondorestore will not eject the CD
     12            Useful if your PC's case has a concealed CD-ROM drive
     13excludedevs Exclude those devices from restoration process
     14            No LVM action done such as pvcreate, and no partitioning
     15            They are removed from /tmp/mountlist.txt and /tmp/i-want-my-lvm
     16            (using  excludedevs="dev1 dev2")
     17forcemods   List of modules to load first (using forcemods="mod1 mod2")
     18net         Activate network support
     19nodmraid    Do not try to start dmraid support
     20nohw        Do not call the mindi-rsthw script to restore your HW configuration
     21nolvm       Do not try to start LVM support
     22nomd        Do not try to start mdadm support
     23nompath     Do not try to start multipath support
     24nopart      Do not try to partition drives at restore time
     25noresize    Do not resize partitions using a factor of (New size)/(Old size)
     26            to use your unallocated hard disk space
     27obdr        Call mondorestore with -o and the tape device
     28obdrmods    List of modules to remove to reset the OBDR tape device using them
     29            to place it in sequential mode. A default list is already embedded.
     30            (using obdrmods="mod1 mod2")
     31pre         Execute a pre-configuration script before calling mondorestore.
     32            Could be located on an NFS share or in the initrd.
     33            Should be executable. (using pre=/tmp/isodir/my-pre.sh)
     34post        Execute a script before rebooting the machine after the restoration
     35            Could be located on an NFS share, the restored disk or the initrd
     36            Should be executable.  (using post=/tmp/isodir/my-post.sh)
     37quiet       Do not print information msgs for easier tracking of error messages
     38serial      Device for the serial console. By default /dev/ttyS0.
     39            Pass also console=ttySx for your kernel. (using serial=/dev/ttySx)
     40            Serial takes precedence over console for mindi.
     41textonly    Do not call the GUI. Unattractive but workk around if Newt has bugs
     42usb         USB device name of backup content (not partition).
     43            Help solve device renaming at restore time. (using usb=/dev/sdxx)
    8444
    8545Look also at README.pxe for additional parameters linked to the PXE/Network usage
  • branches/3.0/mindi/README.pxe

    r3168 r3173  
    1 $Id$
     1MondoRescue supports image deployment using Pre eXecution Environment (PXE)
     2Linux deployments with PXE is documented at http://syslinux.zytor.com/pxe.php
     3Multiple parameters are available at restore time for PXE support:
    24
    3 README for mondo/mindi usage with PXE
     5broadcast   Network broadcast to setup on the device (e.g. 192.168.1.255)
     6dhcp        The LAN interface is automatically setup from DHCP
     7            (replaces ipaddr, netmask, broadcast, gateway)
     8gateway     The default gateway to setup (e.g. 192.168.1.254)
     9hwaddr      MAC address of the device to use to restore through (optional)
     10ipaddr      IP Address to setup on the device (e.g. 192.168.1.1)
     11ipdev       Device name (e.g. eth2)
     12iproute     Additional static route (uses "route add" syntax with : separator)
     13            (e.g. iproute="-net:192.168.8.0:netmask:255.255.255.0:dev:eth3)
     14mountpoint  Mount point on the Remote Network server to use
     15            (if NFS, should be in /etc/exports of the NFS server)
     16netfsmount  Server and mountpoint on which the ISO is available (optional)
     17            (if SSHFS the server part can be of the form user@server)
     18netfsopt    Contains options passed to the mount command (optional)
     19netfspath   Local path on the remote server where image is located (optional)
     20netmask     Netmask to setup on the device (e.g. 255.255.255.0)
     21proto       Protocol to use for mounting the remote share
     22            (default is NFS, sshfs and smbfs are also available)
     23ramdisk_size Size of the RAM disk where the initrd is exploded
     24server      IP address of the Remote Network server
    425
    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:
     26To use it, on your deployment server, add the following line to your conf file:
    1127label mondo
    1228        kernel vmlinuz-mondo
    1329        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] ...
    1430
    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 iproute is an additional static route using the route add syntax using : nstead of space to separate values
    21 dhcp is a keyword. Using it will provide all the previous 4 values to activate the LAN interface.
    22 hwaddr is the MAC address of the device you want to use to restore through
    23 proto is the protocol to use for mounting the remote share (default is NFS, sshfs and smbfs are also available)
    24 server is the ip addr of the Remote Network server
    25 mountpoint is the mount point on the Remote Network server to use (if NFS, should be in /etc/exports of the NFS server)
    26 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.
    27 netfsopt may contains options passed to the mount command
    28 netfspath is the local path on the remote server where the image is located, if different from the one at backup time.
    29 local_path is the local directory under which the mage was made (with the -d option)
    30 ramdisk_size may have to be increase to 262144 or more on more recent distributions such as RHEL 6
    3131The [] mean this parameter is optional
    3232The () mean that you have a choice with the '|' meaning 'or'
     
    5454Please report any problem around that tool to bruno_at_mondorescue.org
    5555
     56$Id$
     57
    56582013-07-25 adds support for iproute
    57592011-10-09 adds support for hwaddr
  • branches/3.0/mindi/install.sh

    r3143 r3173  
    7777install -m 755 analyze-my-lvm $locallib/mindi
    7878install -m 644 msg-txt dev.tgz $locallib/mindi
    79 install -m 644 deplist.txt mindi.conf $conf
     79install -m 644 deplist.txt mindi.conf README.bootparam README.pxe $conf
    8080for f in deplist.d/*.conf; do
    8181    install -m 644 $f $conf/deplist.d
  • branches/3.0/mindi/mindi

    r3172 r3173  
    8787LOGFILE=/var/log/mindi.log
    8888BOOT_MEDIA_MESSAGE="\
    89 To format and restore all files automatically, type 'nuke' <enter>.\n\
    90 To restore some/all files interactively, type 'interactive' <enter>.\n\
    91 To compare the archives with your filesystem, type 'compare' <enter>.\n\
    92 To boot to a command-line prompt (expert mode), type 'expert' <enter>.\n\
    93 You may add one or more of the following parameters as well:-\n\n\
    94         donteject - mondorestore will not eject the CD; this is useful if, for\n\
    95                     instance, your PC's case has a concealed CD-ROM drive\n\
    96         noresize  - your mountlist will not be adjusted to use your unallocated\n\
    97                     hard disk space\n\
    98         textonly  - do not call any Newt library routines; this is unattractive\n\
    99                     but valuable if you find your Newt library has bugs in it\n\n\
    100 e.g. Type 'nuke donteject textonly' if you have an unstable Newt library and \n\
    101 a PC whose CD-ROM drive tray would be damaged if it unexpectedly ejected.\n\
     89To format and restore all files automatically, type '0enuke07' <enter>.\n\
     90To restore some/all files interactively, type '0einteractive07' <enter>.\n\
     91To compare the archives with your filesystem, type '0ecompare07' <enter>.\n\
     92To boot to a command-line prompt (expert mode), type '0eexpert07' <enter>.\n\
     93\n\
     94You may add one or more parameters as well as per the function keys below\n\
     95e.g. Type '0enuke denymods=\"fdomain impi_si\"07' to not load these 2 modules\n\
     96\n\
     97If restoring from a local external disk or USB key, do not connect it \n\
     98until the boot-up has finished.\n\
     99\n\
     100\n0eF107-Main | Boot Parameters 0eF207-1/2 | 0eF307-2/2 | 0eF407-PXE\n\
    102101"
    103102FDISK=$MINDI_SBIN/parted2fdisk
     
    14891488        fi
    14901489    done
    1491     MakeMessageFile | cut -c1-80 > $MINDI_TMP/iso/message.txt
     1490    MakeMessageFile $MINDI_TMP/iso | cut -c1-80 > $MINDI_TMP/iso/message.txt
    14921491    if [ $KERNEL_IS_XEN = "yes" ]; then
    14931492        cp $xenkernelpath $MINDI_TMP/iso/xen.gz 2>> $LOGFILE || Die "Cannot copy xen.gz ($xenkernelpath) to mindi tmp ($MINDI_TMP/iso/xen.gz). Did you run out of disk space?"
     
    15131512    if [ "$ARCH" != "ia64" ] ; then
    15141513        if [ _"$MONDO_SHARE" != _"" ]; then
    1515             cp -f $MINDI_TMP/iso/{isolinux.cfg,initrd.img,vmlinuz,isolinux.bin,message.txt} $MONDO_ROOT 2>> $LOGFILE || Die "Cannot copy core files to ramdisk for boot disk (under $MONDO_ROOT). Did you run out of disk space?"
     1514            cp -f $MINDI_TMP/iso/{isolinux.cfg,initrd.img,vmlinuz,isolinux.bin,message.txt,boot*.txt,pxe.txt} $MONDO_ROOT 2>> $LOGFILE || Die "Cannot copy core files to ramdisk for boot disk (under $MONDO_ROOT). Did you run out of disk space?"
    15161515            if [ $KERNEL_IS_XEN = "yes" ]; then
    15171516                cp -f $MINDI_TMP/iso/{mboot.c32,xen.gz} $MONDO_ROOT 2>> $LOGFILE || Die "Cannot copy Xen core files to ramdisk for boot disk (under $MONDO_ROOT). Did you run out of disk space?"
     
    16611660    done
    16621661    echo -en "."
    1663     MakeMessageFile | cut -c1-80 > $MINDI_TMP/usb/message.txt
     1662    MakeMessageFile $MINDI_TMP/usb | cut -c1-80 > $MINDI_TMP/usb/message.txt
    16641663    echo -en "."
    16651664    cp $kernelpath $MINDI_TMP/usb/vmlinuz 2>> $LOGFILE || Die "Cannot copy vmlinuz ($kernelpath) to mindi tmp ($MINDI_TMP/usb/vmlinuz). Did you run out of disk space?"
     
    17041703    if [ -x "/bin/lsb_release" ]; then
    17051704        DESC=`/bin/lsb_release -d | cut -d: -f2 | sed "s/[ \t]*//"`
    1706     elif [ -r /etc/arch-release ]; then  # this code must be written before /etc/issue test to avoid errors                             
    1707         DESC="Arch Linux"                                                                                                           
    1708         if [ -r /var/log/pacman.log ]; then                                                                                         
    1709             # there are no releases but we can get the last system upgrade                                                     
    1710             # Output example:   Arch Linux [2011-03-03 01:39]                                                                   
    1711             DESC="$DESC $(tac /var/log/pacman.log | grep -m1 'full system upgrade' | cut -d']' -f1)]"                           
     1705    elif [ -r /etc/arch-release ]; then  # this code must be written before /etc/issue test to avoid errors
     1706        DESC="Arch Linux"
     1707        if [ -r /var/log/pacman.log ]; then
     1708            # there are no releases but we can get the last system upgrade
     1709            # Output example:   Arch Linux [2011-03-03 01:39]
     1710            DESC="$DESC $(tac /var/log/pacman.log | grep -m1 'full system upgrade' | cut -d']' -f1)]"
    17121711        fi
    17131712    elif [ -r /etc/issue.net ]; then
     
    17401739        fi
    17411740    fi
    1742     echo -en "\n\n\n"
     1741
     1742    # Also create the other help screens
     1743    head -24 $MINDI_CONF/README.bootparam | cut -c1-80 > $1/boot1.txt
     1744    head -48 $MINDI_CONF/README.bootparam | tail -24 | cut -c1-80 > $1/boot2.txt
     1745    head -24 $MINDI_CONF/README.pxe | cut -c1-80 > $1/pxe.txt
    17431746}
    17441747
     
    17571760    # Generic header for conf file
    17581761    if [ "$type" != "elilo" ] ; then
    1759         echo -en "prompt 1\ndisplay message.txt\n"
     1762        echo -en "prompt 1\ndisplay message.txt\nF1 message.txt\nF2 boot1.txt\nF3 boot2.txt\nF4 pxe.txt\n"
    17601763    else
    17611764        echo -en "prompt\n"
     
    18841887        retval=$(($retval+1))
    18851888    fi
    1886     MakeMessageFile | cut -c1-80 > $mountpoint/message.txt
     1889    MakeMessageFile $mountpoint | cut -c1-80 > $mountpoint/message.txt
    18871890
    18881891    mkdir -p $mountpoint/tmp
     
    19681971
    19691972    # copy Mindi's skeleton fs & lilo/syslinux/whatever stuff into it
    1970     MakeMessageFile | cut -c1-80 > $mountpoint/message.txt
     1973    MakeMessageFile $mountpoint | cut -c1-80 > $mountpoint/message.txt
    19711974    MakeBootConfFile isolinux > $mountpoint/syslinux.cfg
    19721975    LogFile "INFO: Copying $MINDI_TMP/initrd.img to $mountpoint/initrd.img..."
  • branches/3.0/mindi/msg-txt

    r2292 r3173  
    1 Welcome to Mindi vZZZZZ, a cousin of MondoRescue
    21
    3 Creation date: TTTTT
    4 These disks were generated on the following system:-
    5              MMMMM
    6              DDDDD
    7              KKKKK
    8              AAAAA
    92
     3Welcome to 0fMindi vZZZZZ07, a cousin of MondoRescue
     4
     5Creation date: 0fTTTTT07
     6These disks were generated on the following system:
     7             0fMMMMM07
     8             0fDDDDD07
     9             0fKKKKK07
     10             0fAAAAA07
     11
Note: See TracChangeset for help on using the changeset viewer.