From 8de10ac9ca93e32f92383db57205105a882fbac4 Mon Sep 17 00:00:00 2001 From: Francois Pons Date: Thu, 26 Apr 2001 15:44:05 +0000 Subject: added some more comments for DrakX code source and usage. --- docs/README | 138 ++++++++++++++++++++++++++++++------------------------------ 1 file changed, 70 insertions(+), 68 deletions(-) (limited to 'docs/README') diff --git a/docs/README b/docs/README index 71b23c84d..c7ac25e43 100644 --- a/docs/README +++ b/docs/README @@ -1,5 +1,5 @@ Well here is a little description of what DrakX needs to work in comparison -to the standard newt install. +to the RH newt install. ******************************************************************************** * CVS ************************************************************************** @@ -33,7 +33,8 @@ just have to issue: % gendistrib --noclean --distrib -Where is the root of all the media that the install will see: +Where is the root of all the media that the install will see, this first +one is the main one : (1) network or 1-cdrom installs DIRS == the root directory of the Distribution @@ -41,10 +42,11 @@ Where is the root of all the media that the install will see: (2) multi-cdrom install DIRS == the root directories of all the media that the install will see -``gendistrib'' will scan, from the DIRS you provide, for some -Mandrake/RPMS* directories containing some RPM packages. For multi-cd, -please use Mandrake/RPMS, Mandrake/RPMS2, etc. For one CD or a network/hd -volume, please use Mandrake/RPMS. +``gendistrib'' will scan the file Mandrake/base/hdlists in the main root +directory (the first one in DIRS) to search for all media used. Typically you +use Mandrake/RPMS* for RPM packages repository. +For multi-cd, please use Mandrake/RPMS or Mandrake/RPMS1, Mandrake/RPMS2, etc. +For one CD or a network/hd volume, please use Mandrake/RPMS. Optionnally, you can modify ``Mandrake/base/rpmsrate''; this file manages the relative importance of the files, and thus their installation or not. @@ -58,38 +60,62 @@ See below for information about these files. First here are the different things needed : Mandrake/base/hdlists - description of the available install media + description of the available install media. + format is one line for one medium as + + should be match regexp /hdlist\S*.cz2?/ + for example (two cd install) you get + hdlist1.cz Mandrake/RPMS1 Boot CD + hdlist2.cz Mandrake/RPMS2 Extension CD Mandrake/base/hdlist*.cz table of rpm's headers, referred by ``hdlists'' - ! Need to be remade when Mandrake/RPMS changes (with ``gendistrib'') ! + their contents can be listed using ``packdrake -l '' or + or ``parsehdlist ''. + ! Need to be remade when Mandrake/RPMS* changes (with ``gendistrib'') ! -Mandrake/base/depslist +Mandrake/base/depslist.ordered for each packages, tell which package it depends on. Also contains the size for some (obscure) bloody reasons. - ! Need to be remade when Mandrake/RPMS changes ! - (with ``misc/gendepslist2 -o Mandrake/base/depslist Mandrake/base/hdlist.cz2'') - -Mandrake/base/depslist.ordered - more compact depslist with closure done, internally indexed + ! Need to be remade when Mandrake/RPMS* changes ! + (with ``gendistrib --noclean --distrib .'') Mandrake/base/compss obsoletes comps. It store packages in different categories, generated from the %{GROUP} field + ! Need to be remade when Mandrake/RPMS* changes ! + (with ``gendistrib --noclean --distrib .'') Mandrake/base/rpmsrate ranks and classify packages, so that the installer will know which - ones to install (see beginning of perl-install/pkgs.pm for more) + ones to install. format is : + + + where is a symbolic name used in Mandrake/base/compssUsers* files, + and defines importance level as described below : + 5 must have + 4 important + 3 very nice + 2 nice + 1 maybe + by default (for non expert), group selects packages for level 4 (important) + and 5 (must have). export mode add 3 (very nice) level. other level (below 2) + can only be selected using individual package selection. Mandrake/mdkinst live system used on certain installs. See ``Ramdisk or not'' below for more. -Mandrake/base/mdkinst_stage2.gz - for the ramdisk. live sytem in ext2 filesystem gzipped. +Mandrake/base/mdkinst_stage2.bz2 + for the ramdisk. live sytem in ext2 filesystem bzipped2. generated from Mandrake/mdkinst tree using misc/make_mdkinst_stage2 See ``Ramdisk or not'' below for more. +Mandrake/base/rescue_stage2.bz2 + rescue ramdisk. live sytem in ext2 filesystem bzipped2. + this is the ramdisk loaded when typing rescue on boot prompt. + there is no live system available, only the ramdisk is used. + images/*.img boot images to use with DrakX. Use: - cdrom for cdrom install @@ -97,17 +123,20 @@ images/*.img - hd for hard-disk install - pcmcia for pcmcia install (see ``PCMCIA install'' below for more) - the following modules have been removed from: + the following modules have been removed from: network.img: acenic sk98lin de4x5 cdrom.img and hd.img: BusLogic seagate fdomain g_NCR5380 dc395x_trm tmscsim hd.img: dpt_i2o eata eata_pio eata_dma cdrom.img: aztcd gscd isp16 mcd mcdx optcd cm206 sjcd pcmcia.img: apa1480_cb - they are now in "other.img", + they are now in "other.img", + + blank.img is a blank boot image without a kernel nor initrd. this image + can be used to generate custom boot disk. + + if you think one of those modules is used a lot, tell me, i may find some room + to put it back on the main floppies. - if you think one of those modules is used a lot, tell me, i may find some room - to put it back on the main floppies. - ******************************************************************************** * logs ************************************************************************* @@ -161,6 +190,7 @@ The DrakX install is much bigger than the newt one. So the ramdisk which was used is getting big, and costs a lot in memory (eg: the mdkinst_stage2 is 14MB - 23/09/99) (update! now size is 21MB - 24/01/01) +(update! now size is 19MB - 26/04/01) | | newt | DrakX |-------+---------+---------------------------------------------------------- @@ -225,42 +255,6 @@ On a test machine, make a network install, switch to console (ctrl-alt-F2), ente then, on another computer: % DISPLAY=test_machine:0 xwd -root | convert - screenshot.png -******************************************************************************** -* 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 {} - - ******************************************************************************** * Miscellaneous **************************************************************** ******************************************************************************** @@ -289,7 +283,7 @@ doesn't contain scsi modules nor ide. > o Text and Graphic mode installers > - Architectural overview of each -have a look at gi/install.fig +have a look at gi/docs/object_class.fig ******************************************************************************** @@ -304,26 +298,34 @@ have a look at gi/install.fig many solutions: -- make an install on drive hdb, then either - 1. dd if=/dev/hdb of=/dev/hdc - 2. dd if=/dev/hdb of=/dev/hdc count=1 ; kernel_reread /dev/hdc ; - mke2fs /dev/hdc1 ; mount /dev/hdb1 /source ; mount /dev/hdc1 /dest ; cp -a /source /dest +- make an install on drive hdb, then : + dd if=/dev/hdb of=/dev/hdc + but you should make sure the hardware is *REALLY* identical. - try the oem feature - 3. - burn a cd out of *latest* cooker + 3. - burn a cd out of *latest* cooker or 8.0 and above. - boot on it telling "oem" to syslinux - !! it will destroy every data on the harddrive !! + !! it will destroy every data on the harddrive or + resize (or use free space) if *ONLY* one fat partition is defined !! - you now have a very automated install matrix (duplicate it with "dd if=/dev/hdb of=/dev/hdc bs=1M count=730") put the harddrive in the oem box, the user will now have an *very* automated - install, just asking the root password and user password. + install, just asking the root password and user password, and some other + question according its hardware. + + 4. just like 3. but you may have to mount /cdrom after typing rescue on + syslinux prompt (oem script do it automatically if a automatic boot nfs + network has been done as server is known). under /cdrom may be anything + as long as it provides an installation tree of Linux-Mandrake. + after that run oem script by typing "/etc/oem -f" for normal installation + or "/etc/oem -f server" for server installation (normal with server installed). - 4. (just like 3. without burning a cd, doing the first part by hand) + 5. (just like 3. without burning a cd, doing the first part by hand) have a look at the /etc/oem script on the rescue and do it by hand... -cu Pixel. +cu Pixel, fpons. comments: -- cgit v1.2.1