home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Exec 3 / CD_Magazyn_EXEC_nr_3.iso / Linux / Debian / install / amiga / install.doc < prev    next >
Text File  |  2000-07-02  |  23KB  |  442 lines
  1.  
  2.  
  3.     Debian/m68k GNU/Linux - Short Amiga installation instructions (v0.3)
  4.    ---------------------------------------------------------------------
  5.  
  6.       Short Debian/m68k installation instructions for Amiga;
  7.       to be replaced soon by a _slightly_ longer version :-)
  8.  
  9.               Frank Neumann, July 20th, 1998
  10.  
  11.    Updated for Debian 2.1 Jan 29 1999 Michael Schmitz, Christian Steigies
  12.    Updated for Debian 2.2 Jun 07 2000 Christian Steigies (using parts of 
  13.    the VME installation instructions by Nick Holgate)
  14.    Merged in updates for Debian 2.2 19.06.2000 by Marcin Juszkiewicz  
  15.  
  16. Many thanks to Massimo Tantignone for the help with the Amiga icons.
  17.  
  18. A hopefully always up-to-date version of this document should be online at:
  19.      http://www.informatik.uni-oldenburg.de/~amigo/debian_inst.html
  20. (or on any debian mirror in  
  21.  debian/dists/unstable/main/disks-m68k/potato/amiga/install.doc)
  22.  
  23.  
  24. Ok, so you think you want to try Debian, dive into the wonderful world 
  25. of free software and world-wide programming collaboration? Fine. Your
  26. first test will be to install the Debian base system on your Amiga, and I
  27. hope this document will help you in getting that step done.
  28.  
  29. So, without any further ado, these are the absolutely vital steps you need 
  30. to take:
  31.  
  32. 0) Before even thinking of starting to install Debian on your Amiga, you
  33.    should make a BACKUP of your current system. It's not like Debian will
  34.    erase all data on your harddisks immediately when it starts up, but you
  35.    can damage a lot easily if you are new to Linux or Unix in general.
  36.    If you have a DAT, MO or spare harddisk, this is the chance to use them
  37.    for creating a backup.
  38.  
  39. 0b) Check out if your system is suited for Linux/m68k - please read the
  40.     Linux/m68k FAQ, available e.g. at http://www.linux-m68k.org/.
  41.  
  42. 1) Get all required files from one of Debian's FTP sites,
  43.    like ftp.debian.org, ftp.de.debian.org etc. A list of mirror sites
  44.    can be found at http://www.debian.org/distrib/ftplist
  45.    
  46.    No matter what mirror site you use, the path should always be:
  47.    /pub/debian/dists/potato/main/disks-m68k/current
  48.  
  49.    These are the files you need:
  50.    - amigainstall.tgz
  51.    - base2_2.tgz
  52.    (note: we don't officially distribute amigainstall.lha anymore for several
  53.     reasons. With a little luck you might find an amigainstall.lha file, which
  54.     contains the amiga subdirectory and amiga.info at:
  55.     www.debian.org/~cts/debian-m68k/potato/amigainstall.lha)
  56.  
  57.    Alternatively, get the official Debian/68k 2.2 CD set. All required files
  58.    are in /install/
  59.  
  60. 2) Create a subdirectory named "debian" and unpack the amigainstall.tgz file
  61.    to your harddisk (a subdirectory named "amiga" will be automatically
  62.    created for you). I recommend to unpack the archive directly onto the
  63.    created directory of a partition that has at least ~ 25 MB of free
  64.    space. Move the base2_2.tgz file into this same directory ("debian").
  65.    _Don't_ rename any files in that directory.
  66.    When installing from CD, you can use the files in /install/amiga/
  67.    directly. 
  68.  
  69. 3) Partition your harddisk (or rather prepare partitions for Linux) :
  70.    There is a partitioning tool for Linux/m68k called amiga-fdisk, which you
  71.    can use during the installation (see below for short instructions), but
  72.    you can do the partitioning under AmigaOS using the good old HDToolBox
  73.    program.
  74.  
  75.    You should have reserved at least two partitions for Linux: One for the
  76.    "root filesystem" and one for a "swap partition". The size recommendations
  77.    are:
  78.    - for the root partition:
  79.        * absolute minimum should be 42 MB (this is just enough to install
  80.      the base system, and nothing else - probably enough for testing
  81.      it, but not for really using it)
  82.        * a reasonable system starts at around 200 - 400 MB, no limits upwards.
  83.    - for the swap partition: about twice as large as your main memory, but
  84.      rather more than that. Especially on systems with little main memory
  85.      (like 8 MB RAM), don't go below 20 MB swap space. 
  86.      
  87.    Naming conventions: This is important because under Linux your
  88.    partitions have different names than under AmigaOS. This is the
  89.    naming scheme:
  90.    - The first SCSI harddisk (address-wise) is named "sda".
  91.    - The second SCSI harddisk (address-wise) is named "sdb", and so on.
  92.    - The first IDE harddisk is named "hda", the second IDE harddisk
  93.      is named "hdb", and so on.
  94.  
  95.    The partitions on each harddisk are represented by appending a single
  96.    digit to the harddisk name: sda1, sda2, sda3 represent for first, second
  97.    and third partition of the first SCSI harddisk in your system.
  98.  
  99.    Here is a real-life example: Let's assume you have a system with 2 SCSI
  100.    harddisks, one at SCSI address 2 and the other at SCSI address 4.
  101.    The first disk is then named "sda", and the second "sdb". 
  102.    If the "sda" harddisk has 5 partitions on it, these will be named
  103.    "sda1", "sda2", ..., "sda5". Analogous for the "sdb" harddisk and its
  104.    partitions.
  105.    
  106.    So, now that we know the partition names, you can actually change their
  107.    type from within HDToolBox so that the Linux installation program can
  108.    detect them easily:
  109.  
  110.    Start HDToolBox, select the disk you want to use, click on the "Partition
  111.    Drive" button and select/create the partition you want to use as the
  112.    Debian root filesystem.
  113.    Now you need to enable the "Advanced options" and change the following
  114.    items under "Change":
  115.  
  116.    Set the filesystem to "Custom Filesystem" or "Reserved Filesystem" (it
  117.    depends on your HDToolBox version what you get shown here), set the
  118.    identifier to "0x4c4e5800" (this is the hexadecimal equivalent of "LNX\0"),
  119.    disable the "Auto-mount this partition" checkbox, disable "Custom Bootcode",
  120.    set the "Reserved blocks at" settings to: "2" for start and "0" for end.
  121.  
  122.    After having done this, select a partition that is to be used as a swap
  123.    partition, and repeat the same steps as above, but set the identifier
  124.    to "0x53575000" instead (this represents "SWP\0" in ASCII).
  125.  
  126.    Please note:
  127.    - Your root and swap partitions do not need to be on the same harddisk.
  128.    - You can have more than one partition for files besides the root
  129.      filesystem - this even makes sense very often, like when separating the
  130.      user's home directories from the system file area. If you want to use
  131.      more partitions, prepare them just like the root partition.
  132.      If you're just going to try Linux for a short time, it's enough to
  133.      just have a single file partition.
  134.    - You can also have more than one swap partition, though that's not seen
  135.      very often.
  136.    - Write down the partition names (you know, the "sda1" etc. stuff) of
  137.      all partitions that you are going to use for Linux.
  138.    - At this point, please also write down the partition name (Linux-wise)
  139.      of the partition on which you have unpacked the "amigainstall.tgz"
  140.      archive. You will need this later for installation of the base system.
  141.  
  142.    When you have made all required changes, go back to the main window of
  143.    HDToolBox and "Save Changes to drive". Think twice before actually
  144.    clicking on "Yes" - have you chosen the correctly partitions? No
  145.    viable data that could get lost now? Then click OK.
  146.    If required, the Amiga will reboot after this.
  147.  
  148.    Short instructions for partitioning under Linux with amiga-fdisk:
  149.    amiga-fdisk /dev/hda (or /dev/sda or ...)
  150.    type "m" for a short help
  151.    p to print the partition table
  152.    t to change the partition type
  153.    select the partition number (1, 2, 3, ...)
  154.    type the partition number which belongs to the type you want to have for
  155.    the partition you selected, i.e. 11 for LNX (Linux ext2 partitions)
  156.    or 12 for SWP (Linux swap partition)
  157.    after you have done all changes and all looks ok, press w to write the
  158.    changes to disk. Nothing is changed on your disk (and nothing is lost, if
  159.    you chose a wrong partition or partition type) until you "w"rite to disk.
  160.    press "q" if you want to quit without making any changes.
  161.  
  162. 5) When you're back at your Workbench, start the Linux installation process
  163.    by double-clicking on the "StartInstall" icon in the "debian" directory.
  164.  
  165.    You will have to press the <Return> key twice after the bootstrap program
  166.    has output some debugging information into a window.
  167.    After this, the screen will go grey, a few seconds of delay, and after
  168.    that a black screen with white text should come up, displaying all kinds
  169.    of kernel debugging information. These scroll by far too fast for you to
  170.    read, but that's not important right now.
  171.    After a couple of seconds, the installation program should start
  172.    automatically.
  173.    If you get up to this point, you can be quite confident that you will be
  174.    able to install Linux on your system. 
  175.  
  176.    NOTE if you want to use a graphics board with linux, you have to tell the
  177.    kernel about the board. If you don't tell the kernel, it will use standard
  178.    amiga graphics for output (OCS, ECS, AGA) which you might not notice if you
  179.    have your only monitor connected to your graphics board.
  180.  
  181.    To make your life easier, we have prepared a few scripts for boards which
  182.    are supported. Just doubleclick the relevant StartInstall to start the
  183.    install process, i.e.
  184.  
  185.    - StartInstall_clgen if you have a EGS Spectrum, Piccolo or Picasso board
  186.    - StartInstall_CV64  if you have a CyberVision64 board,
  187.    - StartInstall_CV3D  if you have a CyberVision/3D board,
  188.    - StartInstall_retz3 if you have a RetinaZ3 board.
  189.  
  190.    The scripts are using a resolution of 640x480 in 8 bit. Probably you want
  191.    to use higher resolutions after the system has been set up, but for now
  192.    please leave it at this resolution. For the CyberVision 3D board you _have_
  193.    to select a 640x480 screenmode in 8 bit, otherwise you will have a more or
  194.    less distorted screen. I was told the CyberVision64 always uses this mode, 
  195.    you can change it only later under linux with fbset.
  196.  
  197.    For further info, esp. if you want to use higher resolutions in your
  198.    linuxgo file, please read the relevant docs for your board (clgen.txt,
  199.    cv64.txt, cv3d.txt) which were taken from the kernel source or from the
  200.    linux-m68k mailing list. See ocs_ecs_aga.txt if you don't have a graphics
  201.    board and have problems with your video mode.
  202.  
  203. 6) So, now we're getting somewhere. The Debian installation program will
  204.    lead you through the steps of preparing the partitions from the Linux
  205.    side, unpacking and configuring the kernel modules and base system,
  206.    and finally rebooting. Some of the presented steps are not really necessary
  207.    on m68k platforms, and I'll tell you what you have to do at each step now.
  208.    
  209.    - Release notes
  210.      This is just a screen with a few informations about Debian's goals,
  211.      who built the rescue set etc.
  212.  
  213.    Now we come to the main installation screen which lists all possible
  214.    actions you can take, with the next logical step always being highlit
  215.    at the top of the list. I recommend to strictly follow the suggested
  216.    way.
  217.  
  218.    - Configure the keyboard
  219.      Depending on whether you have a U.S. or other keyboard, select the
  220.      one appropriate for you with the cursor keys and <Space>, then move
  221.      with <Tab> to the OK button and press <Return>.
  222.  
  223.    - Partition a hard disk
  224.      If you have not done so under AmigaOS, you can now partition your
  225.      harddisk(s) and select some of them to use them as Linux ext2 and swap
  226.      partitions. As described above, you need at least one partition for
  227.      the root file system (minimum 42 MB). Unless you have a lot of RAM, you
  228.      should also have one or several swap partitions. Besides the root
  229.      partition, you can have more ext2 partitions to hold i.e. the usr and
  230.      home directories. For a longer discussion on this, see the doc directory.
  231.  
  232.    - Initialize and Activate a Swap Partition
  233.      When pressing <Return>, you will see a list of partitions that the
  234.      installation program has found as being prepared by you for usage
  235.      as a swap partition. Probably there is only one choice, and it should
  236.      have the same name you wrote down under AmigaOS while you were in
  237.      HDToolbox.
  238.      If you have chosen to use several swap partitions, repeat the following
  239.      step for all of them:
  240.      * Press <Return> to accept the selected partition
  241.      * When asked whether you want to do a bad-block scan, you can safely
  242.        skip this step, so select "No" here using <Tab>.
  243.      * When asked whether you really want to initialize this partition as
  244.        a swap partition, think twice, then, when being sure, press <Return>.
  245.      At this point the swap partition will be "formatted" which only takes
  246.      a second (you'll hardly be able to read the text that appears at the top
  247.      of the screen - ignore that for now).
  248.  
  249.    - Initialize a Linux partition
  250.      This is very similar to the previous step, but this time it's not about
  251.      swap partitions, but about "real" partition which are supposed to carry
  252.      files. Just as before, you'll be presented with a list of partitions
  253.      that the installer found to be valid as Linux filesystem partitions.
  254.      Again, for each of the partitions you have chosen, accept them, select
  255.      "No" when prompted for kernel 2.0.x compatibility, skip the
  256.      "Bad-block scan" and (when you are sure) select "Yes" to format
  257.      (initialize) the partition. After that, you will be asked whether you
  258.       want to mount the currently active partition as root ("/") partition.
  259.      Say Yes here at the first partition you use. Other partitions can
  260.      be mounted somewhere under this mount point afterwards.
  261.  
  262.    - Install Operating System Kernel and Modules
  263.      Select the medium, on which you have the installation files, i.e. CDROM,
  264.      if you are installing with the official CD-ROM, or the harddisk
  265.      partition on which you copied the amiga subdirectory (or unpacked the 
  266.      "amigainstall.tgz" archive).
  267.      After that you can either enter the path to the directory containing
  268.      the installation files or press <Return> to let the installer build a
  269.      list of all directories with installation files (this may take a little
  270.      time).
  271.  
  272.      The harddisk LED will blink for a while as the kernel and modules are
  273.      unpacked onto the root partition, and after that you get back to the
  274.      main screen.
  275.  
  276.    - Configure Device Driver Modules
  277.      This step is only necessary if certain device drivers need to be loaded
  278.      very early when Linux starts up later; like, an Ethernet driver has
  279.      to be pre-loaded so that the networking can already be initialized
  280.      at boot-time. For a stand-alone system you don't have to configure
  281.      anything here, but you should still select this item so that the
  282.      installer can build a list of available kernel modules.
  283.      When you see the next screen, you can immediately
  284.      "Exit: Finished with modules. Return to previous menu".
  285.  
  286.      If you DO need to configure a device driver for your system, please 
  287.      follow the on-screen explanations for selecting modules to be
  288.      pre-loaded (this section is a bit short right now, sorry). 
  289.      For example: if you have PCMCIA Ethernet card you have to select
  290.      "apne" from "net" submenu.
  291.      You can pass command line arguments to the modules, but usually pressing
  292.      "Return" is enough to install the module.
  293.      When done, select the "Exit" item.
  294.  
  295.      Once your Linux system is installed, you can get back to the
  296.      configuration of modules at any time by starting the "modconf"
  297.      program.
  298.  
  299.    - Configure the Network
  300.      We're almost done! This last step to do is to set up your networking
  301.      if you are so lucky to be connected to a net.
  302.      If you have no network, all you need to enter is your hostname (under
  303.      Linux, every computer has a name!). Pick something you like - your
  304.      girlfriend's name, a famous artist/writer/composer/character/actor/
  305.      whatever. 
  306.  
  307.      If you are connected to a network, you need to enter:
  308.      * Your network's name
  309.      * The IP address of your computer
  310.      * The netmask
  311.      * Your broadcast address
  312.      * Your gateway's IP address, if one is available
  313.      * Your nameserver's IP address, if there is one available.
  314.      * Your type of connection - Ethernet, PPP, Slip or whatever else.
  315.  
  316.    - Install the Base System
  317.      Select the medium, on which you have the installation files, i.e. CDROM,
  318.      if you are installing with the official CD-ROM, or the harddisk
  319.      partition on which you copied the amiga subdirectory (or unpacked the 
  320.      "amigainstall.tgz" archive).
  321.      After that you can either enter the path to the directory containing
  322.      the installation files or press <Return> to let the installer build a
  323.      list of all directories with installation files (this may take a little
  324.      time).
  325.  
  326.      Just as with the "Install Operating System Kernel and Modules" step,
  327.      you need to specify where the base system archive is located. This
  328.      file should be named "base2_2.tgz". If you have put it into the same
  329.      directory as the other installation files, you already know what to
  330.      do now: Select "harddisk: Filesystem on the harddisk", pick the
  331.      correct partition and (if necessary) enter the path name to the
  332.      directory containing those files or press <Return> to let the installer
  333.      build a list of all directories containing the base2_2.tgz that can be
  334.      used for installation (this may take a little time).. 
  335.      If you are installing from CD, select "cdrom: CD-ROM drive" and enter
  336.      "/install" as path. Again, as everything should be in the place the
  337.      installer expects them, press <Return> twice after this to accept the
  338.      default options.
  339.  
  340.      At this moment you've got a few minutes time (depending on the speed
  341.      of your processor/harddisk) while the base archive is unpacked onto
  342.      the Linux root partition.
  343.  
  344.    - Configure the Base System
  345.      In this step you just set the timezone that you're in - this should
  346.      be pretty intuitive. For instance, for Germany the selection
  347.      "CET - Europe" (first screen) and "Berlin" (second screen) should be
  348.      fine.
  349.      When asked whether your system clock is set to "GMT" (Greenwich
  350.      Mean Time), you will likely answer with "No" as most Amigas I have seen
  351.      so far always use the local time instead of GMT.
  352.      In case you have Geek Gadgets/Amiga Developers Environment (ADE)
  353.      installed on your Amiga you have a better option. You can set your
  354.      system clock to GMT (for Linux) and still have the correct time when
  355.      running AmigaOS, even Daylight Saving time is set correctly under AOS.
  356.      This is what I have added to my s:user-startup.
  357.       setenv TZ Europe/Berlin
  358.       ixtimezone -patch-resource
  359.  
  360. Well, that's it! Ignore the next suggested step ("Make Linux bootable directly
  361. from harddisk") and instead select alternative 2: "Reboot the System".
  362. After a few seconds, the Amiga should reboot automatically into AmigaOS.
  363. (on some systems, i.e. Blizzard2060, the system does not reboot by itself, so
  364. that you have to press Amiga-Amiga-Control _after_ the system has tried to
  365. soft-reboot. Be sure to give the system enough time to unmount all
  366. filesystems before hard-rebooting. This is a "feature" of the 2.2.x kernel
  367. series, which might be corrected in later versions. Volunteers?)
  368.  
  369. So, one last step is required from you before you can boot your freshly
  370. installed Linux: Go to the directory containing the installation files
  371. and start up a texteditor into which you need to enter just one line:
  372.  
  373.  amiboot-x.x -k linux root=/dev/yyyy ro
  374.  
  375. In this line, replace the "x.x" with the version number of the amiboot
  376. program that is in that directory - it was "5.6" at release time.
  377. Also, replace the "yyyy" with the Linux-wise partition name of the root
  378. partition onto which you installed the system - like sda1, hdb3, whatever
  379. it was, you figure.
  380.  
  381. Save that file, name it something like "linuxgo", and "protect linuxgo +s"
  382. to make it executable like a program.
  383.  
  384. Now you can just type "linuxgo" (when being in that directory) to actually
  385. start the system, this time booting from harddisk instead of a RAM filesystem.
  386. The more advanced user might want to create an icon that is linked to that
  387. script, or a short-cut key combination for ToolManager, or whatever you like..
  388.  
  389. The boot sequence will take quite a bit longer than when you installed the
  390. system because a database of filenames has to be built ("Locate" database).
  391. After that, you are automatically logged in, and need to take these
  392. steps:
  393.  - Activate (or not) the "MD5 passwords" (recommendation: Yes, use it!)
  394.  - Activate (or not) the "Shadow passwords" (recommendation: Yes, use it!)
  395.  - Set a root password
  396.  - Create another (unprivileged) user account (don't skip this step!)
  397.  - Remove PCMCIA stuff from kernel (if you selected it before - Ethernet
  398.    cards works without it)
  399.  - Determine whether you want to continue installing the system via a PPP
  400.    line or not (untested).
  401.  - Select source of packages for APT. You will be prompted for which parts
  402.    of Debian you want (non-US, non-free, contrib).
  403.  - Select which method of selecting packages you want - "simple" or
  404.    "advanced". 
  405.    The "simple" method uses "tasksel", which you can also use that later, 
  406.    to install meta packages for, i.e. C development or games. Each of these
  407.    meta packages will install a number of single packages, which are needed
  408.    for the meta package.
  409.    The "advanced" method uses "dselect", which is still the main package
  410.    selection tool. With dselect you can select single packages to install,
  411.    dependencies will be checked and additional packages, if needed by the
  412.    packages you selected, will be installed.
  413.    Usage of dpkg is not recommend unless you know what you are doing. Both
  414.    methods (tasksel and dselect) use "apt" (or "apt-get") by default which
  415.    makes the installation of packages very easy and fast (in case you have
  416.    experiences with slink and dselect)
  417.  
  418. When you have finished this step, you get logged out and can log in as root
  419. or as an unprivileged user if you created one before.
  420.  
  421. At this point you have a running basic Debian installation on your Amiga,
  422. and if this all worked out (more or less) well for you, I'd definitely love
  423. to hear about it! :-)
  424.  
  425. One more hint: To cleanly shut down a running Linux system, you must not
  426. just reboot with Ctrl-Amiga-Amiga or turn off the computer - instead, 
  427. press the key combination "Ctrl-Alt-Del" (yeah, just like on a PC :-)
  428. to shut down the system in a controlled manner.
  429. That's "Ctrl" + "LeftAlt" + "Delete_on_keypad (.)".
  430.  
  431. More information:
  432.  
  433. http://www.debian.org
  434. http://www.linux.org
  435. http://www.linux-m68k.org
  436. ..and maybe hundreds of other Linux- or Debian-related Web sites around
  437. the world.
  438.  
  439.  
  440. Good luck in the wonderful world of Debian/m68k,
  441. Frank, Michael, Christian, Marcin
  442.