diff options
| author | Antoine Ginies <aginies@mandriva.com> | 2011-01-19 10:44:49 +0000 |
|---|---|---|
| committer | Antoine Ginies <aginies@mandriva.com> | 2011-01-19 10:44:49 +0000 |
| commit | 530a16ec071db0e24e6e949e265a96848864967c (patch) | |
| tree | fe40cacd28d67b98186754c551b7fd339ebc7e17 /docs | |
| download | drakx-backup-do-not-use-530a16ec071db0e24e6e949e265a96848864967c.tar drakx-backup-do-not-use-530a16ec071db0e24e6e949e265a96848864967c.tar.gz drakx-backup-do-not-use-530a16ec071db0e24e6e949e265a96848864967c.tar.bz2 drakx-backup-do-not-use-530a16ec071db0e24e6e949e265a96848864967c.tar.xz drakx-backup-do-not-use-530a16ec071db0e24e6e949e265a96848864967c.zip | |
add mes5-2.6.33 branch
Diffstat (limited to 'docs')
38 files changed, 5330 insertions, 0 deletions
diff --git a/docs/COPYING b/docs/COPYING new file mode 100644 index 000000000..60549be51 --- /dev/null +++ b/docs/COPYING @@ -0,0 +1,340 @@ + GNU GENERAL PUBLIC LICENSE + Version 2, June 1991 + + Copyright (C) 1989, 1991 Free Software Foundation, Inc. + 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The licenses for most software are designed to take away your +freedom to share and change it. By contrast, the GNU General Public +License is intended to guarantee your freedom to share and change free +software--to make sure the software is free for all its users. This +General Public License applies to most of the Free Software +Foundation's software and to any other program whose authors commit to +using it. (Some other Free Software Foundation software is covered by +the GNU Library General Public License instead.) You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +this service if you wish), that you receive source code or can get it +if you want it, that you can change the software or use pieces of it +in new free programs; and that you know you can do these things. + + To protect your rights, we need to make restrictions that forbid +anyone to deny you these rights or to ask you to surrender the rights. +These restrictions translate to certain responsibilities for you if you +distribute copies of the software, or if you modify it. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must give the recipients all the rights that +you have. You must make sure that they, too, receive or can get the +source code. And you must show them these terms so they know their +rights. + + We protect your rights with two steps: (1) copyright the software, and +(2) offer you this license which gives you legal permission to copy, +distribute and/or modify the software. + + Also, for each author's protection and ours, we want to make certain +that everyone understands that there is no warranty for this free +software. If the software is modified by someone else and passed on, we +want its recipients to know that what they have is not the original, so +that any problems introduced by others will not reflect on the original +authors' reputations. + + Finally, any free program is threatened constantly by software +patents. We wish to avoid the danger that redistributors of a free +program will individually obtain patent licenses, in effect making the +program proprietary. To prevent this, we have made it clear that any +patent must be licensed for everyone's free use or not licensed at all. + + The precise terms and conditions for copying, distribution and +modification follow. + + GNU GENERAL PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. This License applies to any program or other work which contains +a notice placed by the copyright holder saying it may be distributed +under the terms of this General Public License. The "Program", below, +refers to any such program or work, and a "work based on the Program" +means either the Program or any derivative work under copyright law: +that is to say, a work containing the Program or a portion of it, +either verbatim or with modifications and/or translated into another +language. (Hereinafter, translation is included without limitation in +the term "modification".) Each licensee is addressed as "you". + +Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running the Program is not restricted, and the output from the Program +is covered only if its contents constitute a work based on the +Program (independent of having been made by running the Program). +Whether that is true depends on what the Program does. + + 1. You may copy and distribute verbatim copies of the Program's +source code as you receive it, in any medium, provided that you +conspicuously and appropriately publish on each copy an appropriate +copyright notice and disclaimer of warranty; keep intact all the +notices that refer to this License and to the absence of any warranty; +and give any other recipients of the Program a copy of this License +along with the Program. + +You may charge a fee for the physical act of transferring a copy, and +you may at your option offer warranty protection in exchange for a fee. + + 2. You may modify your copy or copies of the Program or any portion +of it, thus forming a work based on the Program, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions: + + a) You must cause the modified files to carry prominent notices + stating that you changed the files and the date of any change. + + b) You must cause any work that you distribute or publish, that in + whole or in part contains or is derived from the Program or any + part thereof, to be licensed as a whole at no charge to all third + parties under the terms of this License. + + c) If the modified program normally reads commands interactively + when run, you must cause it, when started running for such + interactive use in the most ordinary way, to print or display an + announcement including an appropriate copyright notice and a + notice that there is no warranty (or else, saying that you provide + a warranty) and that users may redistribute the program under + these conditions, and telling the user how to view a copy of this + License. (Exception: if the Program itself is interactive but + does not normally print such an announcement, your work based on + the Program is not required to print an announcement.) + +These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Program, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Program, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote it. + +Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Program. + +In addition, mere aggregation of another work not based on the Program +with the Program (or with a work based on the Program) on a volume of +a storage or distribution medium does not bring the other work under +the scope of this License. + + 3. You may copy and distribute the Program (or a work based on it, +under Section 2) in object code or executable form under the terms of +Sections 1 and 2 above provided that you also do one of the following: + + a) Accompany it with the complete corresponding machine-readable + source code, which must be distributed under the terms of Sections + 1 and 2 above on a medium customarily used for software interchange; or, + + b) Accompany it with a written offer, valid for at least three + years, to give any third party, for a charge no more than your + cost of physically performing source distribution, a complete + machine-readable copy of the corresponding source code, to be + distributed under the terms of Sections 1 and 2 above on a medium + customarily used for software interchange; or, + + c) Accompany it with the information you received as to the offer + to distribute corresponding source code. (This alternative is + allowed only for noncommercial distribution and only if you + received the program in object code or executable form with such + an offer, in accord with Subsection b above.) + +The source code for a work means the preferred form of the work for +making modifications to it. For an executable work, complete source +code means all the source code for all modules it contains, plus any +associated interface definition files, plus the scripts used to +control compilation and installation of the executable. However, as a +special exception, the source code distributed need not include +anything that is normally distributed (in either source or binary +form) with the major components (compiler, kernel, and so on) of the +operating system on which the executable runs, unless that component +itself accompanies the executable. + +If distribution of executable or object code is made by offering +access to copy from a designated place, then offering equivalent +access to copy the source code from the same place counts as +distribution of the source code, even though third parties are not +compelled to copy the source along with the object code. + + 4. You may not copy, modify, sublicense, or distribute the Program +except as expressly provided under this License. Any attempt +otherwise to copy, modify, sublicense or distribute the Program is +void, and will automatically terminate your rights under this License. +However, parties who have received copies, or rights, from you under +this License will not have their licenses terminated so long as such +parties remain in full compliance. + + 5. You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Program or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Program (or any work based on the +Program), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Program or works based on it. + + 6. Each time you redistribute the Program (or any work based on the +Program), the recipient automatically receives a license from the +original licensor to copy, distribute or modify the Program subject to +these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted herein. +You are not responsible for enforcing compliance by third parties to +this License. + + 7. If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not distribute the Program at all. For example, if a patent +license would not permit royalty-free redistribution of the Program by +all those who receive copies directly or indirectly through you, then +the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Program. + +If any portion of this section is held invalid or unenforceable under +any particular circumstance, the balance of the section is intended to +apply and the section as a whole is intended to apply in other +circumstances. + +It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system, which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing +to distribute software through any other system and a licensee cannot +impose that choice. + +This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License. + + 8. If the distribution and/or use of the Program is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Program under this License +may add an explicit geographical distribution limitation excluding +those countries, so that distribution is permitted only in or among +countries not thus excluded. In such case, this License incorporates +the limitation as if written in the body of this License. + + 9. The Free Software Foundation may publish revised and/or new versions +of the General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + +Each version is given a distinguishing version number. If the Program +specifies a version number of this License which applies to it and "any +later version", you have the option of following the terms and conditions +either of that version or of any later version published by the Free +Software Foundation. If the Program does not specify a version number of +this License, you may choose any version ever published by the Free Software +Foundation. + + 10. If you wish to incorporate parts of the Program into other free +programs whose distribution conditions are different, write to the author +to ask for permission. For software which is copyrighted by the Free +Software Foundation, write to the Free Software Foundation; we sometimes +make exceptions for this. Our decision will be guided by the two goals +of preserving the free status of all derivatives of our free software and +of promoting the sharing and reuse of software generally. + + NO WARRANTY + + 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY +FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN +OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES +PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED +OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS +TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE +PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, +REPAIR OR CORRECTION. + + 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR +REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, +INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING +OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED +TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY +YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER +PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE +POSSIBILITY OF SUCH DAMAGES. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +convey the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + <one line to give the program's name and a brief idea of what it does.> + Copyright (C) 19yy <name of author> + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + + +Also add information on how to contact you by electronic and paper mail. + +If the program is interactive, make it output a short notice like this +when it starts in an interactive mode: + + Gnomovision version 69, Copyright (C) 19yy name of author + Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, the commands you use may +be called something other than `show w' and `show c'; they could even be +mouse-clicks or menu items--whatever suits your program. + +You should also get your employer (if you work as a programmer) or your +school, if any, to sign a "copyright disclaimer" for the program, if +necessary. Here is a sample; alter the names: + + Yoyodyne, Inc., hereby disclaims all copyright interest in the program + `Gnomovision' (which makes passes at compilers) written by James Hacker. + + <signature of Ty Coon>, 1 April 1989 + Ty Coon, President of Vice + +This General Public License does not permit incorporating your program into +proprietary programs. If your program is a subroutine library, you may +consider it more useful to permit linking proprietary applications with the +library. If this is what you want to do, use the GNU Library General +Public License instead of this License. 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..7dd6524b7 --- /dev/null +++ b/docs/Partition-ends-after-end-of-disk.txt @@ -0,0 +1,66 @@ + Cylinder/Head/Size Hell Is Not Over + + pixel@mandrakesoft.com + $Date: 2002-08-28 07:54:19 -0400 (Wed, 28 Aug 2002) $ + + +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 new file mode 100644 index 000000000..54320919f --- /dev/null +++ b/docs/README @@ -0,0 +1,208 @@ +Well here is a little description of what DrakX needs to work + +******************************************************************************** +* VCS ************************************************************************** +******************************************************************************** +Like all good free software, DrakX is in SVN :) + +You can access it at http://svn.mandriva.com/cgi-bin/viewvc.cgi/soft/drakx/trunk/ + +or via + +svn co http://svn.mandriva.com/svn/soft/drakx/trunk drakx + + +This is only read-only access. If you want more, tell me (pixel@mandriva.com) + +******************************************************************************** +* Making your custom install *************************************************** +******************************************************************************** +If you have your own rpms you want to add, or make your own updated cdrom, you +just have to issue: + +% gendistrib --noclean --distrib <DIR> + +Where <DIR> is the root of all the distribution. + +``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 ``media/media_info/rpmsrate''; this file manages +the relative importance of the files, and thus their installation or not. + +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. + +******************************************************************************** +* FILES ************************************************************************ +******************************************************************************** +First here are the different things needed : + +media/media_info/media.cfg + description of the available install media. + 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 media/main changes (with ``gendistrib'') ! + +media/media_info/compssUsers.pl + +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 media/media_info/compssUsers* files, + and <level> defines importance level as described below : + 5 mandatory + 4 important + 3 interesting + 2 nice + 1 maybe + 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. + +install/stage2/mdkinst.clp + for the compressed loopback of install. + generated from install/stage2/live tree using misc/mdkinst_stage2_tool + +install/stage2/rescue.clp + rescue ramdisk. create_compressed_fs iso file + this is the ramdisk loaded when typing rescue on boot prompt. + +install/images/all.img + fat16 image to dd on a partition (hint: sda1) + +install/images/boot.iso + iso image to burn enabling any install (cdrom/hd/nfs/ftp) + + 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 ************************************************************************* +******************************************************************************** +During install, a lot of interesting stuff can be found in different places: +in consoles and in files. To switch to console 2 for example, do Ctrl-Alt-F2 +from the X install. +- alt-F1: the stdout of the install. Not very interesting stuff +- alt-F2: simple shell. Quite a lot of commands are available but as they are +written in perl (for space), they do not handle the very same options as normal. +After install, you can do ``chroot /mnt'' to see your system just like after +rebooting. ``rpm -qa'' works for example. +- alt-F3: a lot of interesting things. Be carefull, some ``ERROR'' messages are +not interesting. +- alt-F4: kernel's place. aka the output of dmesg. +- alt-F7: the graphical install lives there + +- 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/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/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, +the auto-partitionning partitions can be changed, the default user class can be +set to developer (!)... + +******************************************************************************** +* modules ********************************************************************** +******************************************************************************** +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. + +******************************************************************************** +* Making screenshots *********************************************************** +******************************************************************************** +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 + +******************************************************************************** +* Auto install ***************************************************************** +******************************************************************************** +A powerful auto-install system is available. It allows performing +an install without any human interaction. + +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: + +http://members.shaw.ca/Mandrake2/drakx/9.2/AutoInstall-9.2.2.html + +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 + +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 **************************************************************** +******************************************************************************** +> o Media access methods: nfs, ftp, http, hd, cdrom +> o Stages: init, stage1, stage2 +> - What exactly each stage does + +init loads stage1 +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, 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 drakx/docs/object_class.fig + diff --git a/docs/README.devel b/docs/README.devel new file mode 100644 index 000000000..989946de9 --- /dev/null +++ b/docs/README.devel @@ -0,0 +1,252 @@ +Well here is a little description of how DrakX can be modified or extended. +Please refer to README file for getting DrakX code source and to known more +exactly how it works and what it can do. + + +******************************************************************************** +* Execution of DrakX *********************************************************** +******************************************************************************** +DrakX has originally be written by pixel in perl and C. +entry point for stage2 is /usr/bin/runinstall2 which is typically a link to +/usr/bin/install2 which simply load module install2.pm and execute +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 +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(). +while running step, it trap any errors that may arise and use perl exception to +change step. + +******************************************************************************** +* DrakX modules descriptions *************************************************** +******************************************************************************** +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 + 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 + methods. typically are found all interactive code of DrakX for each steps. + +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 + modules described below). + +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 + interactive_newt. + +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 + not used by standalone tools. + +install_gtk: contains various methods using gtk interface but not used by + standalone tools. + +interactive_stdio: implementation methods for interactivity in stdio mode. + inherit module interactive. + +interactive_newt: implementation methods for interactivity in newt mode. + inherit module interactive. + +interactive_gtk: implementation methods for interactivity in gtk mode. + inherit module interactive. + +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. + +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 + code that reference interactive method which are not defined. + +common: contains very simple and very usefull (common) methods to do various task. + some methods inspired by functionnal language. + +c: contains wrapper to C definition of methods used by DrakX, use of C is necessary + for C extern libraries interface (rpmlib, ldetect), kernel interface, XFree + interface. + +commands: implement some un*x commands, conflicting name with perl contains + trailing underscore (_). this module is used by commands perl script that + determine which command to run according to $0 (this is used this way when DrakX + is running). + +run_program: allow running a program with redirection but without using a shell. + allow rooted execution. + +help: contains all help message displayed by DrakX. + +log: log facility methods. + +lang: language manipulation methods, get and set sysconfig file, load po. + +keyboard: keyboard manipulation methods, get and set sysconfig file, set console + keyboard mapping. + +mouse: mouse manipulation methods, get and set sysconfig file, change mouse. + +timezone: time zone manipulation methods, get and set timezone. + +services: services manipulation methods, activate or delete services (see + /etc/rc.d/init.d directories). + +detect_devices: manage detection of various class of hardware. + +devices: manage device file, create device special according device name. + +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::bsd: matches a BSD partition table. + +partition_table::dos: matches a DOS partition table. + +partition_table::emtpy: matches an empty 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. + +fs: read and write /etc/fstab file, mount and umount, format. + +fsedit: manage (modyfy, edit) mount point associated to partition (like editing + /etc/fstab). + +swap: swap management methods, format and mount (activation). + +raid: raid (software only) management methods. + +lvm: lvm (Logical Volume Manager) management methods. + +loopback: loopback management methods, used for lnx4win type installation or using + a file as a partition. + +diskdrake: diskdrake itself, disk graphical (using gtk) manipulation tools. + +ftp: ftp mangement methods, used when using ftp install. + +http: http management methods, used when using http install. + +modparm: kernel modules options management, allow building nice dialog with each + module parameter available. + +modules: kernel modules management, allow loading or unloading (ala modprobe or + insmod). + +printer: printer management methods, read and write both LPR or CUPS configuration. + +printerdrake: interactive printer management methods. + +network: network management methods, get and set sysconfig file. + +netconnect: network configuration wizard. + +netconnect_const: network configuration wirard data. + +Xconfig: X configuration (monitor + already existing config file) management. + +Xconfigurator: X configuration wizard. + +Xconfigurator_const: X configuration wizard data. + +booloader: bootloader (LILO, GRUB, LOADLIN, SILO) configuration management methods. + +pkgs: rpm package and hdlist, depslist management methods, allow selecting or + unselecting packages, manage rpmsrate file and select group, installation and + removal methods of rpm file. + +crypto: *obsoleted* module to manage crypto site and rpm file. + +standalone: standalone only, allow defining a standalone tools. + +bootlook: standalone only, interface with DrakConf to configure bootloader options. + +drakfirewall: standalone only, interface with DrakConf to configure a tiny firewall. + +******************************************************************************** +* DrakX FAT resizer module description ***************************************** +******************************************************************************** +here is a fat resizer written in perl and C used by DrakX (diskdrake) to resize +FAT16/FAT32 partition. it moves clusters to make sure a shrink can be done on the +limit of the partition itself, if no cluster need to be moved, only boot sector +partition limit are modified. + +any: various methods to flag cluster, compute min size. + +boot_sector: boot sector management methods. + +c_rewritten: originally resize_fat was only perl, this contains code section that + are the most sensible to speed or memory contraints and have been rewritten to C + using perl extension. + +dir_entry: manage directory structure. + +directory: traverse directory recursively, needed to move correctly cluster. + +fat: manage fat structure. + +info_sector: manage info sector. + +io: manage I/O on disk (need to take care of big file as partition size may be + larger than 2GB). + +main: main resizer algortihm. if needed allocate new clusters, copy files, copy + directories. update boot sector info. + +******************************************************************************** +* Adding a new step to DrakX *************************************************** +******************************************************************************** +Say we want to add a question for setting "alawindows" option. +We put it pretty early in the install, let's say after "Select Installation +Class". + +1. in install2.pm + +add + + selectAlawindows => [ __("A la windows or not"), 0, 1, '' ], + +after + + selectInstallClass => [ __("Select installation class"), 1, 1, '' ], + +the 0, 1, '' means not "redoable", "skip on error", "don't hide" + +2. add your function selectAlawindows in install2.pm + +sub selectAlawindows { $o->selectAlawindows } + +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 +case, except for auto_install) + +sub selectAlawindows {} + + diff --git a/docs/README.pxe b/docs/README.pxe new file mode 100644 index 000000000..2ddd205fe --- /dev/null +++ b/docs/README.pxe @@ -0,0 +1,133 @@ +Here is a short description to configure a PXE server using dhcpd and tftpd. +This allows a network boot for your ethernet card conforming to the Interl +PXE specification. + +******************************************************************************** +********** General overview ************ +******************************************************************************** + +You need a dhcp server and a tftp server on one or two machines to allow the +network boot. We are not using a PXE server to achieve this as it is not +mandatory. +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 +assumed to be your domain name, and 192.168.1.1 a name server. All install are +done on subnet 192.168.2.0. + +All the files that will be downloaded by the tftp daemon are located under +"/tftpboot" : + "/tftpboot/pxelinux.0" is a program that is loaded directly by the machine + where a network boot will be done, this program comes + from the SYSLINUX package by H. Peter Anvin. (look at + http://syslinux.zytor.com/pxe.php for more information) + "/tftpboot/pxelinux.cfg/" is a directory where all configuration file for + pxelinux.0 will be found, pxelinux.0 will download + these file by itself. It searches first for a file + named accordind to the machine IP address in + hexadecimal, for example for 192.168.2.20, it + looks for "C0A80214" first, then "C0A8021" and so + on down to "C0", "C" and "default". + "/tftpboot/network.rdz" is the standard network initrd for Mandrake installation. + "/tftpboot/vmlinuz" is the boot kernel for installation. + "/tftpboot/help.msg" is the message displayed by pxelinux.0, note that currently + graphical message (as for install using SYSLINUX 1.48 with + graphic patch by Mandrake) is not supported. + +All file "network.rdz", "vmlinuz", "help.msg" can be found by mounting "network.img", +or the network floppy disk used for install, "pxelinux.cfg" is just an adaptation +of the file found on the "network.img" called "syslinux.cfg" but without the reference +to boot.msg (as it is not currently supported). + +Update network configuration for your needs and start dhcp server on the machine and +tftp server and this should work. + +******************************************************************************** +* /etc/dhcpd.conf ************************************************************** +******************************************************************************** +ddns-update-style ad-hoc; + +authoritative; + +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; + +default-lease-time 28800; +max-lease-time 86400; + +option domain-name "mydomain.com"; +option domain-name-servers 192.168.1.1; + +class "PXE" { + match if substring(option vendor-class-identifier, 0, 9) = "PXEClient"; + option vendor-class-identifier "PXEClient"; + + vendor-option-space PXE; + option PXE.mtftp-ip 0.0.0.0; + next-server 192.168.2.1; #tftp server location + + filename "pxelinux.0"; # standard TFTP + +} + +shared-network "mynetwork" { + subnet 192.168.2.0 netmask 255.255.255.0 { + option subnet-mask 255.255.255.0; + option routers 192.168.2.1; + + ddns-domainname = "mydomain.com"; + + pool { + range 192.168.2.10 192.168.2.20; + allow members of "PXE"; + } + } +} +******************************************************************************** +* /tftpboot/pxelinux.cfg/default *********************************************** +******************************************************************************** +default linux +prompt 1 +timeout 72 +display help.msg +label linux + kernel vmlinuz + append ramdisk_size=32000 initrd=network.rdz root=/dev/ram3 vga=788 +label vgalo + kernel vmlinuz + append ramdisk_size=32000 initrd=network.rdz root=/dev/ram3 vga=785 +label vgahi + kernel vmlinuz + append ramdisk_size=32000 initrd=network.rdz root=/dev/ram3 vga=791 +label vga16 + kernel vmlinuz + append ramdisk_size=32000 initrd=network.rdz root=/dev/ram3 vga16 +label text + kernel vmlinuz + append ramdisk_size=32000 initrd=network.rdz root=/dev/ram3 text +label patch + kernel vmlinuz + append ramdisk_size=32000 initrd=network.rdz root=/dev/ram3 patch vga=788 +label expert + kernel vmlinuz + append ramdisk_size=32000 initrd=network.rdz root=/dev/ram3 expert vga=788 +label rescue + kernel vmlinuz + append ramdisk_size=32000 initrd=network.rdz root=/dev/ram3 rescue rw +label oem + kernel vmlinuz + append ramdisk_size=32000 initrd=network.rdz automatic=method:cdrom root=/dev/ram3 rescue oem rw +******************************************************************************** +* Usefull linkst *************************************************************** +******************************************************************************** + +http://syslinux.zytor.com/pxe.php +http://www.kano.org.uk/projects/pxe/ diff --git a/docs/SHORTCUTS b/docs/SHORTCUTS new file mode 100644 index 000000000..93a7133db --- /dev/null +++ b/docs/SHORTCUTS @@ -0,0 +1,51 @@ +******************************************************************************** +main shortcuts + +F1 -> help +F2 -> take a screenshot +F11 -> previous step +F12 -> next (reachable) step + +******************************************************************************** +diskdrake + +taken directly from diskdrake.pm: + + "a" => \&Active, + "b" => \&Move, + "c" => \&Create, + "d" => \&Delete, + "f" => \&Format, + "m" => \&Mount_point, + "M" => \&Mount, + "n" => \&Create, + "o" => \&ReadFromFile, + "s" => \&SaveInFile, + "q" => \&Exit, + "r" => \&Resize, + "t" => \&Type, + "u" => \&Unmount, + "w" => \&WritePartitions, + "W" => \&WriteFstab, + +hopefully it is explicit enough :) + +******************************************************************************** +list choice + +- acceleration a la windows (default): enter a letter and the selection will move to the +first entry beginning with that letter. If you enter another letter it will try +to find the entry beginning with the 2 letters you have given. In case it fails +the starting_word is reset. +- incremental search a la emacs: searches trough the list + +Use control-s to use incremental search and then to search next occurence + +******************************************************************************** +in case of complete mouse sh**t + +XFree86 provides a way of moving the mouse pointer: +- first, press Ctrl-Shift-NumLock +- then move the pointer with the keypad arrows +- press button is ``0'' (aka Inser) +- release button is ``.'' (aka Suppr) diff --git a/docs/advocacy b/docs/advocacy new file mode 100644 index 000000000..9e7f00b6b --- /dev/null +++ b/docs/advocacy @@ -0,0 +1,87 @@ +a little DrakX history: + +june 1999: + i start rewriting redhat's install in perl, partly for the fun of it. I'm + still working for the army + +5 july 1999: + i start full time job at mandrakesoft. But we don't have many computers and i + must share the accounting computer with Merieme who is working half-time. No + test machine (i test on others box, and destroyed Jacques partitions once), + guess how it slows things down? + +august 1999: + at last computers, even test one + first DrakX version which can install things, very very rough + +september 1999: + a friend of mine help me 2 weeks on DrakX relayed by Francois + +november 1999: + first released version of DrakX (goldpack). Not really stable yet. + +january 2000: + 7.0 is out, with a DrakX quite stable + +july 2000: + dams starts working on draknet + +mid-october -> mid-january 2000: + gc rewrites the stage1 to win every kb we can + -> size divided by 7 (!) for cdrom + + +The DrakX team is also doing a lot of other things: +- drakxtools +- urpmi, early MandrakeUpdate, early rpmdrake... +- Mandrake Control Center (new DrakConf) +- packages maintenance/enhancing (esp. ghostscript, 3D-wrappers, lilo) +- fixing core packages to make them installable +- scoring packages, sorting them, flagging them... (compssList, rpmsrate) +- reading/answering cooker and other MLs +- helping non-perl gurus :) + +That doesn't give much. Me being the one more working on plain DrakX. It gives 2 +people working for 1.5 years. IMO it isn't ``spending an enormous amount of +resources''. +And what do you mean by ``compared to the code base size''??? DrakX is currently +around 28K lines, which is big IMO. You can compare it with linuxconf which is +170K lines. I think the achievement of DrakX is comparable (a 6 times code size +win from dumb C++ to expressive perl is normal imo). + + +Also it seems like we don't have the same understanding of the word +"maintenance". +DrakX functionalities have evolved *a lot* since the beginning: + +- hardware detection, configuration, debugging, work-arounding (multi-kernel installs...) +- making things prettier + - more bitmaps + - "advanced" button + - syslinux graphical boot +- making it work with latest versions of software (eg: switching to rpm4) +- finding out the best way to use rpmlib +- multi-cd +- draknet: configuring every piece of stupid protocols +- diskdrake: raid, loopback, LVM, resizing, checking stupid users entry +- XFdrake: multi-mice, multi-heads, 3D-accel +- porting to axp/sparc/ppc (with Stew's help) +- always more i18n +- keeping things small + - .cz format + - moving to .png + - getFile on demand from mdkinst for ramdisk installs + +[...] + +> You don't believe the books ? Count yourself; see the man/months spent +> in 'pure' developoment in drakX, and the resources put in mantainance +> of the code base; as far as i know, your count should confirm what the +> books says; more probabily, you will discover that our numbers are +> even worse. + +if you count enhancements, adding features... in maintenance, i confirm the +numbers, and find them quite normal. + +if you only count bug fixing, the time would be much shorter (around 30%). + diff --git a/docs/advocacy-interactive b/docs/advocacy-interactive new file mode 100644 index 000000000..99036008e --- /dev/null +++ b/docs/advocacy-interactive @@ -0,0 +1,60 @@ + +> > We already have some functional backends, frontends, that works great, and has +> > not been thrown away since 1 year. We use it during install, post install, mcc +> > and so. +> +> But aren't generic enough. + +DrakX handles: +- buttons +- bool values (checkboxes) +- ranges +- entries +- combo boxes (editable or not) +- lists / radio boxes +- tree lists +- iconlist +- wait messages + +Features: +- all the entries above can be mixed +- nice separation between data and displayed data (eg: choose in list of +objects representing hda/hdb/... but displayed nicely with size...) +- keyboard handled nicely in GTK frontend +- callback on events: + ok pressed => check before the dialog is hidden + focus changed => + * enables pre-setting things based on other entries + * value checking on the fly +- simple/advance toggle +- shadowing of entries +- tooltips +- size of windows computed the best possible +- perl-based + +Misfeatures: +- display not flexible (though i don't know any of the tools we're talking +about that is flexible => nice) +- quite a few features are gtk only (simple/advance toggle, shadowing of +entries, certain events, tooltips). +- a stdio front-end exist but handle only certain entries. It would need a +week-work to finish it +- a http front-end could be done (mod-perl needed) +- perl-based + +The DrakX frontend (called "interactive") could be moved out of DrakX. + +eg of use: + +<#part type="text/plain" filename="~/bin/perl/imessage" disposition=attachment> +<#/part> + +[...] + +> > -provides a lot of frontends +> +> And you ideally have to provide a frontend by widget set. + +nope. The interface is completly standardised, even if it include some +gtk-like niceties. The *complete* newt (and not just entries and radioboxes +like bus) binding takes 241 lines. diff --git a/docs/comparisons b/docs/comparisons new file mode 100644 index 000000000..ccd98f547 --- /dev/null +++ b/docs/comparisons @@ -0,0 +1,306 @@ +redhat 6.1 (fr?), install 766MB, df 900MB, 35min (asked for all groups except "everything") + +upgrade to redhat 6.2, sum 757MB, df 936MB, 20min + +mandrake 7.1, install 755MB, df 1091MB, 17min (asked install size 910MB), 515 packages + +upgrade to cooker, sum 1000MB, df 1404MB, 35min + + +redhat 7.0b, install 815MB, df 960MB, 18min +redhat 7.0, install 995MB, df MB, 26min + +7.2b, 3.3GB 2h26 + + +7.2b: (lang fr) +compssLevel df rpm time fs df/time + +100 64 59 0:59 ext2 500M 1.08 + 90 132 127 1:50 ext2 500M 1.20 + 80 226 218 3:26 ext2 500M 1.10 + 70 449 387 5:52 ext2 1G 1.28 + 60 614 541 8:36 ext2 1G 1.19 + 50 1113 943 17:40 ext2 2G 1.05 + 40 1193 1013 20:39 ext2 2G 0.96 + 30 1262 1072 22:28 ext2 2G 0.94 + 20 1445 1219 27:34 ext2 2G 0.87 + 10 1649 1394 36:58 ext2 2G 0.74 + 0 1943 1638 48:02 ext2 2G 0.67 +-10 2957 2519 101:49 ext2 4G 0.48 + +7.2b: (lang all) +compssLevel df rpm time fs df/time + +100 70 59 1:04 ext2 500M 1.09 + 90 289 281 4:20 ext2 500M 1.11 + 80 373 361 5:41 ext2 500M 1.09 + 70 890 794 13:28 ext2 1G 1.10 + + +mem used 7.2cooker +gtk: runinstall2 13608(data 9572) + FBDev 2984(data 1544) +newt: runinstall2 9516(data 7528) +stdio: runinstall2 9160(data 7372) + +8.0rc1: (lang fr) + +rpmsrate + +4 () 175 139 3:25 reiserfs 2G 0.85 +4 all 831 786 18:08 reiserfs 2G 0.76 + +8.1b + +5 () 77 66 1:24 ext2 300M + +8.1pre_rc1 rpm df time/rpm rpm/df + +6 () 82 66 1:26 ext2 500M 1.05 1.24 +5 () 89 71 1:38 ext2 500M 1.10 1.25 +3 () 94 77 1:46 ext2 500M 1.13 1.22 +5 X 145 127 2:09 ext2 500M 0.89 1.14 +3 X 231 217 3:26 ext2 500M 0.89 1.06 +4 kde 393 316 4:31 ext2 2G 0.69 1.24 +4 kde 393 316 4:41 ext2 2G 0.72 1.24 +4 kde 393 316 4:43 ext2 4G 0.72 1.24 +5 all 367 337 5:02 ext2 500M 0.82 1.09 +4 kde+gnome 454 370 5:50 ext2 4G 0.77 1.23 +4 kde+gnome 454 370 6:10 ext2 4G 0.81 1.23 +4 kde+gnome 454 370 6:24 ext2 4G 0.85 1.23 +5 all 489 406 5:55 ext2 4G 0.73 1.20 +5 all 490 406 5:18 ext2 1G 0.65 1.21 +4 kd+gn+dsk 594 494 7:31 ext2 4G 0.76 1.20 +4 prev+dev 827 696 10:27 ext2 4G 0.76 1.19 +4 all 1100 988 19:34 ext2 1G 1.07 1.11 +3 all 1640 1331 31:33 ext2 2G 1.15 1.23 +3 all 1740 1434 39:38 ext2 4G 1.37 1.21 +2 all 2252 1843 54:40 ext2 4G 1.46 1.22 +-1 all 2490 2048 61:02 ext2 4G 1.47 1.22 + +# 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/drakfont/Makefile b/docs/drakfont/Makefile new file mode 100644 index 000000000..b70b4a0c8 --- /dev/null +++ b/docs/drakfont/Makefile @@ -0,0 +1,57 @@ +# +# +# Project : Projet Libre +# file : pki.tex +# Date : Thu Jun 21 19:26:19 CEST 2001 +# (o- Id : DUPONT Sebastien +# /\ mail : <dupont_s@epita.fr> +# Y_/___________________________________________ +# + +RM = @rm -f + +CD = @cd + +ECHO = @echo + +PRINTF = @echo -n + +FILE = drakfont + +DVI = @dvips -j0 -Pcmz -Pamz -o + +PS = @ps2pdf + +LATEX = @latex + +normal : + $(ECHO) '[35m/*--LATEX--*/[0m' + $(LATEX) $(FILE).tex + +all : + $(ECHO) '/*----------latex -> dvi -> ps -> pdf------------' + $(ECHO) '[35m/*--LATEX--*/[0m' + $(LATEX) $(FILE).tex + $(ECHO) '[35m/*--DVI -> PS--*/[0m' + $(DVI) $(FILE).ps $(FILE).dvi + $(ECHO) '[35m/*--PS -> PDF--*/[0m' + $(PS) $(FILE).ps + $(ECHO) '[35m/*--That s all--*/[0m' + + +ps : normal + $(ECHO) '[35m/*--DVI -> PS--*/[0m' + $(DVI) $(FILE).ps $(FILE).dvi + $(ECHO) '[35m/*--That s all--*/[0m' + +pdf : ps + $(ECHO) '[35m/*--PS -> PDF--*/[0m' + $(PS) $(FILE).ps + $(ECHO) '[35m/*--That s all--*/[0m' + +clean : + $(RM) $(FILE).toc $(FILE).log $(FILE).aux *~ + +fclean : + make clean + $(RM) $(FILE).ps $(FILE).pdf $(FILE).dvi diff --git a/docs/drakfont/dia_srcs/drakfont.dia b/docs/drakfont/dia_srcs/drakfont.dia Binary files differnew file mode 100644 index 000000000..c4502a12e --- /dev/null +++ b/docs/drakfont/dia_srcs/drakfont.dia diff --git a/docs/drakfont/dia_srcs/drakfont_install.dia b/docs/drakfont/dia_srcs/drakfont_install.dia Binary files differnew file mode 100644 index 000000000..737c19b9f --- /dev/null +++ b/docs/drakfont/dia_srcs/drakfont_install.dia diff --git a/docs/drakfont/dia_srcs/drakfont_uninstall.dia b/docs/drakfont/dia_srcs/drakfont_uninstall.dia Binary files differnew file mode 100644 index 000000000..c06f92dd6 --- /dev/null +++ b/docs/drakfont/dia_srcs/drakfont_uninstall.dia diff --git a/docs/drakfont/drakfont.jpg b/docs/drakfont/drakfont.jpg Binary files differnew file mode 100644 index 000000000..898dfe440 --- /dev/null +++ b/docs/drakfont/drakfont.jpg diff --git a/docs/drakfont/drakfont.tex b/docs/drakfont/drakfont.tex new file mode 100644 index 000000000..bbc936e5b --- /dev/null +++ b/docs/drakfont/drakfont.tex @@ -0,0 +1,152 @@ +%\documentclass[pdftex]{article} \usepackage{hyperref} . +%\documentclass[pdftex,onecolumn,11pt,oneside]{article} +\documentclass[onecolumn,11pt,oneside]{article}%seminar} +%\usepackage[pdftex]{hyperref} +\usepackage{isolatin1} +%\ifx\pdfoutput\undefined + +\usepackage[dvips]{graphicx} +%\else +%\usepackage[pdftex]{graphicx} +%\usepackage[pdftex]{hyperref} +%\usepackage{type1cm} +%\fi +%\pdfoutput=1 +\usepackage{color,graphicx,shortvrb,epsfig,verbatim,tabularx} +\usepackage{url} +\usepackage{hyperref} +\urlstyle{sf} +\usepackage{fancyheadings} +\usepackage{program} +\usepackage{ulem} +\usepackage{amsfonts} +\usepackage{xspace} +\usepackage[english,francais]{babel} +\pagestyle{fancy} +\newcommand{\trtitle}{Drakfont\\ fonts importation for mandrake linux} +\DeclareGraphicsRule{.ps}{eps}{.ps}{} +\DeclareGraphicsExtensions{.ps} +\renewcommand\star{{\ttfamily*}} +\let\package\textsf +\newlength{\gxlen} +\settowidth{\gxlen}{\package{graphicx}: } +\newcommand\gs{\makebox[\gxlen][l]{\package{graphics}:}} +\newcommand\gx{\makebox[\gxlen][l]{\package{graphicx}:}} +\MakeShortVerb{\|} +\begin{document} +\title{$Drakfont$ fonts importation for mandrake linux} + +\begin{figure}%[ht] +\begin{center} +%\caption{Exemple d'image} +\mbox{\epsfig{file=mandrake.ps}}\\ %,height=1in,width=2in}}\\ +%\mbox{\epsfig{file=carte_.ps,height=1in,width=2in}} +\end{center} +\end{figure} +%\begin{figure} +%\begin{center} + +%\end{center} +%\end{figure} +\author{Dupont Sebastien \\ sdupont@mandrakesoft.com} +\date{05/10/2001} +\pagestyle{myheadings} +\markright{\scriptsize \trtitle} +\title{\bf \trtitle} +\maketitle +\section{drakfont Future Overview} + +\paragraph{Fonts import :\\} +\begin{itemize} +\item pfb ( Adobe Type 1 binary ) +\item pfa ( Adobe Type 1 ASCII ) +\item ttf ( True-Type ) +\item pcf.gz +\item Speedo +\item pfa ( Adobe Type 1 ASCII ) +\item ttf ( True-Type ) +\item and Bitmap (PCF, BDF, and SNF) +\end{itemize} + + +\paragraph{Features} +\begin{itemize} +\item Install fonts from any directory +\item Get windows fonts on any vfat partitions +\item UN-installation of any fonts (even if not installed through drakfont) +\end{itemize} + + +\paragraph{Support} +\begin{itemize} +\item Xfs +\item ghostscript \& printer +\item Staroffice \& printer +\item abiword +\item Koffice, Gnumeric, ... studying +\item all fonts supported by printer +\item ( aliases by RENDER in Xfree86 .... -> later ) +\end{itemize} + + +\section{Window interface:} +\begin{itemize} +\item +\item Fontselectiondialog widget +\item Command buttons under Fontselectiondialog (like the actual frontend). +\item Commands buttons: +\item import from windows partition. +\item import from all fat32 partitions and look for winnt/windows/font +\item and import all (delete doublon) but don't import if already exist. +\item import from directory +\item look for if it exist before for each font and not delete the original. +\item (replace all, no, none) +\item expert options: +\item ask the directory, and look for if it exist before +\item if it exist ask: (replace all, no, none) +\item uninstall with list per font type +\item Expert additional switch +\item option support: ghostscript, Staroffice, etc... +\item check-button. (by default all check) +\item Printer Application Fonts Support... +\item check-button. (by default all check) +\end{itemize} + +\section{Command line} +\paragraph{Font Importation and monitoring application\\} +\-\-windows\_import : import from all available windows partitions. \\ +\-\-strong : strong verification of font.\\ +\-\-install : accept any font file and any directory.\\ +\-\-uninstall : uninstall any font or any directory of font.\\ +\-\-replace : replace all font if already exist\\ +\-\-application : 0 none application.\\ + : 1 all application available supported.\\ + : name\_of\_application" like staroffice for only this one.\\ + +\section{Graphics} + +to visualize the conceptual graphics please see:\\ +drakfont.jpg\\ +drakfont\_install\.jpg\\ +\& drakfont\_uninstall.jpg\\ + + + +%\begin{figure}%[ht] +%\begin{center} +%\caption{Exemple d'image} +%\mbox{\epsfig{file=drakfont_install.ps}}\\ %,height=1in,width=2in}}\\ +%\mbox{\epsfig{file=carte_.ps,height=1in,width=2in}} +%\end{center} +%\end{figure} + + +%\begin{figure}%[ht] +%\begin{center} +%\caption{Exemple d'image} +%\mbox{\epsfig{file=drakfont_uninstall.eps}}\\ %,height=1in,width=2in}}\\ +%\mbox{\epsfig{file=carte_.ps,height=1in,width=2in}} +%\end{center} +%\end{figure} + +\end{document} diff --git a/docs/drakfont/drakfont_install.jpg b/docs/drakfont/drakfont_install.jpg Binary files differnew file mode 100644 index 000000000..795a5a711 --- /dev/null +++ b/docs/drakfont/drakfont_install.jpg diff --git a/docs/drakfont/drakfont_uninstall.jpg b/docs/drakfont/drakfont_uninstall.jpg Binary files differnew file mode 100644 index 000000000..711f28e77 --- /dev/null +++ b/docs/drakfont/drakfont_uninstall.jpg diff --git a/docs/drakfont/mandrake.ps b/docs/drakfont/mandrake.ps new file mode 100644 index 000000000..1af9d5bb4 --- /dev/null +++ b/docs/drakfont/mandrake.ps @@ -0,0 +1,534 @@ +%!PS-Adobe-3.0 +%%Creator: GIMP PostScript file plugin V 1.12 by Peter Kirchgessner +%%Title: /home/seb/drakfont/mandrake.ps +%%CreationDate: Fri Oct 5 18:28:29 2001 +%%DocumentData: Clean7Bit +%%LanguageLevel: 2 +%%Pages: 1 +%%BoundingBox: 14 14 424 84 +%%EndComments +%%BeginProlog +% Use own dictionary to avoid conflicts +10 dict begin +%%EndProlog +%%Page: 1 1 +% Translate for offset +14.173228 14.173228 translate +% Translate to begin of first scanline +0.000000 69.000000 translate +409.000000 -69.000000 scale +% Image geometry +409 69 8 +% Transformation matrix +[ 409 0 0 69 0 0 ] +% Strings to hold RGB-samples per scanline +/rstr 409 string def +/gstr 409 string def +/bstr 409 string def +{currentfile /ASCII85Decode filter /RunLengthDecode filter rstr readstring pop} +{currentfile /ASCII85Decode filter /RunLengthDecode filter gstr readstring pop} +{currentfile /ASCII85Decode filter /RunLengthDecode filter bstr readstring pop} +true 3 +%%BeginData: 29637 ASCII Bytes +colorimage +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +bl7e@q"4E6s+13Ds*t~> +bl7e@m,@els+13Ds*t~> +bl7e@T5=@Ts+13Ds*t~> +c2RqDnG2D<JcC<$U&TW~> +c2RqDl/9_PJcC<$U&TW~> +c2RqD]71%QJcC<$U&TW~> +cMn+JnG;n/i;S<-JcDJEJ,~> +cMn+JmbuTmh#;m)JcDJEJ,~> +cMn+Jie^A<a8UYiJcDJEJ,~> +cMn+DnbMk)f)($uJcDJEJ,~> +cMn+DjkIhQchi:nJcDJEJ,~> +cMn+DST5n_V>GiDJcDJEJ,~> +ci47Jn+l_KeBdl?s+13Es*t~> +ci47Jkhjh)WP\C\s+13Es*t~> +ci47J^4K&h%!hSus+13Es*t~> +d/OCNnbW%Rn_2+VJcC<$UAo`~> +d/OCNn);p@^TP0>JcC<$UAo`~> +d/OCNj+q1n%LcV6JcC<$UAo`~> +d/OCHnG2eMo&%LUJcC<$UAo`~> +d/OCHjkS+u^p135JcC<$UAo`~> +d/OCHTl`:/%Lk8_JcC<$UAo`~> +lMgqbp\sLY$2s;fp\"1NjN$P:s+13Es*t~> +lMgqbp\sLY$2s,He&K8A[BAeGs+13Es*t~> +lMgqbq>T^[$2r)%;B-/V%3+S`s+13Es*t~> +li.(dk/mMerri>mqY9a_oE+4!k(3P`s.]OD~> +li.(dk/mMersJbqin;Gk_SWgdk(3P`s.]OD~> +li.(dmFhC'rsJbkMeO[R%M'!Pk(3P`s.]OD~> +m/I4fjeV8=m/I1an+l\UoE4C(gAQU&JcDMFJ,~> +m/I4fje_>>m/I4bjk\5#rk\cKUso9ns+13Fs*t~> +m/I4flbMl_m/IIiWH^N?%Ls!Y%&s2Vs+13Fs*t~> +mJd@ggl^4WrU'UfrU9RVp&4Lbm*a;WJcC<$U]5i~> +mJd@gglg:XrU'UfrTiCk`r3aV];N^FJcC<$U]5i~> +mJd@gjg<_0rU'UfrR6L%+8lZO%1J$fJcC<$U]5i~> +mf*Iik)["5qX+:crq-'^p&+Famb#_TJcC<$U]5i~> +mf*Iik)d(6qX+:drq#.'b/=1p"21eLoR[$ns.fUE~> +mf*IilEnChqX+:drp>Y\/e\'l!Xrf8JcC<$U]5i~> +n,F"!nYD2sp&>!hp%nOYp@\.TrV6BpqX41Qqt(!\hT52;s+13Fs*t~> +n,F"!nYM8tp&>!hm-F!$l0Rm2rV6BqqW?VZ`;IIS^p(69JcC<$U]5i~> +n,F"!o>7BVp&>!h[uQH0T!cSkrV6BqqQkK3(&JIB%70K7s+13Fs*t~> +n,FI)^NR3SrVuomhY$U:q"X[\qY0^VpA+[ds82B`p\"CT!oq>fJcC<$U]5i~> +n,FI)^j!BUrVuomg;hIdf%Jg6kNM-qn+?PWs82-AeAqF&!jo2uJcC<$U]5i~> +n,FI)d@e5>rVuom_BM'9>A8)$G_hZm`nC%as80]m<Zq5K!Y$ODJcC<$U]5i~> +nG`[jf8YC8q>UBuqVJd?m.L&NpAajeq#1!kp%eIZp%e4]kKW1@s+13Fs*t~> +nG`[jf8YC8q>UC0qVJQ`]>_n8c-Xnhg"Y?>kiqElf#bi+_?.6OkCNYas.fUE~> +nG`[jhm8^'q>UC0qVI;C%2gQM4%)eE@rZaAKVFlk?7QZc%Kd4N"m:I:JcDMFJ,~> +nc&gmm]UN9m/I"a#6+8C]\r,HrUg-_rq??c!VZ3]oE4O8iVnE.JcDPGJ,~> +nc&gmm]UQ:m/I"a(&mjRYd1mV_SX4/`lQ?JcdC7lcH*p!_?7KSh>W!*JcDPGJ,~> +nc&gmnApp+m/I"a(&mjRCCL^_%M'-d*@NX&6:t6X5:%$?%Km:P%*&9ts+13Gs*t~> +nc&dibD(8oq>C6srp\(Nj6cI(oE4^PjnOE,JcDPGJ,~> +nc&dibD(;pq>C6srp\(:[(O6N_?7]o`5D>d"2VXrpjrHrs.o[F~> +nc&dif<14fq>C6qrp\&r%J^M6%g3L](D78P%KT)pJcC<$V#Pr~> +o)Apnm'1H"lMg\\#6!f&dH0iglLY2OnG*"XrsA\uq"XjgqtB^[JcC<$\c70~> +o)ApnmBLT$lMg\\#6!f&\@0,fm(rqD`5^X+rqQL"rpo1Err;l[jSON.JcE:\J,~> +o)Apnm`LrrlMg\\"T@T$+q<fI"VDOmC#f3frsA\WEU3W(qji66JcC<$\c70~> +o)Amjb*?Map%eUlqr>9CjmVg,oEY'_p\"4Rr;QWo$2s&VmeZnNp>>Uqs+13\s*t~> +o)Amjb*?Pbp%eUlqr>2i[_BTE_?e'"cIM%Anb`=`rsAYegtV](lHe5ZJcC<$\c70~> +o)Amjf"$U`p%eUjqr=df%I4K1%hp3M>Ci]roD\[f$2s$mBDVSN(rc6#s+13\s*t~> +o)Am`[;pHKrV6BrptE13kO@d/(%q:pq"X[Yp%\Lcs8M65p?qSEe(skOs+13\s*t~> +o)Am`[W6TMrV6BrptE!V\A.@H(;n2:dFR%+k3DR:s8W)^b0fDEf>-5=JcC<$\c70~> +o)Am`bFssSrV6BqptC`;%I4K?%hp-C8mQ7RKs0)+s8W)^Q8?5H>YX&NJcC<$\c70~> +oD]!me>?o:lhCD`rq+[OhWjXqo`+Uap(-omq"aUUq=E"uo]5Yem/DS9JcE:\J,~> +oD]!meYd,>lhCD`rq+[DZ+@a9_A'o,aNMlWf%T6KmIg(uccXqbaR&nWs+13\s*t~> +oD]!mgr,DGlhCD_rq+ZT%1VS4'b:op,r7b[?>XPE\DZu+?7Vct]^5WKs+13\s*t~> +oD]!f^6W?3nb2terp\+KipH=!o`+Uap($ilq"O+(guI)Go(DbUrdk*#s1JA^~> +oD]!f^6`H5nb2terp\+:Zb4-;_@si+aNVuZf\>QHa2#=.eDfTZqu20HJcEC_J,~> +oD]!fcFJk?nb2tcrp\*'%H\-7%h]a,2F:;PDg@Us1*L+oT;9Krrdk*#s1JA^~> +oD]!]YCC#np\"OjrThAHk3qp%o_nFnp@?/4i8NJDeEQYKc-"5QrlP;YVY^&e!rCEmrQ58a`3ciI +d/OCNp#k&U\;/o>h#@ZZp#k&V\rFr4iVs>cn`8KObf\)MdFe!gir92]puU2Tbl5cb^&\&$s*t~> +oD]!]YCC#np\"OjrThA1\%]]>_A'o-aN2ZXdCHg.]=keag\&b7bKS30b6#MWqY1!kqUNslb6?&0 +`3ciId/OCNp#k&U\VT)@h#@ZZp#k&V]8k/7iVs>cn`8KObfe/NdFn'hir9DcpuU2Tbfe2P^V9T9 +s*t~> +oD]!]aJt!3p\"OhrTh?P%H@p+%hp!3-mB]:J%7BArWNL]p"S9UgY;_]!n>*`p\t<kinaRe"PMAM +b59Qc#laScjPJ7fjo4'8#laScjPS@lgAU"1%0#nbjk\\Fg=b?Co`!kM"oe>aj5&JhgAfS$qjmb;~> +o`#-pfr/arg&(FA"oIDohWO@goFpf^hTE^[d+I+3\@B)hioYiBMk'a<!fM0fq#:d$hS6+`T:M*e +C1Mkcdf0[Qg;:S9ZD;SVjSds8$N8Ym]Xb>FH>(\%jSoMbptsB7]<eK2rgs@hW2mGdrT4%`rTDG@ +ZDXGrT)saenX]]1~> +o`#-pfr/asg&(FA"oIDmZ+.O/_@s_sYb@bpYJAE'\@B)hioYlDMk'a<!fM3gq#:d$hS?1aT:M*e +C1Mnddf0[Qg;:V:ZD;SWjSds8$N8Ym]XkDGH>1b&jSoMbptsE9]<eK2rgs@hW3!MerT4%`rTDG@ +ZDXGrT)safnX]]1~> +o`#-phSl(>g&(FA"T.;a%1V;,rs]MI#nAC@F#gb?\]3XkXJrM=rP&E>SaH4P%/o8;a1oC'[\K.H +S+>#-$N9&:eC)RXUQ4F6hZ!r]j3uH'bep?>eGA8+#laY_hUg0!`PMPg"iA7"cKP5grs&Ggh:9`f +_>_1NY+"mOs*t~> +o`#-k`1LULi;W?J"o6r`jR)O$oH!MhhT2q%V6%_Zamms?io]goWKMCCDf9T7A7i^Wq>Uls_PM^# +EG/W[H],6!df0[K[s3%5GACN#iVq^6$MV#aF)?#9>[lFajo6"lim#-6Ob7puCMe$3G'nq%P-t2M +rseqc_lA`EF(f,p@pNR+qYpZso@s5Bs*t~> +o`#-k`1U[Ni;W?J"o6r[[Cj?=_B$G(Yb-l2RA-dea2uK^io]goWfhOEDf9T7A7i^Wq>Uls_PM^# +EG/W[H]5<"df0[K[s<.7GACN$iVq^6$MV&bFDc2;>[uLbjo6"lim#-6Ob7puCMe$3G'nq%PICAO +rseqd_lA`EF(f,p@pNU,qYpZso@s5Bs*t~> +o`#-kd(bp"i;W?J"8U`5%HJ$!%2'$U$Vu+1*4lc6i8Wnik-LYHT`1PdTU(S\rV?I%p=$pYT:h[3 +H]"0#n'_4CpW&ntT;8$8L>i-grsJMAUn"!NSr/*QqrRhkr9<%c`3ueET:MRGTqnTfZa\-TkPl"i +kL[_[W1f]IQ'I8]k5,)[rq>LQW;hA~> +o`#*d[?tH4iq!*Orq+U^kO]kem,#gfX.uc3c/-+Vg@4Y3s8V`JaII`jBOk^aA?5P&rseqYZA*4- +An"tc][5[4df0XJgUa)+DIZpqkM?.FpYNZaKQL^.E9$r[rtYF__PW-/@pN2?>?b?@A7fLoF`b+j +kl1kZ]qg0nA7#49!`N1[rVm*#m+]aaPkD!TJ,~> +o`#*d[?tH5iq!*Qrq+UM_o(`U+2GLmT8\SmWkcK^ZHL,*n,E@eo\RZZIq35'An#;Pq>1+#rR\?0 +D.R<g>][R)iqLn$$2<2cTmU`f>^5GfrsJMW^Sup0@p<p4roX4qqq/c_LiHp1=B\p5>[_/TBQ/*: +\,>Ii%J7B1J8/V$='/O*;cr&Xrs&Gggrugaor.n@~> +o`#*daL[Uhiq!*Qrq+T=&eX=;rs]qU$49S'^m5IRb>Su4rr<#jhT2duQC+#+P`30KqYq$'hor9p +R$j.jL:kmmpX9'JpY39ST:_@%Np#6u$MWDlWLorNKS\[fk5Q1nimu&PTTkChKS>2>Od;B(T;/.& +r94.io[1OUS<f1eIXHKcG2iK##6"&QgW-\oW;hA~> +o`#*_Y**4%ipm$Orp7u)p$;5no'G5SYcFP#`80S<da$mpg!]Zqs8DcYY`!(2BkCmdRIp@U%J7;r +C2Rg"@9\fPp%n[9rsAYqkKfKE@U+lYh>[f[o]t&"L1=JFlK8*_qpN'DH"C;]<*!I??<^cDA7fIh +AT[29lMhb#f;aXCARA><Dg6PQL$&F8rp%YE[[qAdm&9r7~> +o`#*_Y**4&ipm$Orp7_N`p:Jb^q6hCN/3h#`80S%YKl1M]Wh22s8DcYY`!(3BkCmdRIp@U%J7;r +C2Rg"@9eoRp%n[9rsAYqkKfNF@U+lYh>[f[o]t&#L1=JFlK8*_qpW-EH"C;]<**RB?X-rFA7fIh +AT[29lMh1hf;aXCARA><DuP"jL?AO9rp%YE[[qAem&9r7~> +o`#*__mY_]ipm$Orp619+6j@9%3>la$;[D7h<&&XcK!"r-M[W@rV>`pZBLK>R$E]4o_SRso[(%8 +R%0S,JXtfnqYnqC$2sJYcaTp<K:M;arsAYrld`SMP_,=gk5Q7phU/s3R#QQ;FaJO^I"dTHR$jJ2 +Rd9t<rsAY\`iu#$O*Z#%reLuJk5YJ\mb?C>^7Lk]W;hA~> +o`#*ZUkW8cipcsMp"fB8mIV+`m,#gfX.uc7h=(70ftQD>j2T+,rVm5nY_6SBEG/onK^em=$iSSQ +AoDX/BO>#Io$.1>roKu.@9o]!gA_B@WJ4hdV"!RI)#`C(R!*(K;HJLGZF-p8L1t./AnPUc]DUso +)>M+?H=pbn?DG-N`Pp?ss8VuHXd"9O@X..9s*t~> +o`#*ZV1rAeipcsMp"%[8mD9RQ]<IodLmP-[h=(70^o$&bj1r.lrVm5nZ%Q\DEG/onK^em=$iSSQ +AoDX/BO>&Jo$.1>roKu.@:#c"gA_B@WeOqfV"!RI)#`C)R!*(K;HJLGZF-p8LM:70AnPUd]_q'p +)>M+@H=pbn?DG-N`Pp?ss8VuHXd"9O@X74:s*t~> +o`#*Z_lo/TipcsMorV=Eljj%)&ISpQ:SPe`n,)Q69AoU*Sm:^^rsJ57Xc8[=R[9,,nGE4nrS5>X +Od;]1Ne"S/c2S%Jjhn-]K!+Xtrs%],YE=C=nE9fgrT2G=UmR0gG)iE)[BQToO-H$"R?WcQr9F;" +ps6[OR?rbYV7X[b`ROGXs81Tm\#Gs[PNf%GJ,~> +o`#*USpk'WipcsMo^2GHmdq7aj3"U,UTDDin,*+anBoYPs7bI*nbrIpl)/<.WHrAm@s759rsSJ2 +I:ACfH"^Ghc1oQ`#Q</JHsU*ip"TKOrR.Hg?!Y;?kPlCl^8$'h@ola#aP>qAk2+1GFD,9!@UY`" +lMhao^RTFYA7Bc1lgXH7o_\[gps#U\B4YY(l)=W4~> +o`#*UT710YipcsMo\e<Am_T^R[@rP8Q`A![n,*+anBoYPs7bI*nbrIpl)8B/WI&Gn@s@;:rsSJ2 +I:JIhH"^Ghc1oQ`#Q</JHsU-jp"TKOrR7Qi?!Y>@kPlCl^8$'h@ola$aP>qAk2+1HF_GB"@UYc# +lMhao^moOZA7Bf2lgXH7o_\[gps#U\B4YY)l)=W4~> +o`#*U^T!9KipcsMoS[$&m1'g>$OR5:U;YmVqu6WbdF%F_pYacqrVm5h`LVjeVOa*;PjJ;I$hVcD +Ln(08RYu[Aps&gDrS#,eNe"q<g]%NWg;9eIJ&_3FrttFU_PirgJp*g.gudh_hT2LdS!f\/M6-I: +ru(IQ]q_!^O-@uWnF?&@qu?]ke&%uMR$+!(W;hA~> +o`#-TSpXpVgA^[C"T@]_p\""I$M!,kX.uc7h=(7?rr39#nF?DUrqQ0`rr3B*gRr(l_2W\Q@;"d$ +rs\kUW+'bVOa^kHB&<L2rs/AEVfl9Mg%sJ'#Pc0+F'E),qrn%trnXZ6D.[6aLXGVgrr<#sm`B`\ +>$>!/P4JSO$NB_ai7ci8j6?C=rVn,AnE]E#]pj(TASZtFkNV-or9Wb8k/F0@AnGb*cfjZYk3)`H +s*t~> +o`#-TT6t$XgA^[C"T@N>dDbRk$Ga!9LmP-[h=(7?rr39#nF?DUrqQ0`rr3B*gS&.n_2`bR@;+j% +rs\kUW+'eWP($tIBAWU3rs/AEVfl9Ng%sJ'#Pc0,F'E,-qrn%trnX]7D.[6bLXGVgrr<#sm`Bc] +>$>!/P4JSO$NB_ai7cl:j6?C=rVn,AnE]E#]ps.UASd(HkN_3pr9`h9k/F3AAnGb*cfjZZk3)`H +s*t~> +o`#-T^Sd0Lh#?mE"T?Pj8f@%,#n77L:SPe`n,*+`rs8Jjnb`@cq"=O`rsSh_^m'YkXJMAJMs($<% +/o#$Nf(?RWL/KohYk_!#PlogUksTSqV2#Tps-RHLk+4Vkl2P"ilJBrR?NDkdI@&4s8W&caeauPL +OslIo)8RqrqGmFjQ#7bn,!%^s!.O8nF5Vd]qLj]S#+d)n*KQAnaQ&6d_hlKR@9u)mdKW2mf'BhJ +,~> +p&>9rfUI1qAAA*6rr_uaq"=(I#jTO4W5RN\qu6*b%/\5;@X67aIVN;&b5VD?%K>h.I9iVgS:>$Q +E97)srseu&j4W#8g[4q*f#-ePrVm?+nD;IBrVulhiRu`LrqQL&rp\gma3WGQSnqYIiVrfU$iTGD +a6`g)o\S-WrVQU'rTr7if@K0ao\.C>rVlg-o=(-$>B&X%s8W)nimu]Zq>V-,le:"AlMgh`q8/\K +BP(dkW9sT^rr`5OC0CL:32Q3Grq"sk`4`U`XfSb5[(FcZrr;`7_S!FWKl(F7COr.a[$dWS`50!q +Y)I=3B52a`ZFI90PP;6[J,~> +p&>9rfUI1qA\\37rri&Tfuh5$_?d`GLo&&Gn,*+Rrs\eJS76chQ@<RWB$1,Prsetr]7!t[aII`i +>B/d(r;R6*puL,ZfA#]jm+92@rr)j+rp\difDYaKo\nKRn,E+^%K>kSdE'\f^7T4HCZ59krsSel +f>m7Wrq,'tir/cS!r_K>rmqA<rUegbg&:pM&+d8uBNoH9rr<#tpu9oVrV?I,rTi4kf'<87s7sR( +H>$o$D5ck$r;Qltf5"Rg=?*/Js8MWGcG[H+YcY"3['dNop&>!cb/:m&VhJu"B5<*mZa?0pm)?fO +]!%'3AnPk)S[,f5R[!QLs*t~> +p&>9rgq9PJM9,Ydrri%ZC+^+e%L<LO$BrEan,*+Rrs\eS]T/*!ZDj@WMUDG&rsetsc_uAqb.Xg> +KSegir;R6*q<I#!ioT_.nD`!err)j+rq#=.ir/oVp?CVroD\Ob%K>t_hUpZCcbH$,L#N%0rsSeq +in3f#rq>O6lM^V[!r_WLro+.MrV#=)jSf)X&+dlSRtQUXrr<#tq<Hu!rV?I,rUAn.iU?dGs7t$U +Vja$?QaH/Zr;QltfoULXFuZ\rs8M]Rh:U3%b/hWGc-=Vmp\t3eg"4[!`N>`"R@UCobg!f8m+Bn9 +dE/\dR@0SC^<FsK]X.@8s*t~> +p&>9qe<bGiA\.^/rri;fq=jRMoEO?eX3pA4rpKdpp:Z]!N7jqXD.7%`qYpL'qp)$GD:$7nHsp9; +li$i-rqG-bVh9;XWO9ORQuhZnrpJ^ob/:HB[J'1A`k&CNP0Nt&ruh:,e%:laFG6?XK4J52kPk5< +g!RmUUOqY(gr[+(Ls#\qrsnq`b-[7VNMEen_5D=oqYpL+m]_pd>`%bGs8D-*^8cn'rVca4rqG*\ +UR%RPTs=LpoX0j'AnG[iJ'@WcrVlruke@"p3O[W8qqfH+UlpI\G'/(ZK85MVUXoD3Z^lo'H#IA. +B52C3Jph<eeu=peJpMEMAnPdpG_(KqBRfHQs*t~> +p&>9qeX1VkB"Rm1rri;ahU9C2_?RE4UXAN,rpKdpp:Z]!N7jqXD.7(aqYpL'qp)$GD:$7oHsp9; +li$i-rqG-bVh9>YWO9RTQuq`orpJ^ob/:HB[J'1Aa1ALOPKj('ruh:,e@_)dFbQHYK4J53kPk5< +g!RmVUP%_)grd1)M9Gksrsnqab-[7VNMEen_5D@qqYpL+m]i!e>`%bGs8D-*^T*"(rVca4rqG*\ +Um@[QU9XUqoX0j'AnG[iJ'@WcrVlruke@"p3O[W8qqfK,UlpI\G'/(ZK85MWUt5M4[%3#(H#IA. +B52C3Jph<feuG!fJpMEMAnPdpG_(KqBRfHQs*t~> +p&>9qft+#DNPkS`rri;GI7tRI%L*@LG1#aTrpKdpp<0q%SCt?PSs,,KqYpL'qq8lGL!\,[W02b$ +li$i-rqPR,`2olF`Qm#^\sr*crpo:3gXjTRanGAcg!Rs[\(^fXruh:0i6o0.Trl)DXHnR#kPk;D +j58S@_Q2qsjkJ/#Yh8pRrsnqigWd+&Zbjr8e\n',qYpL+m_u]%Jskp(s8D<?eAeW;rVca,rqPO' +_R[J$_9)TSoYn85rg<nYWS.(GrVlruke@"p3O[W8qrZY\_R?YIUnaccXKT%E_;Y@\aM+mZV4X3E +R@BhGX/VG]f#G5%X/DV[R@0P9V5p_tQ^[?Fs*t~> +p&>9qh3`IuAXiDbrr_rbq"=%H"QI&9o)A"U*:U4g@'&CoM/d$8Re?^\rp@4;=eXcaRs8=HV""B` +,Q6oOY@q-TL6-A%LjW]Uk5P%GR[TP$I!M[1Y`jQ^I!fUSo_e_Fqq]5`?s\8GL2:U?@9ecXrRd?u +QBI#DJ()9=P_4-kL%YKFp!UC%?<qlDE-@"k@q49irr3PoWJFtfV""E_i5)4IFCTpprr4)=jN*g$ +D1d%QHuQ7cnZ7LaAnG^mH'tnN`mNB$me,iCi[s?cpsm0RKlLX0=^#'8?=RSaG_1XmkFcNo?"%;V +An>FX>?Y-1Gg1_G>$PKHralFG?X-c<=BBS.Y5a"~> +p&>9qh3iP!AXrJcrri#Ufuh5#_?@3>b4>PuruCO6LL@4DZANX3A"3/ks8MDqFBYBr\XRhO?DR)i +s!.L-bcb\bCPIpiI#*/[G38esTUVC9N-orM`j(_WH$k!QI.[@:1]-"IT3tuSP_O!hCLLJ,m/>S$ +PEqAeEe)WUY`sc`AqfpXrq4^MJR2W/QuR;)L1=cKqYpL+l)KPJ?)6uirSYPgMf`H\o`"k4rT)%i +AT!0GEdVi/qsgbCDe<TpCjDGQ^W+[PkjJ-.rSfElo_?tPTnRJs?<LH:>[CoPD0UYebNGR5>[:cL +AnGU`?<^T8=*`&@?s6fDAH$0H@p`JE>$+jJl)t&:~> +p&>9qh7BGJO0/-Irri"VC+^+d%Km4Eb4>PuruCOJYD'@D^TaArN32dQs8MH3UO9'!ah4I3K!+VB +s!.L1grc+;Js;grVm*+\O66H7^q@=jZ`'b5eB>>$V5L5[Sb2j[1]-:d^Q<o(S=,b7SW\Vqm/>nQ +\%/rNTr-Gkb.+RLPbIdMrq>6rX,)+]TUDUZYEajsqYpL+l,KrjJZeMBrTDbLZ(mDOo`"k4rT`+M +OGT3hTr=U#qshD(T:)+9SYj!@e(<I8mIKr7rSfj#o_@Cq_6'AqNJ3%>LlR^eSu&Kjg#oo6Mi<gc +R@0G,NerOFIZr$VOGJgWQC+)-Q&gfYLP:29l)t&:~> +p&>9ri0S\"A;0RGrri;fq=jRLoE4*fhYld?6gCXi@*J&VNH8W?MXg`Hqok^>C=;@PQZHJ=](Q+' +rp%Lt?rMQ_`P77JBOP/&l2U+CMfW]JAS$."@r6'lA7f4[l2CX3qprKA=]_$-c+SaGB4,#@nb_+7 +M/R3CCN#8KEbJrj>'B93oZXOW<,AJK_jGIX@p<^+rVuosf;*h$?,H=6hQhEB?sHc`mJm4bi5(4Q +EjE?WHZ!A@o('&0AS#IdBP_jEO-ucBZ*q3U`p!F%s81?YR<W=O<Duq-Am\kN&Rf6aDJsd;KO7ef +@q'%^@p2q3<t'#lAm/8?A79%]AR/=6<rm7(Y5a"~> +p&>9ri0\b#A;9XHrri;`hU0=0_?70AhYld?6gCXi@*J&VNcS`AMt-iIqok^>CXVIQQucS?](Q+' +rp%Lt?rVZa`P77JBOP/&l2U+CN,rfKAS$."A8Z6nA7f4\l2CX3qprKA=]_$-c+SdHB4,&Anb_+7 +MK!BECN,AMEbJrj>'K?4oZaUX<,AJK_jPRZ@p<a,rVuosf;3n%?GcF7hm.NC?sHfbmJm4bi5(4R +F0`HXHu<JBo(')2AS#IdBP_jEO-ucBZ*q3U`p!F%s81BZR<W=O<Dut/B4,%P&Rf6aDJsg<Kj\"j +@q'%^@p2q3=:B/nB3SJCART.^AR/=6=93C*Y5a"~> +p&>9ri4>bPOe;19rri;8HV,1C%Kd.DhYld?6gDU_K$Nf-Z_<_HU%/0_qq&W>K$ro&\tP+6_"Ia- +rpACTOEHPj`P8(;RZ`8jl2U+TT9u1=Q^+/*LkgkKQ'm\hl2CX$qr-#2L3B3*c+Td@R?3$'nb_4I +SX,h7S=?^MQBIJoJro?up"[`^H\&04_kiuoQ%k"NrVuosh8?4OJB%<]jijTgOG\IOmJm4bkLHeg +KsJ@mVk0*@o('PkR$a;0R[p7U[(F2obKeJ^fC&Y<ruh3rdCZ6COFVLsH[U3kM34-nStDk)UOdT> +N0K]tQ%s\aFps/NMgBPoMisHqQ]-:hFodB_Y5a"~> +o`#-UP]^SJEpNAts7??ep$D;Pj2'a@s$ZkAU1IrnpXt[MAn6;Vs8MDpDHa4-l`?4a>@#qYs8MT- +Uh!JR`T-LO]o6r=>bplho%(RBIqiCm<HOn>XaY%t?!u^ls"s]2]Tc]&S^Zrtj/n,S?<t/8rU&.L +P(%.V@TRN?IUlARM<ju\Z$BA\]%ZT=bE7$Y?%_A?s!RZ_T6+:JgA'O+AS-3k;,aC]s8ColO^)V7 +i9Sg_H!=\@pX=Lu@:]@L6"akGDfpAVKo(nYS%ALrl+*7-B44b;GbVLOYFBWC@qB:fBnaC,WMYDh +BP(^[H)@R?YKGP5WMueYFD>Du?YQ>8W<09Gn#l\@~> +o`#-UP]^SJF6iJu"SCd-ai!M_!jnlbli0BPgnSFnhY5]cF(Ss2mJm1Q[r,BQl0GF5CKk,uqZ$Qc +`2$pDIDt7:kIupq?sTSts74aUQ[`aY<`X@9ZE8UlAmJj*rr4hRhS#.Z=.Rh,o]**2D-gP[p&4:. +^6="\A7AY\T7:BM:l=T7bcuFoA\-U`m)tQ:@U4WMrr4AB`h.?WA_Qq9XCZ!i>#A4rn,N@F^l_l9 +^>S>*T6XXLl1`YT@:<^GAjL'CC2\6@J;&iAR%1bbropt^G\:Ga;L,"B[BH'B@Uit^C2&C<YGnCS +E+iim??rEIWNXIt^T"31P'(MOA7')Iri#t&b3uM5J,~> +o`#-U[\T=SPO%l@"S@FZ.M;%X!Y#=mli0BPhnbV3hY5^3U6q+2mJm1Rc(B?gl0H9rSV_jLqZ$Qd +f>Eo"N5aiIkJ4BrO+FJ's74aUW2c>LJ9QgEZE9[fR#H[Xrr4hRjO:SrG,*OQo]*EbSrJ99p&4:. +^8S$$QAg6HTotC_ELH.gg<6=BICe/#m)uW0PD,:crr4DCdD)H4L"c=`a-)"2J9>q:n,N@Le[C3_ +^>S>*];CF;l1`YtO-,crrg?$?S=cRSWi`M5]"H>crp.qDV4!KrEJUEr[BH3^Ng,p!S!g%fYGnCg +T:;74KnuV*WNXIt^T"31S>)L@QAU6hri#t&b3uM5J,~> +o`#0XQ?d.RC=`CXrr`5dq=a^X#P.6Ah:prSnbMeYji6<Gs*X^eS76L"rSWl_B4,B:s81'6??Olp +kbj/H>\i<ts8'mAH<=RmlhpeYbaWf_?,?77r:T0RP&"9(NPF*,fq*h.>@QXms8MN%Tk.;IdI[A; +oXpN1>@#qYrqlBKViGOu<-5k$Z=$^Xbja>pN*KGaiVEKOiLka1>F"XUs"!`PRr)P[i7t\PD5jp_ +B:%6Erp[^p@9KJfqu,0MEE[;BrTCV-?<UZD@qGOL3bN,AF*`26p!9XhC1LLJLVhd-kiC=+Iq`J+ +BObeoj5S[aL2U[5?]*IpioKLtl/L^YZ\rm:A7'B*ro+"?mJ=!cJ,~> +o`#0XQ?d.RC=`CXrri;^h9a+<_?[lg['-X=]"n-Y!k,,gli2A0bFN*_jo+,%G%Y2rl2UY*TO2lo +punZ2AR'$0rr;i<YBj;Z_s@7#q95@Q?=(MBs8;QOY**R)=H1)Ijk68YAm8d*s8W)f^7f+?Fj]g[ +s7EsjEEcc&qYpBbj/@uR>uc!\d'@(]H-Gd3[u=QoWo<dQrSaH$@9f)crr4M@\XRGDI,NeeB5X`W +EbLilp\sZtSmbg"j88f-YAm`bjo+ANE*c^S@:NmGAiaR<CNFfKX7af>JSJ_!<JSHFk31mW\pnF* +AnY[i_W0Y-Tn[Jt@UG#Eio9%do',/nh6`,^An57idf/5-jR)fHs*t~> +o`#0XZDF%TOkTg.rri;6GXNAF%fQn=$k3[@%K[(Cip6Vlqp`<?MWOfp[%s+OMs:9=fYE<!fD+RK +YEt#uiVrlRfZL+DHc,1Is7t*VUlBoEpAb'`jhS?rLj56#fB(\kXI4lrj8]/Yo$Y@AI>H;Brr;W3 +\Y+e/g%t^Fp#EcnSVqcK^<j<AFc+E4iQnfeGcp$$rr(fjX-/%/mf*5;oZ=b;N0iJ`c'<p^[>9=) +fD#:7e\@5mXQ03Vh8u@BLZSKt\W)?!NKKHlR/<:3R[p1NVo/2[a/b\qLj#!!g?.V[f".<;R$jD. +P0)bDf<h]QR?NDqfAbfNmIKN$in_;RTp_4(MphUa!p&bFY5a"~> +o`#0\SpbBcC8q('s8V]lq"=XY%.`iKfuLG"XLZ^>n+6GK"6[b[rp9Y=p:Z`"MX1<)Q?m4QA^gVB +[r,BTm/>M0IUZQ1kl:YD[?G'&OQ-0;s7sX)F';l'qu6UAn$/*h>B%aLq>TigP@e$<jo>AXd]\:. +=gIAms8V`'Rr2JHiVriV+7#tfA63'HjRh6#W5n/m\tE_>E7O^_s8LoOJ6uQaoD\bEn#qskCQ?fU +NHDegi5i[anbr@/Y'aSseG&t.`0FV+L["j6hQqZ;=^"s4>$P?@@V#IM->.(*HI]WtFCnucBufQ: +rr;umj0s>IAnPXcTDANWY`Ed9@UPDiq>U`q`g(a[A70WGW;hA~> +o`#0\T7(KdC9%.(rr_oSfZF-0%)KWdXe(W3Q'8&Q^;9]`"1Y&Urp9Y=p:Z`"MX1<)Q[3=RB%-_C +\8GNVm/>M1IUZT3kl:YD[?G'&OQ-0;s7sX)F';o(qu6UAn$/*h>B%aLq>TigP@e$=jo>AXe$"C/ +=gIAms8V`'Rr2JHiVriV+7#tfA63*IjRh6$W5n/m\tE_>E7O^_s8LoPJ6uQaoD\bEn$&$lCQHlV +NHMkhi5i[anbr@0Y'aSteG&t.`0FV+M!=s7hQqZ<=^"s4>$P?@@V#IM->.(*He#`uFCnucC<,Z; +rr;umj0sAJAnPXcT_\WXY`Ed9@UPDiq>U`q`g1g\A70ZHW;hA~> +o`#0\[&KU_Q+HhcrrhtK@jhld%L<LP$OR1D$4IC>%Kd.J\,Pao0_W]"MONl2k-LqSP)Iuklcu,M +[d<tJ_5WZQP3DrFkg$Z$I@K6ns8VoA^7pF4gACmL-1Aj`R"U19l1t>I_7,hcM<4d;qqK5oML)_s +rr<#jah44$L#N%1ru^RG[$H5f\`ED<WN+#'n^"t>JVDYKs8W)W_Q&ZH[e'Lu1@N2lSX6>,e$G.J +h;HAhf(&_9fZC(LMq%M#maeq,FI27lptiE>I=$HqL51YFO->otrg>(&RAS]_]q_!ZJq:u.qu6Wp +puAo]R@'D.NjAK\n\MT+R?WN'nbN1jps-FGR?ieol)=W4~> +o`#0bY^gP%AUF"BrtYM!q=aIQn`o#X]W8'.Uo1&mdH'cfr:C*SaOC%Qs!@0?Lg[%Js6HG3Cgq%n +ouW_1FkQTeb+Eug>E%qKqSoF\>[52<rr35r]:3S@DrUcqru1.$M.9eIk5G>[n#qsd>`%bGs7Edj +C0PN+q>UBun?A-h>^,B1ruh="Vh8A[No'X3o&/HpqV830@9]8err<#sd%GYh?IeiMs$GtLMJI3l +WL\$Lh"gg9me6VZn[4^#D4p%Yf"HrE;.[o@s8McQa0:YNB4=qD<`r[6@:a%_B4Z"YTnR;p@9eiS +rVZ[/q:UdLB4b[`MXpf;Y`Ed9@UPDiq>U`q`g(a[A70WGW;hA~> +o`#0bY^pV&AUO(CrtYLoh9a*W^Ug\GQ&(ZkTr4WYVR=.Sr5&QGT?[9"s!@0?Lgd+Ks6HG3Cgq(o +ouWb3G1l]fb+O&h>E/"LqT#L]>[52<rr35r]:3S@E8plrru1.%M.9eIk5G>[n$&$e>`%bGs7Egk +C0PQ,q>UBun?A-h>^5H2ruh="W.SJ\O5Ba4o&/HpqV861@9f>frr<#sd%P_i?e+rNs$GtLMJI3l +WL\$Lh"gg9me6VZn[=d$D4p%Yf"HrE;.[o@s8McQa0:\OB4G%F='8d7@:a%_B4Z"YTnR;p@9noT +rVZ[/q:UdLB4b[aMt6o<Y`Ed9@UPDiq>U`q`g1g\A70ZHW;hA~> +o`#0b]W7TkQC[U@rtG@EGXN>X%LijU$ORA5O/J%.$k<%C!t>X6qs=>/nA_\eY42JW[]>s`O3@4I +]n_Htq>/RTVNHG#m/Qq2`2AK?`Uj*/#PH6PSV;mZrr2p9l,KrlJskd"s8VQ,\<_`7lMpnVbe9O" +K\-&!rs%u3\=&&2kPkK(ro:quO+!JRqYp'Di:$O$aKUeVVX"0\s8CQbV2BfRq#::Ll,9itTWQ2I +TTe1,qXEqHrVuE4\t5=nk4.H[Z&!FLb4>T3pZ';uR#$3<G'/"VK8PhYrg=.\T"De@SXGUlSE9_I +rtG4]XJ2,NQB%[0s7*q4Tp_.$V"+9\#l)]UUm[O-Om/hEJ,~> +o`#3jbCF>>ASnsUq#CBd'DV7gjOV8SX/2Yr_q3baZ*MsCnGMn\kK)$Fm/JBsWH)@^pAaWdLi?m? +V;AUk=gIDnot?l=?X0]'s7*C\C0YK.qu6U"n?A-g>_D;?rs/PTUjlcWV"+Ha&F-<R@9]Mrs8M,[ +M.9eHkl1S]#4&4H@pFuZrr3`3dA)"m>f6.3s8DinrqXF(H<spup&=t,pq`M@>@ugls8W)RV1E2e +Dfg)5C;'TDs!%ElW.SVlHC1@VA6;lY^#f.ks8Mocj4)&ZZE0a]K6:j;@fBsHA8HgPF(f/o@'0"s +rtGCrV1reuA70`Ns7*=SEFrZfPO\JK#l)E)G@kAnGNl(+J,~> +o`#3jbCOD?AT#$Vq#;*$jOhPe[Ao^TLm4C4_q3baZ)=V2^\kqN\=^n<m/JBsWH)@_pAaWdLi?m@ +V;AUk=gIDnot?l=?X9c(s7*F]C0YN/qu6U"n?A-g>_MA@rs/PTV12lYV"+Ha&F-?S@9fVts8M,\ +M.9eHkl1S]#4&7I@pFuZrr3`3dA2(n>f6.3s8DinrqXF(H<st!p&=t,pq`PA>A)mms8W)RVL`;f +Dfg)5CVKcFs!%EmWIn_mHC:IYAQW#[^#f.ks8Mocj4)&ZZE0a]KQV!=@fBsHA8HjQF(f/o@BK+t +rtGCrV1reuA70cOs7*=SEFrZfPO\JK#l)E*G@kAnGj21,J,~> +o`#3jcDmA%R$u+pq#;'#L1;M>%1EUO$8Q4s_q3bg[V$!Xq[N];$_d@^s!?sKU4UDYs7!b+T9bhU +iQdg:[d="dbIs^4J@+nIn]AA4LP4I[rr32l`OM7fQ0J;J#QEPsWfVe7nc&P"lGg)kJ?JDAro_;* +P_,:drr2p%lbg&oK:M<-rtYLb_PW3<`Ua$.rVQQmq9ZpSNI].Drr3c/cG#s,KAc_.s8LonX-f*A +U8+-@b5M8<0`BeGXI#0H]>1J/H?G(Xjno)Xrql6GeA]#)XJ;/DLPLnSR$jA-RA@$\R[K:l[IX4p +'E77+Y+:uHN0N`0n\MT+R?WN'nbN1jps-FGR?ieol)=W4~> +o`#6qhi2JbBP;n\rqcX2rTs@QiQJ^2WMHN)cJe6bqt/mh\(g-:rU^3Ub0]qNs!Ia#U1@`equ?<% +MfWKKPI?KVHeJ5pn?A-r?!bbLs66G:A6jWHrr2p%l`,nQ?(CB_ru1aRT6O[J_=mp/rn!uq?!YVI +s8C?>I:6K`nbrIlk,*c>?)7#irs/;5So@qLh#%!K#P"s\DHgE%r;Q^#o!Oiu>B]0.rs\eJTm:$G +@q]FcB8?0Xs"O5]RWMk;>[1HHEJ1:2jQkXVf\"]ol1a`6kMtCKbe^K:DeN`p@V0q-C1_'eA@D7/ +rt=e+P]:;G?Ztc8nZ\'oAn#/3nbN1jpr8SCAn5:nl)=W4~> +o`#6qhi;SdBP;n\rqcX2rT2eVZ_ES<PaA5XcJe6bqt/mhXKK+KrPAZITum)ss!Ia#UL[lgqu?<& +N,rTLPdc]YI+e>qn?A-r?!khMs66J;A6s`Jrr2p%l`,nQ?(CB_ru1aRT6O[K_Y4$0rn+)s?!b\J +s8C?>I:6NanbrIlk,3i??DR,jrs/;5So@qMh#%!K#P"s\DHgH&r;Q^#o!Oiu>Bf6/rs\eJU3U-H +@qfLdB8?0Xs"O5]RWMk;?!UZLEJ1:2jQkXVg"Fosl1a`6kMtCKbe^K;DeN`p@V0q-C1_'eA[_@0 +rt=e,P]:;G?[(i9nZ\'oAn#/3nbN1jpr8VDAn5:ol)=W4~> +o`#6qhl337R[Kr<rqcX1rOd/&%1ERN(Jp@-cJe6cqt/mhBabIK%Kd.JT_RpS-N;o=Q%@Zds7F@; +TpVIXag?_[g%k[;`jhY!JBmohl,BilL6Ca!rr32g_m>PYW:0`c)Z%jrV2^#FpAb0lh8?4MJ'@Ze +rRercObC(2rVm)a`3#/RY4;Mk#PZKWT883VqtpBun\qu/Lk"4Xrr32na1@^nNTU6?%/\PiV2p+[ +Ng,rtV=jcd0_il(UQ'_NI<pEsOK-@^n)i]kj5ASXp[RS4j5&80_69B$S!f\.OI;f4R@07s^A%L( +'(<]HTp_1&OmE&;_6fo(P_c.*q>U`qcFKa=Q].'kW;hA~> +o`#6sm&bA@AnZ4XqYL4/o^_[uY,e@pZGkP^oAlm+n,)qIb.c]qnc&._lHdfNmJeL0bFE$\j8T)R +d>r?]DM3^N?+fV)s6HVBB3Sj$rVkNCIUccGm/I"iro']*?X'c,rr3o/\XRSB?/#2Us8'd/F'N>5 +r;ZQ,R<N(I[.aM!#Q<)DHsU*ip&=srn["Qp>^,?0qu6oeV28knEo[/urs%npP@RmUli-nnp:Zu8 +>$@)HDJ!EsdJj+E(\4npDI@4VWi`_GcJS-cftXqsXe:!`qu6U*rr)WambP(/EFrcg@#Aq&AclRU +U\FWb'(</mEFrZbHKtP#Y`Ed9@UPDiq>U`q`g(a[AR]oKW;hA~> +o`#6sm&bDAAnZ7YqYL4/o\[]`MhmXjZGkP^oAlp-n,)qIb-/"Z^])(P\u!F@mJeL0bFN*]j8T)R +d?&E^DM3aO?+fV)s6HYCB3Sm%rVkNDIUccHm/I"iro'`+?X0i-rr3o/\sm\C?J>;Vs8'd/F'N>5 +r;ZQ,R<N(J[.aM!#Q<)EHsU-jp&=srn[+Wq>^5E1qu6oeVMStoF6!9!rs%npP@RmUli-nnp:Zu8 +>$@)HDJ!EtdJj+E(\4qqDI@7WWi`_GcJS-cftXqsXe:$aqu6U*rr)WambP+1EFrcg@#Aq&AclRV +U\FWb'(</mEFrZbHKtP#Y`Ed9@UPDiq>U`q`g1g\AR]rLW;hA~> +o`#6sm'rdWR@Bk\qYL4.oOf9T$48nBZGkP^oBO;snb`.Kb#AfZr=/o=%$LAPs!@Ql]oS!0rr;cB +[%`t\XKIS0^@)"#lbg&sLk4C\rnbDhP_bsurr36&j27pYJ%5.Mru1OP]V((0gACpMqU30RLP"@[ +s7jjNUlgAEpAY'srRnubNe"q<rr35na1@[mNop?<rs.l(Z'pW1j8T&X#4BF=Q%>Fjrr3H$bIsO& +H'jtfR?j2mrr)j5o#.u.N.\"-XgZ'khsgC!eBZ.V^S]QYrr3`4rV6$Qh7C%fR@&tgR[ok6R?iuB +p\On&n&Mu4R?N>dlMpCj[%WnPLnsS:rs8DF\YPX[Ng&_+s*t~> +oD]-ke:VIHBQ8U'qu$I:rTWITVkg?,e)^&okeDar]C5b!rThG=gZ\2"o^'uIp$Mc*p:Z`#M<b-@ +rS<QWAnZ$h=G#B*s8V5ZK4J5,jSo&"Q[*(NPOSSO#Q<&EH<ab,q>UC4n$&$i?#\g&s8V`&S8)8O +jo5;PZ]K6:A%;=5rs/A=T64CFg%t^J#4&=M@pFuZqYpcaU5*JnGNf#*#3i+C@9ou)rr3GsYa/m* +FiV=FB4bkDq#14/nZ\'nA9QD\jQZ+*qu6<(TS@c=F)SS`q>Ufm^R]IY@olp:Ir>6t!b[5Xqu7?/ +k-U(`Amef#m/QU[O)\c@@$C-Vrs8D=Q$-bOA9[::s*t~> +oD]-ke:_OIBQA^*qu$I:rSk;MPaSMbe)^&okeMjt]C5b!rThG+Y.;<a_Rl\Wp$Mc*p:Z`#MX(6A +rS<TXAnZ$h=G#B*s8V5[K4J5,jSo&"R!E1OPjn\P#Q<&FH<ae-q>UC4n$/*j?#em's8V`&S8)8P +jo5;PZ]K6:A%;=5rs/A>T64CGg%t^J#4&=M@pFuZqYpcaUPESoGj,,+#3i+C@:$&*rr3GsZ'K!, +G/qFHB4bnEq#14/nZ\'nA9QD\jQZ+*qu6<(TS@c=F)\Yaq>Ufm^R]IY@ols;J8Y?u!b[8Yqu7?/ +k-^.aAmef$m/QU[O)\c@@$C-Vrs8D>Q$-bOA9d@;s*t~> +oD]-ke>&FuR\?e"qu$I3rNm"@+BkGPe)^&omF&)'_XIL(rThEe$k<1G!t>ZQp$Mc*p<0t'Rd0qQ +rS=fSR@Bb/I$*7]s8V6#Xd+TsjSo&*\tt[NV==Ka#Q<;kVM]lSq>UC4n&Dl+LPb$is8V`6]pj_8 +jo5;P`3c8%M88ocrs/AH^S?[:g%t^J#4'78Q%PUnqYpca]W[fdP3DlE#3j.3P(C"1rr3Gs`jqIi +M9!H.R@0DFq#14/n\DN(Oc\#NjQZ+*qu6<6^TXQ5Tps$rq>Ufmcb?0BP_4CfTUu.N!g]SOqu7?/ +kKU<'R?2ogm/QUl[%WnPLnsS:rs8DF\>5O[PEtI3s*t~> +oD]3skbrH1ASZOGVsOE^ruh3s_Psrbh<an5ikpgsNPF3?rr<#qkeY$ekje<3d)>MBs!@0?M.*4L +s8W)ZQ?m4V@TQdJnG`Idd\;/!>_MAAq9"eAAS-kirr35u`hIN\CuG9krs%_dLh'b>l2L\om]Vgb +>`7qJs73CMEFWXdp\t1)oYR8@?>SU"s8W)WVh8D`V"+<]#3hh8Cgq>Hrr36&goH!5?c2X;rsn@p +N+6(Lk2;MDBOu/=rr2p%nZ@^h@Vk9*rri>h\rUh0Acl_$li-e]')U1eNc&E6<-H<EEFrfrAoc)n +r;RH,bc6,*A6N-Ao)J6aO)\c@@$C-VrsAJ=OEG/JA9?`.WW.J~> +oD]3skbrK2ASZOHW9jN_ruh3o[%t+Oh<an5il$q!Nka<@rr<#qkeXC'\\H"nVRQ-`s!@0?M.3:M +s8W)ZQ[3=W@TQdJnG`Idd\D5">_VGBq9"hBAS6tkrr35u`hRT]D;bBlrs%_dLh'e@l2L\om]Vgb +>`A"Ks73CNEFW[fp\t1)oYR8@?>\[#s8W)WW.SMbV"+<]#3hk9CgqAIrr36&goQ'6?c2X;rsn@p +N+6(Lk2;MDBOu2>rr2p%nZIdi@Vt?+rri>h\rUh0Acl_$li-e]')U4fNc&E6<HlKGEFrfrAol/o +r;RH,c)Z;,A6N0Bo)J6aO)\c@@$C-VrsAJ=O`b8KA9Hf/WW.J~> +oD]3skd-eER%:(W_XRR(ruh3V>_of0h<an5l.*2,SA3eNrr<#qkeTIl%1WjW$tf(ts!@0SZ%oLO +s8W)ZZDO(YP_"%onG`IdftjYOKU:s'q9cUFR$496rr35udD;Q7LuA72rs%`,Ya'p*l2L\om`)`% +Jt20,s73t0TTtVPp\t1)oZk7FMMU6js8W)Y`3#2SY4;Ag#3i_%SWf6#rr36&hoMjZK#m]crsnA4 +Z]p$0k2<83R[9K&rr2p%n\;?&PEP/,rri>ja0_K<R0/nXmf*+`')US3Z_!MAH&BY@TUD4:R%Dn- +r;RH,fZ0t[Q\^!uo)J6r[%WnPLnsS:rsAJF[A0.XQ_!.8WW.J~> +o)Bg*dtqgLAnlF@S]^I$s82'2fB2Z"kL6u'D0r;*jnJcQrsJYc_8"[ena+Z@na6>[lE,>?]Cl1' +-L%4TCLpdPK&6D)s7jL(H!t'Mn,N:<N,WB>GO5A0rpIXpE+4(Trr36&gSB=->`J.Mru1+#LLXkt +nc/X]]7k-6BpJ>js8M,mP\afRkPkJdrR%Bf?<t/8qYqf)RXT$_DT;YTs8(!>H=1:<qu?]qiMM68 +>cdMc]Qe%$C6\Mmrs/(sK5P7<\,H:*55jQB]74L*AnZ")S^HX!rqc!<cF9']AR88;ZerB<A7]Cg +DMZI5s8W)mf!pl_ARAAEfD5I:Y`Ed9@UPDiq>Us#c&-IPB4u1McIg^bb5JLCJ,~> +o)Bg*du%mMAnlFAT$$R%s82'2fB2Z"kL@&)DLAJ,jnJcQrsJYc_6'iM^UpANna6>[lE,>@]Cl1' +-L%7UCLpdPK&6D)s7jL(H!t'Nn,N:<NGrK?GjPJ1rpIXpE+4(Trr36&gSB=->`S4Nru1+#LLXkt +nc/X]]7k-6C6nMls8M,mP\afRkPkJdrR%Eg?=(59qYqf)Rso-`DT;YTs8(!>H=1==qu?]qiMV<9 +?**Vd]Qn+%C6\Mmrs/(sK5P7<\,H:*55jQB]7=R+AnZ")T$lg#rqc!<cFB-^AR88;ZerB=A7]Cg +DMZI5s8W)mf!pl_ARAAFfD5I:Y`Ed9@UPDiq>Us#c&6OQB4u1NcIgacbPeUDJ,~> +o)Bg*e"E%mR%0kP^=i/Xs82'2fB2Z"mGQ<uP`W&jjnJcQrsJYc_*8>;%LihXna6>[lGocU_=dg- +-L%t?SX5:\Ol$!8s7jpTV36P3n,N:<Z_*YOSF$:Urp\=LT9#/urr36&hSQ:UJtDB/ru1+@YEb!S +nc/X]`NGf"R'-)]s8M92\=J\DkPkJdrReucNe"q<qYqf)[],gaR*bg3s8(?dViZ_hqu?]qj2A$\ +J@+n:_5*KeR^)Yers/)/XIbfI`r5l955jcd_Q'&lR@9\C^#&/Trql3IgsER+R#ZK:\)4upQC+)0 +T<HoFs8W)niR#$+R#ZK?fD5I:_6fo(P_c.*q>Us#d^#L4R@BhYgZ%2BgAS2SJ,~> +o)Ba/m(IUQ@qB=nJ![1Jce7C<f@J6]Vg;umQbhDFr;-F"qrY`0g$%bO`:<9q#6*J_F)'D)rr4>5 +W.f+u<a*6,rr<#i^n5aYBXIF3ro&]MAnPt[p&*jhVh8bsIHgb2-2YoZH='sZo)Jagd@G\sD6rp8 +s7k,rBP(q$_Ya,_]:+%ZAprqCrs/;6Soe1Bg%tRFEU03?BP2(>lM^"mYDdF1DqY-is8CB@HsL(& +p\NU&D.[I&_>XE6oYc)fAncbIrVui^c'`OhJ7iA'B4u::SZ]T?_S<LQLiHp0:fES5o@f+9@:a(g +H'PYSbKe,8P]gVF;H'1Mrr;MmO)\c@@$C-Vrsnq]JnS_-BPrBkWhXj:p9+FG~> +o)Ba/m(IXR@qB=nJ![4Ld+[R>f[e?_W-W)oR).MGr;-F"qrY_sXgu'C\+/nd#6*J`F)0J*rr4>5 +W.f+u<a*6,rr<#i^n5aYBXIF3ro&`NAnQ"\p&*jiVh8bsId-k3-2YoZH='sZo)Jagd@PbtDR9$9 +s7k,sBP(q%_Ya,_]UF.[Aq'"Drs/;6Soe1Cg%tRFEU06@BP2(?lM^"mYDdF1E7t6js8CBAHsL+' +p\NU&DJ!R'_YsN7oYl2hAnceKrVui^cC/akJS/J(B4u::T!,fC_nWURLiHp0:fES5o@f.:@:a(g +H'Y_Tbg4;:P]gVF;H'1Mrr;MmO)\c@@$C-Vrsnq]K4nh.BPrBkWhXj:p9+FG~> +o)Ba/m(f'QPaIr5Wk-3th;mk`iSiSA`MSQHT>B7Nr;-F"qrY^Z$k3XSAb#3g#6*T(U6+()rr4>5 +]<.ZgJ9Sfurr<#ic+g$<OM1;dro'oKR$jP^p\a=.`N>\rT'?7S-2Z3-VN6;8o)JagfY4>OR)&Cp +s7k-ER[BS?dJNb#d_)KIQ(I7>rs/;D^8$O7g%tRFEU0s,R[KYMmeuV/ag.P'QJDK>s8CWfVi6/O +p\NUASXGq?dJa+FoZ="uR%()6rVuicgq/okT9bb0R@BkN^<+gRf@8*^Yb78=GB9;0o@fq'P*_T. +VRXe#gYLQ.\"oCPHul1Jrr;N)[%WnPLnsS:rsnq]W0s!?R\$Rn`knUap9+FG~> +nc'R)iM^Kt?t<kbFFfLGWNrn2QuunCBp6-WlhUPTrs8Ma_8"[bf>[7Ks(;9#lH6&KFN!>@s8VZ# +MJQNsK&6D(o^(GHP&OuPU>PtMl(Ds(AT*="XcddEAS,Ll[+3%=oXpK)>?o)?s8Vr8NH&QBIE]p? +q;R?H@V9bCWMY2mBP(geDm\'3d-e,uA6Na,rqcY7o"B-RA8?UbXdaBWB4YXiRa]EmoY-W)=^g.b +rp-Y+@qKV2^>dMmfnj<LAp9TQaMOii?&[14CgCFYAS>n&J;9&@Km[`H>uXU'PgK""m_s9V?".A\ +G(l6RSs"Y@@Tu]-MUV7us7*1@@piSIP4AAJ%fYUXB3\hR@qB=iA7:epY5a"~> +nc'R)iM^Kt?t<kbFFfLGWj9"4R<E(FC6Q6XlhUPTrs8Ma_6'iJX0hBcs(;9#lH6)LFN!>@s8VZ$ +MelWtK&6D(o^(JIP&OuPU>PtMl(Ds(AT*@$Y**pHAS,Ll[+<.@oXpK)>?o)?s8Vr8NH&QBIEg!A +q;RBJ@V9bDWMb8oBkCpfDm\*5d-e0!A6Nd-rqcY7o"B0SA8?UcY+0QZB4YXiS(#QpoY-W)=^p4c +rp-\,@qKV2^>dMmfnsENAp9WRaMXrk?B!:5CgCFYAS>n&J;9&@Km[`H>uXX(Q-f+#m_s<W?".A\ +G(l6RSs"Y@@Tu]-MUV7us7*1@@piSIP4AAJ%fYUXBO"qS@qB=iA7:epY5a"~> +nc'R)iNJ<#OHu<*UT:f<`lu]J];(@6JXa7"lhUPTrs8Ma_*8>;$r-6\s(;9'maoFRT$Qg's8VZ- +Z(6brOl$!7p@74k\"B%Y\E<ejl*-V?R%LS"agRq4QC+&1a5PS)oZOe8LjmD=s8VrAZ_<bSVqKhH +q;S9;PF8/P`l+mNQ'[l*S]B^>h<r7hQ\C.PrqcX&o#%)_QCY"hah=C>rg7/a\DQ#goZXk7Kn/"X +rp.%bQ'n5Fd-9EIfqXaoRAILAf[[p/JXOolOc#3bR$sS@Wir\4Y,IqVMgf_kSC$j*m_tEKN0BX" +Uoq8B^:()5P_j[*Q.,F+s7*h'Q&poVU[e0[%fYUjOc,9aQ'[r1Q&;L1Y5a"~> +nc'L+p",mS?!CTA?t!MS@pr\J=&s:,]$fg9rUp0qqrY`/eBP_pnc)Gai3TGCAR/\cG-UrEpW.Sa +:gh?5rqO73TQadJ>$Z,lPPXprG@4QW>$G08OFL_B=^#BOBs$TcB3S;>h#%-Oq9*kc=]o$FBP6f& +^2mU`r`Tq;CS5cU=]np>C2'g1M.KgeFQ`K"55O#m@p3&?>$>'WQ=jB(=^c&ZNT?L@>>]7urr;`B +JRDVb>\S1mVWGI1?<^]DBP:jZBq*B3fqN.d>?bE@rEq6b?!C?/;-%Y9dd[58qr>,4?<^T=?X[DR +@UNJD<)HhTbjYN1s7)^m>$"^$O7E#F"nKol?WgM1=Thf*;NL@Ns*t~> +nc'L+p",pU?!CTA?t!MS@pr\J=''C.]$fg9rUp0qqrY_rWM?N]nc)GaiO#VEAR/\dGI%,GpW7\c +:gqE6rqO:5TQadJ>$Z,mPPXprG[OZX>$G08OFLbC=^#BOBs$TcB3S;?h#%-Oq9*nd=]o$FBP?l' +^2mXar`Tq;CnPoW=]np>C2'g1MIfpfFm&T#55O#nA6N/@>$G-YQ=sH)=^c&[NoZXB>>];!rr;`B +Jmhed>\S4oVrbR3?<^]DBP:m[C7EK4fqN1e>?bE@rEq6b?!C?/;HIk<dd[58qr>,5?X-c??X[DR +@UNJD<)HhUbjYN1s7)an>$"^$OR`,G"nKol?WpS2=Thf*;NUFOs*t~> +nc'L+p"-."K85AFOHG`kQ'.)ZH$+e2]$fg9rUp0qqrY^Z$k+u[nc*5"kKV#QQ].!!UW332pW]Ol +GC.C"rqOsb^nm-KLl@n"ZMO4<QAC6NLk^D*R$!;]L51hRO1shcQA'R/h#%-Oq9YalL4tJJP)Sku +^lsS.Lkp_3Jte9^L5(JEPE3H<Y*4EZMWag855O$,MhHkAL4OW0S;i;YL5_=YW8t@QKQVt/rr;`B +S;W,XMjBou]&gYfKnbMJR@&t_J>(6Pfr9aYKo(eMrK&XlN/3%2F*3/;dd[58qr>2JJqSo;O-,Wj +PE:]UHZF=pbjYN1s7*LXJ9uQ_TCM^V"nKp)Jpr4KJHUIKF.`!*s*t~> +nGa:'o@UL#@Tc`5=&r:!<*O-jVSC^HpAOR^#5dQ!\[\s2nc&ag`,8sbrDsP4R.UFUgM'bkOQ-0; +mYPO[qc>FQG45Cl\:.[a='g0Qa1$"i='KBoY1hojD.[F1jo5;[qr!`H='&mRNP4]TiO!b,<tf%s +]Zd<l='&U?LT]@gI;<G.R-aYK+TCiPO^M6l>Ap1P`IV;r=(lrVd,:%)An[7ks8W&_]Qa?V)J"5b +dI?,&I:$&S='K[-]%6?Io@LF+AQW&8r`9J.<)cdtAq$SmhXpdGrtP7f_j,4H='&F(=&r:!<F0sM +cL(T0rrVc"K`65uJ$AM=rrr>daJ+0"rFQ.II^&CGs*t~> +nG`^lo@UL#@p8k5$s$>+<Ej6lVSC^HpAOR^#5dQ!Vim_=nc&ag`,B'erE'V6R.UFUgM0knOQ-0; +mYPR]qcGLSGOPLm\:.^c=C6BTa1$"j=BoTrYM/#lDJ*X5jo5;[qr!`I=BK*VNP4]TiO!e-=;,2! +]Zd<m=BJgCLTfFhIV`Y2R-aYK+TCiPO^V?o>]?@R`IV>t=D</Yd,:(*B5*Ins8W&_]QjEX)J+;d +dI?,&IUH8V=Boj/]%6?Io@LF+Am&5:r`9J.<)lk!B7HbohXpdGrtP7f_j,7J='&F(=&r:"<F:'P +cL(T0rrVc"K`65uJ$AM=rrr>daJ+3$rFZ4JJ$ALHs*t~> +nG`[ko@UL4J,Xa'H[9mXFEi=sW5$pJpAOR^#5dQ!57013nc&agc]s*,rH8`sWV$5fgQ-Q%S)X>F +m\bqiqfXW:O73&0\rV,[G']"Ia1@.PG'JS&ZJ+?3LOO]6jo5;[qr"5uG'87gR(r"aiO4XCFq]7c +]ZdR7G'8+]Pd9$#RY6-?V!RpW:&aV(S:#L'G_;d/`KY^mG(5INd,:gXIXdpSs8W&_^5[>[G(,FI +eF;G+NdGqjG'J\/]%6?Io@LF7IsH<cH@(!bGBItMIZ12@hXpdGrtP7f_juO.G^4U^H[9jVFaAnF +cL(T0rrVc+Q2ZR@Nk"ZTrrr>daJY#JrI+j!Nk"Y_s*t~> +n,EUkpZ'?$Q[esZ#_\MH]Zo="q#9a^"oIH!ZG#VprrW&S\bi?:[++aJroh(qZdSLGs6n+6qPbL= +b4#B*j2\I*X0fq*n)M6dWirtTh!j[V]"#B!nG`G6rpe@BWiWSBcJnTtpYiumWN<VTkOIBBXfAS8 +akZCObIG'sg%G.?)>idI[]?F4_:e8@bH\(L[`-kamF/_X^=MrUruh-t`36/A[DLGZqY0$k[&K4e +YeS]Op\t3lp>sQ-SrS-pGmK4fX16=.meZq]rs/Q"m+&kSOb<RW#)SnWa5?IdrVlroim%JA!mTa" +p\tBnn(c("rO;sCb2W3!s*t~> +n,EUkpZ'?$Q[esZ#_\MH]Zo="q#9a^"oIH!VmYm]rrW&S\bi?:[++aJroh(qZdSLGs6n+6qPbL= +b4#B*j2\I*X0fq*n)M6dWirtTh!j[V]"#B!nG`G6rpe@BWiWSBcJnTtpYiumWN<VTkOIBBXfAS8 +akZCObIG'sg%G.?)>idI[]?F4_:e8@bH\(L[`-kamF/_X^=MrUruh-t`36/A[DLGZqY0$k[&K4e +YeS]Op\t3lp>sQ-Sr\3rGmSeROK5n6h<t.=rVm-%qWubIYE=M:GmAYPS[6Aoo)8Oe!r1d"rl"r` +iqW9J"T.ZCb.dha"22k:poaXI~> +n,EUkpZ'?$SW*N'#`tOY]Zo="q#9a^"oIH!@u'F@rrW&S\bi?:[++aJroh(qZdSLGs6n+6qPbL= +b4#B*j2\I*X0fq*n)M6dWirtTh!j[V]"#B!nG`G6rpe@BWiWSBcJnTtpYiumWN<VTkOIBBXfAS8 +akZCObIG'sg%G.?)>idI[]?F4_:e8@bH\(L[`-kamF/_X^=MrUruh-t`36/A[DLGZqY0$k[&KLm +YeS]Op\t3lp>sQ-U6^Z7L^Ap$R&da>h<t.=rVm-%qWubIYF1IML^/d#TsMeso)8Oe!r1d"rl"r` +iqW9J"T.ZCb.dha"22k:poaXI~> +mJd^oo&\KIa2Q$<cIh1Do_\XSrri5`f&$)irrW/kkkj?Mk4/?Ks7kj<kOSTOs8)-DqViOVmJ?k^ +qsik0j66%1rqYpAj5oUtqYp?\lKRX*qu-O?rU]75j65q(qu6WpqX3J)j6?47rqGd?j5oUtqYp?[ +l07R,rV-=/rUf@7j6#e*rql3Ij5fIoq#:0]lfmd.r;Q^2rqc'EioB7kpAFphqsin.gY_/]p\k$i +"o\)WgsX=C`<XK0fAPrcqu6Ek#6";aimuAprl#)_d+d^Qqu6Nn!r_obrp^'\q#0pd$i^"om-<j" +lKn'9rN?0N~> +mJd^oo&\KIa2Q$<cIh1Do_\XSrri5`f&$)irrW/kkkj?Mk4/?Ks7kj<kOSTOs8)-DqViOVmJ?k^ +qsik0j66%1rqYpAj5oUtqYp?\lKRX*qu-O?rU]75j65q(qu6WpqX3J)j6?47rqGd?j5oUtqYp?[ +l07R,rV-=/rUf@7j6#e*rql3Ij5fIoq#:0]lfmd.r;Q^2rqc'EioB7kpAFphqsin.gY_/]p\k$i +"o\)WgsX=C`<XK0fAPrcqu6Ek#6";aimuAprl#)_d+d^Qqu6Nn!r_obrp^'\q#0pd$i^"om-<j" +lKn'9rN?0N~> +mJd^oo&\KIa2Q$<cIh1Do_\XSrri5`f&$)irrW/kkkj?Mk4/?Ks7kj<kOSTOs8)-DqViOVmJ?k^ +qsik0j66%1rqYpAj5oUtqYp?\lKRX*qu-O?rU]75j65q(qu6WpqX3J)j6?47rqGd?j5oUtqYp?[ +l07R,rV-=/rUf@7j6#e*rql3Ij5fIoq#:0]lfmd.r;Q^2rqc'EioB7kpAFphqsin.gY_/]p\k$i +"o\)WgsX=C`<XK0fAPrcqu6Ek#6";aimuAprl#)_d+d^Qqu6Nn!r_obrp^'\q#0pd$i^"om-<j" +lKn'9rN?0N~> +li.%cq=O[V"7l-]roa:`r:fsaJcF:#!r`#ppAY6oqtK[[nH8@Tq>Kma"9&&fo)A.]o(Mt[LAuc~> +li.%cq=O[V"7l-]roa:`r:fsaJcF:#!r`#ppAY6oqtK[[nH8@Tq>Kma"9&&fo)A.]o(Mt[LAuc~> +li.%cq=O[V"7l-]roa:`r:fsaJcF:#!r`#ppAY6oqtK[[nH8@Tq>Kma"9&&fo)A.]o(Mt[LAuc~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +JcC<$JcFs6J,~> +%%EndData +showpage +%%Trailer +end +%%EOF 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..354c83aa6 --- /dev/null +++ b/docs/ka_method/Makefile @@ -0,0 +1,55 @@ +#--------- 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 + +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..43bf5c207 --- /dev/null +++ b/docs/ka_method/doc-duplication.xml @@ -0,0 +1,852 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> + <article lang="en"> + <title>Clone a node using KA method</title> + <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, xfs, jfs). + </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</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>you can only duplicate same kind of HDD (IDE or SCSI)</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>. 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 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 all necessary tools 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 to 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.</para></listitem> + </itemizedlist> + </sect3> + <sect3> + <title>Needed files</title> + <para> + All needed files are available on Mandriva Linux cooker. + </para> + <para> + <itemizedlist> + <listitem><para><emphasis role="bold">install/stage2/rescue.sqhfs</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.</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> + Mandriva Linux 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 rescue 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,Mandrake Linux x86 +service=IA64PC,0,2,linux,Mandrake Linux 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), + and mount it loop in <emphasis role="bold">/mnt/ka</emphasis>. + </para> + <para> + <screen> +mkdir /mnt/ka +mount -o loop -t squashfs rescue.sqfs /mnt/ka</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. If you want + to modify the content of this rescue disk (add scripts...), mount it in a tempory directory, and copy the content + into the <emphasis role="bold">/mnt/ka</emphasis> directory. + </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. +<screen> + -h, --help : display this message + -n num : specify the number of (destination) nodes + -x dir : exclude directory + -X sdb : 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'</screen> + </para> + </sect3> + <sect3> + <title>replication.conf</title> + <para> + This file contain 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. + </para> + </sect3> + <sect3> + <title>gen_modprobe_conf.pl</title> + <para> + This script create 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-0.92 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 code source is available in the ka-deploy-0.92 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 Mandriva Linux 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 Mandriva Linux 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 uptodate <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: + </para> + <para> +<programlisting><![CDATA[ + <screen> +[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/hda desc</emphasis>: specify if you want to duplicate SCSI or IDE storage, and 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 node is waiting for the rest of the 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. + </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">rescue_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>). Then, nodes chroot their + memories (the <emphasis role="bold">/tmp/stage2</emphasis> directory), and launch the <emphasis role="bold">drvinst</emphasis> command from the rescue disk, 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, 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>full log of a KA duplication</title> + <sect2> + <title>Golden node side</title> + <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. +got UDP packet from 10.0.1.35 +Session name matches +Sending UDP reply to 10.0.1.35 +Accepting connection from 10.0.1.35 +Clients : want_data 0 / connected 0 +client says hello ! +Client sends options +Client accepts data +Added client 10.0.1.35, daddy = 10.0.1.40 +Accepting connection from 10.0.1.35 +checking connection auth10.0.1.40 reports 10.0.1.35 has opened data connection +Client 10.0.1.35 reports data position : 0 +10.0.1.40 reports 10.0.1.35 has been accepted +Welcome son, you are number 1 (MAX 4) +Let's go! +Total data read = 45 Megs, BUF: 0M FREE = 34M startpos = 10M +End of data flow +Dropping children +Dropping child 10.0.1.35 +All children dropped +Client says dad disconnected +Client says he has finished +Client has finished transfer +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 = 48 Megs, in 2172 packets +Transfer time = 6.125 seconds, throughput = 7.881 Mbytes/second +The pipeline was emptied in 0.026 seconds + - Sending partition/filesystem/mount points informations... + +++ Running ka-deploy +++ +Compiled : Aug 23 2007 12:58:29 +ARGS=+ka-d-server+-s+kainstall1+-n+1+-e+(cd /tmp/ka-d6083 && tar c *)+ +Server IP = 10.0.1.40 +command = (cd /tmp/ka-d6083 && tar c *) +I want 1 clients +Socket 4 on port 30765 on node40.guibland.com ready. +Socket 5 on port 30764 on node40.guibland.com ready. +got UDP packet from 10.0.1.35 +Session name matches +Sending UDP reply to 10.0.1.35 +Accepting connection from 10.0.1.35 +Clients : want_data 0 / connected 0 +client says hello ! +Client sends options +Client accepts data +Added client 10.0.1.35, daddy = 10.0.1.40 +Accepting connection from 10.0.1.35 +checking connection auth10.0.1.40 reports 10.0.1.35 has opened data connection +Client 10.0.1.35 reports data position : 0 +10.0.1.40 reports 10.0.1.35 has been accepted +Welcome son, you are number 1 (MAX 4) +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.35 +All children dropped +Client says dad disconnected +Client says he has finished +Client has finished transfer +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 = 0 Megs, in 1 packets +Transfer time = 0.016 seconds, throughput = 0.628 Mbytes/second +The pipeline was emptied in 0.027 seconds + WAITING node (partition/format) + - Sending Linux filesystem... + +++ Running ka-deploy +++ +Compiled : Aug 23 2007 12:58:29 +ARGS=+ka-d-server+-s+kainstall2+-n+1+-e+(cd /; tar --create --one-file-system --sparse /)+ +Server IP = 10.0.1.40 +command = (cd /; 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. +got UDP packet from 10.0.1.35 +Session name matches +Sending UDP reply to 10.0.1.35 +Accepting connection from 10.0.1.35 +Clients : want_data 0 / connected 0 +client says hello ! +Client sends options +Client accepts data +Added client 10.0.1.35, daddy = 10.0.1.40 +Accepting connection from 10.0.1.35 +checking connection auth10.0.1.40 reports 10.0.1.35 has opened data connection +Client 10.0.1.35 reports data position : 0 +10.0.1.40 reports 10.0.1.35 has been accepted +Welcome son, you are number 1 (MAX 4) +Let's go! +Total data read = 621 Megs, BUF: 24M FREE = 10M startpos = 586M +End of data flow +Dropping children +Dropping child 10.0.1.35 +All children dropped +Client says dad disconnected +Client says he has finished +Client has finished transfer +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 = 627 Megs, in 34011 packets +Transfer time = 127.140 seconds, throughput = 4.937 Mbytes/second +The pipeline was emptied in 1.549 seconds +]]></programlisting> + </para> + </sect2> + <sect2> + <title>KA client side</title> + <para> + Just launch <emphasis role="bold">/mnt/ka/ka/status_node.pl IPADD</emphasis> to get log of the KA client. + </para> +<programlisting><![CDATA[ +10.0.1.35> ------| Ka |---- Install starting... +10.0.1.35> Current session is -s kainstall1 +10.0.1.35> Receiving partitions information...OK +10.0.1.35> Cleaning hard drive... +10.0.1.35> ==> /tmp/kacmd <== +10.0.1.35> Starting log server.. +10.0.1.35> +10.0.1.35> ==> /tmp/ka_log-10.0.1.35-20071024-10h32 <== +10.0.1.35> OK +10.0.1.35> Device contains neither a valid DOS partition table, nor Sun, SGI or OSF disklabel +10.0.1.35> Building a new DOS disklabel with disk identifier 0x59be1427. +10.0.1.35> Changes will remain in memory only, until you decide to write them. +10.0.1.35> After that, of course, the previous content won't be recoverable. +10.0.1.35> +10.0.1.35> +10.0.1.35> The number of cylinders for this disk is set to 1116. +10.0.1.35> There is nothing wrong with that, but this is larger than 1024, +10.0.1.35> and could in certain setups cause problems with: +10.0.1.35> 1) software that runs at boot time (e.g., old versions of LILO) +10.0.1.35> 2) booting and partitioning software from other OSs +10.0.1.35> (e.g., DOS FDISK, OS/2 FDISK) +10.0.1.35> Warning: invalid flag 0x0000 of partition table 4 will be corrected by w(rite) +10.0.1.35> +10.0.1.35> Command (m for help): The partition table has been altered! +10.0.1.35> +10.0.1.35> Calling ioctl() to re-read partition table. +10.0.1.35> Syncing disks. +10.0.1.35> Writing partition table for sda using fdisk...OK +10.0.1.35> Formatting /dev/sda5 as ext3...OK +10.0.1.35> Formatting /dev/sda1 as swap...OK +10.0.1.35> - Mounting /dev/sda5 as /mnt/disk/ ......OK +10.0.1.35> ++++++++++++++++++++++++++ +10.0.1.35> rootfs on / type rootfs (rw) +10.0.1.35> /proc on /proc type proc (rw) +10.0.1.35> none on /sys type sysfs (rw) +10.0.1.35> none on /proc/bus/usb type usbfs (rw) +10.0.1.35> /dev/ram3 on /tmp/stage2 type ext2 (rw) +10.0.1.35> /dev/sda5 on /mnt/disk type ext3 (rw,data=ordered) +10.0.1.35> ++++++++++++++++++++++++++ +10.0.1.35> Linux copy is about to start +10.0.1.35> Server IP is 10.0.1.40 +10.0.1.35> Buffers names :pipe +Total data received = 620 Megs (11.222 Mbytes/sec); BUF :0M End of data flow +10.0.1.35> Flushing buffers +10.0.1.35> Total data received = 627 Megs, in 434960 packets +10.0.1.35> Elapsed time = 128.482 seconds, throughput = 4.886 Mbytes/second +10.0.1.35> Syncing disks...OK +10.0.1.35> Linux copy done. +10.0.1.35> Creating excluded directories +10.0.1.35> - bootloader is grub --with=jfs --with=ata_piix (user choice and options) +10.0.1.35> - Removing duplicated dhcp cache +10.0.1.35> - Writing modprobe.conf +10.0.1.35> ******************** +10.0.1.35> install scsi_hostadapter /sbin/modprobe aic7xxx; /sbin/modprobe ata_piix; /bin/true +10.0.1.35> alias eth0 eepro100 +10.0.1.35> alias eth1 eepro100 +10.0.1.35> ******************** +10.0.1.35> - Remove ude network rules +10.0.1.35> removed `/mnt/disk/etc/udev/rules.d/61-net_config.rules' +10.0.1.35> - Running mkinitrd +10.0.1.35> Looking for default grub menu +10.0.1.35> - erase old initrd.img link +10.0.1.35> removed `/mnt/disk/boot/initrd.img' +10.0.1.35> initrd will be : /boot/initrd-2.6.22.9-desktop-1mdv.img +10.0.1.35> running: chroot /mnt/disk /sbin/mkinitrd -v -f --with=jfs /boot/initrd-2.6.22.9-desktop-1mdv.img 2.6.22.9-desktop-1mdv +10.0.1.35> Looking for deps of module aic7xxx + 10.0.1.35> scsi_transport_spi scsi_mod +10.0.1.35> Looking for deps of module scsi_transport_spi + 10.0.1.35> scsi_mod +10.0.1.35> Looking for deps of module scsi_mod +10.0.1.35> skip dups +10.0.1.35> Looking for deps of module sd_mod + 10.0.1.35> scsi_mod +10.0.1.35> Looking for deps of module scsi_wait_scan + 10.0.1.35> scsi_mod +10.0.1.35> Looking for deps of module ext3 + 10.0.1.35> jbd +10.0.1.35> Looking for deps of module jbd +10.0.1.35> Looking for deps of module jfs +10.0.1.35> Using modules: /lib/modules/2.6.22.9-desktop-1mdv/kernel/drivers/scsi/scsi_mod.ko /lib/modules/2.6.22.9-desktop-1mdv/kernel/drivers/scsi/scsi_transport_spi.ko /lib/modules/2.6.22.9-desktop-1mdv/kernel/drivers/scsi/aic7xxx/aic7xxx.ko /lib/modules/2.6.22.9-desktop-1mdv/kernel/drivers/scsi/sd_mod.ko /lib/modules/2.6.22.9-desktop-1mdv/kernel/drivers/scsi/scsi_wait_scan.ko /lib/modules/2.6.22.9-desktop-1mdv/kernel/fs/jbd/jbd.ko /lib/modules/2.6.22.9-desktop-1mdv/kernel/fs/ext3/ext3.ko /lib/modules/2.6.22.9-desktop-1mdv/kernel/fs/jfs/jfs.ko +10.0.1.35> Using /tmp as temporary directory. +10.0.1.35> /sbin/nash -> /tmp/initrd.tG1408/bin/nash + 10.0.1.35> /lib/modules/2.6.22.9-desktop-1mdv/kernel/drivers/scsi/scsi_mod.ko.gz: 60.6% + 10.0.1.35> /lib/modules/2.6.22.9-desktop-1mdv/kernel/drivers/scsi/scsi_transport_spi.ko.gz: 63.1% + 10.0.1.35> /lib/modules/2.6.22.9-desktop-1mdv/kernel/drivers/scsi/aic7xxx/aic7xxx.ko.gz: 61.4% + 10.0.1.35> /lib/modules/2.6.22.9-desktop-1mdv/kernel/drivers/scsi/sd_mod.ko.gz: 60.2% + 10.0.1.35> /lib/modules/2.6.22.9-desktop-1mdv/kernel/drivers/scsi/scsi_wait_scan.ko.gz: 77.3% + 10.0.1.35> /lib/modules/2.6.22.9-desktop-1mdv/kernel/fs/jbd/jbd.ko.gz: 60.5% + 10.0.1.35> /lib/modules/2.6.22.9-desktop-1mdv/kernel/fs/ext3/ext3.ko.gz: 53.9% + 10.0.1.35> /lib/modules/2.6.22.9-desktop-1mdv/kernel/fs/jfs/jfs.ko.gz: 51.4% +10.0.1.35> Loading module scsi_mod.ko +10.0.1.35> Loading module scsi_transport_spi.ko +10.0.1.35> Loading module aic7xxx.ko +10.0.1.35> Loading module sd_mod.ko +10.0.1.35> Loading module scsi_wait_scan.ko +10.0.1.35> Loading module jbd.ko +10.0.1.35> Loading module ext3.ko +10.0.1.35> Loading module jfs.ko +10.0.1.35> /usr/sbin/resume -> /tmp/initrd.tG1408/bin +10.0.1.35> Contents of RCFILE: +10.0.1.35> #!/bin/nash +10.0.1.35> +10.0.1.35> echo "Loading scsi_mod.ko module" +10.0.1.35> insmod /lib/scsi_mod.ko +10.0.1.35> echo "Loading scsi_transport_spi.ko module" +10.0.1.35> insmod /lib/scsi_transport_spi.ko +10.0.1.35> echo "Loading aic7xxx.ko module" +10.0.1.35> insmod /lib/aic7xxx.ko +10.0.1.35> echo "Loading sd_mod.ko module" +10.0.1.35> insmod /lib/sd_mod.ko +10.0.1.35> echo "Loading scsi_wait_scan.ko module" +10.0.1.35> insmod /lib/scsi_wait_scan.ko +10.0.1.35> echo "Loading jbd.ko module" +10.0.1.35> insmod /lib/jbd.ko +10.0.1.35> echo "Loading ext3.ko module" +10.0.1.35> insmod /lib/ext3.ko +10.0.1.35> echo "Loading jfs.ko module" +10.0.1.35> insmod /lib/jfs.ko +10.0.1.35> echo Mounting /proc filesystem +10.0.1.35> mount -t proc /proc /proc +10.0.1.35> echo Mounting sysfs +10.0.1.35> mount -t sysfs none /sys +10.0.1.35> echo Creating device files +10.0.1.35> mountdev size=32M,mode=0755 +10.0.1.35> mkdevices /dev +10.0.1.35> echo Creating root device +10.0.1.35> mkrootdev /dev/root +10.0.1.35> resume +10.0.1.35> echo 1 > /sys/power/suspend2/do_resume +10.0.1.35> echo 1 > /sys/power/tuxonice/do_resume +10.0.1.35> echo Mounting root filesystem /dev/root with flags relatime +10.0.1.35> mount -o relatime --ro -t ext3 /dev/root /sysroot +10.0.1.35> echo Switching to new root +10.0.1.35> switchroot --movedev /sysroot +10.0.1.35> echo Initrd finished +10.0.1.35> First drive will be: /dev/sda +10.0.1.35> Installation finished. No error reported. +10.0.1.35> This is the contents of the device map /boot/grub/device.map. +10.0.1.35> Check if this is correct or not. If any of the lines is incorrect, +10.0.1.35> fix it and re-run the script `grub-install'. +10.0.1.35> +10.0.1.35> (hd0) /dev/sda +10.0.1.35> (hd1) /dev/sdb +10.0.1.35> umount: /mnt/disk/dev: not mounted +10.0.1.35> Umounting /dev/sda5...OK +10.0.1.35> AUTH not understood +10.0.1.35> Local directory now /tmp +exec lsmod +10.0.1.35> <console> +10.0.1.35> <console> +10.0.1.35> <console> exec lsmod +10.0.1.35> Module Size Used by +10.0.1.35> aic7xxx 167992 0 +10.0.1.35> scsi_transport_spi 22432 1 aic7xxx +10.0.1.35> ata_piix 12228 0 +10.0.1.35> libata 109424 1 ata_piix +10.0.1.35> sr_mod 15044 0 +10.0.1.35> sd_mod 25888 0 +10.0.1.35> scsi_mod 124908 5 aic7xxx,scsi_transport_spi,libata,sr_mod,sd_mod +10.0.1.35> loop 14212 0 +10.0.1.35> jfs 176708 0 +10.0.1.35> xfs 528088 0 +10.0.1.35> reiserfs 247908 0 +10.0.1.35> ext3 118824 0 +10.0.1.35> jbd 50184 1 ext3 +10.0.1.35> vfat 10816 0 +10.0.1.35> nls_iso8859_1 4672 0 +10.0.1.35> nls_cp437 6304 0 +10.0.1.35> fat 45980 1 vfat +10.0.1.35> isofs 31452 0 +10.0.1.35> piix 9060 0 [permanent] +10.0.1.35> ide_cd 35488 0 +10.0.1.35> ide_disk 14496 0 +10.0.1.35> ide_core 99396 3 piix,ide_cd,ide_disk +10.0.1.35> af_packet 17960 0 +10.0.1.35> eepro100 28432 0 +10.0.1.35> mii 5376 1 eepro100 +10.0.1.35> usbkbd 6304 0 +10.0.1.35> uhci_hcd 22736 0 +10.0.1.35> usbcore 113928 3 usbkbd,uhci_hcd +]]></programlisting> + </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.pdf b/docs/ka_method/duplication.pdf Binary files differnew file mode 100644 index 000000000..008fa17d7 --- /dev/null +++ b/docs/ka_method/duplication.pdf diff --git a/docs/ka_method/duplication.xml b/docs/ka_method/duplication.xml new file mode 100644 index 000000000..90d9efd84 --- /dev/null +++ b/docs/ka_method/duplication.xml @@ -0,0 +1,27 @@ +<?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>Mandriva Linux: 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.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/html/duplication.html b/docs/ka_method/html/duplication.html new file mode 100644 index 000000000..b4ecc2203 --- /dev/null +++ b/docs/ka_method/html/duplication.html @@ -0,0 +1,661 @@ +<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" /><title>Duplicate a node</title><link rel="stylesheet" href="styleguibo.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /><link rel="start" href="#id2447712" title="Duplicate a node" /><link rel="next" href="#id2446541" title="1. Duplicate a computer over the network" /></head><body><div class="article" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="id2447712"></a>Duplicate a node</h2></div></div><hr /></div><div class="toc"><dl><dt><span class="sect1"><a href="#id2446541">1. Duplicate a computer over the network</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id2243707">1.1. KA method</a></span></dt><dt><span class="sect2"><a href="#id2521938">1.2. HOW it works</a></span></dt><dd><dl><dt><span class="sect3"><a href="#id2521943">1.2.1. Steps</a></span></dt><dt><span class="sect3"><a href="#id2522328">1.2.2. Needed files</a></span></dt></dl></dd><dt><span class="sect2"><a href="#id2522381">1.3. Step 1: PXE, TFTP, DHCPD services</a></span></dt><dd><dl><dt><span class="sect3"><a href="#id2522416">1.3.1. PXE parameters on server</a></span></dt><dt><span class="sect3"><a href="#id2522497">1.3.2. TFTP server</a></span></dt><dt><span class="sect3"><a href="#id2522528">1.3.3. PXE configuration</a></span></dt><dt><span class="sect3"><a href="#id2522540">1.3.4. DHCPD configuration</a></span></dt></dl></dd></dl></dd><dt><span class="sect1"><a href="#id2522692">2. Setup a node as a golden node</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id2522697">2.1. The rescue.sqfs file</a></span></dt><dd><dl><dt><span class="sect3"><a href="#id2522749">2.1.1. ka-d.sh</a></span></dt><dt><span class="sect3"><a href="#id2522775">2.1.2. replication.conf</a></span></dt><dt><span class="sect3"><a href="#id2522788">2.1.3. fdisk_to_desc</a></span></dt><dt><span class="sect3"><a href="#id2522812">2.1.4. gen_modprobe_conf.pl</a></span></dt><dt><span class="sect3"><a href="#id2522837">2.1.5. ka-d-client</a></span></dt><dt><span class="sect3"><a href="#id2522872">2.1.6. ka-d-server</a></span></dt><dt><span class="sect3"><a href="#id2522906">2.1.7. ka_replication.sh</a></span></dt><dt><span class="sect3"><a href="#id2522931">2.1.8. store_log.sh</a></span></dt><dt><span class="sect3"><a href="#id2522960">2.1.9. bootable_flag.sh</a></span></dt><dt><span class="sect3"><a href="#id2522972">2.1.10. make_initrd_grub</a></span></dt><dt><span class="sect3"><a href="#id2522996">2.1.11. make_initrd_lilo</a></span></dt><dt><span class="sect3"><a href="#id2523020">2.1.12. prepare_node.sh</a></span></dt><dt><span class="sect3"><a href="#id2523046">2.1.13. send_status.pl</a></span></dt><dt><span class="sect3"><a href="#id2523070">2.1.14. status_node.pl</a></span></dt></dl></dd></dl></dd><dt><span class="sect1"><a href="#id2523090">3. The golden node, KA server</a></span></dt><dt><span class="sect1"><a href="#id2523240">4. KA client node</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id2523246">4.1. PXE server (kamethod)</a></span></dt><dt><span class="sect2"><a href="#id2523284">4.2. Stage1 KA method, node waiting stage2 </a></span></dt><dt><span class="sect2"><a href="#id2523331">4.3. Stage2, the duplication process</a></span></dt><dt><span class="sect2"><a href="#id2523401">4.4. Prepare the node</a></span></dt><dt><span class="sect2"><a href="#id2523428">4.5. PXE server to local boot</a></span></dt></dl></dd><dt><span class="sect1"><a href="#id2523445">5. full log of a KA duplication</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id2523451">5.1. Golden node side</a></span></dt><dt><span class="sect2"><a href="#id2523463">5.2. KA client side</a></span></dt></dl></dd></dl></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id2446541"></a>1. Duplicate a computer over the network</h2></div></div></div><p> + 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, xfs, jfs). + </p><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2243707"></a>1.1. KA method</h3></div></div></div><p> + With KA method you can quickly duplicate a node using a <span class="bold"><strong>desc</strong></span> + 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. + </p><p> + Drawbacks: + </p><p> + </p><div class="itemizedlist"><ul type="disc"><li><p>KA method doesn't support RAID software</p></li><li><p>you can only clone Linux filesystems (if you want to duplicate another kinf of FS, it's up to you to modify the scripts)</p></li><li><p>you can only duplicate same kind of HDD (IDE or SCSI)</p></li></ul></div><p> + </p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2521938"></a>1.2. HOW it works</h3></div></div></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id2521943"></a>1.2.1. Steps</h4></div></div></div><p> + The clone process works in three steps + </p><div class="itemizedlist"><ul type="disc"><li><p><span class="bold"><strong>PXE boot to retrieve stage1</strong></span>: the computer boot on PXE mode, retrieve <span class="bold"><strong>vmlinuz</strong></span> and an <span class="bold"><strong>initrd</strong></span>. The computer is in <span class="bold"><strong>stage1</strong></span> mode, and is able to get the stage2 throug KA. Network is up.</p></li><li><p><span class="bold"><strong>get stage2</strong></span>: the computer gets the stage2 with KA method. The <span class="bold"><strong>stage2</strong></span> contains all necessary tools to recognize your hardware (the most important things is to detect your HDD), and all necessary tools to finalize the cloning process.</p></li><li><p><span class="bold"><strong>Duplication process</strong></span>: the computer auto-probes needed modules to be able to access to 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.</p></li></ul></div></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id2522328"></a>1.2.2. Needed files</h4></div></div></div><p> + All needed files are available on Mandriva Linux cooker. + </p><p> + </p><div class="itemizedlist"><ul type="disc"><li><p><span class="bold"><strong>install/stage2/rescue.sqhfs</strong></span>: 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.</p></li><li><p><span class="bold"><strong>isolinux/alt0/vmlinuz</strong></span>: linux kernel, needed in the <span class="bold"><strong>/var/lib/tftpboot/X86PC/linux/images/</strong></span> directory of the PXE server</p></li><li><p><span class="bold"><strong>isolinux/alt0/all.rdz</strong></span>: stage1 and all needed modules.</p></li></ul></div><p> + </p></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2522381"></a>1.3. Step 1: PXE, TFTP, DHCPD services</h3></div></div></div><p> + To easily clone a computer node, we use PXE technology to boot a <span class="bold"><strong>kernel</strong></span>, and an <span class="bold"><strong>initrd</strong></span> image wich contains all needed modules for network and media storage. Documentation about PXE can be found here: <a class="ulink" href="http://people.mandriva.com/~aginies/doc/pxe/" target="_top">PXE doc</a>. Please, keep in mind setting such services can <span class="bold"><strong>DISTURB</strong></span> your current network architecture. + </p><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id2522416"></a>1.3.1. PXE parameters on server</h4></div></div></div><p> + Mandriva Linux 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 (<span class="bold"><strong>/var/lib/tftpboot/X86PC/linux/pxelinux.cfg/default</strong></span>). + </p><p> + </p><pre class="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 rescue kamethod</pre><p> + </p><p> + At boot prompt no you can boot: + </p><p> + </p><div class="itemizedlist"><ul type="disc"><li><p><span class="bold"><strong>DEFAULT local</strong></span>: default boot will be local one, change it with the name of a <span class="bold"><strong>LABEL</strong></span></p></li><li><p><span class="bold"><strong>local</strong></span>: boot local</p></li><li><p><span class="bold"><strong>kamethod</strong></span>: automatic mode, get stage2 through <span class="bold"><strong>KA</strong></span>. Network interface is set to eth0. Auto setup the network with DHCP, and use the KA technology to launch the replication method.</p></li></ul></div><p> + </p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id2522497"></a>1.3.2. TFTP server</h4></div></div></div><p> + TFTP server should be activated in <span class="bold"><strong>/etc/xinetd.d/tftp</strong></span> file, and the <span class="bold"><strong>xinetd</strong></span> service started. + </p><p> + </p><pre class="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 +}</pre><p> + </p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id2522528"></a>1.3.3. PXE configuration</h4></div></div></div><p> +</p><pre class="programlisting"> +# 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,Mandrake Linux x86 +service=IA64PC,0,2,linux,Mandrake Linux IA64 +service=X86PC,0,0,local,Local boot + +# tftpd base dir +tftpdbase=/ + +# domain=guibland.com +domain= +</pre><p> + </p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id2522540"></a>1.3.4. DHCPD configuration</h4></div></div></div><p> + IE of an <span class="bold"><strong>/etc/dhcpd.conf</strong></span> configuration file. Change <span class="bold"><strong>IPADDR_TFTP</strong></span> with the IP address of the TFTP serrver, and the <span class="bold"><strong>NET</strong></span> value. Don't forget to adjust the <span class="bold"><strong>domain-name</strong></span> and the <span class="bold"><strong>domain-name-servers</strong></span>. + </p><p> + </p><pre class="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; + } +}</pre><p> + </p></div></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id2522692"></a>2. Setup a node as a golden node</h2></div></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2522697"></a>2.1. The rescue.sqfs file</h3></div></div></div><p> + You need the rescue disk (wich contains the <span class="bold"><strong>/ka</strong></span> directory), + and mount it loop in <span class="bold"><strong>/mnt/ka</strong></span>. + </p><p> + </p><pre class="screen"> +mkdir /mnt/ka +mount -o loop -t squashfs rescue.sqfs /mnt/ka</pre><p> + </p><p> + Go in the <span class="bold"><strong>/mnt/ka/ka</strong></span> directory, and see all new files available. All those files are needed + to do a <span class="bold"><strong>KA</strong></span> duplication process. We will explain now the rule of each of them. If you want + to modify the content of this rescue disk (add scripts...), mount it in a tempory directory, and copy the content + into the <span class="bold"><strong>/mnt/ka</strong></span> directory. + </p><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id2522749"></a>2.1.1. ka-d.sh</h4></div></div></div><p> + This is the master script to declare a node as a golden node. This script takes a lot of arguments. +</p><pre class="screen"> + -h, --help : display this message + -n num : specify the number of (destination) nodes + -x dir : exclude directory + -X sdb : 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'</pre><p> + </p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id2522775"></a>2.1.2. replication.conf</h4></div></div></div><p> + This file contain all variables needed by other scripts. It also tries to get information like IP address. + </p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id2522788"></a>2.1.3. fdisk_to_desc</h4></div></div></div><p> + This script generate the description table of the hard drive disk in the <span class="bold"><strong>/tmp/desc</strong></span> 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. + </p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id2522812"></a>2.1.4. gen_modprobe_conf.pl</h4></div></div></div><p> + This script create a basic output like the content of the<span class="bold"><strong>/etc/modprobe.conf</strong></span> file. Drawbacks + this file must be updated for each new modules available in the kernel (based on the <span class="bold"><strong>kernel/list_modules.pm</strong></span> file). + </p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id2522837"></a>2.1.5. ka-d-client</h4></div></div></div><p> + The <span class="bold"><strong>ka-d-client</strong></span> binary file is used to get stage2 with the <span class="bold"><strong>KA</strong></span> method, and after + get the whole system. The important argument is the <span class="bold"><strong>-s</strong></span> session name. A <span class="bold"><strong>KA</strong></span> + can only connect to a specific session (getstage2, kainstall ...). The code source is available in the ka-deploy-0.92 SRPM. + </p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id2522872"></a>2.1.6. ka-d-server</h4></div></div></div><p> + The <span class="bold"><strong>ka-d-server</strong></span> binary file is used to be a <span class="bold"><strong>KA</strong></span> golden node server. + Like the <span class="bold"><strong>ka-d-client</strong></span> the session arguments is an important parameter (<span class="bold"><strong>-s session_name</strong></span>). + The code source is available in the ka-deploy-0.92 SRPM. + </p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id2522906"></a>2.1.7. ka_replication.sh</h4></div></div></div><p> + Script launched on the <span class="bold"><strong>KA</strong></span> client (after getting stage2 and probing modules), to do the full process of the + <span class="bold"><strong>Ka</strong></span> duplication. + This script call other scripts to prepare the node (prepare_node.sh), configure the bootloader (make_initrd_grub or make_initrd_lilo). + </p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id2522931"></a>2.1.8. store_log.sh</h4></div></div></div><p> + Basic script to store the log of the <span class="bold"><strong>KA</strong></span> duplication process on an FTP server. Adjust to feet your need, and uncomment + the line <span class="bold"><strong>#store_log.sh</strong></span> in the <span class="bold"><strong>/mnt/ka/ka/ka_replication.sh</strong></span> file. + </p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id2522960"></a>2.1.9. bootable_flag.sh</h4></div></div></div><p> + Script to set bootable an HDD using fdisk. First arg must be the HDD device. + </p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id2522972"></a>2.1.10. make_initrd_grub</h4></div></div></div><p> + Restore and reload the Grub bootloader in the <span class="bold"><strong>/mnt/disk</strong></span> directory. It's a very basic script, and perhaps + use the <span class="bold"><strong>restore_bootloader</strong></span> of the Mandriva Linux Rescue should be a better idea. + </p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id2522996"></a>2.1.11. make_initrd_lilo</h4></div></div></div><p> + Restore and reload the lilo bootloader in the <span class="bold"><strong>/mnt/disk</strong></span> directory. Again it's a very basic script, perhaps we should use the + <span class="bold"><strong>restore_bootloader</strong></span> of the Mandriva Linux Rescue. + </p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id2523020"></a>2.1.12. prepare_node.sh</h4></div></div></div><p> + This script remove in the futur system the old network's udev rules, old dhcp cache files, launch the script <span class="bold"><strong>gen_modprobe_conf.pl</strong></span> to + regenerate an uptodate <span class="bold"><strong>/etc/modprobe.conf</strong></span> 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. + </p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id2523046"></a>2.1.13. send_status.pl</h4></div></div></div><p> + Very basic perl script to open the port 12345, and paste the content of the <span class="bold"><strong>/tmp/ka*</strong></span> file. It also + permit the execution of commands on node, if user send a message from the golden node with the <span class="bold"><strong>exec</strong></span> prefix. + </p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id2523070"></a>2.1.14. status_node.pl</h4></div></div></div><p> + 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 <span class="bold"><strong>exec</strong></span> prefix. + </p></div></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id2523090"></a>3. The golden node, KA server</h2></div></div></div><p> + Now, it is time to build a description of the node partitions. You can use the script + <span class="bold"><strong>/mnt/ka/ka/fdisk_to_desc</strong></span> as root user, or your favorite text editor, + you can write a file like this one: + </p><p> + </p><pre class="screen"> +linux 3500 +extended fill +logical swap 500 +logical linux fill</pre><p> + </p><p> + 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 <span class="bold"><strong>/</strong></span> partition, a 500 MB swap + partition, and <span class="bold"><strong>/var</strong></span> fills the rest, of course you can adjust + sizes accoding to your system. + </p><p> + Type the following to start the ka replication server as root user: + </p><p> +</p><pre class="programlisting"> + <screen> +[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. +</pre><p> + </p><p> + </p><div class="itemizedlist"><ul type="disc"><li><p><span class="bold"><strong>-r "grub --with=jfs --with=ata_piix"</strong></span>: use grub bootloader and <span class="bold"><strong>--with=jfs --with=piix</strong></span> mkinitrd option in the chrooted system after the <span class="bold"><strong>KA</strong></span> deploiement</p></li><li><p><span class="bold"><strong>-n nb_nodes</strong></span>: specify how many nodes are clients</p></li><li><p><span class="bold"><strong>-p sda/hda desc</strong></span>: specify if you want to duplicate SCSI or IDE storage, and the name of the hdd</p></li><li><p><span class="bold"><strong>-x /tmp</strong></span>: exclude <span class="bold"><strong>/tmp</strong></span> directory</p></li><li><p><span class="bold"><strong>-X sdb</strong></span>: exclude <span class="bold"><strong>sdb</strong></span> hdd for the duplication</p></li></ul></div><p> + </p><p> + Now the node is waiting for the rest of the nodes to start replication. + </p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id2523240"></a>4. KA client node</h2></div></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2523246"></a>4.1. PXE server (kamethod)</h3></div></div></div><p> + We have to configure the PXE to boot by default on <span class="bold"><strong>kamethod</strong></span>. + To do this just edit <span class="bold"><strong>/var/lib/tftpboot/X86PC/linux/pxelinux.cfg/default</strong></span> and set + <span class="bold"><strong>DEFAULT</strong></span> to kamethod: + </p><pre class="screen">DEFAULT kamethod</pre><p> + So, next time a node boots, the PXE server will force the + node to boot using the kamethod. + </p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2523284"></a>4.2. Stage1 KA method, node waiting stage2 </h3></div></div></div><p> + Now, you boot all remaining nodes. The replication process + will start once all nodes are up and waiting on the <span class="bold"><strong>KA</strong></span> + screen. + </p><p> + If the nodes can't reach the golden node, running the <span class="bold"><strong>KA</strong></span> + server the message <span class="bold"><strong>Can't reach a valid KA server</strong></span> will appear. + Each node will try five times to reach the <span class="bold"><strong>KA</strong></span> server, after that the node will reboot. + As the node boots on <span class="bold"><strong>kamethod</strong></span>, it will retry until it finds it. + </p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2523331"></a>4.3. Stage2, the duplication process</h3></div></div></div><p> + Once all the nodes have found the <span class="bold"><strong>KA</strong></span> server, the first + duplication process will start. This step duplicates the + <span class="bold"><strong>rescue_stage2</strong></span> from the <span class="bold"><strong>/mnt/ka</strong></span> directory + of the golden node, in the client's nodes memory (<span class="bold"><strong>/dev/ram3</strong></span>). Then, nodes chroot their + memories (the <span class="bold"><strong>/tmp/stage2</strong></span> directory), and launch the <span class="bold"><strong>drvinst</strong></span> command from the rescue disk, to probe all needed their modules (drivers). + Then, the second step of the duplication starts. + </p><p> + The duplication process will clone your drives following + the description you have made (<span class="bold"><strong>/tmp/desc</strong></span> of the golden node). + Nodes will rewrite their partition table, then format their filesystems (ReiserFs, XFS, + ext2/3, JFS). All new partitions will be mounted in the <span class="bold"><strong>/mnt/disk</strong></span> directory. + Then, the drive duplication process will begin. On a fast Ethernet switch you can reach speeds of 10MBytes/sec. + </p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2523401"></a>4.4. Prepare the node</h3></div></div></div><p> + At the end of the duplication process, each node will + chroot its partitions and rebuild its <span class="bold"><strong>/boot/initrd.img</strong></span>, + and <span class="bold"><strong>/etc/modprobe.conf</strong></span> 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. + </p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2523428"></a>4.5. PXE server to local boot</h3></div></div></div><p> + Don't forget to change the default PXE boot to <span class="bold"><strong>local</strong></span> + so node after replication will boot localy. + </p></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id2523445"></a>5. full log of a KA duplication</h2></div></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2523451"></a>5.1. Golden node side</h3></div></div></div><p> +</p><pre class="programlisting"> +[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. +got UDP packet from 10.0.1.35 +Session name matches +Sending UDP reply to 10.0.1.35 +Accepting connection from 10.0.1.35 +Clients : want_data 0 / connected 0 +client says hello ! +Client sends options +Client accepts data +Added client 10.0.1.35, daddy = 10.0.1.40 +Accepting connection from 10.0.1.35 +checking connection auth10.0.1.40 reports 10.0.1.35 has opened data connection +Client 10.0.1.35 reports data position : 0 +10.0.1.40 reports 10.0.1.35 has been accepted +Welcome son, you are number 1 (MAX 4) +Let's go! +Total data read = 45 Megs, BUF: 0M FREE = 34M startpos = 10M +End of data flow +Dropping children +Dropping child 10.0.1.35 +All children dropped +Client says dad disconnected +Client says he has finished +Client has finished transfer +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 = 48 Megs, in 2172 packets +Transfer time = 6.125 seconds, throughput = 7.881 Mbytes/second +The pipeline was emptied in 0.026 seconds + - Sending partition/filesystem/mount points informations... + +++ Running ka-deploy +++ +Compiled : Aug 23 2007 12:58:29 +ARGS=+ka-d-server+-s+kainstall1+-n+1+-e+(cd /tmp/ka-d6083 && tar c *)+ +Server IP = 10.0.1.40 +command = (cd /tmp/ka-d6083 && tar c *) +I want 1 clients +Socket 4 on port 30765 on node40.guibland.com ready. +Socket 5 on port 30764 on node40.guibland.com ready. +got UDP packet from 10.0.1.35 +Session name matches +Sending UDP reply to 10.0.1.35 +Accepting connection from 10.0.1.35 +Clients : want_data 0 / connected 0 +client says hello ! +Client sends options +Client accepts data +Added client 10.0.1.35, daddy = 10.0.1.40 +Accepting connection from 10.0.1.35 +checking connection auth10.0.1.40 reports 10.0.1.35 has opened data connection +Client 10.0.1.35 reports data position : 0 +10.0.1.40 reports 10.0.1.35 has been accepted +Welcome son, you are number 1 (MAX 4) +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.35 +All children dropped +Client says dad disconnected +Client says he has finished +Client has finished transfer +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 = 0 Megs, in 1 packets +Transfer time = 0.016 seconds, throughput = 0.628 Mbytes/second +The pipeline was emptied in 0.027 seconds + WAITING node (partition/format) + - Sending Linux filesystem... + +++ Running ka-deploy +++ +Compiled : Aug 23 2007 12:58:29 +ARGS=+ka-d-server+-s+kainstall2+-n+1+-e+(cd /; tar --create --one-file-system --sparse /)+ +Server IP = 10.0.1.40 +command = (cd /; 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. +got UDP packet from 10.0.1.35 +Session name matches +Sending UDP reply to 10.0.1.35 +Accepting connection from 10.0.1.35 +Clients : want_data 0 / connected 0 +client says hello ! +Client sends options +Client accepts data +Added client 10.0.1.35, daddy = 10.0.1.40 +Accepting connection from 10.0.1.35 +checking connection auth10.0.1.40 reports 10.0.1.35 has opened data connection +Client 10.0.1.35 reports data position : 0 +10.0.1.40 reports 10.0.1.35 has been accepted +Welcome son, you are number 1 (MAX 4) +Let's go! +Total data read = 621 Megs, BUF: 24M FREE = 10M startpos = 586M +End of data flow +Dropping children +Dropping child 10.0.1.35 +All children dropped +Client says dad disconnected +Client says he has finished +Client has finished transfer +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 = 627 Megs, in 34011 packets +Transfer time = 127.140 seconds, throughput = 4.937 Mbytes/second +The pipeline was emptied in 1.549 seconds +</pre><p> + </p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2523463"></a>5.2. KA client side</h3></div></div></div><p> + Just launch <span class="bold"><strong>/mnt/ka/ka/status_node.pl IPADD</strong></span> to get log of the KA client. + </p><pre class="programlisting"> +10.0.1.35> ------| Ka |---- Install starting... +10.0.1.35> Current session is -s kainstall1 +10.0.1.35> Receiving partitions information...OK +10.0.1.35> Cleaning hard drive... +10.0.1.35> ==> /tmp/kacmd <== +10.0.1.35> Starting log server.. +10.0.1.35> +10.0.1.35> ==> /tmp/ka_log-10.0.1.35-20071024-10h32 <== +10.0.1.35> OK +10.0.1.35> Device contains neither a valid DOS partition table, nor Sun, SGI or OSF disklabel +10.0.1.35> Building a new DOS disklabel with disk identifier 0x59be1427. +10.0.1.35> Changes will remain in memory only, until you decide to write them. +10.0.1.35> After that, of course, the previous content won't be recoverable. +10.0.1.35> +10.0.1.35> +10.0.1.35> The number of cylinders for this disk is set to 1116. +10.0.1.35> There is nothing wrong with that, but this is larger than 1024, +10.0.1.35> and could in certain setups cause problems with: +10.0.1.35> 1) software that runs at boot time (e.g., old versions of LILO) +10.0.1.35> 2) booting and partitioning software from other OSs +10.0.1.35> (e.g., DOS FDISK, OS/2 FDISK) +10.0.1.35> Warning: invalid flag 0x0000 of partition table 4 will be corrected by w(rite) +10.0.1.35> +10.0.1.35> Command (m for help): The partition table has been altered! +10.0.1.35> +10.0.1.35> Calling ioctl() to re-read partition table. +10.0.1.35> Syncing disks. +10.0.1.35> Writing partition table for sda using fdisk...OK +10.0.1.35> Formatting /dev/sda5 as ext3...OK +10.0.1.35> Formatting /dev/sda1 as swap...OK +10.0.1.35> - Mounting /dev/sda5 as /mnt/disk/ ......OK +10.0.1.35> ++++++++++++++++++++++++++ +10.0.1.35> rootfs on / type rootfs (rw) +10.0.1.35> /proc on /proc type proc (rw) +10.0.1.35> none on /sys type sysfs (rw) +10.0.1.35> none on /proc/bus/usb type usbfs (rw) +10.0.1.35> /dev/ram3 on /tmp/stage2 type ext2 (rw) +10.0.1.35> /dev/sda5 on /mnt/disk type ext3 (rw,data=ordered) +10.0.1.35> ++++++++++++++++++++++++++ +10.0.1.35> Linux copy is about to start +10.0.1.35> Server IP is 10.0.1.40 +10.0.1.35> Buffers names :pipe +Total data received = 620 Megs (11.222 Mbytes/sec); BUF :0M End of data flow +10.0.1.35> Flushing buffers +10.0.1.35> Total data received = 627 Megs, in 434960 packets +10.0.1.35> Elapsed time = 128.482 seconds, throughput = 4.886 Mbytes/second +10.0.1.35> Syncing disks...OK +10.0.1.35> Linux copy done. +10.0.1.35> Creating excluded directories +10.0.1.35> - bootloader is grub --with=jfs --with=ata_piix (user choice and options) +10.0.1.35> - Removing duplicated dhcp cache +10.0.1.35> - Writing modprobe.conf +10.0.1.35> ******************** +10.0.1.35> install scsi_hostadapter /sbin/modprobe aic7xxx; /sbin/modprobe ata_piix; /bin/true +10.0.1.35> alias eth0 eepro100 +10.0.1.35> alias eth1 eepro100 +10.0.1.35> ******************** +10.0.1.35> - Remove ude network rules +10.0.1.35> removed `/mnt/disk/etc/udev/rules.d/61-net_config.rules' +10.0.1.35> - Running mkinitrd +10.0.1.35> Looking for default grub menu +10.0.1.35> - erase old initrd.img link +10.0.1.35> removed `/mnt/disk/boot/initrd.img' +10.0.1.35> initrd will be : /boot/initrd-2.6.22.9-desktop-1mdv.img +10.0.1.35> running: chroot /mnt/disk /sbin/mkinitrd -v -f --with=jfs /boot/initrd-2.6.22.9-desktop-1mdv.img 2.6.22.9-desktop-1mdv +10.0.1.35> Looking for deps of module aic7xxx + 10.0.1.35> scsi_transport_spi scsi_mod +10.0.1.35> Looking for deps of module scsi_transport_spi + 10.0.1.35> scsi_mod +10.0.1.35> Looking for deps of module scsi_mod +10.0.1.35> skip dups +10.0.1.35> Looking for deps of module sd_mod + 10.0.1.35> scsi_mod +10.0.1.35> Looking for deps of module scsi_wait_scan + 10.0.1.35> scsi_mod +10.0.1.35> Looking for deps of module ext3 + 10.0.1.35> jbd +10.0.1.35> Looking for deps of module jbd +10.0.1.35> Looking for deps of module jfs +10.0.1.35> Using modules: /lib/modules/2.6.22.9-desktop-1mdv/kernel/drivers/scsi/scsi_mod.ko /lib/modules/2.6.22.9-desktop-1mdv/kernel/drivers/scsi/scsi_transport_spi.ko /lib/modules/2.6.22.9-desktop-1mdv/kernel/drivers/scsi/aic7xxx/aic7xxx.ko /lib/modules/2.6.22.9-desktop-1mdv/kernel/drivers/scsi/sd_mod.ko /lib/modules/2.6.22.9-desktop-1mdv/kernel/drivers/scsi/scsi_wait_scan.ko /lib/modules/2.6.22.9-desktop-1mdv/kernel/fs/jbd/jbd.ko /lib/modules/2.6.22.9-desktop-1mdv/kernel/fs/ext3/ext3.ko /lib/modules/2.6.22.9-desktop-1mdv/kernel/fs/jfs/jfs.ko +10.0.1.35> Using /tmp as temporary directory. +10.0.1.35> /sbin/nash -> /tmp/initrd.tG1408/bin/nash + 10.0.1.35> /lib/modules/2.6.22.9-desktop-1mdv/kernel/drivers/scsi/scsi_mod.ko.gz: 60.6% + 10.0.1.35> /lib/modules/2.6.22.9-desktop-1mdv/kernel/drivers/scsi/scsi_transport_spi.ko.gz: 63.1% + 10.0.1.35> /lib/modules/2.6.22.9-desktop-1mdv/kernel/drivers/scsi/aic7xxx/aic7xxx.ko.gz: 61.4% + 10.0.1.35> /lib/modules/2.6.22.9-desktop-1mdv/kernel/drivers/scsi/sd_mod.ko.gz: 60.2% + 10.0.1.35> /lib/modules/2.6.22.9-desktop-1mdv/kernel/drivers/scsi/scsi_wait_scan.ko.gz: 77.3% + 10.0.1.35> /lib/modules/2.6.22.9-desktop-1mdv/kernel/fs/jbd/jbd.ko.gz: 60.5% + 10.0.1.35> /lib/modules/2.6.22.9-desktop-1mdv/kernel/fs/ext3/ext3.ko.gz: 53.9% + 10.0.1.35> /lib/modules/2.6.22.9-desktop-1mdv/kernel/fs/jfs/jfs.ko.gz: 51.4% +10.0.1.35> Loading module scsi_mod.ko +10.0.1.35> Loading module scsi_transport_spi.ko +10.0.1.35> Loading module aic7xxx.ko +10.0.1.35> Loading module sd_mod.ko +10.0.1.35> Loading module scsi_wait_scan.ko +10.0.1.35> Loading module jbd.ko +10.0.1.35> Loading module ext3.ko +10.0.1.35> Loading module jfs.ko +10.0.1.35> /usr/sbin/resume -> /tmp/initrd.tG1408/bin +10.0.1.35> Contents of RCFILE: +10.0.1.35> #!/bin/nash +10.0.1.35> +10.0.1.35> echo "Loading scsi_mod.ko module" +10.0.1.35> insmod /lib/scsi_mod.ko +10.0.1.35> echo "Loading scsi_transport_spi.ko module" +10.0.1.35> insmod /lib/scsi_transport_spi.ko +10.0.1.35> echo "Loading aic7xxx.ko module" +10.0.1.35> insmod /lib/aic7xxx.ko +10.0.1.35> echo "Loading sd_mod.ko module" +10.0.1.35> insmod /lib/sd_mod.ko +10.0.1.35> echo "Loading scsi_wait_scan.ko module" +10.0.1.35> insmod /lib/scsi_wait_scan.ko +10.0.1.35> echo "Loading jbd.ko module" +10.0.1.35> insmod /lib/jbd.ko +10.0.1.35> echo "Loading ext3.ko module" +10.0.1.35> insmod /lib/ext3.ko +10.0.1.35> echo "Loading jfs.ko module" +10.0.1.35> insmod /lib/jfs.ko +10.0.1.35> echo Mounting /proc filesystem +10.0.1.35> mount -t proc /proc /proc +10.0.1.35> echo Mounting sysfs +10.0.1.35> mount -t sysfs none /sys +10.0.1.35> echo Creating device files +10.0.1.35> mountdev size=32M,mode=0755 +10.0.1.35> mkdevices /dev +10.0.1.35> echo Creating root device +10.0.1.35> mkrootdev /dev/root +10.0.1.35> resume +10.0.1.35> echo 1 > /sys/power/suspend2/do_resume +10.0.1.35> echo 1 > /sys/power/tuxonice/do_resume +10.0.1.35> echo Mounting root filesystem /dev/root with flags relatime +10.0.1.35> mount -o relatime --ro -t ext3 /dev/root /sysroot +10.0.1.35> echo Switching to new root +10.0.1.35> switchroot --movedev /sysroot +10.0.1.35> echo Initrd finished +10.0.1.35> First drive will be: /dev/sda +10.0.1.35> Installation finished. No error reported. +10.0.1.35> This is the contents of the device map /boot/grub/device.map. +10.0.1.35> Check if this is correct or not. If any of the lines is incorrect, +10.0.1.35> fix it and re-run the script `grub-install'. +10.0.1.35> +10.0.1.35> (hd0) /dev/sda +10.0.1.35> (hd1) /dev/sdb +10.0.1.35> umount: /mnt/disk/dev: not mounted +10.0.1.35> Umounting /dev/sda5...OK +10.0.1.35> AUTH not understood +10.0.1.35> Local directory now /tmp +exec lsmod +10.0.1.35> <console> +10.0.1.35> <console> +10.0.1.35> <console> exec lsmod +10.0.1.35> Module Size Used by +10.0.1.35> aic7xxx 167992 0 +10.0.1.35> scsi_transport_spi 22432 1 aic7xxx +10.0.1.35> ata_piix 12228 0 +10.0.1.35> libata 109424 1 ata_piix +10.0.1.35> sr_mod 15044 0 +10.0.1.35> sd_mod 25888 0 +10.0.1.35> scsi_mod 124908 5 aic7xxx,scsi_transport_spi,libata,sr_mod,sd_mod +10.0.1.35> loop 14212 0 +10.0.1.35> jfs 176708 0 +10.0.1.35> xfs 528088 0 +10.0.1.35> reiserfs 247908 0 +10.0.1.35> ext3 118824 0 +10.0.1.35> jbd 50184 1 ext3 +10.0.1.35> vfat 10816 0 +10.0.1.35> nls_iso8859_1 4672 0 +10.0.1.35> nls_cp437 6304 0 +10.0.1.35> fat 45980 1 vfat +10.0.1.35> isofs 31452 0 +10.0.1.35> piix 9060 0 [permanent] +10.0.1.35> ide_cd 35488 0 +10.0.1.35> ide_disk 14496 0 +10.0.1.35> ide_core 99396 3 piix,ide_cd,ide_disk +10.0.1.35> af_packet 17960 0 +10.0.1.35> eepro100 28432 0 +10.0.1.35> mii 5376 1 eepro100 +10.0.1.35> usbkbd 6304 0 +10.0.1.35> uhci_hcd 22736 0 +10.0.1.35> usbcore 113928 3 usbkbd,uhci_hcd +</pre></div></div></div></body></html> diff --git a/docs/ka_method/html/styleguibo.css b/docs/ka_method/html/styleguibo.css new file mode 100644 index 000000000..9d088cc93 --- /dev/null +++ b/docs/ka_method/html/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/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..f915b5059 --- /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.clp + + + 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.clp ########################################## + + - compressed loopback containing a iso9660 filesystem. + it is mostly the same as the mdv rescue.clp, *plus* partimage_whole_disk + (nb : use extract_compressed_fs/create_compressed_fs to expand/create rescue.clp) + + +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.clp + => generates part_save_all.iso and part_rest_all.iso diff --git a/docs/mdk-vs-redhat b/docs/mdk-vs-redhat new file mode 100644 index 000000000..4d0de8223 --- /dev/null +++ b/docs/mdk-vs-redhat @@ -0,0 +1,43 @@ ++ Open Development (at least DrakX) ++ UDMA66 (HPT366) ++ gamerz ++ number of packages ++ better packages(?) ++ no automatic handling of ide burners ++ urpmi/rpmdrake ++ XFdrake ++ no newbie install ++ reiserfs ++ fat resizing ++ 3D handling (eg: Voodoo3) ++ diskdrake (vs diskdruid) ++ usb storage (?) ++ KDE2 ++ faces in kdm/gdm ++ menu ++ alternatives ++ /etc/emacs/site-start.d ++ default config ++ i18n (bootloader keyboard) + ++ More user-friendliness in general: + + you can choose between multiple net devices when more than one are + detected + + you are presented with the media descriptions (disks, cdrom's) + when you must choose between multiple media, and not only "sda", + "hdc", .. + + when installing from a disk partition, you are presented with an + extract of the directory contents when you fail to give the + correct location, which is very helpful to correct the input + instead of simply rebooting to remember where on earth you + mirrored the distribution on your disks + ++ Automatic mode (Redhat's equivalent is called "kickstart") is not + performed according to a file on the floppy but from kernel parameters, + which have many pros, among them: (1) we don't need the vfat filesystem + for that purpose, and (2) with advanced bootloaders such as grub and + lilo you can edit parameters on the fly at boot time. + +- no LABEL= in fstab (for auto renumbering of devices) +- kerberos +- LDAP diff --git a/docs/net_object_class.fig b/docs/net_object_class.fig new file mode 100644 index 000000000..19f7f5318 --- /dev/null +++ b/docs/net_object_class.fig @@ -0,0 +1,73 @@ +#FIG 3.2 +Landscape +Center +Inches +Letter +100.00 +Single +-2 +1200 2 +1 1 0 1 0 7 50 0 -1 0.000 1 0.0000 4050 4162 675 338 4050 4162 4725 4500 +1 1 0 1 0 7 50 0 -1 0.000 1 0.0000 5700 3112 675 338 5700 3112 6375 3450 +1 1 0 1 0 7 50 0 -1 0.000 1 0.0000 7275 4087 675 338 7275 4087 7950 4425 +1 1 0 1 0 7 50 0 -1 0.000 1 0.0000 4800 1462 975 487 4800 1462 5775 1950 +1 1 0 1 0 7 50 0 -1 0.000 1 0.0000 2700 3112 675 338 2700 3112 3375 3450 +1 1 0 1 0 7 50 0 -1 0.000 1 0.0000 4875 5887 975 487 4875 5887 5850 6375 +1 1 0 1 0 7 50 0 -1 0.000 1 0.0000 9450 5062 675 338 9450 5062 10125 5400 +1 1 0 1 0 7 50 0 -1 0.000 1 0.0000 4654 4038 3900 3225 4654 4038 754 813 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 0 0 1.00 60.00 120.00 + 4125 1875 3225 2850 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 0 0 1.00 60.00 120.00 + 4575 1950 4200 3750 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 0 0 1.00 60.00 120.00 + 5250 1950 5475 2775 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 0 0 1.00 60.00 120.00 + 3000 3450 3600 3900 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 0 0 1.00 60.00 120.00 + 5925 3450 6675 3900 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 0 0 1.00 60.00 120.00 + 2700 3450 4050 5550 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 0 0 1.00 60.00 120.00 + 4125 4500 4575 5400 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 0 0 1.00 60.00 120.00 + 5625 3450 5025 5400 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 0 0 1.00 60.00 120.00 + 5775 1575 9450 4725 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 0 0 1.00 60.00 120.00 + 7800 4275 9000 4800 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 0 0 1.00 60.00 120.00 + 4800 1950 4800 5400 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 0 0 1.00 60.00 120.00 + 9000 975 9450 4725 +2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5 + 7500 75 10687 75 10687 975 7500 975 7500 75 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 0 0 1.00 60.00 120.00 + 7500 375 5400 1050 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 0 0 1.00 60.00 120.00 + 5550 1800 7200 3675 +4 0 0 50 0 0 12 0.0000 4 135 885 4350 1500 Netconnect\001 +4 0 0 50 0 0 12 0.0000 4 135 435 2475 3150 ISDN\001 +4 0 0 50 0 0 12 0.0000 4 135 720 3675 4200 MODEM\001 +4 0 0 50 0 0 12 0.0000 4 135 960 6825 4125 ETHERNET\001 +4 0 0 50 0 0 12 0.0000 4 135 480 5400 3150 ADSL\001 +4 0 0 50 0 0 12 0.0000 4 135 420 4650 5925 Tools\001 +4 0 0 50 0 0 12 0.0000 4 135 660 9150 5100 Network\001 +4 0 0 50 0 0 12 0.0000 4 135 1305 8400 375 Rest of the world\001 +4 0 0 50 0 0 12 0.0000 4 180 2595 7725 600 (draknet, printerdrake, tinyfirewall\001 +4 0 0 50 0 0 12 0.0000 4 180 2310 7725 825 ftp, http, net_monitor, drakgw)\001 +4 0 0 50 0 0 12 0.0000 4 195 2760 3525 6825 Global variables $in, $prefix, $install\001 +4 0 0 50 0 0 12 0.0000 4 180 2340 3525 7050 shared with the module globals\001 diff --git a/docs/object_class.fig b/docs/object_class.fig new file mode 100644 index 000000000..44fd3fe89 --- /dev/null +++ b/docs/object_class.fig @@ -0,0 +1,32 @@ +#FIG 3.2 +Landscape +Center +Inches +Letter +100.00 +Single +-2 +1200 2 +2 1 0 1 0 7 100 0 -1 0.000 0 0 -1 0 0 2 + 2625 1200 2625 1725 +2 1 0 1 0 7 100 0 -1 0.000 0 0 -1 0 0 2 + 7575 1125 7575 1650 +2 1 0 1 0 7 100 0 -1 0.000 0 0 -1 0 0 2 + 7575 2100 4350 3225 +2 1 0 1 0 7 100 0 -1 0.000 0 0 -1 0 0 2 + 5025 2025 4350 3225 +2 1 0 1 0 7 100 0 -1 0.000 0 0 -1 0 0 2 + 2625 2100 4350 3225 +2 1 0 1 0 7 100 0 -1 0.000 0 0 -1 0 0 2 + 5025 2025 6075 4125 +2 1 0 1 0 7 100 0 -1 0.000 0 0 -1 0 0 2 + 2625 1200 4950 1725 +2 1 0 1 0 7 100 0 -1 0.000 0 0 -1 0 0 2 + 7575 1125 4950 1725 +4 0 0 100 0 0 12 0.0000 4 180 1755 1800 1050 install_steps_gtk\001 +4 0 0 100 0 0 12 0.0000 4 180 1440 6900 975 install_steps_stdio\001 +4 0 0 100 0 0 12 0.0000 4 180 1140 2100 1950 interactive_gtk\001 +4 0 0 100 0 0 12 0.0000 4 180 1275 6900 1950 interactive_stdio\001 +4 0 0 100 0 0 12 0.0000 4 180 1875 4125 1950 install_steps_interactive\001 +4 0 0 100 0 0 12 0.0000 4 135 810 3975 3450 interactive\001 +4 0 0 100 0 0 12 0.0000 4 180 975 5625 4350 install_steps\001 diff --git a/docs/wizard.doc b/docs/wizard.doc new file mode 100644 index 000000000..0bbf8d254 --- /dev/null +++ b/docs/wizard.doc @@ -0,0 +1,31 @@ +How to handle wizard? + +to switch in wizard mode: +set $::isWizard to true; +if $::Wizard_no_previous is set to true, the wizard won't display the previous button. Usefull for first step +if $::Wizard_finished is set to true, the wizard will display Finish instead of Next. Usefull for last step + +how to code: +Code as if there were no wizard. +OK button is displayed as Next +Cancel is displayed as Previous +a additional button Cancel is added, xhich die with the exception 'wizard_cancelled' + +You have to handle the previous button. For example: + +step 1: +ask_from list( blablablabl) or return; +step2: +ask_from list( blablablabl) or goto step1; +step3: +ask_from list( blablablabl) or goto step2; + +etc... You don't have to handle the wizard Cancel button as it send an exception. + +Understood? If yes, you'll see that there is a pb with ask_yesorno. In this case, yes+next returns true, no+next returns false, Cancel send the exception 'wizard_canceled' and previous send the exception 'wizard previous'. So you have to handle the previous button manually. + +plop. + +dam's, pour vous servir + + |
