VINO requires the following: Intel-class CPU, 486 or higher, 400 megabytes or so of disk space; 8 megabytes of RAM; working install of NetBSD already present. You must have at least 16 megabytes of swap space available in a separate partition. Supported hardware is largely the same as that supported by NetBSD, with some exceptions; in particular, only 3Com 3c5xx and compatible ethernet cards are supported. This release will probably not run on oddball hardware.
For bearable performance, running this release on at least a Pentium-100 class machine with at least 16 MB of RAM is highly recommended.
1. Install NetBSD, if you haven't. Make a partition to hold VINO; we strongly recommend that you allow at least 400 MB for your VINO partition. Put this partition in the NetBSD disklabel. Write down (or remember) the partition name. For the purposes of this document we'll suppose the partition is "wd0f", although you can use any partition NetBSD knows how to find. For maximum compatibility with other things, including possibly future releases of VINO, list the partition in the fdisk partition table as well as the NetBSD disklabel.
2. Format the VINO partition. Use NetBSD's newfs, but you must set the block size to 4096 by using the -b 4096 option. If you're using a fresh NetBSD install, you can save a little time by tweaking the fragment size and block size of the partition to 4096/1024 in the NetBSd installer instead of rerunning newfs after the install is complete.
3. Mount the VINO partition. You will generally find that you want to have it mounted from NetBSD, so you will want to put it in /etc/fstab. We recommend using a mount point called /vinoroot, although you can use whatever you like. (However, the cross-compiler in the binary snapshot looks in /vinoroot, so you'd need to rebuild it.) If you are using a fresh NetBSD install, you can get the installer to set up /etc/fstab for you.
4. Untar the binary snapshot (vino-0.50-bin.tar.gz) into /vinoroot. Be sure to use the -p option to tar to preserve file permissions. If you are installing entirely from source, skip this step.
5. Untar the source snapshot (vino-0.50-src.tar.gz) into /vinoroot/usr/src. You will need this to compile the bootloader (step 7). If you have previously installed the bootloader and you don't plan to recompile anything, you don't need the source. However, since this is an alpha release, you'll probably want it.
6. If you are installing entirely from source, go to /vinoroot/usr/src and run ./bootstrap.sh. You may need to supply appropriate --vinoroot, --host, and/or --arch options. bootstrap.sh builds the cross-compiler. When it completes it will tell you to do make world. Note that you have to use the version of make it tells you to use - that one knows where to find the cross-compiler. make world takes a few hours. Cross-compiling works from NetBSD, BSD/OS, and Redhat Linux. It will probably work from FreeBSD and/or other variants of Linux with some minor tweaking. It will probably not work from other platforms, however. After the make world finishes, do make installetc. This installs necessary files in /etc. Don't do this again later unless you want the password file reset to the default and stuff.
7. You need to install a bootloader that will boot VINO as well as NetBSD kernels. To do this, go into /vinoroot/usr/src/tools/boot/i386-1.3. Read README.VINO and do what it says. This needs to be done in NetBSD.
8. Uncompress the kernel snapshot ("vino.gz") in the NetBSD root directory. It has to be there for the bootloader to find it; if you put it in /vinoroot it won't work. If you installed from source, move the kernel you compiled from /vinoroot/usr/src/vino instead.
9. Reboot; at the bootloader prompt type "vino" instead of "netbsd"; it should boot. It will ask you for the names of the root and swap partitions; for the root partition, give the name of the partition you formatted for VINO; for the swap partition, you should use the same swap partition NetBSD uses (typically wd0b or sd0b).
Caveat emptor: The second partition on the first disk of any particular type (wd0b, sd0b, etc.) is almost always the swap partition. Note, however, that if you swap on a data partition, you will clobber it. Thus, as in all cases, you should be sure that you know what you are doing.
10. You will be asked whether you wish to boot single-user, multi-user, enter the kernel shell (kshell), etc. The first time you boot VINO, you should boot multiuser, log in as root, and run /usr/sbin/setup to do basic system configuration, and then reboot by running /sbin/reboot. Thereafter, you may boot either single user (which just runs sh for you -- init does not start up if you boot single user) or multi-user as it suits you. Initially, there are just two accounts: root and test. Neither account has an initial password; if you get prompted for one, something is wrong.
11. At this point you're done. If you like you can recompile the kernel and change compile-time settings, such as the default partition names. See Configuring and Compiling Kernels.
Last updated Friday, October 20, 1998 by Robert Haas (rhaas@eecs.harvard.edu).