# hdw - linux INSTALL file

this is a short introduction on how to install hdw-linux. you should have build
your hdw distro already or at least have the hdw-linux sources installed to use
the hdw-get script to install from precompiled binaries.
it is supposed to work at least for me. though this is dev and may hurt your 
baby, be warned. i mean it!

there are two possibilities for installation. the first one assumes you have
build your hdw distro and are ready to rock. the second assumes that you have
created/got the binarie tarballs and want to install them using hdw-get. mention
that hdw-get may fetch the binaries from a http/ftp server too. i keep trying to
offer the binaries of the latest hdw development version on my site.
the third step explains how to configure your installed system and make it ready
to rboot.

here we go ...

1. way - hdw-distro ready to rock
---------------------------------

in case your hdw-build directory alreday has been mounted on a seperated 
partition you may skip the following and read on at chapter 'final steps'.
otherwise copy over the hdw system to your target partition.
	
	example:

	mke2fs <target partition>
	mount <target partition> /mnt/hdw-target

	umount $hdw_build_dir/dev
	umount $hdw_build_dir/proc
	cp -a $hdw_build_dir/* /mnt/hdw-target

(where /mnt/hdw-target is the mountpoint the target partition was mounted to)

2. way - hdw-get
----------------

if you didnt build and create the hdw distro by your own, make sure you have the
hdw-get script present which can be found in the hdw-linux sources. the way of 
installation differs whether you have the binaries on your host or if you want
to download them via network/internet.

	binaries exist on local host
	----------------------------
	in that case just do the following:
	
	example:

	mke2fs <target partition>
	mount <target partition> /mnt/hdw-target
	(feel free to create more partitions, e.g. for usr, var and stuff)

	for i in /point/to/binaries/*/*.tar.bz2; do
		hdw-get install /mnt/hdw-target $i
	done

	binaries from network/internet
	------------------------------
	if you want to fetch them from the internet you need to configure
	hdw-get. after that you are able to download the binaries which get 
	installed afterwards. please notice that there is currently just 586 
	optimized binaries on my server. feel free to add mirrors and contact
	me.
	as we dont have the sources on our local computer we need Helper script
	to figure out what we are going to install (also available in the hdw
	sources)
	you will need wget installed for hdw-get to work!
	
	example:
	
	cat > /etc/hdw-get.conf << EOF
	net_addr="http://hackdaworld.dyndns.org/download"
	# note that there doesnt exist binaries of all versions/archs
	hdw_version="0.3-dev"
	hdw_arch="ia32" ; hdw_arch_opt="i586"
	EOF
	
	. misc/hdw-tools/hdw-get install /mnt/hdw-target 00-dirtree
	for i in 2 3; do
		./scripts/Helper -show buildorder $i | grep -v '^#' >> foobar
	done
	cat foobar | while read a b c; do
		. misc/hdw-tools/hdw-get install /mnt/hdw-target $c
	done


final steps
-----------

chroot to your new build system and compile a new kernel (default optimized for
pentiumII)
	
	example:
	
	chroot /mnt/hdw-target /bin/bash \
		PATH="/sbin:/bin:/usr/sbin:/usr/bin" --login
	cd /usr/src/linux
	make menuconfig
	(make sure to always enable devfs support!)
	make dep bzImage modules modules_install

yo may want to set a root password.
	
	example:
	
	passwd
	(type your password, yes, type it 2 times :)

leave the chroot (beside you are not installing from rescue disks) and make the
kernel bootable.

	example:
	
	exit
	cp /mnt/hdw-target/usr/src/linux/arch/i386/boot/bzImage \
		/boot/vmlinuz_hdw
	vi /etc/lilo.conf
	(add vmlinuz_hdw
	lilo
	
have a look at the config files in /mnt/hdw-target/etc/* and adjust to your 
needs. reboot then - good luck! ;)
	
	example:
	
	init 6


troubleshooting:
----------------

- visit: irc.hackdaworld.dyndns.org, #hackdaworld
- visit: http://www.hackdaworld.dyndns.org/contents/mailing-list/
- visit: www.linuxfromscratch.org, www.linuxdoc.org, www.rocklinux.org ;)


regards hackbard