home *** CD-ROM | disk | FTP | other *** search
/ Dream 46 / Amiga_Dream_46.iso / bo / disks-i386 / 1997-05-30 / dselect.beginner.8.txt < prev    next >
Text File  |  1997-06-03  |  16KB  |  378 lines
  1.  
  2. Dselect documentation for beginners.
  3.  
  4.    This file documents Dselect for first-time users and is intended to
  5.    help in getting Debian installed successfully. It makes no attempt to
  6.    explain everything, so when you first meet dselect work through the
  7.    help screens.
  8.    
  9.    Dselect is used to select just which [1]packages (from ~1100) you wish
  10.    to install. It will be run for you during the install and as it is a
  11.    very powerful and somewhat complex thing, some knowledge of it before
  12.    hand will not go astray. It will step you through the package
  13.    installation process as follows:
  14.    
  15.    Choose the access method to use.
  16.        Update list of available packages, if possible.
  17.        Request which packages you want on your system.
  18.        Install and upgrade wanted packages.
  19.        Configure any packages that are unconfigured.
  20.        Remove unwanted software.
  21.        
  22.    As each step is completed successfully it will lead you on to the
  23.    next. Go through them in order without skipping any steps.
  24.    
  25.    Here and there in this document we talk of starting another shell.
  26.    Linux has 6 console sessions or shells available at any one time. You
  27.    switch betwen them by hitting <LEFT-ALT> <F1> ... <F6>, after which
  28.    you log in on your new shell and go ahead. The shell used by the
  29.    install process is #1 so hit <LEFT-ALT> <F1>when you want to return to
  30.    that process.
  31.    
  32.    Once in dselect you will get this screen:-
  33.    
  34.     Debian Linux `dselect' package handling front end.
  35.     
  36. 0.  [A]ccess  Choose the access method to use.
  37. 1.  [U]pdate  Update list of available packages, if possible.
  38. 2   [S]elect  Request which packages you want on your system.
  39. 3.  [I]nstall Install and upgrade wanted packages.
  40. 4.  [C]onfig  Configure any packages that are unconfigured.
  41. 5.  [R]emove  Remove unwanted software.
  42. 6.  [Q]uit    Quit dselect.
  43.  Let's look at these one by one.
  44.   _____________________________________________________________________________
  45.   
  46.   0 Access:
  47.   
  48.    Here's the access screen:
  49.    
  50.     dselect - list of access methods
  51.     
  52. Abbrev.   Description
  53. cdrom     Install from a CD-ROM.
  54. nfs       Install from an NFS server (not yet mounted).
  55. harddisk  Install from a hard disk partition (not yet mounted).
  56. mounted   Install from a filesystem which is already mounted.
  57. floppy    Install from a pile of floppy disks.
  58. ftp       Install using ftp.
  59.  
  60.    Here we tell dselect where our packages are. Note that the first three
  61.    items are just a convenience and it would be just as good if you
  62.    mounted your cdrom, nfs mount or other partition yourself and then
  63.    used the _mounted_ option. It follows that if your cdrom _is_ already
  64.    mounted then you use the _mounted_ item, rather than the cdrom item.
  65.    The same thing goes for nfs and for partitions on your harddisk.
  66.    
  67.    If you run into a problem here - maybe Linux can not see your cdrom,
  68.    your nfs mount is not working or you have forgotten which partition
  69.    the packages are on - you have a couple of options:-
  70.    
  71.      Start another shell. Fix the problem and then return to the main
  72.    shell.
  73.    
  74.      Quit dselect and run it again later. You might even need to shut
  75.    down the computer to solve some problem. This is quite ok but when you
  76.    come back to dselect run it as root. It will not be run automatically
  77.    after the first time.
  78.    
  79.    After you choose the access method dselect will get you to indicate
  80.    the precise location of the packages. If you do not get this right the
  81.    first time hit ^C and return to the Access item.
  82.    
  83.    Once you are through here you will be returned to the main screen.
  84.    ______________________________________________________________________
  85.    
  86.   1 Update
  87.   
  88.    Dselect will read the Packages or Packages.gz files from the mirror
  89.    and create a database on your system of all available packages.
  90.    ______________________________________________________________________
  91.    
  92.   2 Select
  93.   
  94.    Hang on to your hat. This is where it all happens. The object of the
  95.    excercise is to select just which packages you wish to have installed.
  96.    
  97.    Hit <Enter>. If you have a slow machine be aware that the screen will
  98.    clear and can remain blank for 15 seconds so don't start bashing keys
  99.    at this point.
  100.    
  101.    The first thing that comes up on the screen is page 1 of the Help
  102.    file. You can get to this help by hitting ? at any point in the Select
  103.    screens and you can page through the help screens by hitting the .
  104.    (full stop) key.
  105.    
  106.    Before you dive in note these points:
  107.    
  108.      To exit the Select screen after all selections are complete, hit
  109.    <Enter>. This will return you to the main screen if there is no
  110.    problem with your selection. Else you will be asked to deal with that
  111.    problem. When you are happy with any given screen hit <Enter> to get
  112.    out.
  113.    
  114.      _Problems_ are quite normal and are to be expected. If you select
  115.    package A and that package requires package B to run, then dselect
  116.    will warn you of the problem and will most likely suggest a solution.
  117.    If package A conflicts with package B (they are mutually exclusive)
  118.    you will be asked to decide between them.
  119.    
  120.    Let's look at the top two lines of the Select screen.
  121.    
  122. dselect - recursive package listing               mark:+/=/- verbose:v help:?
  123. EIOM Pri Section Package Description 
  124.  
  125.    This tells us of some of the special keys:-
  126.    
  127. +      Select a package for installation.
  128. =      Place a package on hold - useful on a broken package. You can reinstall
  129. an older
  130.          version and place it on hold while you wait for a new one to appear.
  131. -      Remove a package
  132. _      Remove a package and its config files.
  133. i,I    Toggle/cycle info displays.
  134. o,O    Cycle through the sort options.
  135. v,V    Is a terse/verbose toggle. Use this key to unlock the meanings of EIOM o
  136. n line two,
  137.        but I'll give you a summary here anyway. (Note that upper and lower case
  138.  keys are
  139.        quite different in effect.)
  140.  
  141. Flag   Meaning           Possible values
  142. E      Error             Space, R, I
  143. I      Installed state   Space, *, -, U, C, I
  144. O      Old mark          *, -, =, _, n
  145. M      Mark              *, -, =, _, n
  146.  
  147.    Rather that spell all this out here I refer you to the Help screens
  148.    where all is revealed. One example though.
  149.    You enter dselect and find a line like this:-
  150.    
  151. EIOM Pri  Section  Package   Description
  152.   ** Opt  misc     loadlin   a loader (running under DOS) for LINUX kernel
  153.  
  154.    This is saying that loadlin was selected when you last ran dselect and
  155.    that it is still selected, but it is not installed. Why not? The
  156.    answer must be that the loadlin package is not physically avaiable. It
  157.    is missing from your mirror.
  158.    
  159.    The information which dselect uses to get all the right packages
  160.    installed is buried in the packages themselves. Nothing in this world
  161.    is perfect and it does sometimes happen that the dependancies built
  162.    into a package are incorrect, with the result that dselect simply
  163.    cannot resolve the situation. A way out is provided where the user can
  164.    regain control and it takes the form of the commands Q and X which are
  165.    available in the Select screen.
  166.    
  167. Q   An over-ride. Forces dselect to ignore the built in dependancies and to do
  168. what you have
  169.       specified. The results, of course, will be on your own head.
  170. X   Use X if you get totally lost. It puts things back the way they were and ex
  171. its.
  172.  
  173.    Keys which help you _not_ to get lost (!) are R, U and D.
  174.    
  175. R   Cancels all selections at this level. Does not affect selections made
  176.       at the previous level.
  177. U   If dselect has proposed changes and you have made further changes U will
  178.       restore dselect's selections.
  179. D   Removes the selections made by dselect, leaving only yours.
  180.  
  181.    An example: 
  182.    
  183.    The boot-floppies package depends on these packages:-
  184.    libc5-pic
  185.    ncurses3.0-pic
  186.    mkrboot
  187.    ncurses3.0-dev
  188.    
  189.    The person maintaining boot-floppies also thinks that the following
  190.    packages should be installed. These are not, however, essential:-
  191.    
  192. loadlin
  193. fdos
  194. dosemu
  195.  
  196. So when I select boot-floppies I get this screen:
  197.  
  198. dselect - recursive package listing mark:             +/=/- verbose:v help:?
  199. EIOM Pri Section Package Description
  200.  
  201.   _* Opt devel boot-floppie Scripts to create the Debian installationfloppy
  202.   _* Xtt devel libc5-pic Kit for building specialized versions of the sha
  203.   _* Xtr devel ncurses3.0-p Video termial manipulation: Shared-library subs
  204.   _* Opt devel mkrboot Make a kernel + rootimage bootable from one disk
  205.   _* Opt devel ncurses3.0-d Video terminal manipulation: Developer's librari
  206.   _* Opt misc loadlin a loader (running under DOS) for LINUX kernel i
  207.   _* Opt misc fdos Free DOS (Kernel + boot utilities + Documentatio
  208.   __ Opt misc dosemu The Linux DOS Emulator
  209. See how all the required packages have been selected for me.
  210.  
  211.    The R key puts things back to the starting point.
  212.    
  213. dselect - recursive package listing mark:             +/=/- verbose:v help:?
  214. EIOM Pri Section Package Description
  215.   __ Opt devel boot-floppie Scripts to create the Debian installationfloppy
  216.   __ Xtt devel libc5-pic Kit for building specialized versions of the sha
  217.   __ Xtr devel ncurses3.0-p Video termial manipulation: Shared-library subs
  218.   __ Opt devel mkrboot Make a kernel + rootimage bootable from one disk
  219.   __ Opt devel ncurses3.0-d Video terminal manipulation: Developer's librari
  220.   __ Opt misc loadlin a loader (running under DOS) for LINUX kernel i
  221.   __ Opt misc fdos Free DOS (Kernel + boot utilities + Documentatio
  222.   __ Opt misc dosemu The Linux DOS Emulator
  223.  
  224.    (If I decide now that I don't want boot-floppies I just hit <Enter>.)
  225.    
  226.    The D key puts things the way I selected them in the first place.
  227.    
  228. dselect - recursive package listing mark:             +/=/- verbose:v help:?
  229. EIOM Pri Section Package Description
  230.   _* Opt devel boot-floppie Scripts to create the Debian installation floppy
  231.   __ Xtt devel libc5-pic Kit for building specialized versions of the sha
  232.   __ Xtr devel ncurses3.0-p Video termial manipulation: Shared-library subs
  233.   __ Opt devel mkrboot Make a kernel + rootimage bootable from one disk
  234.   __ Opt devel ncurses3.0-d Video terminal manipulation: Developer's librari
  235.   __ Opt misc loadlin a loader (running under DOS) for LINUX kernel
  236.   __ Opt misc fdos Free DOS (Kernel + boot utilities + Documentatio
  237.   __ Opt misc dosemu The Linux DOS Emulator
  238.  
  239.    The U key restores dselect's selections.
  240.    
  241. dselect - recursive package listing mark:            +/=/- verbose:v help:?
  242. EIOM Pri Section Package Description
  243.   _* Opt devel boot-floppie Scripts to create the Debian installation floppy
  244.   _* Xtt devel libc5-pic Kit for building specialized versions of the sha
  245.   _* Xtr devel ncurses3.0-p Video termial manipulation: Shared-library subs
  246.   _* Opt devel mkrboot Make a kernel + rootimage bootable from one disk
  247.   _* Opt devel ncurses3.0-d Video terminal manipulation: Developer's librari
  248.   _* Opt misc loadlin a loader (running under DOS) for LINUX kernel i
  249.   _* Opt misc fdos Free DOS (Kernel + boot utilities + Documentatio
  250.   __ Opt misc dosemu The Linux DOS Emulator
  251.  
  252.    I suggest running with the defaults for now - you will have ample
  253.    opportunity of adding more later. A possible exception which you may
  254.    choose to deselect depending on your experience is:-
  255.    
  256. emacs (very big, not everyone wants it)
  257.  
  258.    And I would suggest not installing:
  259.    
  260. inn   (big, difficult to get going)
  261. x11   (big, difficult to get going)
  262.  
  263.    Whatever you decide, hit <Enter> to accept and return to the main
  264.    screen. If this results in unresolved problems you will be bounced
  265.    right back to another problem resolution screen.
  266.    
  267.    So the R, U and D keys are very useful in what_if situations. You can
  268.    experiment at will and then restore everything and start again. Don't
  269.    look on them as being in a glass box labelled Break In Emergency. 
  270.    
  271.    After making your selections in the Select screen, hit I to give you a
  272.    big window, t to take you to the beginning and then use the page-down
  273.    key to look quickly through the settings. This way you can check the
  274.    results of your work and spot glaring errors. Some people have
  275.    dselected whole groups of packages by mistake and not noticed the
  276.    error until too late. Dselect is a _very_ powerful tool so don't
  277.    misuse it.
  278.    
  279.    You should now have this situation:-
  280.    
  281. package category     status
  282.  
  283. required             all selected
  284. important            all selected
  285. standard             mostly selected
  286. optional             mostly dselected
  287. extra                mostly dselected
  288.  
  289.    Happy? Hit <Enter> to exit the Select process. You can come back and
  290.    run Select again if you wish.
  291.   _____________________________________________________________________________
  292.   
  293.   3 Install
  294.   
  295.    Dselect runs through the entire 1100 packages and installs those
  296.    selected. Expect to get asked to make decisions as you go. It is often
  297.    useful to switch to a different shell to compare, say, an old config
  298.    with a new one. If the old file is conf.modules the new one will be
  299.    conf.modules.dpkg-new.
  300.    
  301.    The screen scrolls past fairly quickly on a new machine. You can
  302.    stop/start it with ^S/^Q and at the end of the run you will get a list
  303.    of any uninstalled packages. If you want to keep a record of
  304.    everything that happens use normal Unix features like tee or script.
  305.    
  306.    It can happen that a package does not get installed because it depends
  307.    on some other package which is listed for installation but is not yet
  308.    installed. The answer here is to run Install again. Cases have been
  309.    reported where it was necessary to run it 4 times before everything
  310.    slipped into place.
  311.   _____________________________________________________________________________
  312.   
  313.   4 Configure
  314.   
  315.    Most packages get configured in step 3, but anything left hanging can
  316.    be configured here.
  317.   _____________________________________________________________________________
  318.   
  319.   5 Remove
  320.   
  321.    Removes packages that are installed but no longer required.
  322.   _____________________________________________________________________________
  323.   
  324.   6 Quit
  325.   
  326.    I suggest running /etc/cron.daily/find at this point as you have a lot
  327.    of new files on your system. Then you can use locate to get the
  328.    location of any given file.
  329.     ___________________________________________________________________________
  330.     
  331.     A few hints in conclusion.
  332.     
  333.    When the install process runs dselect for you, you will doubtless be
  334.    eager to get Debian running ASAP. Well, please be prepared to take an
  335.    hour or so as you have to learn your way around and then get it right.
  336.    When you enter the Select screen for the first time don't make ANY
  337.    selections at all - just hit <Enter> and see what dependancy problems
  338.    there are. Try fixing them. If you find yourself back at the main
  339.    screen run Select again.
  340.    
  341.    You can get an idea of the size of a package by hitting i twice and
  342.    looking for the Size figure. This is the size of the crunched package,
  343.    so the uncrunched files will be a lot bigger.
  344.    
  345.    Installing a new Debian system is a very complex thing, but dselect
  346.    can do it for you as easily as can be. So take the time to learn how
  347.    to drive it. Read the help screens and experiment with i, I, o, and O.
  348.    Use the R key. It's all there, but it's up to you to use it
  349.    effectively.
  350.    ______________________________________________________________________
  351.    
  352.    Glossary:
  353.    
  354.    Package
  355.    A file which contains everything needed to install, de-install and run
  356.    a particular program.
  357.    
  358.    The program which handles packages is dpkg. Dselect is a front end to
  359.    dpkg. Experienced users often use dpkg to install or remove a package.
  360.    
  361.    Package names
  362.    All package names have the form xxxxxxxxxxx.deb
  363.    
  364.    Sample package names are:
  365.    efax_08a-1.deb
  366.    lrzsz_0.12b-1.deb
  367.    mgetty_0.99.2-6.deb
  368.    minicom_1.75-1.deb
  369.    term_2.3.5-5.deb
  370.    uucp_1.06.1-2.deb
  371.    uutraf_1.1-1.deb
  372.    xringd_1.10-2.deb
  373.    xtel_3.1-2.deb
  374.  
  375. References
  376.  
  377.    1. file://localhost/home/sr1/src/boot-floppies/boot-floppies-1.2.19/documentation/dselect.beginner.8.html#Package
  378.