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 may hurt your baby, be
   7 warned. i mean it!
   8
   9 there are two diffrent ways of how to setup your hdw-linux system. the first
  10 one assumes you have finished a build as explained in doc/BUILD. for the other
  11 way you need to have the binary tarballs accessible which you may have created
  12 after/during build procedure or on cd from someone else. please note that
  13 hdw-get is able to fetch them from a http/ftp server too. i keep trying to
  14 offer the binaries of the latest stable release on hackdaworld.dyndns.org,
  15 mirrors appreciated! finally some configuration issues are discussed and the
  16 system is prepared for reboot.
  17
  18 here we go ...
  19
  20 1. way - hdw-distro ready @ $hdw_build_dir
  21 ------------------------------------------
  22
  23 in case your hdw-build directory alreday has been mounted on a seperated
  24 partition you may skip the following and read on at chapter 'final steps'.
  25 otherwise copy over the hdw system to your target partition. please make sure
  26 unmount the hdw related mounts which the scripts may not have umounted.
  27
  28         example:
  29
  30         mke2fs <target partition>
  31         mkdir -p /mnt/hdw-target
  32         mount <target partition> /mnt/hdw-target
  33         (feel free to create more partitions like /usr, /var, /boot and so on)
  34         mke2fs <another partition>
  35         mkdir -p /mnt/hdw-target/boot
  36         mount <another partition> /mnt/hdw-target/boot
  37
  38         umount $hdw_build_dir/dev/{shm,pts}
  39         umount $hdw_build_dir/{dev,sys,proc}
  40         umount $hdw_build_dir/usr/src/hdw-linux/{download,binaries}
  41         cp -a $hdw_build_dir/* /mnt/hdw-target
  42
  43 2. way - hdw-get
  44 ----------------
  45
  46 hdw-get is a minimal packet manager used to install/remove packages from your
  47 hdw distribution. please have a look at the hdw-get script, it is simple and
  48 thus more easy to get its functionality. two diffrent ways using hde-get are
  49 introduced now. the hdw-get script can be found in the hdw-linux source tree
  50 in the ./misc/hdw-tools directory.
  51
  52         installing binaries explicitly pointing to them
  53         -----------------------------------------------
  54         in that case you may just install one package after another.
  55
  56         example:
  57
  58         mke2fs <target partition>
  59         mount <target partition> /mnt/hdw-target
  60         (again feel free to create more partitions)
  61
  62         for i in /point/to/binaries/*.tar.bz2; do
  63                 hdw-get install /mnt/hdw-target $i
  64         done
  65
  66         this is not a nice way since what you want is more control of the
  67         packages going to be installed. please try to use the next method.
  68
  69         install binaries according to a distribution package list
  70         ---------------------------------------------------------
  71         in that case binaries should be located in bin_dir or net_addr of your
  72         hdw-get.conf file within the same directory structure as created by
  73         scripts/Create-Binary. wget is needed if you want to fetch the binaries
  74         via internet. please note that due to harddisk limitations binaries for
  75         only one arch/optimization and hdw version can be offered via internet.
  76         if you thnk this is bad and you could help out, please contact me!
  77
  78         example:
  79
  80         cat > /etc/hdw-get.conf << EOF
  81         net_addr="http://hackdaworld.dyndns.org/download"
  82         bin_addr="/usr/src/hdw-linux/binaries"
  83         # note that there dont exist binaries of all versions/archs
  84         hdw_version="0.3"
  85         hdw_arch="ia32" ; hdw_arch_opt="i686"
  86         EOF
  87
  88         ./scripts/Helper -create_dist_file
  89         . misc/hdw-tools/hdw-get dist-install /mnt/hdw-target \
  90                                                 ./distro/<target name>
  91
  92         you may edit the distribution file, hdw-get should actually warn you
  93         about runtime dependencies. please note that dependency checking is
  94         still in development, even for the stable releases, so be sure you know
  95         what you are doing.
  96
  97         hint: (how i am using hdw ...)
  98                 o build target all-dev, skip packages that wont build by
  99                   touching a logfile
 100                 o upload all the created binaries to a networked computer with
 101                   apache installed
 102                 o boot your other debian/suse/old-hdw systems, get the hdw-linux
 103                   sources, create appropriate distro files and run hdw-get
 104                   (or even use an automated method using pxe boot,
 105                    see ./doc/FAI)
 106
 107 final steps
 108 -----------
 109
 110 - chroot to your new build system and compile a new kernel
 111
 112         example:
 113
 114         chroot /mnt/hdw-target /bin/bash \
 115                 PATH="/sbin:/bin:/usr/sbin:/usr/bin" --login
 116         cd /usr/src/linux
 117         make menuconfig
 118         make dep bzImage modules modules_install
 119
 120 - yo may want to set a root password (default is 'hdw' iirc)
 121
 122         example:
 123
 124         passwd
 125         (type your password, yes, type it twice :)
 126
 127 - leave the chroot (beside you are not installing from rescue disks or via FAI)
 128   and make the kernel bootable
 129
 130         example:
 131
 132         exit
 133         cp /mnt/hdw-target/usr/src/linux/arch/i386/boot/bzImage \
 134                 /boot/vmlinuz_hdw
 135         vi /etc/lilo.conf
 136         (add vmlinuz_hdw)
 137         lilo
 138
 139 - have a look at the config files in /mnt/hdw-target/etc/* and adjust to your
 140   needs. reboot then - good luck! ;)
 141
 142         example:
 143
 144         init 6
 145
 146
 147 troubleshooting:
 148 ----------------
 149
 150 - visit: irc.hackdaworld.dyndns.org, #hackdaworld
 151 - visit: http://www.hackdaworld.dyndns.org/contents/mailing-list/
 152 - visit: www.linuxfromscratch.org, www.linuxdoc.org, www.rocklinux.org ;)
 153
 154
 155 regards hackbard