]> hackdaworld.org Git - hdw-linux/hdw-linux.git/blob - doc/INSTALL
corrected optimize flag
[hdw-linux/hdw-linux.git] / 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