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.
18 for both ways you will need kernel 2.6 running to do the chroot later on!
22 1. way - hdw-distro ready @ $hdw_build_dir
23 ------------------------------------------
25 in case your hdw-build directory alreday has been mounted on a seperated
26 partition you may skip the following and read on at chapter 'final steps'.
27 otherwise copy over the hdw system to your target partition. please make sure
28 unmount the hdw related mounts which the scripts may not have umounted.
32 mke2fs <target partition>
33 mkdir -p /mnt/hdw-target
34 mount <target partition> /mnt/hdw-target
35 (feel free to create more partitions like /usr, /var, /boot and so on)
36 mke2fs <another partition>
37 mkdir -p /mnt/hdw-target/boot
38 mount <another partition> /mnt/hdw-target/boot
40 umount $hdw_build_dir/dev/{shm,pts}
41 umount $hdw_build_dir/{dev,sys,proc}
42 umount $hdw_build_dir/usr/src/hdw-linux/{download,binaries}
43 cp -a $hdw_build_dir/* /mnt/hdw-target
48 hdw-get is a minimal packet manager used to install/remove packages from your
49 hdw distribution. please have a look at the hdw-get script, it is simple and
50 thus more easy to get its functionality. two diffrent ways using hde-get are
51 introduced now. the hdw-get script can be found in the hdw-linux source tree
52 in the ./misc/hdw-tools directory.
54 installing binaries explicitly pointing to them
55 -----------------------------------------------
56 in that case you may just install one package after another.
60 mke2fs <target partition>
61 mount <target partition> /mnt/hdw-target
62 (again feel free to create more partitions)
64 for i in /point/to/binaries/*.tar.bz2; do
65 hdw-get install /mnt/hdw-target $i
68 this is not a nice way since what you want is more control of the
69 packages going to be installed. please try to use the next method.
71 install binaries according to a distribution package list
72 ---------------------------------------------------------
73 in that case binaries should be located in bin_dir or net_addr of your
74 hdw-get.conf file within the same directory structure as created by
75 scripts/Create-Binary. wget is needed if you want to fetch the binaries
76 via internet. please note that due to harddisk limitations binaries for
77 only one arch/optimization and hdw version can be offered via internet.
78 if you thnk this is bad and you could help out, please contact me!
82 cat > /etc/hdw-get.conf << EOF
83 net_addr="http://hackdaworld.dyndns.org/download"
84 bin_addr="/usr/src/hdw-linux/binaries"
85 # note that there dont exist binaries of all versions/archs
87 hdw_arch="ia32" ; hdw_arch_opt="i686"
90 ./scripts/Helper -create_dist_file
91 ./misc/hdw-tools/hdw-get dist-install /mnt/hdw-target \
92 ./distro/<target name>
94 you may edit the distribution file, hdw-get should actually warn you
95 about runtime dependencies. please note that dependency checking is
96 still in development, even for the stable releases, so be sure you know
99 hint: (how i am using hdw ...)
100 o build target all-dev, skip packages that wont build by
102 o upload all the created binaries to a networked computer with
104 o boot your other debian/suse/old-hdw systems, get the hdw-linux
105 sources, create appropriate distro files and run hdw-get
106 (or even use an automated method using pxe boot,
112 |--------------------------------------------------------------------------|
113 | you may want/need to mount proc/sysfs somewhere in tis steps, simply do: |
114 | mount /proc ; mount /sys (when you think its needed) |
115 |--------------------------------------------------------------------------|
117 - chroot to your new build system and compile a new kernel
118 (you have to do this if you are not booting via nfsroot!)
122 chroot /mnt/hdw-target /bin/bash \
123 PATH="/sbin:/bin:/usr/sbin:/usr/bin" --login
126 (disable CONFIG_ROOT_NFS, if you are not booting via nfsroot!)
127 make dep bzImage modules modules_install
129 - yo may want to set a root password (default is 'hdw' iirc)
134 (type your password, yes, type it twice :)
136 - leave the chroot (beside you are not installing from rescue disks or via FAI)
137 and make the kernel bootable
142 cp /mnt/hdw-target/usr/src/linux/arch/i386/boot/bzImage \
148 - create essential console and null nodes (!important!)
152 mknod -m 0666 /mnt/hdw-target/dev/null c 1 3
153 mknod -m 0600 /mnt/hdw-target/dev/console c 5 1
155 [ WARNING : your system will not start up without these nodes ]
157 - have a look at the config files in /mnt/hdw-target/etc/* and adjust to your
158 needs. reboot then - good luck! ;)
168 - visit: irc.hackdaworld.dyndns.org, #hackdaworld
169 - visit: http://www.hackdaworld.dyndns.org/contents/mailing-list/
170 - visit: www.linuxfromscratch.org, www.linuxdoc.org, www.rocklinux.org ;)