doc/INSTALL

   1 # hdw - linux INSTALL file
   2
   3 this is a short introduction on how to install hdw-linux. you should have build
   4 your hdw distro already or at least have the hdw-linux sources installed to use
   5 the hdw-get script to install from precompiled binaries.
   6 it is supposed to work at least for me. though this is dev and may hurt your
   7 baby, be warned. i mean it!
   8
   9 there are two possibilities for installation. the first one assumes you have
  10 build your hdw distro and are ready to rock. the second assumes that you have
  11 created/got the binarie tarballs and want to install them using hdw-get. mention
  12 that hdw-get may fetch the binaries from a http/ftp server too. i keep trying to
  13 offer the binaries of the latest hdw development version on my site.
  14 the third step explains how to configure your installed system and make it ready
  15 to rboot.
  16
  17 here we go ...
  18
  19 1. way - hdw-distro ready to rock
  20 ---------------------------------
  21
  22 in case your hdw-build directory alreday has been mounted on a seperated
  23 partition you may skip the following and read on at chapter 'final steps'.
  24 otherwise copy over the hdw system to your target partition.
  25
  26         example:
  27
  28         mke2fs <target partition>
  29         mount <target partition> /mnt/hdw-target
  30
  31         umount $hdw_build_dir/dev
  32         umount $hdw_build_dir/proc
  33         cp -a $hdw_build_dir/* /mnt/hdw-target
  34
  35 (where /mnt/hdw-target is the mountpoint the target partition was mounted to)
  36
  37 2. way - hdw-get
  38 ----------------
  39
  40 if you didnt build and create the hdw distro by your own, make sure you have the
  41 hdw-get script present which can be found in the hdw-linux sources. the way of
  42 installation differs whether you have the binaries on your host or if you want
  43 to download them via network/internet.
  44
  45         binaries exist on local host
  46         ----------------------------
  47         in that case just do the following:
  48
  49         example:
  50
  51         mke2fs <target partition>
  52         mount <target partition> /mnt/hdw-target
  53         (feel free to create more partitions, e.g. for usr, var and stuff)
  54
  55         for i in /point/to/binaries/*/*.tar.bz2; do
  56                 hdw-get install /mnt/hdw-target $i
  57         done
  58
  59         binaries from network/internet
  60         ------------------------------
  61         if you want to fetch them from the internet you need to configure
  62         hdw-get. after that you are able to download the binaries which get
  63         installed afterwards. please notice that there is currently just 586
  64         optimized binaries on my server. feel free to add mirrors and contact
  65         me.
  66         as we dont have the sources on our local computer we need Helper script
  67         to figure out what we are going to install (also available in the hdw
  68         sources)
  69         you will need wget installed for hdw-get to work!
  70
  71         example:
  72
  73         cat > /etc/hdw-get.conf << EOF
  74         net_addr="http://hackdaworld.dyndns.org/download"
  75         # note that there doesnt exist binaries of all versions/archs
  76         hdw_version="0.3-dev"
  77         hdw_arch="ia32" ; hdw_arch_opt="i586"
  78         EOF
  79
  80         . misc/hdw-tools/hdw-get install /mnt/hdw-target 00-dirtree
  81         for i in 2 3; do
  82                 ./scripts/Helper -show buildorder $i | grep -v '^#' >> foobar
  83         done
  84         cat foobar | while read a b c; do
  85                 . misc/hdw-tools/hdw-get install /mnt/hdw-target $c
  86         done
  87
  88
  89 final steps
  90 -----------
  91
  92 chroot to your new build system and compile a new kernel (default optimized for
  93 pentiumII)
  94
  95         example:
  96
  97         chroot /mnt/hdw-target /bin/bash \
  98                 PATH="/sbin:/bin:/usr/sbin:/usr/bin" --login
  99         cd /usr/src/linux
 100         make menuconfig
 101         (make sure to always enable devfs support!)
 102         make dep bzImage modules modules_install
 103
 104 yo may want to set a root password.
 105
 106         example:
 107
 108         passwd
 109         (type your password, yes, type it 2 times :)
 110
 111 leave the chroot (beside you are not installing from rescue disks) and make the
 112 kernel bootable.
 113
 114         example:
 115
 116         exit
 117         cp /mnt/hdw-target/usr/src/linux/arch/i386/boot/bzImage \
 118                 /boot/vmlinuz_hdw
 119         vi /etc/lilo.conf
 120         (add vmlinuz_hdw
 121         lilo
 122
 123 have a look at the config files in /mnt/hdw-target/etc/* and adjust to your
 124 needs. reboot then - good luck! ;)
 125
 126         example:
 127
 128         init 6
 129
 130
 131 troubleshooting:
 132 ----------------
 133
 134 - visit: irc.hackdaworld.dyndns.org, #hackdaworld
 135 - visit: http://www.hackdaworld.dyndns.org/contents/mailing-list/
 136 - visit: www.linuxfromscratch.org, www.linuxdoc.org, www.rocklinux.org ;)
 137
 138
 139 regards hackbard