diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/.cvsignore | 1 | ||||
| -rw-r--r-- | docs/BUGS | 10 | ||||
| -rw-r--r-- | docs/HACKING | 122 | ||||
| -rw-r--r-- | docs/Partition-ends-after-end-of-disk.txt | 66 | ||||
| -rw-r--r-- | docs/README | 372 | ||||
| -rw-r--r-- | docs/README.devel | 48 | ||||
| -rw-r--r-- | docs/README.pxe | 11 | ||||
| -rw-r--r-- | docs/SHORTCUTS | 4 | ||||
| -rw-r--r-- | docs/TODO | 515 | ||||
| -rw-r--r-- | docs/comparisons | 224 | ||||
| -rw-r--r-- | docs/diskdrake.TODO | 23 | ||||
| -rw-r--r-- | docs/drakfont/drakfont.tex | 2 | ||||
| -rw-r--r-- | docs/draknet_advanced_doc.txt | 165 | ||||
| -rwxr-xr-x | docs/interactive/ask_from | 29 | ||||
| -rwxr-xr-x | docs/interactive/ask_from_list | 27 | ||||
| -rwxr-xr-x | docs/interactive/ask_from_listf | 27 | ||||
| -rwxr-xr-x | docs/interactive/ask_from_treelist | 27 | ||||
| -rwxr-xr-x | docs/interactive/wait_message | 13 | ||||
| -rw-r--r-- | docs/ka_method/Makefile | 59 | ||||
| -rw-r--r-- | docs/ka_method/doc-duplication.xml | 1487 | ||||
| -rw-r--r-- | docs/ka_method/docbook-jadetex.dsssl | 450 | ||||
| -rw-r--r-- | docs/ka_method/duplication.xml | 39 | ||||
| -rw-r--r-- | docs/ka_method/duplication.xsl | 24 | ||||
| -rw-r--r-- | docs/ka_method/oneduplication.xsl | 37 | ||||
| -rw-r--r-- | docs/ka_method/styleguibo.css | 296 | ||||
| -rw-r--r-- | docs/mastering-tool-for-restore-cd | 84 |
26 files changed, 3020 insertions, 1142 deletions
diff --git a/docs/.cvsignore b/docs/.cvsignore deleted file mode 100644 index a0593a470..000000000 --- a/docs/.cvsignore +++ /dev/null @@ -1 +0,0 @@ -pictures diff --git a/docs/BUGS b/docs/BUGS deleted file mode 100644 index 1d154fcf1..000000000 --- a/docs/BUGS +++ /dev/null @@ -1,10 +0,0 @@ -doInstallStep: if there's not enough room, error, but packages are marked installed :( - -when you click directly on setupFilesystems and you have scsi, you're fucked. -Even if you go to setupSCSI, you won't be able to have partitions again. - -bug non reproductible: -- /etc/passwd is empty after `root passwd' stage :( -- reboot at the end of package installation with a lot of error messages from -gtk about the progressbar - diff --git a/docs/HACKING b/docs/HACKING deleted file mode 100644 index fb3c8cf49..000000000 --- a/docs/HACKING +++ /dev/null @@ -1,122 +0,0 @@ --=-=-- -DrakX is a very big project, and it needs special setups to work. -The purpose of this file is to explain how you can setup your box to make it -compile and run. --=-=-- - -Beware, don't try this on a production machine with important data. - - --------------------------------------------------------------------------- -Sources installation: - - First grab the gi.tar.bz2 archive and untar it in your home directory, -for example from DrakX-*.src.rpm on your Mandrake Linux distribution. - -cd to gi -for i in `du -a | grep CVS/Root | cut -f 2` -do - sed -e 's/prigaux/anoncvs/' $i > $i.tmp - mv $i.tmp $i -done - -Then, log yourself into the cvs: -% export CVS_RSH=ssh -% export CVSROOT=:ext:anoncvs@cvs.mandrakesoft.com:/cooker -% cvs checkout gi - (passwd: 'cvs') -And update the gi package: -cvs update -P -d - - --------------------------------------------------------------------------- -Preparing the compilation process: - -(1) target directory - -create a /export directory and copy a recent Mandrake Linux CD in there. -(You don't have to put have all the RPMS...) ; you'll need roughly 1.5 -Gbytes for a full install. - -[gc@obiwan ~/cvs/gi] su -c "mkdir /export" - - -(2) devel packages - -you need quite a few devel packages to run the stuff; roughly: gcc, make, -glibc-devel, perl-devel, XFree86-devel, libglib-devel, libgtk+-devel, -perl-GTK, ldetect*, libslang-devel, libnewt-devel, e2fsprogs, dosfstools, -rpm-devel, popt-devel, rpmtools. - - -(3) sudo - -never build or run DrakX as root; install package sudo, and set up -relevant permissions; the following should be enough: (in your -/etc/sudoers) - -gc ALL=(root) NOPASSWD:/usr/bin/patch,NOPASSWD:/bin/rpm,NOPASSWD:/bin/mount,NOPASSWD:/bin/cp,NOPASSWD:/bin/umount,NOPASSWD:/usr/bin/install,NOPASSWD:/bin/rm,NOPASSWD:/bin/mv,NOPASSWD:/bin/tar,NOPASSWD:/bin/cpio,NOPASSWD:/bin/chown,NOPASSWD:/bin/mkdir,NOPASSWD:/usr/bin/strip - - -(4) boot kernel - -you need one or more kernels and (all?) their modules. it's located in -subdirectory "all.kernels" in DrakX-*.src.rpm ; if you ever grab (or -build) another boot kernel, replace or add an entry in "all.kernels" as: - - (a) create your modules subdir (useful to describe the - VERSION_RELEASE) and untar your kernel - -[gc@obiwan ~/cvs/gi/all.kernels] mkdir 2.4.1-BOOTcustom -[gc@obiwan ~/cvs/gi/all.kernels] cd 2.4.1-BOOTcustom -[gc@obiwan ~/cvs/gi/all.kernels/2.4.1-BOOTcustom] tar jxvf ~/mycustomkernel.tar.bz2 -[gc@obiwan ~/cvs/gi/all.kernels/2.4.1-BOOTcustom] ls -boot/ cardmgr/ lib/ - - (c) build kernel/modules stuff for stage1 and stage2 -[gc@obiwan ~/cvs/gi] ./update_kernel - - -(5) pray - -[gc@obiwan ~/cvs/gi] make - - ---------------------------------------------------------------------------- -The comments written with #- are automatically stripped out at install. - - ---------------------------------------------------------------------------- -testing all: - - go to the perl-install directory and execute ./g_auto_install --test - - You should be able to test the whole thing in a non-destructive way. - -NEVER compile and/or execute DrakX as root! - - - - -Here is how I (dams) made it work on my computer. -------------------------------------------------- - -- get the sources -- install the librairies needed included newt-devel gtk+-devel popt-devel popt gtk-engines -- cd path/to/gi -- make -- mkdir /usr/share/gtk -- ln -s path/to/gi/perl-install/share/themes /usr/share/gtk -- ln -s path/to/gi/perl-install/share/step-* /usr/share -- ln -s path/to/gi/perl-install/share/help.xpm /usr/share -- ln -s path/to/gi/perl-install/share/isdn* /etc/sysconfdir/network-scripts -- have a cd architecture linked on /export -- ln -s /export /tmp/rhimage -- export PERL_INSTALL_TEST=1 -- cd path/to/gi/perl-install -- gendistrib --noclean --distrib /export -- ./install2 in root (dangerous) or chmod a+r /dev/hd* and ./install2 in user - - - -address all bugreports to dave@null.com diff --git a/docs/Partition-ends-after-end-of-disk.txt b/docs/Partition-ends-after-end-of-disk.txt new file mode 100644 index 000000000..037fe9106 --- /dev/null +++ b/docs/Partition-ends-after-end-of-disk.txt @@ -0,0 +1,66 @@ + Cylinder/Head/Size Hell Is Not Over + + pixel + $Date$ + + +Nowadays, you can boot Linux without ever relying on CHS +(Cylinder/Head/Size): + +- CHS information on partition table is obsolete and not used anymore. +It was causing the 1024th cylinder limitation: + - disallowing partitions above 8GiG. Problem overcome using 28bits Linear + Block Addressing (LBA) in partition table. + - disallowing to boot on partition above 8GiG (due to int13 limitation used + in bootloaders). Problem overcome using int13 extensions (EDD) + +Logical CHS (Cylinder/Head/Size) and physical CHS are not related anymore. +Especially the size of a hard drive is not a multiple of the number of +Cylinders. + + +The problem is that many tools still rely somewhat heavily on CHS information. +- most tools adjust partitions on cylinder boundary +- some tools compute the size of the disk based on CHS (eg: fdisk) + + +Resulting problems in various tools: + +- last partition not cylinder boundary adjusted, and overrun CHS computed size + - fdisk + > Total allocated sectors %d greater than the maximum %d + - cfdisk (need confirmation) + > FATAL ERROR: Bad primary partition %d: Partition ends after end-of-disk + or + > FATAL ERROR: Bad logical partition %d: Partition ends after end-of-disk + - Partition Magic (version?) + > Error #109: Partition ends after end of disk + - Windows <= 98se, Windows Me + (doesn't like it, what error message?) + + Tools handling it correctly: + - parted and so diskdruid in RedHat >= 7.2 (or is it 7.x?) + - diskdrake >= Mandrake 8.2 + - Windows XP (need confirmation) + + Tools using the full size of the disk, and so causing pbs with fdisk/cfdisk/...: + - diskdrake == Mandrake 8.2 + +- disagreement between CHS and linear address + - parted + > "Warning: Unable to align partition properly. This probably means that + > another partitioning tool generated an + > incorrect partition table, because it didn't have the correct BIOS + > geometry. It is safe to ignore,but + > ignoring may cause (fixable) problems with some boot loaders. + > Ignore Cancel ? C + - lilo + > Warning: Kernel & BIOS return differing head/sector geometries for device 0x80 + > Kernel: 38792 cylinders, 16 heads, 63 sectors + > BIOS: 1023 cylinders, 255 heads, 63 sectors + > Device 0x2100: Inconsistent partition table, 2nd entry + > CHS address in PT: 48:0:1 --> LBA (771120) + > LBA address in PT: 48384 --> CHS (3:3:1) + > The partition table is *NOT* being adjusted. + + diff --git a/docs/README b/docs/README index dffa604e4..02bc5d351 100644 --- a/docs/README +++ b/docs/README @@ -1,37 +1,18 @@ -Well here is a little description of what DrakX needs to work in comparison -to the RH newt install. +Well here is a little description of what DrakX needs to work ******************************************************************************** -* CVS ************************************************************************** +* VCS ************************************************************************** ******************************************************************************** -Like all good free software, DrakX is in CVS :) +Like all good free software, DrakX is in SVN :) -You can access it at http://www.mandrakelinux.com/cgi-bin/cvsweb.cgi/gi +You can access it at http://svnweb.mageia.org/soft/drakx/trunk/ or via -export CVS_RSH=ssh -export CVSROOT=:ext:anoncvs@cvs.mandrakesoft.com:/cooker -cvs checkout gi - (enter password 'cvs') +svn co svn+ssh://svn.mageia.org/svn/soft/drakx/trunk -This is only read-only access. If you want more, tell me (pixel@mandrakesoft.com) - -Alas, all is not in CVS as a lot of things are binary files. - -For the boot kernel, see https://kenobi.mandrakesoft.com/~chmou/kernel/BOOT/ -or build your own: -- install the kernel-*.src.rpm from -- go to the /usr/src/RPM/SPECS/ (or any others topdir you have configured). -- type rpm -ba --with BOOT kernel-2.4.spec. -Then see function install_kernel() at the end of gi/update_kernel. - -For the other things, take SRPMS/DrakX-*.src.rpm - -Please note that redoing *all* the stuff is not for the faint of heart. I myself -sometimes wonder what the whole make does :-% -Instead, changing some .pm files is quite easy (nice interpreted language) +This is only read-only access. If you want more, tell me (pixel) ******************************************************************************** * Making your custom install *************************************************** @@ -39,27 +20,19 @@ Instead, changing some .pm files is quite easy (nice interpreted language) If you have your own rpms you want to add, or make your own updated cdrom, you just have to issue: -% gendistrib --noclean --distrib <DIRS> - -Where <DIRS> is the root of all the media that the install will see, this first -one is the main one : - -(1) network or 1-cdrom installs - DIRS == the root directory of the Distribution +% gendistrib --noclean --distrib <DIR> -(2) multi-cdrom install - DIRS == the root directories of all the media that the install will see +Where <DIR> is the root of all the distribution. -``gendistrib'' will scan the file Mandrake/base/hdlists in the main root -directory (the first one in DIRS) to search for all media used. Typically you -use Mandrake/RPMS* for RPM packages repository. -For multi-cd, please use Mandrake/RPMS or Mandrake/RPMS1, Mandrake/RPMS2, etc. -For one CD or a network/hd volume, please use Mandrake/RPMS. +``gendistrib'' will scan the file media/media_info/media.cfg to search for all +media used. Typically you use media/main for RPM packages repository. -Optionnally, you can modify ``Mandrake/base/rpmsrate''; this file manages +Optionnally, you can modify ``media/media_info/rpmsrate''; this file manages the relative importance of the files, and thus their installation or not. -Also, mdkinst_stage2.gz must be remade if you modify files in Mandrake/mdkinst. +To modify the code of stage2, use "misc/mdkinst_stage2_tool --uncompress +install/stage2" to generate "install/stage2/live". When you are done, use +"misc/mdkinst_stage2_tool --clean --compress install/stage2". See below for information about these files. ******************************************************************************** @@ -67,84 +40,59 @@ See below for information about these files. ******************************************************************************** First here are the different things needed : -Mandrake/base/hdlists +media/media_info/media.cfg description of the available install media. - format is one line for one medium as - <hdlist_name> <rpms_directory> <description> - <hdlist_name> should be match regexp /hdlist\S*.cz2?/ - for example (two cd install) you get - hdlist1.cz Mandrake/RPMS1 Boot CD - hdlist2.cz Mandrake/RPMS2 Extension CD - -Mandrake/base/hdlist*.cz - table of rpm's headers, referred by ``hdlists'' + cf MDV::Distribconf(3) + +media/media_info/hdlist*.cz + table of rpm's headers, referred by ``media.cfg'' their contents can be listed using ``packdrake -l <hdlist_file>'' or or ``parsehdlist <hdlist_file>''. - ! Need to be remade when Mandrake/RPMS* changes (with ``gendistrib'') ! - -Mandrake/base/depslist.ordered - for each packages, tell which package it depends on. Also contains the - size for some (obscure) bloody reasons. - ! Need to be remade when Mandrake/RPMS* changes ! - (with ``gendistrib --noclean --distrib .'') + ! Need to be remade when media/main changes (with ``gendistrib'') ! -Mandrake/base/compss - obsoletes comps. It store packages in different categories, generated - from the %{GROUP} field - ! Need to be remade when Mandrake/RPMS* changes ! - (with ``gendistrib --noclean --distrib .'') +media/media_info/compssUsers.pl -Mandrake/base/rpmsrate +media/media_info/rpmsrate ranks and classify packages, so that the installer will know which ones to install. format is : <intern_group> <level> <packages> - where <intern_group> is a symbolic name used in Mandrake/base/compssUsers* files, + where <intern_group> is a symbolic name used in media/media_info/compssUsers* files, and <level> defines importance level as described below : - 5 must have + 5 mandatory 4 important - 3 very nice + 3 interesting 2 nice 1 maybe - by default (for non expert), group selects packages for level 4 (important) - and 5 (must have). export mode add 3 (very nice) level. other level (below 2) - can only be selected using individual package selection. - -Mandrake/mdkinst - live system used on certain installs. See ``Ramdisk or not'' below for - more. + installer selects packages for level 4 (important) and 5 (mandatory). + packages in other level (3, 2, 1) can only be selected using + individual package selection. -Mandrake/base/mdkinst_stage2.bz2 - for the ramdisk. live sytem in ext2 filesystem bzipped2. - generated from Mandrake/mdkinst tree using misc/make_mdkinst_stage2 - See ``Ramdisk or not'' below for more. +install/stage2/mdkinst.sqfs + for the compressed loopback of install. + generated from install/stage2/live tree using misc/mdkinst_stage2_tool -Mandrake/base/rescue_stage2.bz2 - rescue ramdisk. live sytem in ext2 filesystem bzipped2. +install/stage2/rescue.sqfs + rescue ramdisk. create_compressed_fs iso file this is the ramdisk loaded when typing rescue on boot prompt. - there is no live system available, only the ramdisk is used. -images/*.img - boot images to use with DrakX. Use: - - cdrom for cdrom install - - network for ftp/nfs install (non-pcmcia devices) - - hd for hard-disk install - - pcmcia for pcmcia install (see ``PCMCIA install'' below for more) +install/images/all.img + fat16 image to dd on a partition (hint: sda1) - the following modules have been removed from: - network.img: acenic sk98lin de4x5 - cdrom.img and hd.img: BusLogic seagate fdomain g_NCR5380 dc395x_trm tmscsim - hd.img: dpt_i2o eata eata_pio eata_dma - cdrom.img: aztcd gscd isp16 mcd mcdx optcd cm206 sjcd - pcmcia.img: apa1480_cb - they are now in "other.img", +install/images/boot.iso + iso image to burn enabling any install (cdrom/hd/nfs/ftp) - blank.img is a blank boot image without a kernel nor initrd. this image - can be used to generate custom boot disk. - - if you think one of those modules is used a lot, tell me, i may find some room - to put it back on the main floppies. + To boot from cdrom, use boot.iso + To boot from network, use isolinux/alt0/all.rdz + vmlinuz via pxe + To boot from hd (esp. usb key), use all.img. + NB for usb boot: + - it seems some bioses don't use the code on MBR (sda), + or at least skip it when it's blanked + (eg: "dd if=/dev/zero of=/dev/sda bs=1 count=446") + - some bioses need it. I had some luck using + dd if=/usr/lib/extipl/aldebaran.bin of=/dev/sda + (install package extipl first) ******************************************************************************** * logs ************************************************************************* @@ -162,14 +110,16 @@ not interesting. - alt-F4: kernel's place. aka the output of dmesg. - alt-F7: the graphical install lives there -- command "bug" puts on floppy lots of interesting stuff. -- /tmp/ddebug.log: same (or nearly the same) as alt-F3 +- command "bug" puts on floppy/usb-key lots of interesting stuff. +- /tmp/stage1.log: same as alt-F3 part when stage1 run (e.g. actions + before graphical install really begins) +- /tmp/ddebug.log: (nearly the) same as latter alt-F3 part - /tmp/syslog: same as alt-F4 -- /mnt/root/ddebug.log: at the end of each step, DrakX tries to backup -/tmp/ddebug.log to /mnt/root. Available only after mounting of /. -- /mnt/root/install.log: the log of the installation (or upgrade) of the rpms +- /mnt/root/drakx/ddebug.log: at the end of each step, DrakX tries to backup + /tmp/ddebug.log to /mnt/root/drakx. Available only after mounting of /. +- /mnt/root/drakx/install.log: the log of the installation (or upgrade) of the rpms (just like rpm's /mnt/tmp/(install|upgrade).log) -- /mnt/root/auto_inst.cfg.pl: a kickstart file generated at the end of each +- /mnt/root/drakx/auto_inst.cfg.pl: a kickstart file generated at the end of each step. Can be used in 2 ways: kickstart install or ``defcfg'' install. Hopefully you know about kickstart. ``defcfg'' is a way to customize the default values in install. For example, French can be the default language with a qwerty keyboard, @@ -177,91 +127,58 @@ the auto-partitionning partitions can be changed, the default user class can be set to developer (!)... ******************************************************************************** -* po translation files ********************************************************* -******************************************************************************** -DrakX uses .po files for its translation. A script takes the different -strings out of the .pm files. It generates the DrakX.pot file which contains -all the english strings to translate. -To add a new language, you just have to add it to lang.pm (if it's not there -already) and put the .po in the perl-install/po directory (see ``Ramdisk or -not'' to know if you have to regenerate the mdkinst_stage2.gz) - -******************************************************************************** -* PCMCIA install *************************************************************** +* modules ********************************************************************** ******************************************************************************** -If the media you use to install is a pcmcia device, use the pcmcia boot disk. +To manually install a module during install, switch to console #2 +and type "modprobe <modulename>". The modprobe program is a perl +wrapper around /usr/bin/insmod. ******************************************************************************** -* Ramdisk or not *************************************************************** +* Making screenshots *********************************************************** ******************************************************************************** -The DrakX install is much bigger than the newt one. So the ramdisk which was -used is getting big, and costs a lot in memory -(eg: the mdkinst_stage2 is 14MB - 23/09/99) -(update! now size is 21MB - 24/01/01) -(update! now size is 19MB - 26/04/01) - -| | newt | DrakX -|-------+---------+---------------------------------------------------------- -| nfs | live | live -| ftp | ramdisk | ramdisk -| http | ramdisk | ramdisk -| hd | ramdisk | live if Mandrake/mdkinst/usr/bin/runinstall2 is a link, -| | | ramdisk otherwise -| cdrom | ramdisk | live if memory < 52MB, ramdisk otherwise - -Where ramdisk is needed, if detected memory is below the limit allowed for -ramdisk (maintained in file gi/mdk-stage1/config-stage1.h; currently 52 Mb), -a failure dialog will be printed explaining that there is not enough memory -to perform the installation. - -When i say live, it means that the stage1 will *mount* the -Mandrake/mdkinst and use it that way. - -The ramdisk is used in place of the live in some cases. This ramdisk is filled -with mdkinst_stage2.gz - -For cdrom install, the ramdisk is used to speed up things (access time is quite -high on cdrom drives) - -For pcmcia, it depends on the type of install. +1. easy solution: press "F2"! +2. On a test machine, make a network install, switch to console (ctrl-alt-F2), enter: +% xhost+ +then, on another computer: +% DISPLAY=test_machine:0 xwd -root | convert - screenshot.png ******************************************************************************** -* modules ********************************************************************** +* Auto install ***************************************************************** ******************************************************************************** -Modules can be found in at least 2 places: -- in /modules/modules.mar -- in /lib/modules.cz<KERNEL_VERSION_RELEASE> - -/modules/modules.mar is used in mdk-stage1. It contains only modules -interesting for one kind of install. For example in an hd install, it -contains scsi modules. For a network install, it contains network card -modules. (To create, extract or view files in a ``mar'' archive, please -use gi/mdk-stage1/mar/mar; this is basically an archive format meant to -be minimalistic) +A powerful auto-install system is available. It allows performing +an install without any human interaction. -/lib/modules.cz<KERNEL_VERSION_RELEASE> contains all modules, it is used -in stage2. +To feed automatic parameters to the stage1 part (the textmode +part - might not be necessary for you if you plan to do +cdrom-based auto-installs, but mostly highly needed when doing +network installs), please refer to ../mdk-stage1/doc/TECH-INFOS. +About the stage2 part (the actual installer, at the time you're +(usually) running in graphical mode), please refer to the nice +documentation written by David Eastcott. Either install the +package "drakx-autoinstall-doc" from contrib, or browse: -To install a module, use modprobe which is in /usr/bin. It's a perl wrapper -around /usr/bin/insmod. It uses the dependencies found in -/modules/modules.dep (stage1). +http://members.shaw.ca/Mandrake2/drakx/9.2/AutoInstall-9.2.2.html -/usr/bin/insmod is a wrapper around /usr/bin/insmod_. It just extracts the -module out of /lib/modules.cz in /tmp. Then it calls insmod_. - -/usr/bin/insmod_ is the real prog (which you usually find in /sbin/). You need -to give it the complete path. - -******************************************************************************** -* Making screenshots *********************************************************** -******************************************************************************** -On a test machine, make a network install, switch to console (ctrl-alt-F2), enter: -% xhost+ +The previous document will explain you how to setup the contents +of the auto_inst.cfg file. Note that you have 3 alternatives for +providing this file: +- from a floppy disk; use "kickstart=floppy" as kernel parameter, + as explained in the document +- from the installation volume itself; put the file in the + "install" directory of the installation volume; use + "kickstart" only, or "kickstart=filename" to specify another + filename than auto_inst.cfg +- specified by the network; setup your DHCP server to provide the + "bootfile" parameter, this file will be used as the + "auto_inst.cfg" file; in this case you also need to provide the + "netauto" boot parameter -then, on another computer: -% DISPLAY=test_machine:0 xwd -root | convert - screenshot.png +In any case, if the specified file ends with -IP or -IP.pl, IP +will be substituted by the IP address of the machine, when doing +a network install. Might be useful so that you can control all +your auto installs from your server. ******************************************************************************** * Miscellaneous **************************************************************** @@ -271,104 +188,21 @@ then, on another computer: > - What exactly each stage does init loads stage1 -stage1 loads stage2, on various medium type - -stage2 is too big to fit on a floppy, that's why stage1 exists - -> - How each stage relates to the various media access methods - -stage1 knows only how to access to the media is compiled for. It contains only -the kernel modules needed for that media. For eg, the nfs/ftp/http stage1 -doesn't contain scsi modules nor ide. +stage1 loads stage2, from various medium type > - How one stage terminates and another begins. i.e., How does > stage1 find, mount, and launch stage2? -/sbin/init just starts /sbin/stage1 -/sbin/stage1 takes care of mounting stage2 (in ramdisk if necessary) - then it runs /usr/bin/runinstall2 + /sbin/init just starts /sbin/stage1, and monitors its +execution; it's here to cleanly umount the partitions when stage1 +or stage2 dies/finished + + /sbin/stage1 takes care of mounting stage2 (in ramdisk if +necessary) then it execs /usr/bin/runinstall2 (thus, stage2 +replaces stage1, and init then monitors stage2) > o Text and Graphic mode installers > - Architectural overview of each -have a look at gi/docs/object_class.fig - +have a look at drakx/docs/object_class.fig -******************************************************************************** -* OEM ************************************************************************** -******************************************************************************** -> I am a system OEM in Bangalore,India selling systems bundled with -> Mandrake Linux. The problem is that with every system I sell, I need to -> install & configure the system which takes HOURS!. Can I do a diskcopy -> instead? -> -> Please Help. This is a major bottleneck for me. - -many solutions: - -- make an install on drive hdb, then : - dd if=/dev/hdb of=/dev/hdc - but you should make sure the hardware is *REALLY* identical. - -- try the oem feature - 3. - burn a cd out of *latest* cooker or 8.0 and above. - - boot on it telling "oem" to syslinux - !! it will destroy every data on the harddrive or - resize (or use free space) if *ONLY* one fat partition is defined !! - - you now have a very automated install matrix - (duplicate it with "dd if=/dev/hdb of=/dev/hdc bs=1M count=730") - - put the harddrive in the oem box, the user will now have an *very* automated - install, just asking the root password and user password, and some other - question according its hardware. - - 4. just like 3. but you may have to mount /cdrom after typing rescue on - syslinux prompt (oem script do it automatically if a automatic boot nfs - network has been done as server is known). under /cdrom may be anything - as long as it provides an installation tree of Mandrake Linux. - after that run oem script by typing "/etc/oem -f" for normal installation - or "/etc/oem -f server" for server installation (normal with server installed). - - 5. (just like 3. without burning a cd, doing the first part by hand) - have a look at the /etc/oem script on the rescue and do it by hand... - - -cu Pixel, fpons. - - -comments: -1. maybe copy unnecessary things -> take too long - solution -> use bs=8k count=xxxx -2. kernel_reread can be found on the new rescue, source is also at end of this -mail. This solution works with one partition. Can be easily enhanced to many -primary partitions... For extended partitions, more complicated, but not much :) -3. has just been added in latest cooker. It may still have some pb. The main -current limitation is IDE only, though it can be fixed easily for special cases. - --------------------------------------------------------------------------------- -#include <stdio.h> -#include <sys/mount.h> -#include <fcntl.h> - -void die(char *msg) -{ - perror(msg); - exit(1); -} - -void kernel_read(char *dev) -{ - int fd; - if ((fd = open(dev, O_RDONLY)) == -1) die("can't open device"); - ioctl(fd, BLKRRPART, 0); - close(fd); -} - -int main(int argc, char **argv) -{ - if (argc != 2) { - fprintf(stderr, "usage: kernel_read_part <hard drive device>\n"); - exit(1); - } - kernel_read(argv[1]); -} diff --git a/docs/README.devel b/docs/README.devel index 0244557ba..70d2b6285 100644 --- a/docs/README.devel +++ b/docs/README.devel @@ -12,12 +12,12 @@ entry point for stage2 is /usr/bin/runinstall2 which is typically a link to install2::main with @ARGV. install2::main parse command line arguments, prepare installation, find the right -install_interactive class (take a look at gi/docs/object_class.fig) according to +install/interactive class (take a look at gi/docs/object_class.fig) according to command line, memory available and if the interactive chosen is initializing correctly, else it will try a less-demanding interactive object. Once done, $::o is set to this install & interactive object and main runs the various step of install2 defined in $o->{steps}, starting with $o->{steps}{first} -and iterating with method install_any::getNextStep(). +and iterating with method install::any::getNextStep(). while running step, it trap any errors that may arise and use perl exception to change step. @@ -28,35 +28,35 @@ Here is a brief description of what each modules of DrakX is doing. install2: main module of DrakX as described above, main loop execution of DrakX. -install_steps: generic installation module containing steps definition, all steps +install/steps: generic installation module containing steps definition, all steps should always be defined here as some methods may be used on automatic mode. there is no interactivity available. typically are defined base operation for configuring each step according to $o. -install_steps_interactive: generic installation module with generic interative +install/steps_interactive: generic installation module with generic interative methods. typically are found all interactive code of DrakX for each steps. -install_steps_auto_install: implementation installation module without interactive +install/steps_auto_install: implementation installation module without interactive methods to match auto_install mode. this is the simplest as almost no method are - redefined (inherit module install_steps only, compared to other implementation + redefined (inherit module install/steps only, compared to other implementation modules described below). -install_steps_stdio: implementation installation module with interactive stdio - methods to match stdio mode. inherit modules install_steps_interactive and +install/steps_stdio: implementation installation module with interactive stdio + methods to match stdio mode. inherit modules install/steps_interactive and interactive_stdio. -install_steps_newt: implementation installation module with interactive newt - methods to match newt mode. inherit modules install_steps_interactive and +install/steps_newt: implementation installation module with interactive newt + methods to match newt mode. inherit modules install/steps_interactive and interactive_newt. -install_steps_gtk: implementation installation module with interactive gtk - methods to match gtk mode. inherit modules install_steps_interactive and +install/steps_gtk: implementation installation module with interactive gtk + methods to match gtk mode. inherit modules install/steps_interactive and interactive_gtk. -install_any: contains various methods using generic interactive interface but +install/any: contains various methods using generic interactive interface but not used by standalone tools. -install_gtk: contains various methods using gtk interface but not used by +install/gtk: contains various methods using gtk interface but not used by standalone tools. interactive_stdio: implementation methods for interactivity in stdio mode. @@ -71,7 +71,7 @@ interactive_gtk: implementation methods for interactivity in gtk mode. my_gtk: basic gtk access methods. any: contains various methods using generic interactive interface. to compare - against install_any module as this one is available for standalone tools. + against install/any module as this one is available for standalone tools. class_discard: simple module that implement every methods undefined to return nothing. this trick is used to ensure no undefined method can arise when using @@ -116,17 +116,17 @@ partition_table: base partition table management methods, it manages appriopriate partition_table_XXX object according to what has been read as XXX partition table type. -partition_table_raw: generic class for the following partition_table_XXX. +partition_table::bsd: matches a BSD partition table. -partition_table_emtpy: matches an empty partition table. +partition_table::dos: matches a DOS partition table. -partition_table_dos: matches a DOS partition table. +partition_table::emtpy: matches an empty partition table. -partition_table_bsd: matches a BSD partition table. +partition_table::mac: matches an Apple partition table. -partition_table_mac: matches an Apple partition table. +partition_table::raw: generic class for the following partition_table::XXX. -partition_table_sun: matches a Sun Label partition table. +partition_table::sun: matches a Sun Label partition table. fs: read and write /etc/fstab file, mount and umount, format. @@ -182,7 +182,7 @@ standalone: standalone only, allow defining a standalone tools. bootlook: standalone only, interface with DrakConf to configure bootloader options. -tinyfirewall: standalone only, interface with DrakConf to configure a tiny firewall. +drakfirewall: standalone only, interface with DrakConf to configure a tiny firewall. ******************************************************************************** * DrakX FAT resizer module description ***************************************** @@ -237,14 +237,14 @@ the 0, 1, '' means not "redoable", "skip on error", "don't hide" sub selectAlawindows { $o->selectAlawindows } -3. add your function selectAlawindows in install_steps_interactive.pm +3. add your function selectAlawindows in install/steps_interactive.pm sub selectAlawindows { my ($o) = @_; $o->{alawindows} = $o->ask_yesorno('', _("Throw everything away as windobe does?"), 1); } -4. add your function selectAlawindows in install_steps.pm (not needed in that +4. add your function selectAlawindows in install/steps.pm (not needed in that case, except for auto_install) sub selectAlawindows {} diff --git a/docs/README.pxe b/docs/README.pxe index 14115369a..e60aa9ecf 100644 --- a/docs/README.pxe +++ b/docs/README.pxe @@ -13,7 +13,7 @@ You can install tftp-server and dhcp-server package from the Mandrake distribution for example. On the server machine at 192.168.2.1, you will find a "/etc/dhcpd.conf" sample -file written by Florin Grad <florin@mandrakesoft.com>, where "mydomain.com" is +file written by Florin Grad <florin>, where "mydomain.com" is assumed to be your domain name, and 192.168.1.1 a name server. All install are done on subnet 192.168.2.0. @@ -122,18 +122,9 @@ label expert label rescue kernel vmlinuz append ramdisk_size=32000 initrd=network.rdz root=/dev/ram3 rescue rw -label lnx4win - kernel vmlinuz - append ramdisk_size=32000 initrd=network.rdz root=/dev/ram3 lnx4win vga=788 -label preinst - kernel vmlinuz - append ramdisk_size=32000 initrd=network.rdz automatic=method:cdrom root=/dev/ram3 rescue oem rw label oem kernel vmlinuz append ramdisk_size=32000 initrd=network.rdz automatic=method:cdrom root=/dev/ram3 rescue oem rw -label auto - kernel vmlinuz - append ramdisk_size=32000 initrd=network.rdz auto_install=Mandrake/base/auto_inst.cfg.pl ******************************************************************************** * Usefull linkst *************************************************************** ******************************************************************************** diff --git a/docs/SHORTCUTS b/docs/SHORTCUTS index bc8325625..0a0d6e0ab 100644 --- a/docs/SHORTCUTS +++ b/docs/SHORTCUTS @@ -1,8 +1,8 @@ ******************************************************************************** main shortcuts -F11 -> previous step -F12 -> next (reachable) step +F1 -> help +F2 -> take a screenshot ******************************************************************************** diskdrake diff --git a/docs/TODO b/docs/TODO deleted file mode 100644 index cb9399f82..000000000 --- a/docs/TODO +++ /dev/null @@ -1,515 +0,0 @@ --URGENT--------------------------------------------------------------------------------- -check for fpons/pixel BOTH that resize_fat is clean for current version -relative to 7.0-2. - -heavy testing of diskdrake to avoid corrupting partition table, current version -should be available to fix bogus partition table, writing enabled only when -partition is Ok (fixme? allow primary partition inside extended one, but with -warning on diskdrake startup, made them as warning ?). - --features------------------------------------------------------------------------------- -add rpmdrake in menu - -(7.1 or later) clean SCSI CDROM autoboot. -(done,gc,8.0) stage1 & cdrom: add ability in expert to choose the scsi cdrom drive to use - -(7.1)better help for partitioning in newbie - -(7.1)Improved network configuration (PPP and/or Ethernet) -PPPoE install and configuration (SuSE includes it, DHCP-like) -(7.1)standalone applications for configuration (netdrake, timetool, authentificationconf, soundcard) - ----- -(7.2) replace normal with standard (in the installClass's) - -(7.2 or later)horizontal sub-steps - -(7.2 or later)diskdrake in text mode - -ask "do you have SCSI?" before asking "probe PCI or not" - -(?) paride in stage1 -(done,gc,8.0) stage1 & network: add ability to choose the network interface to use - -(?) msec custom - -(?)firewall configuration (instant firewalling?) - -(?)widget for displaying fdisk (dindinx) -add fdisk using the zvt widget (taken in gnome-libs) - -(?)help in some configuration files. - -ability to add nfs/weird_fs entries in fstab - -size of packages in crypto - --to test-------------------------------------------------------------------------------- -what's lseek64? - -ensure installClass is set to something in auto install. - -for axp, swriteboot -f1 if swriteboot failed. -axp with swap part sigsegv - -tree for choosing monitors (buggy?) - -what happens if a module fails to insmod (scsi step), in beginner/normal/expert - -fstab must be sorted (/usr/local after /usr) - -RAID upgrades - -add choice clean /tmp or not in expert - -kernel chosen by default must be the one according to supermount/secure - -bug if ide-scsi, no more hdX, but scd0 (aka sr0) - (and add alias block-major-11 ide-scsi ?) - -check on update for conf.modules and modules.conf ! - -with /usr, /usr/local and /usr/local/e mount points i get an error at step mounting local filesystems - --easy fixes----------------------------------------------------------------------------- -rpmdrake proposition for cdrom labels - -use option nocheck to mount for upgrades - --fixes needing thinking----------------------------------------------------------------- -bug: changing mem= in miscellaneous doesn't modify lilo conf if you backtrack - -ask network configuration only if NIC found? - -configure DHCP for newbies if ethernet & DHCP card available - -xvidtune like screen configuration (see SuSE's yast) - -live cdrom for alpha (sparc?) - -network boot - -get the error when getting/reading .rpm files fail -better timeout handling for network installs - -handle not enough room for update -(fpons)verify the free space is big enough. - -the XFdrake test does not handle the fontset - -> Here I go into the printer configuration select 'HP Deskjet 722C Colour', -> print a test ASCII page, pressing 'No' when prompted to indicate the page did -> not print OK and then hitting cancel when prompted to choose a printer type -> again. -> ask_from_list cancel at /usr/lib/libDrakX/my_gtk.pm line 504. - -diskdrake: take from parted mklabel, hide(?) - -bug in kde desktop if keeps home but not an upgrade - -bug in users: mandrake user is added twice in strange installs -(mixed of security 0 + ???) - -bugs rpmdrake: -- just after installing a package, switch to `Installed', the package has wrong name -- refresh the kde desktop after package installation in rpmdrake -(restart kpanel) -- rpmdrake and same name packages - -urpmi: pb if XXX-devel requires XXX = 1.2.3 and we updgrade XXX-1.2.3 - -bug in defcfg in with lang=fr_FR, display is buggy - -bug keyboard focus: after switch in console at Xconfig step - - - --to look at-------------------------------------------------------------------------- -adduserdrake to remove/update users - -(???)free provider auto configuration facility (to be discussed). -auto ppp-configure with free provider - -(?)on laptop, configure the MMU to use swap not very often - -(?)checkboxes in groups based on compssList (and availableSpace?) - -(?)see what can be done with nvram (50 bytes to save information) - -better wacom support - -(fpons)bug: CANON BJC 4X00 do not work with current rhs-printfilters - (work with magicfilters (debian)) - (should be handled by ghostscript BJC600's driver) - -(pix)install text on mem=8M, mem=16M? - -(pix)kickstart -partitioning? raid? -X configuration and bootloader in kickstart - -XFdrake chooseResolutions with ask_from_list do not permit ``Show all'' - -(?) options in mkfs, progress bar when formatting - -(?) when some error occurs, partition must be unset isFormatted - --hardware------------------------------------------------------------------------------- -- with no floppy drive, mkbootdisk step fails badly -- with bad floppy or write protected, mkbootdisk doesn't say anything -- try detect_devices::floppies (and how are scsi floppies handled?) -maybe: do a iotcl FDGETPRM to detect fd1, fd0. - -need a simple solution to precise mouse type (syslinux option?) - -ELSA Gloria has bad ddc info - -token ring is tr0 not eth0 - -I have Mandrake 6.1 installed and working on a ThinkPad 770. -To enable the PCMCIA Token ring I have to append the following line to -/etc/pcmcia/config.opts -module "ibmtr_cs" opts "mmiobase=0xd2000 srambase=0xd4000" - -smp not detected (mhoward@memphisonline.com on cooker, bios=BP6PW) - -UDMA66 (ultra66.o for promise) - -aha152x needs "insmod aha152x.o aha152x=0x140,11,7" - -(obsolete) usb module not removed if no mouse found - -(fpons)handle dat drives - -hibernation on laptop -> clock not restored - -# in 2.3.15 "Silicon Integrated Systems [SiS]|SiS900 10/100 Ethernet" is handled - -(?)enable the testing of the mouse type (under X) (wheel) -possibility to specify the mouse - --(?)--------------------------------------------------------------------------------- -(?) handle NT (add entry for it in lilo, put it in fstab) - -(?) lilo-0.22-19mdk is buggy with boot=/dev/hde & root=/dev/sda13, it needs -disk=/dev/hde bios=0x80 & disk=/dev/sda bios=0x81 - -(?)using setxkb, enable the testing of the keyboard - -(?)XFdrake does not handle fbdev - -(?) Je viens de faire une installation sur une machine où seul Be était -installé. Je l'ai supprimé et installé (mode recommandé) Oxygen. Au -redémarrage, le boot manager de Be apparaît et il est impossible de -démarrer Linux. -Pourquoi ne pas installer LILO si on supprime toutes les partitions ? - -(?)initrd in bzip2 - -(?)smaller zsh (or ash in initrd) - -(?)is configureNetworkNet needed with dhcp/bootp? - -(?)bug in upgrade: install from hda1:/usr/local/blah with hda1:/ - -(?)mandrake_desk was not installed while kdebase it there on upgrade - -(?)when clicking on X configuration, installation of packages is not displayed - -(?)maybe remove commented lines in /usr/lib/perl5/... files - -(?)timezone using a picture (pb: how to delimit zones) -when asking GMT or not, display the time for each possibility -the list is too big for USA - -(?)ability to select the type of install when booting of cdrom -(?)use the ability of el torito to handle 2.88MB or more - -(obsolete)lilo-deinstallation in case of lilo auto-installation for beginners - -(?)loadFont sucks - -(obsolete)trash on the screen when X first starts - -(?)remove the gray line surrounding the logo - -(?)cleanup /etc/services & /etc/protocols - -(?)strange: no scsi of type 'fd', only 'tape' - -(?)remount ro before X test. - -(?)remove every << and >> (doesn't handle > 32bits) - - --done--------------------------------------------------------------------------------- -(7.1,done,fpons) improve printerdrake to at least have the same functionalities as printtool. - -(done,fpons)diskdrake can olverlap partitions (resize lower, resize original typically -after clear all and auto allocate, try maximal size available). - -(done,fpons)rewrite mouseconfig in perl? - -(done,pix)kudzu or not in miscellaneous - -(done,pix)warn the user if not enough ram to fulfill install - -(done,fpons)test after printer config - -(done,pix)ask for more than the memory size detected - -(done,fpons)modem config - -(done,pix)call kudzu in batch to initialize its list - -(done,pix)standalone generator of mdkinst_stage2.gz - -(done,pix)text install - -(done,pix) if u choose mouse usb != found mouse, it fails at X config - -(done,pix) diskdrake bug: saved information on floppy contains isMounted. - -(done,pix) update devices.c from modules.pm - -(done,pix) in lilo.conf, put -disk=/dev/hdb - bios=0x80 - -(done,pix) diskdrake -auto_partitions -suggested partition tables must be better foreach installClass - -(done,pix) update the list of modules (in update_kernel) - -(done,pix) language support: only choose the right locales and upmark the packages requiring it - -(done,pix) move security question before isntallation of packages - -(done,pix) install ssh - -(done,fpons,pix) change the boot message of syslinux (have something different from RedHat) - -(done,pix) install_steps.pm: 569 (128M + 3) - -(done,pix) bug: mouse freeze just before network configuration (mouse primax) - (was kudzu) - -(done,pix) signal 11 in stage1 nfs kickstart mount failed - -(done,pix) ask supermount or not, no supermount with kernel-secure - -(done,pix) fix bug in g_auto_install (can't go through all) - -(done,pix) bug: install from ciril.fr fails - -(done,pix)wizard for partitioning in case of one full vfat - -(done,dindinx)app for choosing drakxtools (drakxconf) -(done,pix)verify being root -(done,pix)log::l -> initlog - -(done,pix)install apmd for laptops (maybe not start apmd though) -(done,pix)icewm apm (sh icewm_apm) -(done,pix)kde apm (put Kapm.kdelnk in ~/Desktop/Autostart) - -(done,pix)bug in adduserdrake: missing pwconv in md5 -(done,pix)correct the default value of draksec (cp draksec) -(done,pix)in draksec, (and maybe others) have --expert as default if /etc/sysconfig/system has TYPE=expert - -(done,pix)bug in XFdrake in install, cancel in choose Card do not close the window - -(done,pix)in XFdrake, testing should not overwrite /etc/X11/XF86Config - -(done,pix) hwiz and supermount and eject :( - -(done(replaced by msec's),pix) bug: usermod -G urpmi a not done (full install) - -(done,pix)perl and .ph's - -(done,pix) BUG bootp in network install sigsegv - -(done,pix) move the last done stuff before Xconfiguration if possible - -(done,pix)draksec is buggy, don't try security >= 4 - -(done,pix)install apmd on laptops?? (maybe ask emcweb@btinernet.com (see alix)) - -(done,pix)missing alias ll for root - -(done,pix)urpmi.addmedia: |gzip instead of doing it afterwards - -(done,pix)locale (and fonts?) buggy in case ramdisk is used - -(done,pix)rpmdrake: Installed packages not in hdlist should be there - -(done)in ftp install, locale not installed properly - -(done,pix)pcmcia.img does not handle hd/cdrom - -(done,pix)cyrillic font buggy in DrakX - -(done,fred)remove xfs user from kdm - -(done,pix)bug with 2 cdrom drives (.kdelnk to there for 1st drive) - -(done,pix(works))test ramdisk stage2 and romanian - -(done,pix)kfmrc - -(done,pix)on laptop, default to 1024x768 - -(done,pix)mkinitrd and deps - -(done,fred(removed the call))XFdrake and mousedrake freeze if lothar launches them - -(done,pix)crypto message - -(done,pix)test bug with lilo and windows (if not on mbr) - -(done,pix)removed icons come back later (kde desktop) - -(done,pix(was bug in upgrade reading old config)) - segfault in linuxconf (adapter 1 empty) - (test with the sysconfig sent) - -(done,fpons)bug: Lrosqu'on effectue une mise à jour et que /etc/lilo.conf -contient la variable « default » positionnée sur autre chose que -« linux » ou « windows », DrakX est incapable de générer LILO. - -(done,fpons)bug: GeForce and hd.img? - -(done,fpons)for upgrade in expert, give choice of packages to install - choosing packages available in upgrade? - -(done,pix)rpmdrake: pb uninstalling package with dependencies (rpmdrake is killed?!) (as root too) - -(done,pix)noatime option for ext2 fs on laptops (do not wake up the hd) - Do not update inode access times on this - file system (e.g, for faster access on the - news spool to speed up news servers). - -(done,pix)kde's icons: 28 horiz and 25 vert grid for big icons - -(done,pix)bug: DrakConf don't follow the charset -> add setlocale(LC_ALL, "") -(done,pix)for ko|ja|zh, gnome-terminal should point to rxvt (-CLE) -(done,pix)group cdrom in /etc/group (gid=22) -(done,pix)drakxtools should require urpmi -(done,pix)bug: gdm unset LANG -(done,pix) zip with automount -> ppa not autoloaded -(done,pix)when you set the kde icons to Large, maybe it'd be good to chown the .kderc -(done,pix)lilo in russian/japaneese is horrible -(ok,pix)test ide burners -(ok)test check bad blocks optional for mke2fs -(done,pix)hd install: no umount is done at the end of install :( - -just before release: -(done,pix)- mandrake_doc-xx, the symlink is no good in /usr/doc/mandrake as -(done,pix)- crypto dependencies to update -(done,pix)- update kudzu's pcitable -(done,pix)- update pcitable for 86C368 if 3.3.6 (and other S3 3D's) - ("ATI|3D Rage P/M Mobility AGP 2x" -> changed to Server:Mach64) - -(done,pix)with 2MB of video ram, chooses 8bpp instead of 16bpp - -(done,pix) replace - { device => "loop7", type => 0x83, size => ((cat_('/dos/lnx4win/size.txt'))[0]*2048), mntpoint => "/", isFormatted => 1, isMounted => 1 }, -by - { device => "loop7", type => 0x83, size => cat_('/dos/lnx4win/size.txt') * 2048, mntpoint => "/", isFormatted => 1, isMounted => 1 }, - -(done,fpons)in ftp install, bug with X server install with wu-ftpd 2.6 (see http://www.wu-ftpd.org/broken-clients.html) - -(done,pix)ask package installation languages (must be put in RPM_INSTALL_LANG) - -(done,pix)bug (by dadou): Si la partition racine est trop petite pour installer le système, un -message d'erreur apparaît pour signaler le problème (bien) mais on ne -peut en sortir. La seule solution est de redémarrer. - -(obsolete)bug when selecting compssUsers, do not deselect after (if u deselect) - -(done,pix)detect ide burners and then add hdX=ide-scsi to kernel cmdline - -(done,pix)urpmi: handle many args on cmd-line - -(done,pix)fix any // in path to ftp server otherwise windobe server bug :( - -(done,pix)diskdrake and auto partitioning, may have the last creation of partition rejected, -try to figure why? - -(done,pix)in chooseResolutions: display the graphic card found - -(done,pix)with pcmcia, need ONBOOT=no - -(fpons,done) XFree: handle by card options -eg: SIS6326 needs "no_bitblt" "no_bltimage" and 24bpp instead of 32bpp - -(done,pix) Xconfiguration: if "can't open fixed font", relaunch xfs. - -(obsolete) pb with dependencies ``missing'': icewm do not require XFree86 and so you can have icewm but no X server - -(obsolete) bug in ext2resizing (no sparse superbloc, don't finish properly) - -(done,pix,7.1)manage a lot of language (ergonomic issue as it already exists) - -(done,pix,7.1)tree for choosing things like timezone, monitors, graphic cards, modules, mice, keyboard? ... - -(done,pix,7.1)sound config, although very simple, no dedicated steps and only PCI (or maybe ISA-PNP if time left ?) - -(done,pix,7.1)partitioning, keyboard shortcut. - -(done,fpons,7.1)index/compress hdlist? (for multi-cd) -! for multi-cd live is mandatory, small transaction are mandatory too. - -(done,pix,7.1?)loopback partitions (even root one) - -(done,pix)in ok_cancel, focus has 3 states, should be 2 (ask dindinx) - -(done,pix,7.1)Generally improved package selection /ergonmic issue. -Tree -> CTree, ``all'' branch with all packages -show the value associated (100->a must, 90->great, 80->nice, ... 10->useless, 0->do not install) - -(done,pix)let diskdrake have dos/win partition automatically set up with mount point, -this will help loopback too. - -(done,pix,7.1)grub - -(done,pix,7.1)feature missing: cancel installation - -(obsolete) bug in diskdrake: can in strange cases create a primary partition at sector #0 - -(done,pix(partly, protection against bugging))bug in diskdrake: -in expert: blank, create hda5 at beginning, create hda6 at the end, create hda7 -in the middle, remove the first one. Result hda5 at the end and bug. - -(obsolete) have a better time estimation of the remaining time in install packages - -(done,dindinx+pix)ask_many_from_list can't keyboard scroll - -(done,pix,7.1)individual package selection: double click is tiring... - -(done,fpons,7.1) sparc ehancement, avoid V7+ machine target (div and mul not in v7 standard) - -(done,fpons,7.1)syslinux in graphical mode to be improved for heavily bogus BIOSes. - -(done,pix)missing feature in lilo configuration: can't give hda2 with /boot/vmlinuz if -already hda1 with /boot/vmlinuz - -(done,pix)in 640x480 install box is to small (cuz of 'Cancel' button beeing added) - -(done,pix)chooseGroup with individual alone - -(done)(7.1) rewrite crypto stuff -(done)crypto: add a cancel & progress bar while downloading -(done)error handling (like reading hdlist) -(done)(7.1)progression bar on crypto. - -(done, daouda&pix,7.1, other persons)rescue: -- small modification for stage1 to get the rescue stage2 -- create a stage2 with many tools (fdisk, bash...) -the rescue could be on another cd (if multi-cd) -! care must be taken about modules (if ide is in module...) - -(done,7.1)install in 800x600 -- need handling of both 640x480 (mostly for VGA16) and 800x600 - -(done,NEED 7.1) auto-install for corporate, very important (need consolidation). diff --git a/docs/comparisons b/docs/comparisons index 6d5f5c93d..ccd98f547 100644 --- a/docs/comparisons +++ b/docs/comparisons @@ -80,3 +80,227 @@ rpmsrate # perl -alpe '$F[4] =~ /(.*):(.*)/; $r = ($1 * 60 + $2) / $F[2]; s|\S+(\s+\S+)\s*$|sprintf("%.2f", $r) . "$1"|e;' # perl -ape '$r = $F[2] / $F[3]; s|\S+\s*$|sprintf "%.2f\n", $r|e;' + +9.0beta1 + +5 () 89 71 1:35 ext2 500M +3 X 240 231 3:41 ext2 500M +5 all 306 293 3:36 ext2 500M +4 all 808 731 6:48 ext2 1G +4 all 1433 1331 21:44 ext2 2G +4 X+kde 822 749 6:05 ext2 2G +4 X+gnome 369 319 5:58 ext2 2G + rpm df time time/rpm rpm/df +2006beta +celeron 360Mhz, 256MB, auto_install +6 - 106 225 1:46 ext3 788M 1.00 0.47 +5 X 365 440 4:19 ext2 3.2G 0.71 0.83 +5 X 385 417 5:15 ext2 3.2G 0.82 0.92 +4 X 415 489 05:26 ext2 3.2G 0.79 0.85 +4 X 436 511 06:05 ext2 788M 0.84 0.85 +4 X+KDE 709 829 08:39 ext2 3.2G 0.73 0.86 +4 X+KDE 709 829 09:01 ext2 3.2G 0.76 0.86 +4 X+KDE 709 934 11:01 ext3 3.2G 0.93 0.76 +4 X+KDE 709 934 10:37 ext3 3.2G 0.90 0.76 +4 X+KDE+GNO 763 888 11:06 ext2 3.2G 0.87 0.86 +4 def+GNO 1024 1126 12:41 ext2 3.2G 0.74 0.91 +4 def+GNO 1227 1130 13:52 ext2 3.2G 0.68 1.09 +4 default 1433 1536 18:26 ext2 3.2G 0.77 0.93 +4 def+GNO 1442 1633 17:58 ext2 3.2G 0.75 0.88 +2 all 2800 3200 47:56 ext2 4G 1.03 0.88 + + +redhat 7.3: +- do not halt the box when "halt" is used +- no sysreq +- kdm has gnome entry whereas gnome is not installed + => choosing gnome gives a flashing black screen and kdm reruns + +- repartition of packages on various CDs is crap + +- bootloader: handling of multiple disks is more powerful in redhat, but more +dangerous (proposed to everyone, but not proposed especially to people having +a dangerous combinaison) +- why still asking about lba32!! + +* anaconda 7.3 vs 7.3.92 + - skipddc option (locks some machines) ?? + maybe because it's done at the beginning of their install? + + - LVM + - lvm_dialog_gui.py + - Physical Extent 1MB 2MB 4MB ... 16GB + (vgcreate -s ${PhysicalExtentSize}k) + - see lvm_sanity_checks.txt, take them + - lvm on / (mkinitrd) + - handle upgrade when lvm on / + - vgcreate -An (ie --autobackup no) ?? + (also for lvcreate vgchange lvremove + - see clampPVSize in lvm.py + + - RAID + - Number of spares ?? + - mkraid --dangerous-no-resync ?? + + - progress bar in ext2 formatting + + - ctrl-alt-suppr during install => reboots + + - user names: the regexp is [a-zA-Z][^\0-\x20:,\n]* or [A-Za-z][A-Za-z0-9]{0,7} (depending on wether you're in text mode or graphic mode :) + - check the user name created is not a system one (see systemUsers) + + - SMB authentification + - cloneDrive ? + + - edd dropped (was to detect lba32 capability, which was dumb) + + - reconfig type of installed removed (was something between install & upgrade) + + - ddcprobe code removed -> moved to kudzu + changes: sigprocmask and movl added around lrmi_vm86 + + - $ENV{GDK_USE_XFT} = 0 + +* kudzu 0.99.52 vs 0.99.55 + - blacklisting modules.pcimap e100 and bcm5700 + +* hwdata 0.14 vs 0.32 + - dropped XFree86 3.3.6 support + + - upgradelist: list of (old_module => new_module) for upgrades + (a simpler way would be to drop entries in modules.conf that concern + obsolete (and not available anymore) modules, relying on auto-detection to + add the new one) + + - CardMonitorCombos (for laptops) + +redhat 8.0: + + (legend: + pros - cons / notice) + + Install steps difference + + firewall wizard + + md5sum check when booting install + - no upgrade packages installation during install + - no services configuration (chkconfig) + - no printer configuration + - no autologin + - no real small installation + - no small packages (groff-for-man, perl-base...) + / still propose non-MD5 or non-shadow passwords + / post install tool (firstconfig) + + General install behaviour, eye-candiness + + package selection a la Windows + + in language selection languages displayed in native language + + candy timezone selection + + help uses bold/italic/big-font + - no one CD install + / not using fb at install + / python + gtk2 vs perl + gtk + / ask many things before doing anything (esp. delayed partitioning, swap not available when selecting packages!(?)) + - more width-hard-coded dialog boxes (harder for translations) + / use a loopback file from the CD then copied on system + + Partitioning + - no diskdruid after install + - no partitioning wizard + - no devfs + - no xfs (but now has reiserfs/jfs) + - no loopback crypted fs + - no file swap (?) + - no supermount + + LABELed entries in fstab + + progress bar while formatting + + Bootloader + + bootloader configuration less awkward + - no automatic handling of bios ordering with many harddrives + - propose to manually change bios ordering even with one harddrive + - LBA32 checkbox + / defaults to grub + + Network + - awkward question apropos hostname when using DHCP + - no default choice for netmask/gateway/DNS based on IP + + XFree + - no wacom configuration + - no graphic card multi-head configuration + - no ATI tvout configuration + - no prompt for logout after changing X config + - VideoRam prompted for everybody + / no XFree3 + / no Utah GLX + / load module "fbdevhw" "record", but not "v4l" + / always load module "glx" and "dri" + + Keyboard + - many non useful keyboard entries (eg: latin0) + - no way to choose the toggle key to choose between latin/non-latin keyboard + - no loadkeys done during install for console + + Mouse + - no way to test mouse choice + - mouse choices include many non-useful choices, badly sorted + (Intellimouse must be sought in Microsoft whereas it's used by many others) + + Multimedia + - no bttv configuration (including webcams) + - missing audio modules (alsa, audigy...) + +* anaconda 8.0 (rel. 4) vs 8.0.92 + - use vte instead of gnome.zvt + - add alpha (axp) partitioning code + - remove label "nofb" and options "devfs=nomount ramdisk_size=9216" from syslinux.cfg + - edd (ddc probe) moved to kudzu + - add "-Odir_index" option to ext3 tunefs + - screenshoting in directory /root/anaconda-screenshots/ instead of using exported display + - assembler code change in cpuid, smp.c + - there is some code to read the "raid superblock" (see doGetRaidSuperblock in isys/isys.c) + - new code for choosing to upgrade or not + - hack to remove /var/lib/rpm/__db.00[123] (with comment "make sure that the rpmdb doesn't have stale locks :/") + +* anaconda 8.0.92 vs 8.0.93 (rel. 0.20030108205243) + - drop xmode (bring up text mode in a remote xterm) + - code available to check the ability to do a mkbootdisk + (check size of vmlinuz + initrd, check size of floppy) + - drop "-Odir_index" option to ext3 tunefs + (with comment "add back -Odir_index when htree is safe") + - waitForLink added to loader2/net.c using added ethtool thingy (get_ethtool_link_status, get_link_status) + - OS390 fdasd & z/IPL changes + - for kickstart, new option "--ignoremissing", (there were --ignoredeps and --resolvedeps) + - /usr/kerberos/lib in LD_LIBRARY_PATH + - these are symlinks so you cant make them mount points + otherexcept = ['/var/mail', '/usr/bin/X11', '/usr/lib/X11', '/usr/tmp'] + + elif self.mountpoint in otherexcept: + return _("The mount point %s cannot be used. It must " + "be a symbolic link for proper system " + "operation. Please select a different " + "mount point.") % (self.mountpoint,) + + +* hwdata 0.47 (redhat 8.0) vs 0.62 (redhat 8.1 beta1 phoebe) + - pcitable & upgradelist + - replace eepro100 with e100 + - switch 0x1106 0x3059 "via82cxxx_audio" to "unknown" + - Cards + - remove most swcursor with comment: + # mharris - Nov 23, 2002 - Commented out the swcursor option, if it is still + # needed, then lets disable it right in the driver completely, or possibly + # fix it. + - using driver "nv" for GeForce4 and Quadro4 with comment: + # mharris - Nov 23, 2002 - enabling "nv" driver for GeForce 4 and Quadro 4 as + # CVS XFree86 support them now in 4.2.99.2 + - special options "externDisp" and "internDisp" for NeoMagic cards + together with CHIPSET + +* kudzu 0.99.69 (redhat 8.0) vs 0.99.83 (redhat 8.1 beta1 phoebe) + - don't read eepro100 entries from the pcitable + - handle compressed modules + - many changes in PS/2 mouse detection, and handle "intellips/2" mouse + - changes in PnP serial modem detection + - use "udf,iso9660" option for cdrom entry in fstab + (note that comma separated choice of filesystems *is* allowed, though not + documented in fstab(5)) diff --git a/docs/diskdrake.TODO b/docs/diskdrake.TODO deleted file mode 100644 index e6f2da038..000000000 --- a/docs/diskdrake.TODO +++ /dev/null @@ -1,23 +0,0 @@ -- test what windows can handle (the number of partitions) -- better keyboard focus handling -- end sector in Create -- add warnings for scsi drives if you create more than sdx15 -- the information put in save/restore partitions must be cleaned -(remove mounted/formatted/..., also remove the Data::Dumper dependency) -- test, test, test -- do not allow swap partitions above 2Gigs -- wanting the first partition to be extended is not used -- maybe warn if a mounted partition change of dev number -- text version -- better error handling (what to do if we find a bad partition table?) -- display the information about the correspondance color2type -- handle the partition labels (missing information here) -- add comments in the code -- add documentation -- handle the `luke' case (main extended partition must be extended) -- ability to batch actions (like chained moves) -- add a verification after fdiskReadPartitionTable that the start_cyl, -end_cyl... do correspond to start and start+size. For the moment, this -information is just discarded :( -This verif can't be done in fdiskReadPartitionTable as start is relative in -extended partitions diff --git a/docs/drakfont/drakfont.tex b/docs/drakfont/drakfont.tex index bbc936e5b..035adf3a9 100644 --- a/docs/drakfont/drakfont.tex +++ b/docs/drakfont/drakfont.tex @@ -48,7 +48,7 @@ %\end{center} %\end{figure} -\author{Dupont Sebastien \\ sdupont@mandrakesoft.com} +\author{Dupont Sebastien \\ sdupont} \date{05/10/2001} \pagestyle{myheadings} \markright{\scriptsize \trtitle} diff --git a/docs/draknet_advanced_doc.txt b/docs/draknet_advanced_doc.txt deleted file mode 100644 index a0c0c63e0..000000000 --- a/docs/draknet_advanced_doc.txt +++ /dev/null @@ -1,165 +0,0 @@ -This document details the entry points you can call without the DrakX graohical -toolkit. First, the general variables you will encounter further. If you don't -know wht a variable is, look here. Any additional locally variables are -commented 'in place' - ------------------------------- -Special types (in upper cases) ------------------------------- - DB_FILE : file storing the ISDN ISP database. see share/isdndb.txt : file of lines in 'Unlisted - edit manually' or /^(.*)\|(.*)\|(.*)=>([0-9]*)=>(.*)=>(\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3})=>(\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3})$/ where $1=Land $2=City $3=ISP_name $4=phone_number $5=hostname $6=dns1 $7=dns2 - ---------------------------------------------------------------------------------------- -Summary of common variables used (local variables are described in the function itself) ---------------------------------------------------------------------------------------- -notation : keys : description : type : format (regexp or enumeration. `...' means it's not exhaustive - $prefix : prefix path (empty in post-install) : string : path - $isLaptop : flag for laptop : boolean or int : guess - $isdn : hash table containing isdn infos - $isdn->{login} : cnx login : string - $isdn->{passwd} : cnx passwd : string - $isdn->{phone_in} : user phone : /^[0-9]*$/ - $isdn->{phone_out} : ISP phone : /^[0-9]*$/ - $isdn->{dialing_mode} : dialing mode : "auto" or "manual" - $isdn->{driver} : driver used for the card : "hisax" or "b1pci" or ... - $isdn->{type} : type of card, used for the driver, see netconnect_consts : integer : /^[1-22]|[24-37]$/ - $isdn->{irq} : irq of the ISA card : integer | - $isdn->{mem} : mem of the ISA card : string | - $isdn->{io} : io of the ISA card : string | see netconnect_consts for examples. - $isdn->{io0} : io0 of the ISA card : string | - $isdn->{io1} : i01 of the ISA card : string | - $isdn->{idl} : amount of time after the cnx times out in secs : int - $isdn->{user_name} : not used anymore. Not explicit. It represented the name of the connexion. - $isdn->{card_type} : card type : string : "isa" or "pci" or "pcmcia" - $isdn->{protocol} : cnx protocol : int : 1|2|3 : 1 for old german specific (not used anymore), 2 for europe, 3 for rest of the world - $isdn->{id} : card id. Associated with vendor, identify strictly the card. see pcitable : integer - $isdn->{description} : card description from pcitable : string - $isdn->{vendor} : card vendor : integer - $isdn->{passwd2} : passwd verification : string - $modem : hash table containing modem infos - $modem->{device} : device of the modem : string : /ttyS[0-9]/ - $adsl : hash table containing modem infos - $adsl->{login} : cnx login : string - $adsl->{passwd} : cnx passwd : string - $adsl->{atboot} : - $netc : hash table containing system-wide networking infos (maybe not true, correct this) : - $netc->{NET_DEVICE} - $netc->{dnsServer2} - $netc->{dnsServer3} - $netc->{DOMAINNAME2} - $netc->{NET_INTERFACE} is set to "ppp0" - $in : interactive object - ------------- -Entry points ------------- - -isdn_write_config_backend : write isdn info, only for ippp0 -> ask_connect_now -input : - $prefix - $isdn -$isdn input: - $isdn->{login} $isdn->{passwd} $isdn->{phone_in} $isdn->{phone_out} $isdn->{dialing_mode} - $isdn->{driver} $isdn->{type} $isdn->{irq} $isdn->{mem} $isdn->{io} $isdn->{io0} $isdn->{io1} - -write_secret_backend : write login and passwd into /etc/ppp/{chap, pap}-secrets. Replace old passwd only if same login -input : - $a : login : string : /^.*$/ - $b : passwd : string : /^.*$/ - -connect_backend : launch the cnx script -input : $prefix - -connect_backend : launch the cnx script -input : $prefix - -read_providers_backend : build the tree of isdn ISP -input : - $file : 1st location of the file : ISDN_DB_FILE - $file2 : 2nd location of the file : ISDN_DB_FILE -output : the list of ISP : array of strings : array of /^(.*)\|(.*)\|(.*)$/ where $1=Land $2=City $3=ISP_name - -get_info_isdn_backend : fills the infos from the line of the tree returned into $isdn and $netc -input : - $isdn - $netc - $name : the line choosen in the tree of ISP : string : /^(.*)\|(.*)\|(.*)$/ with $1=Land $2=City $3=ISP_name - $file : 1st location of the file : ISDN_DB_FILE - $file2 : 2nd location of the file : ISDN_DB_FILE -$isdn ouput - $isdn->{user_name}, $isdn->{phone_out}, $netc->{DOMAINNAME2}, $netc->{dnsServer2}, $netc->{dnsServer3}, -$netc output - $netc->{DOMAINNAME2}, $netc->{dnsServer2}, $netc->{dnsServer3} - -isdn_detect_backend : detects isdn pci card and fills the infos in $isdn : only detects one card -input - $isdn -$isdn output: - $isdn->{description} $isdn->{vendor} $isdn->{id} $isdn->{driver} $isdn->{card_type} $isdn->{type} - -isdn_get_list : return isdn cards descriptions list. This function is not use internally. -output : descriptions : list of strings - -isdn_get_info : return isdn card infos. This function is not use internally. -input : the description of the card (see isdn_get_list) -output : a reference on the decription of the card. : ref on a hash(description,type,irq,mem,io,io0,io1card,) - -conf_network_card_backend : configure the network cards and return the list of them, or configure one specified interface : WARNING, you have to setup the ethernet cards, by calling setup_thiskind($in, 'net', !$::expert, 1) or setup_thiskind_backend before calling this function. Basically, you call this function in 2 times. -input - $prefix - $netc - $intf - $type : type of interface, must be given if $interface is : string : "static" or "dhcp" - $interface : facultative, if given, set this interface and return it in a proper form. If not, return @all_cards - $ipadr : facultative, ip address of the interface : string - $netadr : facultative, netaddress of the interface : string -when $interface is given, informations are written in $intf and $netc. If not, @all_cards is returned. -$intf output: $device is the result of - $intf->{$device}->{DEVICE} : which device is concerned : $device is the result of $interface =~ /(eth[0-9]+)/; my $device = $1;; - $intf->{$device}->{BOOTPROTO} : $type - $intf->{$device}->{NETMASK} : '255.255.255.0' - $intf->{$device}->{NETWORK} : $netadr - $intf->{$device}->{ONBOOT} : "yes" -$netc output: - $netc->{nb_cards} : nb of ethernet cards - $netc->{NET_DEVICE} : this is used to indicate that this eth card is used to connect to internet : $device -output: - $all_cards : a list of a list ( (eth1, module1), ... , (ethn, modulen)). Pass the ethx as $interface in further call. - $device : only returned in case $interface was given it's $interface, but filtered by /eth[0-9+]/ : string : /eth[0-9+]/ - -adsl_conf_backend : write adsl configuration -input : - $prefix - $adsl - $netc - $adsl_type : type of cnx : string : "pptp" or "pppoe" -$adsl input: - $adsl->{login}, $adsl->{passwd}, $adsl->{atboot} -$netc input: - $netc->{NET_DEVICE} - $netc->{dnsServer2} - $netc->{dnsServer3} - $netc->{DOMAINNAME2} -$netc output: - $netc->{NET_INTERFACE} is set to "ppp0" - -modem_detect_backend : detects modem on serial ports and fills the infos in $modem : detects only one card -input - $modem - $mouse : facultative, hash containing device to exclude not to test mouse port : ( device => /ttyS[0-9]/ ) -output: - $modem->{device} : device where the modem were detected - -get_net_device : return the device choosen for the net cnx -no input -output : name of the internet device. - -read_net_conf : read the information stored in $prefix/etc/sysconfig/draknet and $prefix/etc/sysconfig/draknet.`type` -input: - $prefix - $netcnx - $netc - -set_net_conf : set the information from netcnx in $prefix/etc/sysconfig/draknet and $prefix/etc/sysconfig/draknet.`type` - $prefix - $netcnx - $netc : useless! REMOVE ME diff --git a/docs/interactive/ask_from b/docs/interactive/ask_from new file mode 100755 index 000000000..dad69247e --- /dev/null +++ b/docs/interactive/ask_from @@ -0,0 +1,29 @@ +#!/usr/bin/perl +# Yves Duret <yduret at mandrakesoft.com> +# license: GPL + +use lib qw(/usr/lib/libDrakX); +use interactive; + +my $irq=1; +my $login; +my $login2="editable"; +my $check; +my $range=57; + +my $in = 'interactive'->vnew(undef, 'default'); + +$in->ask_from("window title - ask_from", + "message\nexamples of utilisation of ask_from", + [ + { label => "enter scalar", val => \$irq }, + { label => "combo (type=>combo optionnal)", val => \$login, list => ['Netherlands', 'France', 'Belgium', 'Italy', 'UK'], type => 'combo'}, + { label => "choose from list editable and sorted", val => \$login2, list => ['Netherlands', 'France', 'Belgium', 'Italy', 'UK'], not_edit => 0, sort => 1}, + { label => "check box", val => \$check, type => "bool", text => "text" }, + { label => "range", val => \$range, type => 'range', min => 0, max => 100 }, + ], + complete => sub { print "complete\n";print "$irq\n$login\n$range\n"; }, +# focus_out => sub { print "focus_out\n"}, +# changed => sub { print "changed\n"; }, + ) or $in->exit(0); +$in->exit(0); diff --git a/docs/interactive/ask_from_list b/docs/interactive/ask_from_list new file mode 100755 index 000000000..63c0ee996 --- /dev/null +++ b/docs/interactive/ask_from_list @@ -0,0 +1,27 @@ +#!/usr/bin/perl +# Yves Duret <yduret at mandrakesoft.com> +# license: GPL + +use lib qw(/usr/lib/libDrakX); +use common; +use interactive; + +my %l = ( + 0 => "Welcome To Crackers", + 1 => "Poor", + 2 => "Low", + 3 => "Medium", + 4 => "High", + 5 => "Paranoid", + ); + +my $in = 'interactive'->vnew(undef, 'default'); + +my $level = $in->ask_from_list("window title - ask_from_list", + "radio button\nexamples of utilisation of ask_from_list", + [ values %l ], $l{2} + ) or $in->exit(0); + +print "$level\n"; +$in->exit(0); + diff --git a/docs/interactive/ask_from_listf b/docs/interactive/ask_from_listf new file mode 100755 index 000000000..077540b49 --- /dev/null +++ b/docs/interactive/ask_from_listf @@ -0,0 +1,27 @@ +#!/usr/bin/perl +# Yves Duret <yduret at mandrakesoft.com> +# license: GPL + +use lib qw(/usr/lib/libDrakX); +use interactive; +use Data::Dumper; + +my $in = 'interactive'->vnew(undef, 'default'); + +my @m=( + { description => "dhcpcd", + c => 1}, + { description => "dhcpxd", + c => 3}, + { description => "dhcp-client", + c => 4}, + ); +my $f = $in->ask_from_listf(_("ask_from_listf"), + _("Which dhcp client do you want to use?\nDefault is dhcpcd"), + sub { $_[0]{description} }, + \@m ); + +print Data::Dumper->Dump([$f],['f']) . "\n"; + +$in->exit(0); + diff --git a/docs/interactive/ask_from_treelist b/docs/interactive/ask_from_treelist new file mode 100755 index 000000000..ade7141d4 --- /dev/null +++ b/docs/interactive/ask_from_treelist @@ -0,0 +1,27 @@ +#!/usr/bin/perl +# Yves Duret <yduret at mandrakesoft.com> +# license: GPL + +use lib qw(/usr/lib/libDrakX); +use common; +use interactive; + +my $in = 'interactive'->vnew(undef, 'default'); +my $foo = $in->ask_from_treelist("window title - ask_from_treelist", + "message\nexamples of utilisation of ask_from_treelist", + '|', + ['Custom', + 'Other|Unlisted', + 'Matrox|Millennium II=>Matrox Millennium II', + 'Matrox|Millennium G200=>Matrox Millennium G200', + 'Matrox|Millennium G400=>Matrox Millennium G400', + 'Matrox|Millennium G450=>Matrox Millennium G450', + 'Matrox|Millennium G550=>Matrox Millennium G550', + 'Sun|FFB 67MHz Creator=>Sun FFB 67MHz Creator', + 'Sun|FFB 67MHz Creator 3D=>Sun FFB 67MHz Creator 3D', + 'Sun|FFB 75MHz Creator 3D=>Sun FFB 75MHz Creator 3D', + ], + 'Custom' + ) or $in->exit(0); +print "$foo\n"; +$in->exit(0); diff --git a/docs/interactive/wait_message b/docs/interactive/wait_message new file mode 100755 index 000000000..0caec4471 --- /dev/null +++ b/docs/interactive/wait_message @@ -0,0 +1,13 @@ +#!/usr/bin/perl +# Yves Duret <yduret at mandrakesoft.com> +# license: GPL + +use lib qw(/usr/lib/libDrakX); +use interactive; + +my $in = 'interactive'->vnew(undef, 'default'); +my $wait = $in->wait_message('wainting title', _("Moving files to the new partition")); +sleep(3); +$wait->set(_("Removing")); +sleep(3); +$in->exit(0); diff --git a/docs/ka_method/Makefile b/docs/ka_method/Makefile new file mode 100644 index 000000000..346475433 --- /dev/null +++ b/docs/ka_method/Makefile @@ -0,0 +1,59 @@ +#--------- HTML TARGET --------- +WWW_PATH=html/ + +#-------- PDF TARGET -------------- +DSL=/usr/share/sgml/docbook/utils-0.6.??/docbook-utils.dsl +#CATALOG=/etc/sgml/xml-docbook-4.1.2.cat +CATALOG=/etc/sgml/catalog + +#-------- ALL TARGETS -------------- +XSL_FILE=oneduplication.xsl +BASE=doc-duplication +XML_FILE=${BASE}.xml + +#----------- ---------------- +DSSSL_JADETEX=/usr/share/sgml/docbook/dsssl-stylesheets/print/docbook.dsl +XSL_JADETEX=/usr/share/sgml/docbook/xsl-stylesheets/xhtml/docbook.xsl +JADE=openjade + +#------------ MAIN ---------------- +all: clean prepare html_doc + +prepare: + mkdir -p ${WWW_PATH} + rm -rf ${WWW_PATH}*.html + +clean: + rm -rf *log + rm -rf ${BASE}.pdf ${BASE}.tex ${BASE}.fot + rm -rf *~ + rm -rf *.aux + rm -rf *.out + rm -rf *.pdf +pdf_doc: + db2pdf -c ${CATALOG} -d ${DSL} ${XML_FILE} 2>&1 + +pdf_noprint: + make clean + DSSSL_JADETEX=docbook-jadetex.dsssl make duplication.pdf DSSSL_JADETEX=docbook-jadetex.dsssl + +html_doc: + xsltproc ${XSL_FILE} ${XML_FILE} + mv -f index.html ${WWW_PATH}/duplication.html + cp -v styleguibo.css ${WWW_PATH} + +%.tex: %.xml $(DSSSL_JADETEX) + $(JADE) -t tex -d $(DSSSL_JADETEX) -c /usr/share/sgml/openjade/catalog \ + -o $@ /usr/share/sgml/openjade/pubtext/xml.dcl $< + +%.pdf %.out %.aux %.log: %.tex + if [ -e prior.aux ]; then cp -pf prior.aux pprior.aux; fi + f=$(shell basename $< .tex).aux; if [ -e $$f ]; then cp -pf $$f prior.aux; fi + -pdfjadetex $< > pdfjadetex.log + if ! cmp $(shell basename $< .tex).aux prior.aux > /dev/null 2>&1 && \ + ! cmp $(shell basename $< .tex).aux pprior.aux > /dev/null 2>&1 && \ + expr $(MAKELEVEL) '<' 4 > /dev/null; then \ + rm -f $@; \ + echo "Found undefined references, compiling again..."; \ + $(MAKE) $@ DSSSL_JADETEX=docbook-jadetex.dsssl; \ + fi diff --git a/docs/ka_method/doc-duplication.xml b/docs/ka_method/doc-duplication.xml new file mode 100644 index 000000000..8196835fb --- /dev/null +++ b/docs/ka_method/doc-duplication.xml @@ -0,0 +1,1487 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> + <article lang="en"> + <title>Clone a node/computer using KA method</title> + <sect1><title>CLONING WILL ERASE ALL CLIENT NODES DATA !</title><para>!! USE WITH CARE !! </para></sect1> + <sect1> + <title>Clone a computer over the network</title> + <para> + Goal of duplication is to easily deploy a computer over network without taking care of numbers of computer. In this documentation, we call golden node the node we want to clone. We can duplicate SCSI or IDE hard drive, and duplication support multiple filesystem (reiserfs, ext2, ext3, ext4, xfs, jfs). + This method came from a very old project called CLIC, and was used under IGGI project, all Mandrake Clustering products, and now it is used under XtreemOS project. Now it should be available in 2010 spring, and all futur product. + </para> + <para>WARNING: all data on client nodes will be ERASED ! We duplicate partitions of HDD's golden node, and the process will do an fdisk command on the client node, so ALL YOUR DATA will be erased on client nodes.</para> + <sect2> + <title>KA method</title> + <para> + With KA method you can quickly duplicate a node using a <emphasis role="bold">desc</emphasis> + file describing partitions. KA method only duplicate data on partitions, so if you have 80go HDD disk, and + only 10go on it, KA only duplicates 10go, and not the whole disk. KA method doesn't not support RAID software. + </para> + <para> + Drawbacks: + </para> + <para> + <itemizedlist> + <listitem><para>KA method doesn't support RAID software (use dolly to do that)</para></listitem> + <listitem><para>all data on client nodes are erased</para></listitem> + <listitem><para>you need a PXE, DHDCP and TFTP server</para></listitem> + <listitem><para>you must re-create same partition table as the golden node (even if size can differ)</para></listitem> + <listitem><para>even if it has been tested, it's still an experimental method</para></listitem> + <listitem><para>cloning script are old, and need a full rewrite</para></listitem> + <listitem><para>now it's only works with the Mageia installer (need to patch it to support a KA method)</para></listitem> + <listitem><para>if a node crash while doing a duplication, the duplication process stop (or became very unstable)</para></listitem> + <listitem><para>using fdisk to erase and re-format the HDD is not a good way to proceed</para></listitem> + <listitem><para>UUID support is not really done (fstab use old /dec/sdX)</para></listitem> + <listitem><para>you can only clone Linux filesystems (if you want to duplicate another kinf of FS, it's up to you to modify the scripts)</para></listitem> + <listitem><para>of course various other things !</para></listitem> + </itemizedlist> + </para> + </sect2> + <sect2> + <title>HOW it works</title> + <sect3> + <title>Steps</title> + <para> + The clone process works in three steps + </para> + <itemizedlist> + <listitem><para><emphasis role="bold">PXE boot to retrieve stage1</emphasis>: the computer boot on PXE mode, retrieve <emphasis role="bold">vmlinuz</emphasis> and an <emphasis role="bold">initrd</emphasis> image. The computer is in <emphasis role="bold">stage1</emphasis> mode, and is able to get the stage2 throug KA. Network is up.</para></listitem> + <listitem><para><emphasis role="bold">get stage2</emphasis>: the computer gets the stage2 with the KA method. The <emphasis role="bold">stage2</emphasis> contains all necessary tools to recognize your hardware (the most important things is to detect your HDD and your network card), and all necessary tools/scripts to finalize the cloning process.</para></listitem> + <listitem><para><emphasis role="bold">Duplication process</emphasis>: the computer auto-probes needed modules to be able to access the HDD. A basic log server is launched on the client node to be able to run command and get status of the KA duplication process. The computer reconfigure the modprobe.conf and restore the booloader (grub or lilo)</para></listitem> + </itemizedlist> + </sect3> + <sect3> + <title>Needed files</title> + <para> + All needed files are available in Mageia cooker. + </para> + <para> + <itemizedlist> + <listitem><para><emphasis role="bold">install/stage2/rescue.sqfs</emphasis>: this is the stage2 file with all needed files to detect and probe modules, and launch the third step of the duplication process. This file will be used on the golden node.</para></listitem> + <listitem><para><emphasis role="bold">isolinux/alt0/vmlinuz</emphasis>: linux kernel, needed in the <emphasis role="bold">/var/lib/tftpboot/X86PC/linux/images/</emphasis> directory of the PXE server</para></listitem> + <listitem><para><emphasis role="bold">isolinux/alt0/all.rdz</emphasis>: stage1 and all needed modules and tools.</para></listitem> + </itemizedlist> + </para> + </sect3> + </sect2> + <sect2> + <title>Step 1: PXE, TFTP, DHCPD services</title> + <para> + To easily clone a computer node, we use PXE technology to boot a <emphasis role="bold">kernel</emphasis>, and an <emphasis role="bold">initrd</emphasis> image wich contains all needed modules for network and media storage. Documentation about PXE can be found here: <ulink url="http://people.mandriva.com/~aginies/doc/pxe/">PXE doc</ulink>. Please, keep in mind setting such services can <emphasis role="bold">DISTURB</emphasis> your current network architecture. + </para> + <sect3> + <title>PXE parameters on server</title> + <para> + Mageia installer supports various methods to install a computer. With PXE configuration file you can specify wich method you want to use to install your node, or add a specific option at boot prompt. Edit your default PXE configuration file to add your custom entry (<emphasis role="bold">/var/lib/tftpboot/X86PC/linux/pxelinux.cfg/default</emphasis>). + </para> + <para> + <screen> +PROMPT 1 +DEFAULT local +DISPLAY messages +TIMEOUT 50 +F1 help.txt + +label local + LOCALBOOT 0 + +label kamethod + KERNEL images/vmlinuz + APPEND initrd=images/all.rdz ramdisk_size=64000 vga=788 \ + automatic=method:ka,interface:eth0,network:dhcp root=/dev/ram3 rw kamethod</screen> + </para> + <para> + At boot prompt no you can boot: + </para> + <para> + <itemizedlist> + <listitem><para><emphasis role="bold">DEFAULT local</emphasis>: default boot will be local one, change it with the name of a <emphasis role="bold">LABEL</emphasis></para></listitem> + <listitem><para><emphasis role="bold">local</emphasis>: boot local</para></listitem> + <listitem><para><emphasis role="bold">kamethod</emphasis>: automatic mode, get stage2 through <emphasis role="bold">KA</emphasis>. Network interface is set to eth0. Auto setup the network with DHCP, and use the KA technology to launch the replication method.</para></listitem> + </itemizedlist> + </para> + </sect3> + <sect3> + <title>TFTP server</title> + <para> + TFTP server should be activated in <emphasis role="bold">/etc/xinetd.d/tftp</emphasis> file, and the <emphasis role="bold">xinetd</emphasis> service started. + </para> + <para> + <screen> +service tftp +{ + disable= no + socket_type= dgram + protocol= udp + wait= yes + user= root + server= /usr/sbin/in.tftpd + server_args = -s /var/lib/tftpboot + per_source= 11 + cps= 100 2 + flags= IPv4 +}</screen> + </para> + </sect3> + <sect3> + <title>PXE configuration</title> + <para> +<programlisting><![CDATA[ +# which interface to use +interface=eth0 +default_address=IPADDR_PXE + +# the multicast ip address to listen on +multicast_address=224.0.1.2 + +# mtftp info +mtftp_address=IPADDR_TFTP +mtftp_client_port=1758 +mtftp_server_port=1759 + +# the port to listen on +listen_port=4011 + +# enable multicast? +use_multicast=1 + +# enable broadcast? +use_broadcast=0 + +# user prompt +prompt=Press F8 to view menu ... +prompt_timeout=2 + +# what services to provide, priority in ordering +# CSA = Client System Architecture +# service=<CSA>,<min layer>,<max layer>,<basename>,<menu entry> +service=X86PC,0,2,linux,Mageia x86 +service=IA64PC,0,2,linux,Mageia IA64 +service=X86PC,0,0,local,Local boot + +# tftpd base dir +tftpdbase=/ + +# domain=guibland.com +domain= +]]></programlisting> + </para> + </sect3> + <sect3> + <title>DHCPD configuration</title> + <para> + IE of an <emphasis role="bold">/etc/dhcpd.conf</emphasis> configuration file. Change <emphasis role="bold">IPADDR_TFTP</emphasis> with the IP address of the TFTP serrver, and the <emphasis role="bold">NET</emphasis> value. Don't forget to adjust the <emphasis role="bold">domain-name</emphasis> and the <emphasis role="bold">domain-name-servers</emphasis>. + </para> + <para> + <screen> +ddns-update-style none; +allow booting; +allow bootp; + +authoritative; + +# Definition of PXE-specific options +# Code 1: Multicast IP address of bootfile +# Code 2: UDP port that client should monitor for MTFTP responses +# Code 3: UDP port that MTFTP servers are using to listen for MTFTP requests +# Code 4: Number of secondes a client must listen for activity before trying +# to start a new MTFTP transfer +# Code 5: Number of secondes a client must listen before trying to restart +# a MTFTP transfer + +# define Option for the PXE class +option space PXE; +option PXE.mtftp-ip code 1 = ip-address; +option PXE.mtftp-cport code 2 = unsigned integer 16; +option PXE.mtftp-sport code 3 = unsigned integer 16; +option PXE.mtftp-tmout code 4 = unsigned integer 8; +option PXE.mtftp-delay code 5 = unsigned integer 8; +option PXE.discovery-control code 6 = unsigned integer 8; +option PXE.discovery-mcast-addr code 7 = ip-address; + +#Define options for pxelinux +option space pxelinux; +option pxelinux.magic code 208 = string; +option pxelinux.configfile code 209 = text; +option pxelinux.pathprefix code 210 = text; +option pxelinux.reboottime code 211 = unsigned integer 32; +site-option-space "pxelinux"; + +option pxelinux.magic f1:00:74:7e; +option pxelinux.reboottime 30; + +#Class that determine the options for Etherboot 5.x requests +class "Etherboot" { +#if The vendor-class-identifier equal Etherboot-5.0 +match if substring (option vendor-class-identifier, 0, 13) = "Etherboot-5.0"; +# filename define the file retrieve by the client, there nbgrub +# our tftp is chrooted so is just the path to the file +filename "/etherboot/nbgrub"; +#Used by etherboot to detect a valid pxe dhcp server +option vendor-encapsulated-options 3c:09:45:74:68:65:72:62:6f:6f:74:ff; +# Set the "vendor-class-identifier" field to "PXEClient" in dhcp answer +# if this field is not set the pxe client will ignore the answer ! +option vendor-class-identifier "Etherboot-5.0"; +vendor-option-space PXE; +option PXE.mtftp-ip 0.0.0.0; +# IP of you TFTP server +next-server IPADDR_TFTP; +} + +# create the Class PXE +class "PXE" { +# if the "vendor-class-identifier" is set to "PXEClient" in the client dhcp request +match if substring(option vendor-class-identifier, 0, 9) = "PXEClient"; +filename "/X86PC/linux/linux.0"; +option vendor-class-identifier "PXEClient"; +vendor-option-space PXE; +option PXE.mtftp-ip 0.0.0.0; +next-server IPADDR_TFTP; +} + +#host node20 { +# hardware ethernet 00:40:CA:8C:B6:E9; +# fixed-address node20; +#} + +subnet NET.0 netmask 255.255.255.0 { + option subnet-mask 255.255.255.0; + option routers IPADDR_GW; + default-lease-time 288000; + max-lease-time 864000; + option domain-name "guibland.com"; + option domain-name-servers IPADDR_DNS; + next-server IPADDR_TFTP; + pool { + range NET.30 NET.40; + } +}</screen> + </para> + </sect3> + </sect2> + </sect1> + + <sect1> + <title>Setup a node as a golden node</title> + <sect2> + <title>The rescue.sqfs file</title> + <para> + You need the rescue disk (wich contains the <emphasis role="bold">/ka</emphasis> directory), + Just extract this file, and copy all directory in <emphasis role="bold">/mnt/ka</emphasis>. + </para> + <para> + <screen> +[root@guibpiv ~]# mkdir /mnt/ka +[root@guibpiv ~]# cd /mnt/ka/ +[root@guibpiv ka]# unsquashfs rescue.sqfs +[root@guibpiv ka]# mv squashfs-root/* . +[root@guibpiv ka]# ls +bin/ dev/ etc/ ka/ lib/ modules/ proc/ sbin/ squashfs-root/ tmp/ usr/ var/ +</screen> + </para> + <para> + Go in the <emphasis role="bold">/mnt/ka/ka</emphasis> directory, and see all new files available. All those files are needed to do a <emphasis role="bold">KA</emphasis> duplication process. We will explain now the rule of each of them. You can modify all them, those files will be copied in the directory <emphasis role="bold">/tmp/stage2</emphasis> of the client node of the duplication process (second step). + </para> + <sect3> + <title>ka-d.sh</title> + <para> + This is the master script to declare a node as a golden node. This script takes a lot of arguments. This script should be run + on the host wich have the <emphasis role="bold">/mnt/ka</emphasis> directory. +<screen> + -h, --help : display this message + -n num : specify the number of (destination) nodes + -x dir : exclude directory + -X sdb|sdc : exclude sdb for the replication + -m drive : copy the master boot record (for windows) of this drive (not really tested yet) + -M drive file : use 'file' as master boot record (must be 446 bytes long) for the specified drive + -D partition : also copy partition 'partition' + -p drive pdesc : use 'pdesc' file as partition scheme (see doc) for the specified drive + -d delay : delay beteween the release of 2 clients (1/10 second) + -r 'grub|lilo' : choose the bootloader (you can add mkinitrd options) + + ie: ka-d.sh -n 3 -p sda /tmp/desc -X 'sdb|sdc' -r 'grub --with=ata_piix --with=piix'</screen> + </para> + </sect3> + <sect3> + <title>replication.conf</title> + <para> + This file contains all variables needed by other scripts. It also tries to get information like IP address. + </para> + </sect3> + <sect3> + <title>fdisk_to_desc</title> + <para> + This script generate the description table of the hard drive disk in the <emphasis role="bold">/tmp/desc</emphasis> file. + This file must follow some rules: one line per partition, with two fields : type of partition and size in megabytes. + The type can be linux, swap, extended. Other types can be obtained by appending their hexadecimal number to 'type'. + For example linux is the same as type83. The size is either a number of megabytes, or the keyword fill (to take all + available space). The logical partitions must have the logical keyword. Do a <emphasis role="bold">man ka-d</emphasis> for more help. + </para> + </sect3> + <sect3> + <title>gen_modprobe_conf.pl</title> + <para> + This script creates a basic output like the content of the<emphasis role="bold">/etc/modprobe.conf</emphasis> file. Drawbacks + this file must be updated for each new modules available in the kernel (based on the <emphasis role="bold">kernel/list_modules.pm</emphasis> file). + </para> + </sect3> + <sect3> + <title>ka-d-client</title> + <para> + The <emphasis role="bold">ka-d-client</emphasis> binary file is used to get stage2 with the <emphasis role="bold">KA</emphasis> method, and after get the whole system. The important argument is the <emphasis role="bold">-s</emphasis> session name. A <emphasis role="bold">KA</emphasis> can only connect to a specific session (getstage2, kainstall ...). The code source is available in the ka-deploy SRPM. + </para> + </sect3> + <sect3> + <title>ka-d-server</title> + <para> + The <emphasis role="bold">ka-d-server</emphasis> binary file is used to be a <emphasis role="bold">KA</emphasis> golden node server. Like the <emphasis role="bold">ka-d-client</emphasis> the session arguments is an important parameter (<emphasis role="bold">-s session_name</emphasis>). The session name will be <emphasis role="bold">getstage2</emphasis> to retrieve the stage2 (after the PXE boot) and will be <emphasis role="bold">kainstall1</emphasis> at duplication process step. If you want to do more than one duplication process of nodes at the same time, you should synchronize the ka_sesion name between the server and the client. The code source is available in the ka-deploy SRPM. + </para> + </sect3> + <sect3> + <title>ka_replication.sh</title> + <para> + Script launched on the <emphasis role="bold">KA</emphasis> client (after getting stage2 and probing modules), to do the full process of the <emphasis role="bold">Ka</emphasis> duplication. + This script call other scripts to prepare the node (prepare_node.sh), configure the bootloader (make_initrd_grub or make_initrd_lilo). + </para> + </sect3> + <sect3> + <title>store_log.sh</title> + <para> + Basic script to store the log of the <emphasis role="bold">KA</emphasis> duplication process on an FTP server. Adjust to feet your need, and uncomment the line <emphasis role="bold">#store_log.sh</emphasis> in the <emphasis role="bold">/mnt/ka/ka/ka_replication.sh</emphasis> file. + </para> + </sect3> + <sect3> + <title>bootable_flag.sh</title> + <para> + Script to set bootable an HDD using fdisk. First arg must be the HDD device. + </para> + </sect3> + <sect3> + <title>make_initrd_grub</title> + <para> + Restore and reload the Grub bootloader in the <emphasis role="bold">/mnt/disk</emphasis> directory. It's a very basic script, and perhaps use the <emphasis role="bold">restore_bootloader</emphasis> of the Mageia Rescue should be a better idea.</para> + </sect3> + <sect3> + <title>make_initrd_lilo</title> + <para> + Restore and reload the lilo bootloader in the <emphasis role="bold">/mnt/disk</emphasis> directory. Again it's a very basic script, perhaps we should use the <emphasis role="bold">restore_bootloader</emphasis> of the Mageia Rescue. + </para> + </sect3> + <sect3> + <title>prepare_node.sh</title> + <para> + This script remove in the futur system the old network's udev rules, old dhcp cache files, launch the script <emphasis role="bold">gen_modprobe_conf.pl</emphasis> to regenerate an up to date <emphasis role="bold">/etc/modprobe.conf</emphasis> in the new system, and launch the script to restore the bootloader. If you want to do more action on the installed, system, you can modify this script. + </para> + </sect3> + <sect3> + <title>send_status.pl</title> + <para> + Very basic perl script to open the port 12345, and paste the content of the <emphasis role="bold">/tmp/ka*</emphasis> file. It also permit the execution of commands on node, if user send a message from the golden node with the <emphasis role="bold">exec</emphasis> prefix. + </para> + </sect3> + <sect3> + <title>status_node.pl</title> + <para> + Script to connect to a client node, first arg must be the IP address of the node. You can run command on the node with the <emphasis role="bold">exec</emphasis> prefix. + </para> + </sect3> + </sect2> + </sect1> + <sect1> + <title>The golden node, KA server</title> + <para> + Now, it is time to build a description of the node partitions. You can use the script <emphasis role="bold">/mnt/ka/ka/fdisk_to_desc</emphasis> as root user, or your favorite text editor, + you can write a file like this one: + </para> + <para> + <screen> +linux 3500 +extended fill +logical swap 500 +logical linux fill</screen> + </para> + <para> + This file describes your partition table and the sample above can be considered as a default one for a recommended + installation. There is a 3.5GB <emphasis role="bold">/</emphasis> partition, a 500 MB swap + partition, and <emphasis role="bold">/var</emphasis> fills the rest, of course you can adjust + sizes accoding to your system. + </para> + <para> + Type the following to start the ka replication server as root user on the golden node: + </para> + <para> +<programlisting><![CDATA[ +[root@node40 ka]# ./ka-d.sh -n 1 -p sda /root/desc -X sdb -r "grub --with=jfs --with=ata_piix" +takembr = +desc = sda /root/desc ++ Mount points : + /dev/sda5 / ext3 + /dev/sda1 swap swap ++ Hard drives : + sda ++ Reading partition table description for sda + Added partition 1 : type 82 + Added partition 5 : type 83 ++ Included mount points : / ++ Bootloader is: grub --with=jfs --with=ata_piix ++++ Sending Stage2 +++ +Compiled : Aug 23 2007 12:58:29 +ARGS=+ka-d-server+-s+getstage2+-n+1+-e+(cd /mnt/ka; tar --create --one-file-system --sparse . )+ +Server IP = 10.0.1.40 +command = (cd /mnt/ka; tar --create --one-file-system --sparse . ) +I want 1 clients +Socket 4 on port 30765 on node40.guibland.com ready. +Socket 5 on port 30764 on node40.guibland.com ready. +]]></programlisting> + </para> + <para> + <itemizedlist> + <listitem><para><emphasis role="bold">-r "grub --with=jfs --with=ata_piix"</emphasis>: use grub bootloader and <emphasis role="bold">--with=jfs --with=piix</emphasis> mkinitrd option in the chrooted system after the <emphasis role="bold">KA</emphasis> deploiement</para></listitem> + <listitem><para><emphasis role="bold">-n nb_nodes</emphasis>: specify how many nodes are clients</para></listitem> + <listitem><para><emphasis role="bold">-p sda desc</emphasis>: specify the name of the hdd</para></listitem> + <listitem><para><emphasis role="bold">-x /tmp</emphasis>: exclude <emphasis role="bold">/tmp</emphasis> directory</para></listitem> + <listitem><para><emphasis role="bold">-X sdb</emphasis>: exclude <emphasis role="bold">sdb</emphasis> hdd for the duplication</para></listitem> + </itemizedlist> + </para> + <para> + Now the golden node is waiting for clients nodes to start replication. + </para> + </sect1> + <sect1> + <title>KA client node</title> + <sect2> + <title>PXE server (kamethod)</title> + <para> + We have to configure the PXE to boot by default on <emphasis role="bold">kamethod</emphasis>. + To do this just edit <emphasis role="bold">/var/lib/tftpboot/X86PC/linux/pxelinux.cfg/default</emphasis> and set + <emphasis role="bold">DEFAULT</emphasis> to kamethod: + </para> + <screen>DEFAULT kamethod</screen> + <para> + So, next time a node boots, the PXE server will force the node to boot using the kamethod entry. + </para> + </sect2> + <sect2> + <title>Stage1 KA method, node waiting stage2 </title> + <para> + Now, you boot all remaining nodes. The replication process + will start once all nodes are up and waiting on the <emphasis role="bold">KA</emphasis> + screen. + </para> + <para> + If the nodes can't reach the golden node, running the <emphasis role="bold">KA</emphasis> + server the message <emphasis role="bold">Can't reach a valid KA server</emphasis> will appear. + Each node will try five times to reach the <emphasis role="bold">KA</emphasis> server, after that the node will reboot. + As the node boots on <emphasis role="bold">kamethod</emphasis>, it will retry until it finds it. + </para> + </sect2> + <sect2> + <title>Stage2, the duplication process</title> + <para> + Once all the nodes have found the <emphasis role="bold">KA</emphasis> server, the first + duplication process will start. This step duplicates the + <emphasis role="bold">stage2</emphasis> from the <emphasis role="bold">/mnt/ka</emphasis> directory + of the golden node, in the client's nodes memory (<emphasis role="bold">/dev/ram3</emphasis> formated as ext2). Then, nodes chroot their memories (the <emphasis role="bold">/tmp/stage2</emphasis> directory), and launch the <emphasis role="bold">drvinst</emphasis> command from the stage2, to probe all needed their modules (drivers). Then, the second step of the duplication starts. + </para> + <para> + The duplication process will clone your drives following + the description you have made (<emphasis role="bold">/tmp/desc</emphasis> of the golden node). + Nodes will rewrite their partition table, then format their filesystems (ReiserFs, XFS, + ext2/3/4, JFS). All new partitions will be mounted in the <emphasis role="bold">/mnt/disk</emphasis> directory. + Then, the drive duplication process will begin. On a fast Ethernet switch you can reach speeds of 10MBytes/sec. + </para> + </sect2> + <sect2> + <title>Prepare the node</title> + <para> + At the end of the duplication process, each node will + chroot its partitions and rebuild its <emphasis role="bold">/boot/initrd.img</emphasis>, + and <emphasis role="bold">/etc/modprobe.conf</emphasis> files. + This step ensures that your node will reboot using its potential + SCSI drives and adjusting its network card driver. Before + rebooting, each node reinstalls lilo/grub. All your node are + now ready, and are clone of master node. + </para> + </sect2> + <sect2><title>PXE server to local boot</title> + <para> + Don't forget to change the default PXE boot to <emphasis role="bold">local</emphasis> + so node after replication will boot localy. + </para> + </sect2> + </sect1> + <sect1> + <title>Step by step from scratch KA duplication</title> + <para>We will use a PIV 3gz box as golden node, with a SATA hard drive, and an Intel 82540EM Gigabit Ethernet Controller card. This golden box will be the: PXE, DHCPD, TFTP server. Client nodes are</para> + <para> + <itemizedlist> + <listitem><para>basic PIV 2.8gz, with a Realtek Semiconductor 8139 network card, and a IDE hard drive disk</para></listitem> + <listitem><para>PE2650 dual XEON 2.4gz, SCSI Hard Drive disk, and NetXtreme BCM5701 Gigabit Ethernet cards</para></listitem> + </itemizedlist> + </para> + <para>Both nodes are configured to boot on their network card.</para> + <sect2> + <title>Golden node side</title> + <para> + Prepapre the golden node, install all needed tools. + </para> + <para> +<programlisting><![CDATA[ +[root@localhost ~]# urpmi ka-deploy-source-node + http://192.168.1.253/cooker/i586/media/main/release/ka-deploy-source-node-0.94.1-1mdv2010.1.i586.rpm +installing ka-deploy-source-node-0.94.1-1mdv2010.1.i586.rpm from /var/cache/urpmi/rpms +Preparing... ############################################################################### + 1/1: ka-deploy-source-node ############################################################################### + +[root@localhost ~]# rpm -ql ka-deploy-source-node +/etc/ka +/etc/ka/replication.conf +/usr/bin/bootable_flag.sh +/usr/bin/fdisk_to_desc +/usr/bin/gen_modprobe_conf.pl +/usr/bin/ka-d-client +/usr/bin/ka-d-server +/usr/bin/ka-d.sh +/usr/bin/ka_replication.sh +/usr/bin/make_initrd_grub +/usr/bin/make_initrd_lilo +/usr/bin/prepare_node.sh +/usr/bin/send_status.pl +/usr/bin/status_node.pl +/usr/bin/store_log.sh +/usr/bin/udev_creation.sh +/usr/share/ka-deploy-0.94.1 +/usr/share/man/man1/ka-d-client.1.lzma +/usr/share/man/man1/ka-d-server.1.lzma +/usr/share/man/man1/ka-d.1.lzma +/usr/share/man/man1/ka-d.sh.1.lzma +/usr/share/man/man1/ka-deploy.1.lzma +]]></programlisting> + </para> + <para>Create the /mnt/ka directory, and put all stuff in it (this directory will be sent to all client nodes and use to finish + the duplication process)</para> + <para> +<programlisting><![CDATA[ +[root@localhost ~]# mkdir /mnt/ka +lftp distrib-coffee.ipsl.jussieu.fr:~> cd pub/linux/Mageia/distrib/cauldron/i586/install/stage2/ +lftp distrib-coffee.ipsl.jussieu.fr:/pub/linux/Mageia/distrib/cauldron/i586/install/stage2> pget rescue.sqfs +19132416 bytes transferred in 78 seconds (241.1K/s) + +[root@localhost ~]# urpmi squashfs-tools + http://192.168.1.253/cooker/i586/media/main/release/squashfs-tools-4.0-3.20091221.1mdv2010.1.i586.rpm +installing squashfs-tools-4.0-3.20091221.1mdv2010.1.i586.rpm from /var/cache/urpmi/rpms +Preparing... ############################################################################ + 1/1: squashfs-tools ############################################################################ + +[root@localhost ~]# unsquashfs rescue.sqfs +Parallel unsquashfs: Using 2 processors +988 inodes (1222 blocks) to write +[============================================================================================-] 1222/1222 100% +created 550 files +created 93 directories +created 60 symlinks +created 371 devices +created 1 fifos + +[root@localhost ~]# cd squashfs-root/ +[root@localhost squashfs-root]# ls +bin/ dev/ etc/ ka/ lib/ modules/ proc/ sbin/ tmp/ usr/ var/ +[root@localhost squashfs-root]# mv * /mnt/ka/ +]]></programlisting> + </para> + <para>Install all needed packages to be able to be a PXE, DHCPD and TFTP server</para> + <para> +<programlisting><![CDATA[ +[root@localhost ka]# ka-d.sh -h +/usr/bin/ka-d.sh : clone this machine +Usage: + -h, --help : display this message + -n num : specify the number of (destination) nodes + -x 'dir|dir2' : exclude directory + -X 'sdb|sdc' : exclude sdb for the replication + -m drive : copy the master boot record (for windows) of this drive + -M drive file : use 'file' as master boot record (must be 446 bytes long) for the specified drive + -D partition : also copy partition 'partition' + -p drive pdesc : use 'pdesc' file as partition scheme (see doc) for the specified drive + -d delay : delay beteween the release of 2 clients (1/10 second) + -r 'grub|lilo' : choose the bootloader (you can add mkinitrd options) + + ie: ka-d.sh -n 3 -p sda /tmp/desc -X sdb -r 'grub --with=ata_piix --with=piix' + +[root@localhost ka]# urpmi ka-deploy-server +To satisfy dependencies, the following packages are going to be installed: + Package Version Release Arch +(medium "Main") + bind-utils 9.7.0 4mdv2010.1 i586 + clusterscripts-common 3.5 1mdv2010.1 noarch + clusterscripts-server-conf 3.5 1mdv2010.1 noarch + clusterscripts-server-pxe 3.5 1mdv2010.1 noarch + dhcp-server 4.1.1 5mdv2010.1 i586 + ka-deploy-server 0.94.1 1mdv2010.1 i586 + perl-Crypt-PasswdMD5 1.300.0 1mdv2010.1 noarch + pxe 1.4.2 19mdv2010.1 i586 + pxelinux 3.83 1mdv2010.1 i586 + syslinux 3.83 1mdv2010.1 i586 + tftp-server 5.0 4mdv2010.1 i586 + xinetd 2.3.14 11mdv2010.1 i586 +12MB of additional disk space will be used. +2.5MB of packages will be retrieved. +Proceed with the installation of the 12 packages? (Y/n) +]]></programlisting> + </para> + <para>Configure all services</para> + <para> +<programlisting><![CDATA[ +[root@localhost ~]# hostname +node42.guibland.com +[root@localhost ~]# domainname +guibland.com + +[root@localhost ~]# ip addr show eth0 +2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP qlen 100 + link/ether 00:17:31:19:a0:78 brd ff:ff:ff:ff:ff:ff + inet 10.0.1.42/24 brd 10.0.1.255 scope global eth0 + inet6 fe80::217:31ff:fe19:a078/64 scope link + valid_lft forever preferred_lft forever + +[root@localhost ~]# vi /etc/pxe.conf +# which interface to use +interface=eth0 +default_address=10.0.1.42 + +# the multicast ip address to listen on +multicast_address=224.0.1.2 + +# mtftp info +mtftp_address=10.0.1.42 +mtftp_client_port=1758 +mtftp_server_port=1759 + +# the port to listen on +listen_port=4011 + +# enable multicast? +use_multicast=1 + +# enable broadcast? +use_broadcast=0 + +# user prompt +prompt=Press F8 to view menu ... +prompt_timeout=2 + +# what services to provide, priority in ordering +# CSA = Client System Architecture +# service=<CSA>,<min layer>,<max layer>,<basename>,<menu entry> +service=X86PC,0,2,linux,Mageia x86 +service=IA64PC,0,2,linux,Mageia IA64 +service=X86PC,0,0,local,Local boot + +# tftpd base dir +tftpdbase=/ + +# domain name +domain=guibland.com + +[root@localhost ~]# vi /etc/xinetd.d/tftp +service tftp +{ + disable = no + socket_type = dgram + protocol = udp + wait = yes + user = root + server = /usr/sbin/in.tftpd + server_args = -s /var/lib/tftpboot + per_source = 11 + cps = 100 2 + flags = IPv4 +} + + +[root@localhost ~]# cp /etc/dhcpd.conf.pxe.single /etc/dhcpd.conf +cp: overwrite `/etc/dhcpd.conf'? y + +[root@localhost ~]# cat /etc/resolv.conf +nameserver 10.0.1.253 +search guibland.com + +[root@localhost ~]# cat /etc/dhcpd.conf +# for explanation in french go to : http://www.delafond.org/traducmanfr/man/man5/dhcpd.conf.5.html +ddns-update-style none; +allow booting; +allow bootp; + +# Your dhcp server is not master on your network ! +#not authoritative; +# Your dhcpd server is master on your network ! +#authoritative; +authoritative; + +#Interface where dhcpd is active +#DHCPD_INTERFACE = "eth0"; + +# Definition of PXE-specific options +# Code 1: Multicast IP address of bootfile +# Code 2: UDP port that client should monitor for MTFTP responses +# Code 3: UDP port that MTFTP servers are using to listen for MTFTP requests +# Code 4: Number of secondes a client must listen for activity before trying +# to start a new MTFTP transfer +# Code 5: Number of secondes a client must listen before trying to restart +# a MTFTP transfer + +# define Option for the PXE class +option space PXE; +option PXE.mtftp-ip code 1 = ip-address; +option PXE.mtftp-cport code 2 = unsigned integer 16; +option PXE.mtftp-sport code 3 = unsigned integer 16; +option PXE.mtftp-tmout code 4 = unsigned integer 8; +option PXE.mtftp-delay code 5 = unsigned integer 8; +option PXE.discovery-control code 6 = unsigned integer 8; +option PXE.discovery-mcast-addr code 7 = ip-address; + +#Define options for pxelinux +option space pxelinux; +option pxelinux.magic code 208 = string; +option pxelinux.configfile code 209 = text; +option pxelinux.pathprefix code 210 = text; +option pxelinux.reboottime code 211 = unsigned integer 32; +site-option-space "pxelinux"; +# These lines should be customized to your setup +#option pxelinux.configfile "configs/common"; +#option pxelinux.pathprefix "/pxelinux/files/"; +#filename "/pxelinux/pxelinux.bin"; + +option pxelinux.magic f1:00:74:7e; +option pxelinux.reboottime 30; +#if exists dhcp-parameter-request-list { +# Always send the PXELINUX options +# append dhcp-parameter-request-list 208, 209, 210, 211; +# append dhcp-parameter-request-list 208,211; +# } + +#Class that determine the options for Etherboot 5.x requests +class "Etherboot" { + +#if The vendor-class-identifier equal Etherboot-5.0 +match if substring (option vendor-class-identifier, 0, 13) = "Etherboot-5.0"; + +# filename define the file retrieve by the client, there nbgrub +# our tftp is chrooted so is just the path to the file +filename "/etherboot/nbgrub"; + +#Used by etherboot to detect a valid pxe dhcp server +option vendor-encapsulated-options 3c:09:45:74:68:65:72:62:6f:6f:74:ff; + +# Set the "vendor-class-identifier" field to "PXEClient" in dhcp answer +# if this field is not set the pxe client will ignore the answer ! +option vendor-class-identifier "Etherboot-5.0"; + +vendor-option-space PXE; +option PXE.mtftp-ip 0.0.0.0; + +# IP of you TFTP server +next-server 10.0.1.42; +} + + +# create the Class PXE +class "PXE" { +# if the "vendor-class-identifier" is set to "PXEClient" in the client dhcp request +match if substring(option vendor-class-identifier, 0, 9) = "PXEClient"; + +# filename define the file retrieve by the client, there pxelinux.0 +# our tftp is chrooted so is just the path to the file +# If you prefer use grub, use pxegrub compiled for your ethernet card. +#filename "/PXEClient/pxegrub"; +filename "/X86PC/linux/linux.0"; + +# Set the "vendor-class-identifier" field to "PXEClient" in dhcp answer +# if this field is not set the pxe client will ignore the answer ! +option vendor-class-identifier "PXEClient"; + + +vendor-option-space PXE; +option PXE.mtftp-ip 0.0.0.0; + +# IP of you TFTP server +next-server 10.0.1.42; +} + +# Tags uses by dhcpnode and setup_add_nodes_to_dhcp +# TAG: NODE_LIST_ADMIN_BEGIN + +# TAG: NODE_LIST_ADMIN_END + +# TAG: MY_ADMIN_BEGIN +subnet 10.0.1.0 netmask 255.255.255.0 { + option subnet-mask 255.255.255.0; + option routers 10.0.1.253; + default-lease-time 288000; + max-lease-time 864000; + option domain-name "guibland.com"; + option domain-name-servers 10.0.1.253; + next-server 10.0.1.42; + + pool { + range 10.0.1.110 10.0.1.120; + } +} + +# TAG: MY_ADMIN_END + + +[root@localhost ~]# service xinetd restart +Stopping xinetd [FAILED] +Starting xinetd [ OK ] +[root@localhost ~]# service pxe restart +Stopping PXE server [FAILED] +Dhcp server is not running on this machine ! +Be sure that a valid PXE Dhcp server is running on your network +Starting PXE server [ OK ] +[root@localhost ~]# service dhcpd restart +Shutting down dhcpd: [ OK ] +Starting dhcpd: [ OK ] +]]></programlisting> + </para> + <para>KA listen only listen on eth0, and need a FQDN. So if it is not the case, ka-d-server will try to open + a port on 0.0.0.0 IP address, wich cause an error. You can fix it easely setting an valid hostname in /etc/hosts file. + Don't forget to kill ka-d-server with crtl+C key, after testing it will open a port on a valid IP address.</para> + <para> +<programlisting><![CDATA[ +[root@node42 ~]# ka-d-server +Compiled : May 4 2010 20:33:07 +ARGS=+ka-d-server+ +Server IP = 0.0.0.0 +command = (cd /; tar --create --one-file-system --sparse /) +I want 1 clients +ka-d-server: server.c:1987: main: Assertion `socket_server >=0' failed. +Aborted + + +[root@node42 ~]# cat /etc/hosts +127.0.0.1 localhost.localdomain localhost +10.0.1.42 node42.guibland.com + +[root@node42 ~]# ka-d-server +Compiled : May 4 2010 20:33:07 +ARGS=+ka-d-server+ +Server IP = 10.0.1.42 +command = (cd /; tar --create --one-file-system --sparse /) +I want 1 clients +Socket 3 on port 30765 on node42.guibland.com ready. +Socket 4 on port 30764 on node42.guibland.com ready. +[root@node42 ~]# ^C +]]></programlisting> + </para> + <para>We need to describe the partition table of our golden node, to send it to client nodes.</para> + <para> +<programlisting><![CDATA[ +[root@node42 ~]# fdisk -l + +Disk /dev/sda: 80.0 GB, 80026361856 bytes +255 heads, 63 sectors/track, 9729 cylinders +Units = cylinders of 16065 * 512 = 8225280 bytes +Sector size (logical/physical): 512 bytes / 512 bytes +I/O size (minimum/optimal): 512 bytes / 512 bytes +Disk identifier: 0xd9b576f2 + + Device Boot Start End Blocks Id System +/dev/sda1 * 1 1019 8185086 82 Linux swap / Solaris +/dev/sda2 1020 4843 30716280 83 Linux +/dev/sda3 4844 9729 39246795 5 Extended +/dev/sda5 4844 9729 39246763+ 83 Linux + + +[root@node42 ~]# fdisk_to_desc + -devices: sda1 -size en Mo: 7993 -filesystem: Linux +Use of uninitialized value $e in concatenation (.) or string at /usr/bin/fdisk_to_desc line 50. + -devices: sda2 -size en Mo: 29996 -filesystem: Linux +Use of uninitialized value $e in concatenation (.) or string at /usr/bin/fdisk_to_desc line 55. + -devices: sda3 -size en Mo: 38326 -filesystem: Extended + -devices: sda5 -size en Mo: 38326 -filesystem: Linux +Desc file is /tmp/desc +[root@node42 ~]# cat /tmp/d +ddebug.log desc +[root@node42 ~]# cat /tmp/desc +swap 7993 +linux 29996 +extended 38326 +logical linux 38326 + +[root@node42 ~]# cat /tmp/desc +swap 7993 +linux 29996 +extended fill +logical linux fill +]]></programlisting> + </para> + <para>Set default PXE boot to kamethod</para> + <para> +<programlisting><![CDATA[ +[root@node42 ~]# cat /var/lib/tftpboot/X86PC/linux/pxelinux.cfg/default +PROMPT 1 +DEFAULT kamethod +DISPLAY messages +TIMEOUT 50 + +label local + LOCALBOOT 0 + +label kamethod + KERNEL images/vmlinuz + APPEND initrd=images/all.rdz ramdisk_size=64000 vga=788 automatic=method:ka,interface:eth0,network:dhcp root=/dev/ram3 rw kamethod + + +[root@node42 ~]# cd /var/lib/tftpboot/X86PC/linux/ +[root@node42 linux]# ls +help.txt linux.0 memdisk messages pxelinux.cfg/ +[root@node42 linux]# mkdir images + +lftp distrib-coffee.ipsl.jussieu.fr:/pub/linux/Mageia/distrib/cauldron/i586/isolinux/alt0> ls +-rw-r--r-- 1 ftp ftp 15613654 Apr 23 17:26 all.rdz +-rw-r--r-- 1 ftp ftp 2279584 Apr 23 17:26 vmlinuz +lftp distrib-coffee.ipsl.jussieu.fr:/pub/linux/Mageia/distrib/cauldron/i586/isolinux/alt0> mget * +17893238 bytes transferred in 77 seconds (227.9K/s) +Total 2 files transferred +lftp distrib-coffee.ipsl.jussieu.fr:/pub/linux/Mageia/distrib/cauldron/i586/isolinux/alt0> + +[root@node42 images]# pwd +/var/lib/tftpboot/X86PC/linux/images +[root@node42 images]# ls +all.rdz vmlinuz +]]></programlisting> + </para> + <para>Now it's time to launch the duplication process</para> + <para> +<programlisting><![CDATA[ +[root@node42 ka]# ka-d.sh -n 2 -p sda /tmp/desc -r grub +takembr = +desc = sda /tmp/desc +`/etc/fstab' -> `/tmp/ka-d3156/pfstab.tmp' ++ Mount points : + /dev/sda2 / ext3 relatime 1 1 + /dev/sda5 /home ext4 relatime 1 2 + /dev/sda1 swap swap defaults 0 0 ++ Hard drives : + sda ++ Reading partition table description for sda + Added partition 1 : type 82 + Added partition 2 : type 83 + Added partition 5 : type 83 ++ Included mount points : / /home ++ Bootloader is: grub ++++ Sending Stage2 +++ +Compiled : May 4 2010 20:33:07 +ARGS=+ka-d-server+-s+getstage2+-n+2+-e+(cd /mnt/ka; tar --create --one-file-system --sparse . )+ +Server IP = 10.0.1.42 +command = (cd /mnt/ka; tar --create --one-file-system --sparse . ) +I want 2 clients +Socket 4 on port 30765 on node42.guibland.com ready. +Socket 5 on port 30764 on node42.guibland.com ready. +got UDP packet from 10.0.1.111 +Session name matches +Sending UDP reply to 10.0.1.111 +Accepting connection from 10.0.1.111 +Clients : want_data 0 / connected 0 +client says hello ! +Client sends options +Client accepts data +got UDP packet from 10.0.1.110 +Session name matches +Sending UDP reply to 10.0.1.110 +Accepting connection from 10.0.1.110 +Clients : want_data 1 / connected 0 +client says hello ! +Client sends options +Client accepts data +Added client 10.0.1.110, daddy = 10.0.1.42 +Added client 10.0.1.111, daddy = 10.0.1.110 +Accepting connection from 10.0.1.110 +checking connection auth10.0.1.42 reports 10.0.1.110 has opened data connection +Client 10.0.1.110 reports data position : 0 +10.0.1.42 reports 10.0.1.110 has been accepted +Welcome son, you are number 1 (MAX 4) +Client got client +10.0.1.110 reports 10.0.1.111 has opened data connection +Client 10.0.1.111 reports data position : 0 +sending auth for 10.0.1.111 to 10.0.1.110 +Client got client +10.0.1.110 reports 10.0.1.111 has been accepted +Let's go! +Total data read = 43 Megs, BUF: 34M FREE = 0M startpos = 8MM +End of data flow +Dropping children +Dropping child 10.0.1.110 +All children dropped +Client says dad disconnected +Client says he has finished +Client has finished transfer +Busy clients: 1 -- connected : 2 +Client says dad disconnected +Client says he has finished +Client has finished transfer +Busy clients: 0 -- connected : 2 +Peer closed connection on socket 7 +close_connection(7) +Busy clients: 0 -- connected : 1 +Peer closed connection on socket 6 +close_connection(6) +Busy clients: 0 -- connected : 0 +All clients left, I quit +Total data sent = 44 Megs, in 1543 packets +Transfer time = 0.858 seconds, throughput = 51.307 Mbytes/second +The pipeline was emptied in 3.250 seconds + - Sending partition/filesystem/mount points informations... + +++ Running ka-deploy +++ +Compiled : May 4 2010 20:33:07 +ARGS=+ka-d-server+-s+kainstall1+-n+2+-e+(cd /tmp/ka-d3156 && tar c *)+ +Server IP = 10.0.1.42 +command = (cd /tmp/ka-d3156 && tar c *) +I want 2 clients +Socket 4 on port 30765 on node42.guibland.com ready. +Socket 5 on port 30764 on node42.guibland.com ready. +got UDP packet from 10.0.1.110 +Session name matches +Sending UDP reply to 10.0.1.110 +Accepting connection from 10.0.1.110 +Clients : want_data 0 / connected 0 +client says hello ! +Client sends options +Client accepts data +got UDP packet from 10.0.1.111 +Session name matches +Sending UDP reply to 10.0.1.111 +Accepting connection from 10.0.1.111 +Clients : want_data 1 / connected 0 +client says hello ! +Client sends options +Client accepts data +Added client 10.0.1.110, daddy = 10.0.1.42 +Added client 10.0.1.111, daddy = 10.0.1.110 +Accepting connection from 10.0.1.110 +checking connection auth10.0.1.42 reports 10.0.1.110 has opened data connection +Client 10.0.1.110 reports data position : 0 +10.0.1.42 reports 10.0.1.110 has been accepted +Welcome son, you are number 1 (MAX 4) +Client got client +10.0.1.110 reports 10.0.1.111 has opened data connection +Client 10.0.1.111 reports data position : 0 +sending auth for 10.0.1.111 to 10.0.1.110 +Client got client +10.0.1.110 reports 10.0.1.111 has been accepted +Let's go! +Total data read = 0 Megs, BUF: 0M FREE = 34M startpos = 0M +End of data flow +Dropping children +Dropping child 10.0.1.110 +All children dropped +Client says dad disconnected +Client says he has finished +Client has finished transfer +Busy clients: 1 -- connected : 2 +Client says dad disconnected +Client says he has finished +Client has finished transfer +Busy clients: 0 -- connected : 2 +Peer closed connection on socket 6 +close_connection(6) +Busy clients: 0 -- connected : 1 +Peer closed connection on socket 7 +close_connection(7) +Busy clients: 0 -- connected : 0 +All clients left, I quit +Total data sent = 0 Megs, in 1 packets +Transfer time = 0.006 seconds, throughput = 1.698 Mbytes/second +The pipeline was emptied in 0.038 seconds + WAITING node (partition/format) + - Sending Linux filesystem... + +++ Running ka-deploy +++ +Compiled : May 4 2010 20:33:07 +ARGS=+ka-d-server+-s+kainstall2+-n+2+-e+(cd /; tar --create --one-file-system --sparse / /home)+ +Server IP = 10.0.1.42 +command = (cd /; tar --create --one-file-system --sparse / /home) +I want 2 clients +Socket 4 on port 30765 on node42.guibland.com ready. +Socket 5 on port 30764 on node42.guibland.com ready. +got UDP packet from 10.0.1.110 +Session name matches +Sending UDP reply to 10.0.1.110 +Accepting connection from 10.0.1.110 +Clients : want_data 0 / connected 0 +client says hello ! +Client sends options +Client accepts data +got UDP packet from 10.0.1.111 +Session name matches +Sending UDP reply to 10.0.1.111 +Accepting connection from 10.0.1.111 +Clients : want_data 1 / connected 0 +client says hello ! +Client sends options +Client accepts data +Added client 10.0.1.110, daddy = 10.0.1.42 +Added client 10.0.1.111, daddy = 10.0.1.110 +Accepting connection from 10.0.1.110 +checking connection auth10.0.1.42 reports 10.0.1.110 has opened data connection +Client got client +10.0.1.110 reports 10.0.1.111 has opened data connection +Client 10.0.1.110 reports data position : 0 +10.0.1.42 reports 10.0.1.110 has been accepted +Welcome son, you are number 1 (MAX 4) +Client 10.0.1.111 reports data position : 0 +sending auth for 10.0.1.111 to 10.0.1.110 +Client got client +10.0.1.110 reports 10.0.1.111 has been accepted +Let's go! +Total data read = 789 Megs, BUF: 34M FREE = 0M startpos = 754M +End of data flow +Dropping children +Dropping child 10.0.1.110 +All children dropped +Client says dad disconnected +Client says he has finished +Client has finished transfer +Busy clients: 1 -- connected : 2 +Client says dad disconnected +Client says he has finished +Client has finished transfer +Busy clients: 0 -- connected : 2 +Peer closed connection on socket 7 +close_connection(7) +Busy clients: 0 -- connected : 1 +Peer closed connection on socket 6 +close_connection(6) +Busy clients: 0 -- connected : 0 +All clients left, I quit +Total data sent = 792 Megs, in 25445 packets +Transfer time = 69.904 seconds, throughput = 11.343 Mbytes/second +The pipeline was emptied in 4.002 seconds +]]></programlisting> + </para> + </sect2> + <sect2> + <title>KA client side</title> + <para> + To get the log of the client node, launch <emphasis role="bold">/mnt/ka/ka/status_node.pl IPADD</emphasis> on the golden node. + </para> +<programlisting><![CDATA[ +[root@node42 ka]# status_node.pl 10.0.1.111 + + Get the status of the Ka duplication process + If you want to execute a command on node, just use the 'exec' prefix +10.0.1.111> ------| Ka |---- Install starting... +10.0.1.111> Current session is -s kainstall1 +10.0.1.111> Receiving partitions information...OK +10.0.1.111> Cleaning hard drive... +10.0.1.111> ==> /tmp/kacmd <== +10.0.1.111> Starting log server.. +10.0.1.111> +10.0.1.111> ==> /tmp/ka_log-10.0.1.111-20100507-10h32 <== +10.0.1.111> OK +10.0.1.111> Device contains neither a valid DOS partition table, nor Sun, SGI or OSF disklabel +10.0.1.111> Building a new DOS disklabel with disk identifier 0x59be1427. +10.0.1.111> Changes will remain in memory only, until you decide to write them. +10.0.1.111> After that, of course, the previous content won't be recoverable. +10.0.1.111> +10.0.1.111> +10.0.1.111> The number of cylinders for this disk is set to 1116. +10.0.1.111> There is nothing wrong with that, but this is larger than 1024, +10.0.1.111> and could in certain setups cause problems with: +10.0.1.111> 1) software that runs at boot time (e.g., old versions of LILO) +10.0.1.111> 2) booting and partitioning software from other OSs +10.0.1.111> (e.g., DOS FDISK, OS/2 FDISK) +10.0.1.111> Warning: invalid flag 0x0000 of partition table 4 will be corrected by w(rite) +10.0.1.111> +10.0.1.111> Command (m for help): The partition table has been altered! +10.0.1.111> +10.0.1.111> Calling ioctl() to re-read partition table. +10.0.1.111> Syncing disks. +10.0.1.111> Writing partition table for sda using fdisk...OK +10.0.1.111> Formatting /dev/sda2 as ext3...OK +10.0.1.111> Formatting /dev/sda5 as ext4...OK +10.0.1.111> Formatting /dev/sda1 as swap...OK +10.0.1.111> - Mounting /dev/sda2 as /mnt/disk/ ......OK +10.0.1.111> - Mounting /dev/sda5 as /mnt/disk/home ......OK +10.0.1.111> ++++++++++++++++++++++++++ +10.0.1.111> none on /sys type sysfs (rw,relatime) +10.0.1.111> none on /proc/bus/usb type usbfs (rw,relatime) +10.0.1.111> /dev/ram3 on /tmp/stage2 type ext2 (rw,relatime,errors=continue) +10.0.1.111> /dev/sda2 on /mnt/disk type ext3 (rw,relatime,errors=continue,data=ordered) +10.0.1.111> /dev/sda5 on /mnt/disk/home type ext4 (rw,relatime,barrier=1,data=ordered) +10.0.1.111> ++++++++++++++++++++++++++ +10.0.1.111> Linux copy is about to start +10.0.1.111> Server IP is 10.0.1.42 +10.0.1.111> Buffers names :pipe +Total data received = 21 Megs (10.830 Mbytes/sec); BUF :0M +10.0.1.111> ==> /tmp/kacmd <== +10.0.1.111> Starting log server.. +10.0.1.111> +10.0.1.111> ==> /tmp/ka_log-localhost-20100507-11h17 <== +Total data received = 788 Megs (10.796 Mbytes/sec); BUF :0M End of data flow +10.0.1.111> Flushing buffers +10.0.1.111> Total data received = 792 Megs, in 574479 packets +10.0.1.111> Elapsed time = 73.413 seconds, throughput = 10.801 Mbytes/second +10.0.1.111> Syncing disks...OK +10.0.1.111> Linux copy done. +10.0.1.111> Creating excluded directories +10.0.1.111> - bootloader is grub (user choice) +10.0.1.111> `/tmp/partfiles/pfstab' -> `/mnt/disk/etc/fstab' +10.0.1.111> - Removing duplicated dhcp cache +10.0.1.111> - Writing modprobe.conf +10.0.1.111> ******************** +10.0.1.111> install scsi_hostadapter /sbin/modprobe aic7xxx; /bin/true +10.0.1.111> install scsi_hostadapter /sbin/modprobe pata_serverworks; /bin/true +10.0.1.111> alias eth0 tg3 +10.0.1.111> alias eth1 tg3 +10.0.1.111> ******************** +10.0.1.111> - Remove persistent udev rules +10.0.1.111> removed `/mnt/disk/etc/udev/rules.d/70-persistent-net.rules' +10.0.1.111> - Fix /dev in /mnt/disk +10.0.1.111> `/ka2/udev_creation.sh' -> `/mnt/disk/sbin/udev_creation.sh' +10.0.1.111> Starting udev: [ OK ] +10.0.1.111> umount: /mnt/disk/dev: device is busy. +10.0.1.111> (In some cases useful info about processes that use +10.0.1.111> the device is found by lsof(8) or fuser(1)) +10.0.1.111> - Running mkinitrd +10.0.1.111> - Looking for default grub menu +10.0.1.111> - erase old initrd.img link +10.0.1.111> removed `/mnt/disk/boot/initrd.img' +10.0.1.111> initrd will be : /boot/initrd-2.6.33.3-desktop-1mnb.img +10.0.1.111> running: chroot /mnt/disk /sbin/mkinitrd -v -f /boot/initrd-2.6.33.3-desktop-1mnb.img 2.6.33.3-desktop-1mnb +10.0.1.111> Creating initramfs +10.0.1.111> Looking for driver for /dev/sda2 in /sys/block/sda/sda2 +10.0.1.111> Looking for deps of module scsi:t-0x00: crc-t10dif scsi_mod sd_mod +10.0.1.111> Looking for deps of module pci:v00009005d000000CFsv00001028sd00000121bc01sc00i00: scsi_mod scsi_transport_spi aic7xxx +10.0.1.111> Looking for deps of module pci:v00008086d00000309sv00000000sd00000000bc06sc04i00: pci_hotplug shpchp +10.0.1.111> Looking for driver for /dev/sda1 in /sys/block/sda/sda1 +10.0.1.111> Using modules: usbhid ehci-hcd ohci-hcd uhci-hcd ext3 crc-t10dif scsi_mod sd_mod scsi_transport_spi aic7xxx pci_hotplug shpchp pata_serverworks +10.0.1.111> Building initrd in /tmp/initrd.uuIIkZ +10.0.1.111> /sbin/nash -> /tmp/initrd.uuIIkZ/bin/nash +10.0.1.111> /usr/lib/libnash.so.6.0.93 -> /tmp/initrd.uuIIkZ/usr/lib/libnash.so.6.0.93 +10.0.1.111> /lib/libdevmapper.so.1.02 -> /tmp/initrd.uuIIkZ/lib/libdevmapper.so.1.02 +10.0.1.111> /lib/libreadline.so.6 -> /tmp/initrd.uuIIkZ/lib/libreadline.so.6 +10.0.1.111> /lib/libreadline.so.6.1 -> /tmp/initrd.uuIIkZ/lib/libreadline.so.6.1 +10.0.1.111> /lib/libncurses.so.5 -> /tmp/initrd.uuIIkZ/lib/libncurses.so.5 +10.0.1.111> /lib/libncurses.so.5.7 -> /tmp/initrd.uuIIkZ/lib/libncurses.so.5.7 +10.0.1.111> /lib/libc.so.6 -> /tmp/initrd.uuIIkZ/lib/libc.so.6 +10.0.1.111> /lib/libc-2.11.1.so -> /tmp/initrd.uuIIkZ/lib/libc-2.11.1.so +10.0.1.111> /lib/ld-linux.so.2 -> /tmp/initrd.uuIIkZ/lib/ld-linux.so.2 +10.0.1.111> /lib/ld-2.11.1.so -> /tmp/initrd.uuIIkZ/lib/ld-2.11.1.so +10.0.1.111> /lib/libdl.so.2 -> /tmp/initrd.uuIIkZ/lib/libdl.so.2 +10.0.1.111> /lib/libdl-2.11.1.so -> /tmp/initrd.uuIIkZ/lib/libdl-2.11.1.so +10.0.1.111> /lib/libudev.so.0 -> /tmp/initrd.uuIIkZ/lib/libudev.so.0 +10.0.1.111> /lib/libudev.so.0.7.0 -> /tmp/initrd.uuIIkZ/lib/libudev.so.0.7.0 +10.0.1.111> /usr/lib/libparted.so.0 -> /tmp/initrd.uuIIkZ/usr/lib/libparted.so.0 +10.0.1.111> /usr/lib/libparted.so.0.0.1 -> /tmp/initrd.uuIIkZ/usr/lib/libparted.so.0.0.1 +10.0.1.111> /lib/libuuid.so.1 -> /tmp/initrd.uuIIkZ/lib/libuuid.so.1 +10.0.1.111> /lib/libuuid.so.1.3.0 -> /tmp/initrd.uuIIkZ/lib/libuuid.so.1.3.0 +10.0.1.111> /lib/libblkid.so.1 -> /tmp/initrd.uuIIkZ/lib/libblkid.so.1 +10.0.1.111> /lib/libblkid.so.1.1.0 -> /tmp/initrd.uuIIkZ/lib/libblkid.so.1.1.0 +10.0.1.111> /lib/libpopt.so.0 -> /tmp/initrd.uuIIkZ/lib/libpopt.so.0 +10.0.1.111> /lib/libpopt.so.0.0.0 -> /tmp/initrd.uuIIkZ/lib/libpopt.so.0.0.0 +10.0.1.111> /lib/libresolv.so.2 -> /tmp/initrd.uuIIkZ/lib/libresolv.so.2 +10.0.1.111> /lib/libresolv-2.11.1.so -> /tmp/initrd.uuIIkZ/lib/libresolv-2.11.1.so +10.0.1.111> /usr/lib/libelf.so.1 -> /tmp/initrd.uuIIkZ/usr/lib/libelf.so.1 +10.0.1.111> /usr/lib/libelf-0.146.so -> /tmp/initrd.uuIIkZ/usr/lib/libelf-0.146.so +10.0.1.111> /lib/libm.so.6 -> /tmp/initrd.uuIIkZ/lib/libm.so.6 +10.0.1.111> /lib/libm-2.11.1.so -> /tmp/initrd.uuIIkZ/lib/libm-2.11.1.so +10.0.1.111> /lib/libgcc_s.so.1 -> /tmp/initrd.uuIIkZ/lib/libgcc_s.so.1 +10.0.1.111> /lib/libgcc_s-4.4.3.so.1 -> /tmp/initrd.uuIIkZ/lib/libgcc_s-4.4.3.so.1 +10.0.1.111> /usr/lib/libbdevid.so.6.0.93 -> /tmp/initrd.uuIIkZ/usr/lib/libbdevid.so.6.0.93 +10.0.1.111> /sbin/modprobe -> /tmp/initrd.uuIIkZ/bin/modprobe +10.0.1.111> /lib/libmodprobe.so.0 -> /tmp/initrd.uuIIkZ/lib/libmodprobe.so.0 +10.0.1.111> /lib/libmodprobe.so.0.0.0 -> /tmp/initrd.uuIIkZ/lib/libmodprobe.so.0.0.0 +10.0.1.111> /lib/libz.so.1 -> /tmp/initrd.uuIIkZ/lib/libz.so.1 +10.0.1.111> /lib/libz.so.1.2.3 -> /tmp/initrd.uuIIkZ/lib/libz.so.1.2.3 +10.0.1.111> /sbin/rmmod -> /tmp/initrd.uuIIkZ/bin/rmmod +10.0.1.111> /bin/ln -> /tmp/initrd.uuIIkZ/bin/ln +10.0.1.111> resolving for MODULES +10.0.1.111> and that has items of usbhid ehci-hcd ohci-hcd uhci-hcd ext3 crc-t10dif scsi_mod sd_mod scsi_transport_spi aic7xxx pci_hotplug shpchp pata_serverworks +10.0.1.111> Looking for deps of module usbhid: usbcore hid +10.0.1.111> Looking for deps of module ehci-hcd: usbcore +10.0.1.111> Looking for deps of module ohci-hcd: usbcore +10.0.1.111> Looking for deps of module uhci-hcd: usbcore +10.0.1.111> Looking for deps of module ext3: jbd +10.0.1.111> Looking for deps of module crc-t10dif +10.0.1.111> Looking for deps of module scsi_mod +10.0.1.111> Looking for deps of module sd_mod: crc-t10dif scsi_mod +10.0.1.111> Looking for deps of module scsi_transport_spi: scsi_mod +10.0.1.111> Looking for deps of module aic7xxx: scsi_mod scsi_transport_spi +10.0.1.111> Looking for deps of module pci_hotplug +10.0.1.111> Looking for deps of module shpchp: pci_hotplug +10.0.1.111> Looking for deps of module pata_serverworks: scsi_mod libata +10.0.1.111> Looking for deps of module aic7xxx: scsi_mod scsi_transport_spi +10.0.1.111> Looking for deps of module crc-t10dif +10.0.1.111> Looking for deps of module ehci-hcd: usbcore +10.0.1.111> Looking for deps of module ext3: jbd +10.0.1.111> Looking for deps of module hid +10.0.1.111> Looking for deps of module jbd +10.0.1.111> Looking for deps of module libata: scsi_mod +10.0.1.111> Looking for deps of module ohci-hcd: usbcore +10.0.1.111> Looking for deps of module pata_serverworks: scsi_mod libata +10.0.1.111> Looking for deps of module pci_hotplug +10.0.1.111> Looking for deps of module scsi_mod +10.0.1.111> Looking for deps of module scsi_transport_spi: scsi_mod +10.0.1.111> Looking for deps of module sd_mod: crc-t10dif scsi_mod +10.0.1.111> Looking for deps of module shpchp: pci_hotplug +10.0.1.111> Looking for deps of module uhci-hcd: usbcore +10.0.1.111> Looking for deps of module usbcore +10.0.1.111> Looking for deps of module usbhid: usbcore hid +10.0.1.111> resolving for availmodules +10.0.1.111> and that has items of +10.0.1.111> /lib/modules/2.6.33.3-desktop-1mnb/kernel/drivers/scsi/aic7xxx/aic7xxx.ko.gz -> /tmp/initrd.uuIIkZ/lib/modules/2.6.33.3-desktop-1mnb/aic7xxx.ko.gz +10.0.1.111> /lib/modules/2.6.33.3-desktop-1mnb/kernel/lib/crc-t10dif.ko.gz -> /tmp/initrd.uuIIkZ/lib/modules/2.6.33.3-desktop-1mnb/crc-t10dif.ko.gz +10.0.1.111> /lib/modules/2.6.33.3-desktop-1mnb/kernel/drivers/usb/host/ehci-hcd.ko.gz -> /tmp/initrd.uuIIkZ/lib/modules/2.6.33.3-desktop-1mnb/ehci-hcd.ko.gz +10.0.1.111> /lib/modules/2.6.33.3-desktop-1mnb/kernel/fs/ext3/ext3.ko.gz -> /tmp/initrd.uuIIkZ/lib/modules/2.6.33.3-desktop-1mnb/ext3.ko.gz +10.0.1.111> /lib/modules/2.6.33.3-desktop-1mnb/kernel/drivers/hid/hid.ko.gz -> /tmp/initrd.uuIIkZ/lib/modules/2.6.33.3-desktop-1mnb/hid.ko.gz +10.0.1.111> /lib/modules/2.6.33.3-desktop-1mnb/kernel/fs/jbd/jbd.ko.gz -> /tmp/initrd.uuIIkZ/lib/modules/2.6.33.3-desktop-1mnb/jbd.ko.gz +10.0.1.111> /lib/modules/2.6.33.3-desktop-1mnb/kernel/drivers/ata/libata.ko.gz -> /tmp/initrd.uuIIkZ/lib/modules/2.6.33.3-desktop-1mnb/libata.ko.gz +10.0.1.111> /lib/modules/2.6.33.3-desktop-1mnb/kernel/drivers/usb/host/ohci-hcd.ko.gz -> /tmp/initrd.uuIIkZ/lib/modules/2.6.33.3-desktop-1mnb/ohci-hcd.ko.gz +10.0.1.111> /lib/modules/2.6.33.3-desktop-1mnb/kernel/drivers/ata/pata_serverworks.ko.gz -> /tmp/initrd.uuIIkZ/lib/modules/2.6.33.3-desktop-1mnb/pata_serverworks.ko.gz +10.0.1.111> /lib/modules/2.6.33.3-desktop-1mnb/kernel/drivers/pci/hotplug/pci_hotplug.ko.gz -> /tmp/initrd.uuIIkZ/lib/modules/2.6.33.3-desktop-1mnb/pci_hotplug.ko.gz +10.0.1.111> /lib/modules/2.6.33.3-desktop-1mnb/kernel/drivers/scsi/scsi_mod.ko.gz -> /tmp/initrd.uuIIkZ/lib/modules/2.6.33.3-desktop-1mnb/scsi_mod.ko.gz +10.0.1.111> /lib/modules/2.6.33.3-desktop-1mnb/kernel/drivers/scsi/scsi_transport_spi.ko.gz -> /tmp/initrd.uuIIkZ/lib/modules/2.6.33.3-desktop-1mnb/scsi_transport_spi.ko.gz +10.0.1.111> /lib/modules/2.6.33.3-desktop-1mnb/kernel/drivers/scsi/sd_mod.ko.gz -> /tmp/initrd.uuIIkZ/lib/modules/2.6.33.3-desktop-1mnb/sd_mod.ko.gz +10.0.1.111> /lib/modules/2.6.33.3-desktop-1mnb/kernel/drivers/pci/hotplug/shpchp.ko.gz -> /tmp/initrd.uuIIkZ/lib/modules/2.6.33.3-desktop-1mnb/shpchp.ko.gz +10.0.1.111> /lib/modules/2.6.33.3-desktop-1mnb/kernel/drivers/usb/host/uhci-hcd.ko.gz -> /tmp/initrd.uuIIkZ/lib/modules/2.6.33.3-desktop-1mnb/uhci-hcd.ko.gz +10.0.1.111> /lib/modules/2.6.33.3-desktop-1mnb/kernel/drivers/usb/core/usbcore.ko.gz -> /tmp/initrd.uuIIkZ/lib/modules/2.6.33.3-desktop-1mnb/usbcore.ko.gz +10.0.1.111> /lib/modules/2.6.33.3-desktop-1mnb/kernel/drivers/hid/usbhid/usbhid.ko.gz -> /tmp/initrd.uuIIkZ/lib/modules/2.6.33.3-desktop-1mnb/usbhid.ko.gz +10.0.1.111> /etc/sysconfig/keyboard -> /tmp/initrd.uuIIkZ/etc/sysconfig/keyboard +10.0.1.111> /bin/loadkeys -> /tmp/initrd.uuIIkZ/bin/loadkeys +10.0.1.111> /etc/sysconfig/console/default.kmap -> /tmp/initrd.uuIIkZ/etc/sysconfig/console/default.kmap +10.0.1.111> /etc/sysconfig/i18n -> /tmp/initrd.uuIIkZ/etc/sysconfig/i18n +10.0.1.111> /bin/setfont -> /tmp/initrd.uuIIkZ/bin/setfont +10.0.1.111> /usr/lib/kbd/consolefonts/lat0-16.psfu.gz -> /tmp/initrd.uuIIkZ/usr/lib/kbd/consolefonts/lat0-16.psfu.gz +10.0.1.111> /lib/udev/console_init -> /tmp/initrd.uuIIkZ/lib/udev/console_init +10.0.1.111> probing for drm modules for pci device /sys/bus/pci/devices/0000:00:0e.0 +10.0.1.111> Adding graphics device /sys/bus/pci/devices/0000:00:0e.0 +10.0.1.111> Looking for deps of module pci:v00001002d00004752sv00001028sd00000121bc03sc00i00 +10.0.1.111> resolving for GRAPHICSMODS +10.0.1.111> and that has items of +10.0.1.111> Adding module usbhid +10.0.1.111> Adding module ehci-hcd +10.0.1.111> Adding module ohci-hcd +10.0.1.111> Adding module uhci-hcd +10.0.1.111> Adding module ext3 +10.0.1.111> Adding module crc-t10dif +10.0.1.111> Adding module scsi_mod +10.0.1.111> Adding module sd_mod +10.0.1.111> Adding module scsi_transport_spi +10.0.1.111> Adding module aic7xxx +10.0.1.111> Adding module pci_hotplug +10.0.1.111> Adding module shpchp +10.0.1.111> Adding module pata_serverworks +10.0.1.111> /usr/sbin/resume -> /tmp/initrd.uuIIkZ/bin/resume +10.0.1.111> /usr/lib/suspend/resume -> /tmp/initrd.uuIIkZ/usr/lib/suspend/resume +10.0.1.111> /usr/lib/liblzo2.so.2 -> /tmp/initrd.uuIIkZ/usr/lib/liblzo2.so.2 +10.0.1.111> /usr/lib/liblzo2.so.2.0.0 -> /tmp/initrd.uuIIkZ/usr/lib/liblzo2.so.2.0.0 +10.0.1.111> /lib/libpthread.so.0 -> /tmp/initrd.uuIIkZ/lib/libpthread.so.0 +10.0.1.111> /lib/libpthread-2.11.1.so -> /tmp/initrd.uuIIkZ/lib/libpthread-2.11.1.so +10.0.1.111> /lib/libply.so.2 -> /tmp/initrd.uuIIkZ/lib/libply.so.2 +10.0.1.111> /lib/libply.so.2.0.0 -> /tmp/initrd.uuIIkZ/lib/libply.so.2.0.0 +10.0.1.111> /lib/librt.so.1 -> /tmp/initrd.uuIIkZ/lib/librt.so.1 +10.0.1.111> /lib/librt-2.11.1.so -> /tmp/initrd.uuIIkZ/lib/librt-2.11.1.so +10.0.1.111> /lib/libply-splash-core.so.2 -> /tmp/initrd.uuIIkZ/lib/libply-splash-core.so.2 +10.0.1.111> /lib/libply-splash-core.so.2.0.0 -> /tmp/initrd.uuIIkZ/lib/libply-splash-core.so.2.0.0 +10.0.1.111> /etc/suspend.conf -> /tmp/initrd.uuIIkZ/etc/suspend.conf +10.0.1.111> This initrd uses dynamic shared objects. +10.0.1.111> Adding dynamic linker configuration files. +10.0.1.111> /etc/ld.so.conf -> /tmp/initrd.uuIIkZ/etc/ld.so.conf +10.0.1.111> Running ldconfig +10.0.1.111> Installation finished. No error reported. +10.0.1.111> This is the contents of the device map /boot/grub/device.map. +10.0.1.111> Check if this is correct or not. If any of the lines is incorrect, +10.0.1.111> fix it and re-run the script `grub-install'. +10.0.1.111> +10.0.1.111> (hd0) /dev/sda +10.0.1.111> Umounting /dev/sda5...OK +10.0.1.111> Umounting /dev/sda2...OK +10.0.1.111> ftp: connect: Connection refused +10.0.1.111> Local directory now /tmp +10.0.1.111> Not connected. +]]></programlisting> + </sect2> + <sect2> + <title>Post duplication process</title> + <para>Now client nodes reboots, so we have to switch PXE to a local boot.</para> + <para> +<programlisting><![CDATA[ +[root@node42 ka]# vi /var/lib/tftpboot/X86PC/linux/pxelinux.cfg/default +DEFAULT local +]]></programlisting> + </para> + <para>Nodes hsould be up, we can to see their hardware.</para> + <para> + <programlisting><![CDATA[ +[root@node42 ka]# ssh render@10.0.1.110 +[render@linux ~]$ lspcidrake +8139too : Realtek Semiconductor Co., Ltd.|RTL-8139/8139C/8139C+ [NETWORK_ETHERNET] (rev: 10) +snd_intel8x0 : Intel Corporation|82801EB/ER (ICH5/ICH5R) AC'97 Audio Controller [MULTIMEDIA_AUDIO] (rev: 02) +i2c_i801 : Intel Corporation|82801EB/ER (ICH5/ICH5R) SMBus Controller [SERIAL_SMBUS] (rev: 02) +ata_piix : Intel Corporation|82801EB/ER (ICH5/ICH5R) IDE Controller [STORAGE_IDE] (rev: 02) +iTCO_wdt : Intel Corporation|82801EB/ER (ICH5/ICH5R) LPC Interface Bridge [BRIDGE_ISA] (rev: 02) +shpchp : Intel Corporation|82801 PCI Bridge [BRIDGE_PCI] (rev: c2) +ehci_hcd : Intel Corporation|82801EB/ER (ICH5/ICH5R) USB2 EHCI Controller [SERIAL_USB] (rev: 02) +uhci_hcd : Intel Corporation|82801EB/ER (ICH5/ICH5R) USB UHCI Controller #4 [SERIAL_USB] (rev: 02) +uhci_hcd : Intel Corporation|82801EB/ER (ICH5/ICH5R) USB UHCI Controller #3 [SERIAL_USB] (rev: 02) +uhci_hcd : Intel Corporation|82801EB/ER (ICH5/ICH5R) USB UHCI Controller #2 [SERIAL_USB] (rev: 02) +uhci_hcd : Intel Corporation|82801EB/ER (ICH5/ICH5R) USB UHCI Controller #1 [SERIAL_USB] (rev: 02) +unknown : Intel Corporation|82865G/PE/P Processor to I/O Memory Interface [SYSTEM_OTHER] (rev: 02) +Card:Intel 810 and later: Intel Corporation|82865G Integrated Graphics Controller [DISPLAY_VGA] (rev: 02) +unknown : Intel Corporation|82865G/PE/P DRAM Controller/Host-Hub Interface [BRIDGE_HOST] (rev: 02) +hub : Linux 2.6.33.3-desktop-1mnb uhci_hcd|UHCI Host Controller [Hub|Unused|Full speed (or root) hub] +hub : Linux 2.6.33.3-desktop-1mnb uhci_hcd|UHCI Host Controller [Hub|Unused|Full speed (or root) hub] +hub : Linux 2.6.33.3-desktop-1mnb uhci_hcd|UHCI Host Controller [Hub|Unused|Full speed (or root) hub] +usbhid : |SCISSORS Keyboard [Human Interface Device|Boot Interface Subclass|Keyboard] +hub : Linux 2.6.33.3-desktop-1mnb uhci_hcd|UHCI Host Controller [Hub|Unused|Full speed (or root) hub] +hub : Linux 2.6.33.3-desktop-1mnb ehci_hcd|EHCI Host Controller [Hub|Unused|Full speed (or root) hub] +[render@linux ~]$ cat /etc/modprobe.conf +install scsi_hostadapter /sbin/modprobe ata_piix; /sbin/modprobe ahci; /bin/true +alias eth0 8139too +install usb-interface /sbin/modprobe ehci_hcd; /sbin/modprobe uhci_hcd; /bin/true +alias sound-slot-0 snd_intel8x0 + +[root@node42 ka]# ssh render@10.0.1.111 +[render@localhost ~]$ lspcidrake +ath5k : Atheros Communications Inc.|AR2413 802.11bg NIC [NETWORK_ETHERNET] (rev: 01) +tg3 : Broadcom Corporation|NetXtreme BCM5701 Gigabit Ethernet [NETWORK_ETHERNET] (rev: 15) +tg3 : Broadcom Corporation|NetXtreme BCM5701 Gigabit Ethernet [NETWORK_ETHERNET] (rev: 15) +aic7xxx : Adaptec|AIC-7899P U160/m [STORAGE_SCSI] (rev: 01) +aic7xxx : Adaptec|AIC-7899P U160/m [STORAGE_SCSI] (rev: 01) +shpchp : Intel Corporation|80303 I/O Processor PCI-to-PCI Bridge [BRIDGE_PCI] (rev: 01) +unknown : Broadcom|CIOB-X2 PCI-X I/O Bridge [BRIDGE_HOST] (rev: 03) +unknown : Broadcom|CIOB-X2 PCI-X I/O Bridge [BRIDGE_HOST] (rev: 03) +unknown : Broadcom|CIOB-X2 PCI-X I/O Bridge [BRIDGE_HOST] (rev: 03) +unknown : Broadcom|CIOB-X2 PCI-X I/O Bridge [BRIDGE_HOST] (rev: 03) +unknown : Broadcom|CSB5 LPC bridge [BRIDGE_ISA] +ohci_hcd : Broadcom|OSB4/CSB5 OHCI USB Controller [SERIAL_USB] (rev: 05) +pata_serverworks: Broadcom|CSB5 IDE Controller [STORAGE_IDE] (rev: 93) +i2c_piix4 : Broadcom|CSB5 South Bridge [BRIDGE_HOST] (rev: 93) +Card:ATI Mach 64-based cards (no 3D acceleration): ATI Technologies Inc|Rage XL [DISPLAY_VGA] (rev: 27) +unknown : Dell|Embedded Remote Access: BMC/SMIC device +unknown : Dell|Remote Access Card III +unknown : Dell|Embedded Remote Access or ERA/O +unknown : Broadcom|CMIC-LE [BRIDGE_HOST] +unknown : Broadcom|CMIC-WS Host Bridge (GC-LE chipset) [BRIDGE_HOST] +unknown : Broadcom|CMIC-WS Host Bridge (GC-LE chipset) [BRIDGE_HOST] (rev: 13) +hub : Linux 2.6.33.3-desktop-1mnb ohci_hcd|OHCI Host Controller [Hub|Unused|Full speed (or root) hub] + + +[render@localhost ~]$ cat /etc/modprobe.conf +install scsi_hostadapter /sbin/modprobe pata_serverworks; /sbin/modprobe aic7xxx; /bin/true +alias eth0 tg3 +alias eth1 tg3 +install ide-controller /sbin/modprobe ide_generic; /bin/true +install usb-interface /sbin/modprobe ohci_hcd; /bin/true +alias wlan0 ath5k +]]></programlisting> + </para> + </sect2> + </sect1> +</article> +<!-- Keep this comment at the end of the file +Local Variables: +mode: xml +sgml-parent-document: (".duplication.xml" "legalnotice") +End: +--> diff --git a/docs/ka_method/docbook-jadetex.dsssl b/docs/ka_method/docbook-jadetex.dsssl new file mode 100644 index 000000000..5b7d8b96d --- /dev/null +++ b/docs/ka_method/docbook-jadetex.dsssl @@ -0,0 +1,450 @@ +<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [ +<!ENTITY dbstyle SYSTEM "/usr/share/sgml/docbook/dsssl-stylesheets/print/docbook.dsl" CDATA DSSSL> +]> + +<!-- +;; This customization layer is inspired from: +;; +;;####################################################################### +;;# # +;;# The GNOME Documentation Project's # +;;# Custion DocBook Stylesheet Layer # +;;# by Dave Mason dcm@redhat.com # +;;# Based on Norman Walsh's Modular Stylesheets # +;;# # +;;# This is intended as a drop-in replacement for # +;;# the cygnus-both.dsl file in DocBook Tools. # +;;# Just copy it to the location dbtools created # +;;# and rename it cygnus-both.dsl # +;;# # +;;# This is Version 1.0-4 # +;;# patched to fix RTF output (#49677) # +;;# patched to work with docbook-dsssl-1.72 # +;;# patched for ADDRESS output (#50605) # +;;# removed comment and remark # +;;# disabled use-id-as-filename # +;;# don't define %graphic-default-extension% # +;;####################################################################### +--> + +<style-sheet> +<style-specification use="docbook"> +<style-specification-body> + +;;####################################################################### +;; Change the parameters below at your envy... +;;####################################################################### + +;;====================================== +;;General Options +;;====================================== + +;;Do you want to print on both sides of the paper? +(define %two-side% #f) + +;;Do you want enumerated sections? (E.g, 1.1, 1.1.1, 1.2, etc.) +(define %section-autolabel% #t) + +;;Show URL links? If the text of the link and the URL are identical, +;;the parenthetical URL is suppressed. +(define %show-ulinks% #t) + +;; footnotes at the bottom of each page (and not chapter) +(define bop-footnotes #t) + +;Make Ulinks footnotes to stop bleeding in the edges - this increases +;'jade --> print' time tremendously keep this in mind before +;complaining! +(define %footnote-ulinks% #t) + +(define %no-shade-screen% #f) + +;;Tex Backend on +(define tex-backend #t) + +;;Define Line Spacing +(define %line-spacing-factor% 1.1) + +;;Define the Paragraph Style +;;(define para-style +;; (style +;; font-size: %bf-size% +;; color: *blue* +;; font-weight: 'medium +;; font-posture: 'upright +;; font-family-name: %body-font-family% +;; line-spacing: (* %bf-size% %line-spacing-factor%))) + +(define ($object-titles-after$) + (list (normalize "figure"))) + +;;====================================== +;;Book Options +;;====================================== + +;;Do you want a title page for a Book? +(define %generate-book-titlepage% #t) + +;;Do you want a separate page for the title? +(define %generate-book-titlepage-on-separate-page% #f) + +;;Generate Book TOC? +(define %generate-book-toc% #t) + +;;What depth should the TOC generate? +;;!Only top level of appendixes! +(define (toc-depth nd) + (if (string=? (gi nd) (normalize "book")) + 3 + (if (string=? (gi nd) (normalize "appendix")) + 0 + 1))) + +;;Do you want a TOC for the element part? +(define %generate-part-toc% #f) + +;;Do you want the part toc on the part titlepage or separate? +;(define %generate-part-toc-on-titlepage% +; #t) + +;;Generate Part Title Page? +(define %generate-part-titlepage% #f) + +;;Do you want the Part intro on the part title page? +(define %generate-partintro-on-titlepage% #f) + +;;What elements should have a LOT? +(define ($generate-book-lot-list$) + (list (normalize "equation"))) + +;;Do you want chapters enumerated? +(define %chapter-autolabel% #t) + +;;Do you want Chapter's and Appendix's +;;to have automatic labels? +(define %chap-app-running-head-autolabel% #f) + +;;====================================== +;;Article Options +;;====================================== + +;;Do you want a title page for an Article? +(define %generate-article-titlepage% + #t) + +;;Generate Article TOC? +(define %generate-article-toc% + #t) + +;;Do you want a separate page for the title? +(define %generate-article-titlepage-on-separate-page% + #t) + +;;Do you want the article toc on the titlepage or separate? +(define %generate-article-toc-on-titlepage% + #t) + +;;Do you want to start new page numbers with each article? +(define %article-page-number-restart% + #f) + +;;Titlepage Separate? +(define (chunk-skip-first-element-list) + '()) + +;;Titlepage Not Separate +;(define (chunk-skip-first-element-list) +; (list (normalize "sect1") +; (normalize "section"))) + +;;====================================== +;;Columns +;;====================================== + +;;How many columns do you want? +(define %page-n-columns% 1) + +;;How much space between columns? +(define %page-column-sep% 0.2in) + +;;How many Columns on the titlepage? +(define %titlepage-n-columns% 1) + +;;Balance columns? +(define %page-balance-colums% #t) + +;;====================================== +;;Fonts +;;====================================== + +;;Defines the general size of the text in the document. normal(10), +;;presbyopic(12), and large-type(24). +(define %visual-acuity% "normal") + +;;What font would you like for titles? +(define %title-font-family% "Helvetica") + +;;What font would you like for the body? +(define %body-font-family% "Palatino") + +;;What font would you like for mono-seq? +(define %mono-font-family% "Courier New") + +;;If the base fontsize is 10pt, and '%hsize-bump-factor%' is +;; 1.2, hsize 1 is 12pt, hsize 2 is 14.4pt, hsize 3 is 17.28pt, etc +(define %hsize-bump-factor% + 1.1) + +;;What size do you want the body fonts? +(define %bf-size% + (case %visual-acuity% + (("tiny") 8pt) + (("normal") 10pt) + (("presbyopic") 12pt) + (("large-type") 24pt))) + +(define-unit em %bf-size%) + +;;====================================== +;;Margins +;;====================================== + +(define %left-right-margin% 2pi) + +;;How much indentation for the body? +(define %body-start-indent% 1pt) + +;;How big is the left margin? (relative to physical page) +(define %left-margin% 2pi) ;white-paper-column + +;;How big is the right margin? (relative to physical page) +(define %right-margin% 2pi) ;white-paper-column + +;;How big do you want the margin at the top? +(define %top-margin% +(if (equal? %visual-acuity% "large-type") + 7.5pi + 6pi)) + +;;How big do you want the margin at the bottom? +(define %bottom-margin% + (if (equal? %visual-acuity% "large-type") + 7.5pi + 6pi)) + +;;Define the text width. (Change the elements in the formula rather +;;than the formula itself) +;(define %text-width% (- %page-width% (* %left-right-margin% 2))) +(define %text-width% (- %page-width% (+ %left-margin% %right-margin%))) + +;;Define the body width. (Change the elements in the formula rather +;;than the formula itself) +(define %body-width% (- %text-width% %body-start-indent%)) + +;;Define distance between paragraphs +(define %para-sep% (/ %bf-size% 2.0)) + +;;Define distance between block elements (figures, tables, etc.). +(define %block-sep% (* %para-sep% 2.0)) + +;;Indent block elements? +(define %block-start-indent% 0pt) +;0pt + +;;====================================== +;;Admon Graphics +;;====================================== + +;;Do you want admon graohics on? +(define %admon-graphics% #t) + +;;Where are the admon graphics? +(define %admon-graphics-path% "images/") + +;;====================================== +;;Quadding +;;====================================== + +;;What quadding do you want by default; start, center, justify, or end? +(define %default-quadding% 'justify) + +;;What quadding for component titles(Chapter, Appendix, etc)? +(define %component-title-quadding% 'start) + +;;What quadding for section titles? +(define %section-title-quadding% 'start) + +;;What quadding for section sub-titles? +(define %section-subtitle-quadding% 'start) + +;;What quadding for article title? +(define %article-title-quadding% 'center) + +;;What quadding for article sub-titles? +(define %article-subtitle-quadding% 'center) + +;;What quadding for division subtitles? +(define %division-subtitle-quadding% 'start) + +;;What quadding for component subtitles? +(define %component-subtitle-quadding% 'start) + +(define box-start-indent .25in) +(define box-end-indent 5in) + +;;====================================== +;;Paper Options +;;====================================== + +;;What size paper do you need? A4, A5, USletter or USlandscape? +(define %paper-type% + "A4") + +;;Now define those paper types' width +(define %page-width% + (case %paper-type% + (("A4") 210mm) + (("A5") 148.5mm) + (("USletter") 8.5in) + (("USlandscape") 11in))) + +;;Now define those paper types' height +(define %page-height% + (case %paper-type% + (("A4") 297mm) + (("A5") 210mm) + (("USletter") 11in) + (("USlandscape") 8.5in))) + +;;Callouts are confusing in Postscript... fix them. +(define %callout-fancy-bug% #t) + +(define *rgb-color-space* + (color-space "ISO/IEC 10179:1996//Color-Space Family::Device RGB")) +(define *bluet* + (color *rgb-color-space* (/ 16 255) (/ 73 255) (/ 148 255))) +(define *grey* + (color *rgb-color-space* (/ 231 255) (/ 231 255) (/ 231 255))) +(define *bluec* + (color *rgb-color-space* (/ 74 255) (/ 97 255) (/ 173 255))) +(define *black* + (color *rgb-color-space* 0 0 0)) +(define *white* + (color *rgb-color-space* 1 1 1)) + +(element (book title) + (make sequence + color: *black* + ) + ) + +(element (chapter title) + (make paragraph + end-indent: 0.3cm + quadding: 'center + (make box + font-size: 16pt + font-weight: 'bold + background-color: *bluet* + color: *white* + ) + (empty-sosofo) + ) + ) + +(element (title) + (make paragraph + end-indent: 0.3cm + (make box + font-size: 13pt + font-posture: 'oblique + background-color: *bluec* + color: *white* + ) + (empty-sosofo) + ) + ) + +(element (para) + (make sequence + (make paragraph + space-before: 0.3cm + font-size: 10pt + color: *black* + ) + (empty-sosofo) + ) + ) + +(element (itemizedlist) + (make box + background-color: *grey* + color: *black* + ) + ) + +(element (orderedlist) + (make box + background-color: *grey* + color: *black* + ) + ) + +;;====================================== +;;Non-printing Elements +;;====================================== +;;(element TITLEABBREV (empty-sosofo)) +;;(element SUBTITLE (empty-sosofo)) +;;(element SETINFO (empty-sosofo)) +;;(element BOOKINFO (empty-sosofo)) +;;(element BIBLIOENTRY (empty-sosofo)) +;;(element BIBLIOMISC (empty-sosofo)) +;;(element BOOKBIBLIO (empty-sosofo)) +;;(element SERIESINFO (empty-sosofo)) +;;(element DOCINFO (empty-sosofo)) +;;(element ARTHEADER (empty-sosofo)) +;;(element revhistory (empty-sosofo)) +;;(element ADDRESS (empty-sosofo)) + +;;Show comment element? +(define %show-comments% + #t) + +;;====================================== +;;Formalpara titles +;;====================================== + + +;;Change the way Formal Paragraph titles are displayed. The commented +;;out section will run the titles in the paragraphs. +(element (formalpara title) + ;(make sequence + ;font-weight: 'bold + ;($runinhead$)) + ($lowtitle$ 5 7)) + +;;====================================== +;;Inlines +;;====================================== + +(element application ($mono-seq$)) +(element command ($bold-seq$)) +(element filename ($mono-seq$)) +(element function ($mono-seq$)) +(element guibutton ($bold-seq$)) +(element guiicon ($bold-seq$)) +(element guilabel ($italic-seq$)) +(element guimenu ($bold-seq$)) +(element guimenuitem ($bold-seq$)) +(element hardware ($bold-mono-seq$)) +(element keycap ($bold-seq$)) +(element literal ($mono-seq$)) +(element parameter ($italic-mono-seq$)) +(element prompt ($mono-seq$)) +(element symbol ($charseq$)) +(element emphasis ($italic-seq$)) + +</style-specification-body> +</style-specification> +<external-specification id="docbook" document="dbstyle"> +</style-sheet>
\ No newline at end of file diff --git a/docs/ka_method/duplication.xml b/docs/ka_method/duplication.xml new file mode 100644 index 000000000..410c37d40 --- /dev/null +++ b/docs/ka_method/duplication.xml @@ -0,0 +1,39 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//FR" +"/usr/share/sgml/docbook/xml-dtd-4.2/docbookx.dtd" [ +<!ENTITY dupli SYSTEM "doc-duplication.xml"> +]> +<!-- juste un commentaire --> +<book lang="en"> + <title>Mageia: HOWTO Clone a system using KA method</title> + <bookinfo> + <authorgroup> + <author> + <firstname>Antoine Ginies</firstname> + <email>aginies _@_ mandriva.com</email> + </author> + </authorgroup> + <revhistory> + <revision> + <revnumber>0.3</revnumber> + <date>May 2010</date> + <authorinitials>ag</authorinitials> + <revremark>update/fix</revremark> + </revision> + <revision> + <revnumber>0.2</revnumber> + <date>Fev 2010</date> + <authorinitials>ag</authorinitials> + <revremark>update</revremark> + </revision> + <revision> + <revnumber>0.1</revnumber> + <date>OCT 2007</date> + <authorinitials>ag</authorinitials> + <revremark>update</revremark> + </revision> + </revhistory> + <pubdate>2007</pubdate> + </bookinfo> + &dupli; +</book> diff --git a/docs/ka_method/duplication.xsl b/docs/ka_method/duplication.xsl new file mode 100644 index 000000000..f2027f5eb --- /dev/null +++ b/docs/ka_method/duplication.xsl @@ -0,0 +1,24 @@ +<?xml version='1.0'?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version='1.0' + xmlns="http://www.w3.org/TR/xhtml1/transitional" + exclude-result-prefixes="#default"> + +<xsl:import href="/usr/share/sgml/docbook/xsl-stylesheets/xhtml/chunk.xsl"/> +<xsl:param name="chunk.section.depth" select="0"/> +<xsl:param name="html.ext" select="'.html'"/> +<xsl:param name="navig.graphics" select="0"/> +<xsl:param name="generate.chapter.toc" select="0"/> +<xsl:param name="toc.section.depth" select="3"/> +<xsl:param name="section.autolabel" select="1"/> +<xsl:param name="section.label.includes.component.label" select="1"/> +<xsl:param name="html.stylesheet.type">text/css</xsl:param> +<xsl:param name="html.stylesheet">styleguibo.css</xsl:param> +<xsl:param name="chunker.output.encoding" select="'ISO-8859-1'"/> +<xsl:param name="css.decoration">1</xsl:param> +<xsl:param name="callout.defaultcolumn" select="'60'"/> +<xsl:param name="callout.graphics" select="'1'"/> +<xsl:param name="callout.list.table" select="'1'"/> +<xsl:param name="callout.graphics.extension" select="'.gif'"/> +<xsl:param name="callout.graphics.path">images</xsl:param> +</xsl:stylesheet> diff --git a/docs/ka_method/oneduplication.xsl b/docs/ka_method/oneduplication.xsl new file mode 100644 index 000000000..e63762722 --- /dev/null +++ b/docs/ka_method/oneduplication.xsl @@ -0,0 +1,37 @@ +<?xml version='1.0'?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version='1.0' + xmlns="http://www.w3.org/TR/xhtml1/transitional" + exclude-result-prefixes="#default"> + +<xsl:import + href="/usr/share/sgml/docbook/xsl-stylesheets/xhtml/onechunk.xsl"/> +<xsl:param name="chunk.section.depth" select="'1'"/> +<xsl:param name="html.ext" select="'.html'"/> +<xsl:param name="navig.graphics" select="'0'"/> +<xsl:param name="generate.chapter.toc" select="'1'"/> +<xsl:param name="toc.section.depth" select="'3'"/> +<xsl:param name="generate.toc"> + appendix toc + article toc + chapter toc + part toc + preface toc + qandadiv toc + qandaset toc + reference toc + section toc + set toc +</xsl:param> +<xsl:param name="section.autolabel" select="'1'"/> +<xsl:param name="chunker.output.encoding" select="'ISO-8859-1'"/> +<xsl:param name="section.autolabel" select="'1'"/> +<xsl:param name="section.label.includes.component.label" select="1"/> +<xsl:param name="html.stylesheet.type">text/css</xsl:param> +<xsl:param name="html.stylesheet">styleguibo.css</xsl:param> +<xsl:param name="css.decoration">1</xsl:param> +<xsl:param name="callout.defaultcolumn" select="'60'"/> +<xsl:param name="callout.graphics" select="'1'"/> +<xsl:param name="callout.list.table" select="'1'"/> +<xsl:param name="callout.graphics.path">images</xsl:param> +</xsl:stylesheet> diff --git a/docs/ka_method/styleguibo.css b/docs/ka_method/styleguibo.css new file mode 100644 index 000000000..9d088cc93 --- /dev/null +++ b/docs/ka_method/styleguibo.css @@ -0,0 +1,296 @@ +/* Documentation specific changes */ + +span.guilabel { + padding: 0px, 1px, 0px, 1px; + margin: 1px; + background: #e6e6e6; + border-style: none; +} + +span.guimenu, span.guimenuitem, .guibutton { + padding: 0px, 1px, 0px, 1px; + margin: 1px; + border-top: 1px solid #eeeeee; + border-right: 2px solid #cccccc; + border-bottom: 2px solid #cccccc; + border-left: 1px solid #eeeeee; + background: #f5f5f5; +} + +span.accel { + text-decoration: underline; +} + +pre.screen { background-color: #E0E0E0; } +pre.programlisting { background-color: #E0E0E0; } + +/* Colours borrowed from Firefox's keyboard shortcuts table */ +.keycap, .keysym { + padding: 0px, 1px, 0px, 1px; + margin: 1px; + border-top: 1px solid #eedddd; + border-right: 2px solid #bbaaaa; + border-bottom: 2px solid #bbaaaa; + border-left: 1px solid #eeeedd; + background: #faf6f6; + font-family: Courier, monospaced, mono; +} + + +/* Mandrakesoft.com website default */ + +BODY { + background-color: #ffffff; + font-family: Arial, sans-serif; + font-size: 14px; + color: #333333; +} + +.plinks { + background-color: #ffffff; + font-family: Arial, sans-serif; + font-size: 13px; + color: #333333; +} + +TD { + font-family: Arial, sans-serif; + font-size: 15px; + color: #333333; +} + +FORM { + display: inline; +} + +A:link { + text-decoration: none; + color: #21449c; +} + +A:visited { + text-decoration: none; + color: #21449c; +} + +A:hover { + text-decoration: underline; + color: #21449c; +} + +A:active { + text-decoration: underline; + color: #21449c; +} + +INPUT, SELECT { + font-size: 15px; +} + +A.News { + font-size: 13px; + color: #333333; +} + +h1 { + font-family: Arial, sans-serif; + font-size: 23px; + font-weight: bold; + color: #000000; +} + +h2 { + font-family: Arial, sans-serif; + font-size: 18px; + font-weight: bold; + color: #21449c; + display: inline; +} + +h3 { + font-family: Arial, sans-serif; + font-size: 15px; + font-weight: italic; + color: #11649b; + padding: 25px; + display: inline; +} + +h4 { + font-family: Arial, sans-serif; + font-size: 14px; + padding: 45px; + display: inline; +} + +h3.div { + font-family: Arial, sans-serif; + font-size: 11px; + padding: 45px; + display: inline; +} + + +#MainTable { + width: 900px; +} + + +#ContentTable { + width: 719px; +} + +.SelectedLinks { + color: #333333; + font-size: 15px; + font-weight: bold; + padding: 3px; + background-color: #eeeeee; +} + + +.Footer { + font-size: 14px; + padding: 3px; + background-color: #eeeeee; +} + + +.BoxTitle { + font-size: 15px; + color: #333333; + padding-top: 2px; + padding-bottom: 2px; + font-weight: bold; +} + +.BoxContent { + font-size: 13px; + color: #333333; + padding-top: 2px; + padding-bottom: 2px; +} + +.SelectList { + background-color: #ffffff; + color: #333333; + border-style: none; +} + +.InputText { + font-size: 15px; + border-style: solid; + background-color: #ffffff; + border-color: #cccccc; +} + +A.FocusTitle { + color: #999999; + font-weight: bold; + font-size: 15px; + font-decoration: none; +} + +.HomeLink, A.HomeLink { + color: #21449c; + font-size: 15px; +} + +.HomeNewsDate { + color: #21449c; + font-size: 13px; +} + +.text { + font-family: Arial, sans-serif; + font-size: 15px; + color : #333333; +} + +.texte { + font-family: Arial, sans-serif; + font-size: 15px; + color : #333333; +} + +.text4form { + font-family: Arial, sans-serif; + font-size: 15px; + color: #333333; +} + + +.titre1 { + font-family: Arial, sans-serif; + font-size: 15px; + font-weight: bold; + color: #21449c; +} + +.titre2 { + font-family: Arial, sans-serif; + font-size: 15px; + font-weight: bold; + color: #21449c; + display: inline; +} + +.titre3 { + font-family: Arial, sans-serif; + font-size: 15px; + font-weight: bold; + color: #333333; +} + +.textbox { + font-family: Arial, sans-serif; + text-align: left; + font-size: 15px; + color: #000000; +} + +.newsdate { + font-family: Arial, sans-serif; + font-size: 15px; + color: #000000; +} + +.date { + font-family: Arial, sans-serif; + font-size: 13px; + font-weight: normal; + color: #333333; +} + +.note { + font-family: Arial, sans-serif; + font-size: 13px; + color: #333366; +} + +.inzedark { + font-family: Arial, sans-serif; + font-size: 13px; + color: #ffffff; +} + +.titrinzedark { + font-family: Arial, sans-serif; + font-size: 13px; + font-weight: bold; + color: #ffffff; +} + +.TitreHome1 { + font-family: Arial, sans-serif; + font-size: 21px; + font-weight: bold; + color: #acacac; + } + +.TitreHome2 { + font-family: Arial, sans-serif; + font-size: 18px; + font-weight: bold; + color: #21449c; + } diff --git a/docs/mastering-tool-for-restore-cd b/docs/mastering-tool-for-restore-cd new file mode 100644 index 000000000..f40db4d77 --- /dev/null +++ b/docs/mastering-tool-for-restore-cd @@ -0,0 +1,84 @@ +Restore CD architecture ######################################################## + +the restore CD is based on a mdv rescue CD. +it typically contains: + + data/box.XXX/lst + data/box.XXX/hda5 + isolinux/all.rdz + isolinux/isolinux.bin + isolinux/isolinux.cfg + isolinux/vmlinuz + install/stage2/rescue.sqfs + + + data/box.XXX ####################################################### + + - lst contains the partition table and the drive geometry + (the format is custom, read and generated by partimage_whole_disk) + + - hda5 is an imagefile, a mirror of /dev/hda5 + (the format is partimage only, the idea of partimage is same as dump(8)) + + isolinux ########################################################### + + - kernel and stage1 (same as standard mdv rescue) + + - isolinux.cfg customized to call directly save_all or rest_all + (with option keepmounted for rest_all) + + install/stage2/rescue.sqfs ########################################## + + - compressed loopback containing a iso9660 filesystem. + it is mostly the same as the mdv rescue.sqfs, *plus* partimage_whole_disk + (nb : use extract_compressed_fs/create_compressed_fs to expand/create rescue.sqfs) + + +Mastering process ############################################################## + +1. install a distribution and customize it + + nb: it's better to leave an empty space on the disk after the /home + partition (since the restore script grows it, it's no waste) to allow + adapting to different disk geometry without failing + +2. boot on part_save_all.iso +3. "partimage_whole_disk -s hostfoo save_all /data/box" is called + 3.1. it connects to partimaged server on hostfoo + 3.2. it fins the first free /data/box.XXX + 3.3. it saves the partition table and geometry in /data/box.XXX/lst calling + partimage with action save_file (need a patched partimage) + 3.4. it saves the devices needing to be saved calling partimage with action save. + nb: it doesn't save swap partitions (useless) + nb: it doesn't save ntfs/fat partitions + nb: with option save_home_directory, the last linux partition is not saved + +4. a restore CD iso is built using the data from step (3.) +5. restore CD is burned + +6. restore CD booted on the target computer +7. "partimage_whole_disk rest_all /data/box.XXX" is called + 7.1. it resizes main windows partition if wanted and needed + 7.2. it gets the partition table and geometry and creates partition table + accordingly + 7.3. it creates swap partitions if needed + 7.4. it restores linux partitions + 7.5. it creates linux partitions if wanted (esp. for /home) + 7.6. it grows the last linux partition if wanted (esp. for /home) + 7.7. it installs the bootloader (calling rescue script "install_bootloader") + + +Build process ################################################################## + +- patched partimaged must be installed and launched + (one gets patched partimage rpm building with option "--with jail") + +- the data gets to /var/lib/partimage/data/box.XXX (owned by user partimag) + +- sudo chmod a+r /var/lib/partimage/data/*/* + +- in gi/rescue, call + ./make_partimage_save_rest_all partimage-0.6.4-7mdk.i586.rpm /var/lib/partimage /data/box.XXX + + => it calls ./make_rescue_img with special options to create a special rescue.sqfs + => generates part_save_all.iso and part_rest_all.iso |