===============================================================================
The NetBSD Foundation, Inc.
NetBSD/cobalt Installation CD [1.6.1 Patch Release]
===============================================================================

Welcome to the NetBSD/cobalt installation.

===========================
Minimum System Requirements
===========================

Intel-Compatible PC Desktop or Laptop with

 - IDE (ATAPI) or SCSI CD-ROM
 - At least one network card

Computer MUST be CD-ROM-bootable.

========================
Installation Limitations
========================

Please note that Intel-based server appliances cannot be installed using
this CD-ROM.

=========================
Installation Instructions
=========================

1.	Connect this computer to the server appliance using either a crossover
	cable or hub.
2.	Turn on the server appliance while simultaneously pressing and holding
	down both the left (<) and right (>) arrow buttons on the LCD console.
3.	Continue holding down both the left (<) and right (>) arrow buttons
	until "Net Booting" appears on the LCD display.
4.	Wait until the box reboots. Finally, the box host name and IP address
	should appear on the LCD screen. This indicates installation success.

Warning: Please note that the installation process may take a while. Do not
interrupt it until it is finished.

Warning: Freshly installed box is configured as DHCP client, i.e. it tries
to obtain its IP address over the network from DHCP server. To disable this,
change /etc/rc.conf to contain "dhclient=NO" line.

5.	BE AWARE that newly installed box is left in highly insecure state.
	All ttys are open by default and allow root access over the network.
	Also, telnet and rlogin ports are open. This is done to allow you
	to login into the fresh box in order to make necessary configuration
	changes. Please do not forget to bring your box to the secure state.

If your appliance have a serial console and you want to use it or if you want
to use this computer in order to monitor network activity or to perform other
installation tasks, quit this welcome screen and login into the system as root.
Use 'tip qube' to connect to your appliance over the serial port (/dev/tty00).
Use 'rlogin' to login into your box when the installation is finished.

This file is permanently available as /root/instructions.txt.

===============
Troubleshooting
===============

Q: Installation seem to went smooth, but after reboot I am seeing

	"Jump_to_Real_Kernel: disk error, trying BFD again"

A: This may be a problem with the hard drive configuration. Here is
   an advice from debian-mips list:

   Check the jumpers on your hard drive.  The jumper on my Qube's hard
   drive had settings for "Primary" and for "Only disk in the chain".  I
   had it set to "primary" which let me install things, but wouldn't
   boot.  I had to put it on "Only disk" to get a boot.  This cost me
   three days :(

Q: Installation was ok, but the boot loader doesn't seem to boot a kernel
A: Please report this to port-cobalt@netbsd.org. In the mean time, use the
   following workaround:

   - Reboot the box
   - When Cobalt's banner "We serve it, you surf it" appears, hit space button
   - In PROM console, type

	bfd /boot/netbsd.gz

   - When kernel is booted, mount /dev/wd0e partition and set up all
     vmlinux* links to point to netbsd.gz:

	# mount /dev/wd0e /mnt
	# cd /mnt/boot
	# rm vmlinux.gz
	# ln -s netbsd.gz vmlinux.gz
	...
	# rm vmlinux_raq-2800.gz
	# ln -s netbsd.gz vmlinux_raq-2800.gz

Please report any problems not covered by this section to
port-cobalt@netbsd.org.

=======
Credits
=======

Cobalt Networks, Inc. -- first and foremost, for the idea of this installation.
Beside of the idea, many configuration files were taken out of the original
Cobalt OS Restore CD and modified to work with the NetBSD.

NetBSD Cobalt users -- for testing and many useful suggestions. Without you,
this work would have never been done!
