1 # hdw - linux INSTALL file
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
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.
20 1. way - hdw-distro ready @ $hdw_build_dir
21 ------------------------------------------
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.
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
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
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.
52 installing binaries explicitly pointing to them
53 -----------------------------------------------
54 in that case you may just install one package after another.
58 mke2fs <target partition>
59 mount <target partition> /mnt/hdw-target
60 (again feel free to create more partitions)
62 for i in /point/to/binaries/*.tar.bz2; do
63 hdw-get install /mnt/hdw-target $i
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.
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!
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
85 hdw_arch="ia32" ; hdw_arch_opt="i686"
88 ./scripts/Helper -create_dist_file
89 . misc/hdw-tools/hdw-get dist-install /mnt/hdw-target \
90 ./distro/<target name>
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
97 hint: (how i am using hdw ...)
98 o build target all-dev, skip packages that wont build by
100 o upload all the created binaries to a networked computer with
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,
110 - chroot to your new build system and compile a new kernel
114 chroot /mnt/hdw-target /bin/bash \
115 PATH="/sbin:/bin:/usr/sbin:/usr/bin" --login
118 make dep bzImage modules modules_install
120 - yo may want to set a root password (default is 'hdw' iirc)
125 (type your password, yes, type it twice :)
127 - leave the chroot (beside you are not installing from rescue disks or via FAI)
128 and make the kernel bootable
133 cp /mnt/hdw-target/usr/src/linux/arch/i386/boot/bzImage \
139 - have a look at the config files in /mnt/hdw-target/etc/* and adjust to your
140 needs. reboot then - good luck! ;)
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 ;)