Bug 17518

Summary: Please update the UPDATING document
Product: Documentation Reporter: girgen <girgen>
Component: Books & ArticlesAssignee: Warner Losh <imp>
Status: Closed FIXED    
Severity: Affects Only Me CC: imp
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description girgen 2000-03-20 23:50:01 UTC
The UPDATING document in the src dir need a few more
lines to prevent problems.

	To build a kernel
	-----------------
	Update config, genassym and go:
		cd src/usr.bin/genassym
		make depend all install clean
		cd ../../usr.sbin/config
		make depend all install clean
		cd ../../sys/i386/conf

+ Before config can run, it needs to find a libc.so.4 to link with. I
  did this by setting LD_LIBRARY_PATH to /usr/obj/usr/src/lib/libc,
  but there are many other ways.

		config YOUR_KERNEL_HERE
		cd ../../compile/YOUR_KERNEL_HERE
		make depend && make
		make install


	To update from 3.x to 4.0 stable
	--------------------------------
	cd /usr/src
	make buildworld
	cd sbin/mknod
	make install
	<follow directions to build/install a kernel>

+ also, kld modules need to be installed, especially if you're using
  vinum! cd sys/modules && make install is one way to go, but perhaps
  copying the old ones somewhere safe first is a good idea

	<follow rebuild disk /dev entries above>	[*]
	reboot
	<in single user>
	cd /usr/src

+ a make test here is a very good idea. If the user (like I did on one
  of my machines) forgets to remove the /etc/rc.conf.local, the make
  binary will get installed first of all, and since it cannot run
  without the new libc, thing will come to a prompt halt. make will
  not run again until you get libc.so.4 in your ld path.

	make -DNOINFO installworld
	make installworld

How-To-Repeat: 
Get a 3.x installation preferrably with vinum volume
management. Follow the UPDATING document when updating to version 4.
Comment 1 Sheldon Hearn freebsd_committer freebsd_triage 2000-03-22 13:08:30 UTC
Responsible Changed
From-To: freebsd-doc->imp

Over to UPDATING's maintainer. 
Comment 2 Warner Losh freebsd_committer freebsd_triage 2000-05-18 01:33:25 UTC
State Changed
From-To: open->closed

I've updated things with this info.