Subject: Last draft of 1.3.2 install notes
To: None <port-pmax@NetBSD.ORG>
From: Simon Burge <simonb@telstra.com.au>
List: port-pmax
Date: 05/16/1998 02:45:59
Well, as usual, time is running out.

Here's the "Guide for the Impatient", and changes to the normal INSTALL
notes.  I've got until about 22:00 UTC to get this done (five hours from
now, and that includes about about 4 1/2 hours sleep).  Please send any
changes or botches to me ASAP.

Thanks to Jonathon Stone, Michael Hitch, Greg Woods and probably others
I've forgotten.

Simon.
--------------------------- Guide for the Impatient ---------------------------

NetBSD 1.3.2 includes the install materials on CD.  However, we cannot
make a single CD bootable on a dozen systems, so the CD cannot be
booted directly in a DECstation.  If your DECstation already has an OS
installed and has a CD-ROM drive, you can install NetBSD by mounting the
CD and copying a miniroot to your swap partition.


In the following instructions, lines starting with a # character are
comments and are not typed in.  It is also assumed that your CD-ROM
drive is at SCSI id 4, and your disk is at SCSI id 0.


Under Ultrix, do:

    # Boot into single user mode
    boot -f rz(0,0,0)vmunix			# on 2100, 3100
    boot 5/rz0/vmunix				# on 5000/200
    boot 3/rz0/vmunix				# on all other models

    # At the single-user root prompt
    mkdir -p /cdrom
    mount -r -t cdfs -o nodefperm,noversion /dev/rz4c /cdrom
    PATH=$PATH:/cdrom/NetBSD-1.3.2/pmax/installation/misc; export PATH

    # Check that your swap partition is at least 32Mbytes
    chpt -q /dev/rz0c           
    # Look at the "b" partition, you'll need at least 65536 blocks

    # Put the netbsd kernel on the root filesystem
    cd /cdrom/NetBSD-1.3.2/pmax/binary/kernel
    gunzip -c netbsd.ecoff.gz > /netbsd
    # Copy the diskimage to the swap partition
    cd ../../installation/diskimage
    gunzip -c diskimage.gz | dd of=/dev/rrz0b bs=32k

    # ... halt and follow install from instructions for booting diskimage
    # from swap partition, using netbsd as the kernel name
    halt

    boot -f rz(0,0,0)netbsd n			# on 2100, 3100
    boot 5/rz0/netbsd n				# on 5000/200
    boot 3/rz0/netbsd n				# on all other models

    [... Kernel boot meessages and copyright...]

    boot device: rz0
    root device (default rz0a): rz0b	# enter "rz0b" for root device
    dump device (default rz0b): none	# enter "none" for dump device
    file system (default generic):	# press <return> at this prompt
    root on rz0b
    WARNING: clock gained 50 days -- CHECK AND RESET THE DATE!
    root file system type: ffs
    Enter pathname of shell or RETURN for sh:

    # Now proceed to instructions in the INSTALL document for running sysinst


>From an earlier version of NetBSD (or OpenBSD), do:

    # Boot into single user mode
    boot -f rz(0,0,0)netbsd			# on 2100, 3100
    boot 5/rz0/netbsd				# on 5000/200
    boot 3/rz0/netbsd				# on all other models

    # At the single-user root prompt
    mount -u /
    mount -r /usr			# if /usr is on a separate filesystem
    mkdir -p /cdrom
    mount -r -t cd9660 /dev/rz4c /cdrom

    # Check that your swap partition is at least 32Mbytes
    disklabel rz0
    # Look at the "b" partition, you'll need at least 65536 blocks

    # Put the new netbsd kernel on the root filesystem
    cd /cdrom/NetBSD-1.3.2/pmax/binary/kernel
    gunzip -c netbsd.gz > /netbsd-1.3.2
    # Copy the diskimage to the swap partition
    cd ../../installation/diskimage
    gunzip -c diskimage.gz | dd of=/dev/rrz0b bs=32k

    # ... halt and follow install from instructions for booting diskimage
    # from swap partition, using netbsd-1.3.2 as the kernel name
    halt

    boot -f rz(0,0,0)netbsd-1.3.2 n			# on 2100, 3100
    boot 5/rz0/netbsd-1.3.2 n				# on 5000/200
    boot 3/rz0/netbsd-1.3.2 n				# on all other models

    [... Kernel boot meessages and copyright...]

    boot device: rz0
    root device (default rz0a): rz0b	# enter "rz0b" for root device
    dump device (default rz0b): none	# enter "none" for dump device
    file system (default generic):	# press <return> at this prompt
    root on rz0b
    WARNING: clock gained 50 days -- CHECK AND RESET THE DATE!
    root file system type: ffs
    Enter pathname of shell or RETURN for sh:

    # Now proceed to instructions in the INSTALL document for running sysinst


If your machine has Ultrix and your network bandwith can sustain FTPing
10 Megabytes to get the initial diskimage, you can fetch the diskimage
via FTP.  Something similar will also work for a network connected
NetBSD machine - the main change would be to not get the Ultrix version
of gunzip from the FTP site.

    # While still in multi-user mode, ftp files to a local filesystem

    # check for 12MB free space - need ~2MB on / and ~10MB on
    # /place/for/files
    df
    cd /place/for/files
    # Connect to the NetBSD ftp archive or whatever your local
    # "mirror" site is.
    ftp ftp.netbsd.org
    Name: ftp
    Password: your@email.address
    ftp> bin
    ftp> cd /pub/NetBSD/NetbSD-1.3.2/pmax/installation/misc
    ftp> get gunzip
    ftp> cd ../diskimage
    ftp> get diskimage.gz
    ftp> cd ../../binary/kernel
    ftp> get netbsd.ecoff.gz
    ftp> quit
    chmod 755 gunzip
    ./gunzip -c < netbsd.ecoff.gz > /netbsd

    # Shutdown and boot into single user mode
    shutdown -h now

    boot -f rz(0,0,0)vmunix			# on 2100, 3100
    boot 5/rz0/vmunix				# on 5000/200
    boot 3/rz0/vmunix				# on all other models

    # At the single-user root prompt
    mount -a -t ufs
    cd /place/for/files

    # Copy the diskimage to the swap partition
    ./gunzip -c diskimage.gz | dd of=/dev/rrz0b bs=32k

    # ... halt and follow install from instructions for booting diskimage
    # from swap partition, using netbsd as the kernel name
    halt

    boot -f rz(0,0,0)netbsd n			# on 2100, 3100
    boot 5/rz0/netbsd n				# on 5000/200
    boot 3/rz0/netbsd n				# on all other models

    [... Kernel boot meessages and copyright...]

    boot device: rz0
    root device (default rz0a): rz0b	# enter "rz0b" for root device
    dump device (default rz0b): none	# enter "none" for dump device
    file system (default generic):	# press <return> at this prompt
    root on rz0b
    WARNING: clock gained 50 days -- CHECK AND RESET THE DATE!
    root file system type: ffs
    Enter pathname of shell or RETURN for sh:

    # Now proceed to instructions in the INSTALL document for running sysinst

-------------------------------- INSTALL NOTES --------------------------------

Index: INSTALL
===================================================================
RCS file: /cvsroot/src/distrib/notes/INSTALL,v
retrieving revision 1.27.2.15
diff -c -w -r1.27.2.15 INSTALL
*** INSTALL	1997/12/30 00:04:51	1.27.2.15
--- INSTALL	1998/05/15 16:02:20
***************
*** 205,211 ****
  #include "mirrors"
  
  NetBSD _VER Release Contents:
! ------ --- ------- --------
  
  The NetBSD _VER release is organized in the following way:
  
--- 205,211 ----
  #include "mirrors"
  
  NetBSD _VER Release Contents:
! ------ ----- ------- --------
  
  The NetBSD _VER release is organized in the following way:
  
Index: pmax/hardware
===================================================================
RCS file: /cvsroot/src/distrib/notes/pmax/hardware,v
retrieving revision 1.2.2.2
diff -c -w -r1.2.2.2 hardware
*** hardware	1998/02/07 06:21:22	1.2.2.2
--- hardware	1998/05/15 16:02:22
***************
*** 6,16 ****
  	- Decstation 5000/120, /125, and /133, also known as "3MIN"
  	- Decstation 5000/200, also known as "3MAX"
  	- Decstation 5000/240, als known as "3MAXPLUS"
  
  NetBSD/pmax _VER does *not* (yet) run on these machines:
! 	- Decstation 5100 (an r2000-based cousin of the Decstation 3100)
! 	- Decsystem 5400 and 5500 (Qbus-based systems, similar to 
!  		a Vax 'Mayfair' and 'Mayfair II', but with an r2000a or r3000
  		cpu instead of a CVAX cpu.)
  	- Decsystem 5800 (xbi-based multiprocessor, a Vax 8800 with
  		 Vax CPU boards replaced with Mips cpu boards)
--- 6,18 ----
  	- Decstation 5000/120, /125, and /133, also known as "3MIN"
  	- Decstation 5000/200, also known as "3MAX"
  	- Decstation 5000/240, als known as "3MAXPLUS"
+ 	- Decstation 5000/50, 5000/150 and 5000/260 - R4000 and R4400
+ 		variants of the the MAXINE, 3MIN and 3MAXPLUS
  
  NetBSD/pmax _VER does *not* (yet) run on these machines:
! 	- Decstation 5100 (an r3000-based cousin of the Decstation 3100)
! 	- Decsystem 5400 and 5500 (Qbus-based systems, similar to a Vax
! 		'Mayfair' and 'Mayfair II', but with an r2000a or r3000
  		cpu instead of a CVAX cpu.)
  	- Decsystem 5800 (xbi-based multiprocessor, a Vax 8800 with
  		 Vax CPU boards replaced with Mips cpu boards)
***************
*** 41,52 ****
  
  	ethernet: 
  		on-board AMD Lance ethernet ("le0"), 
! 		TURBOchannel AMD Lance ethernet cards.
  
  	SCSI: 
  		on-board DEC "sii" SCSI controller (2100 and 3100)
  		on-board "asc" SCSI controller (5000 series machines)
! 		TurboChannel "asc" SCSI controller, 
  	DEC (LK-201 or compatible) keyboard 
  	DEC ("hockey puck" or compatible) mouse.
  
--- 43,55 ----
  
  	ethernet: 
  		on-board AMD Lance ethernet ("le0"), 
! 		TURBOchannel AMD Lance ethernet cards (the "PMAD").
  
  	SCSI: 
  		on-board DEC "sii" SCSI controller (2100 and 3100)
  		on-board "asc" SCSI controller (5000 series machines)
! 		TurboChannel "asc" SCSI controller (the "PMAZ").
! 
  	DEC (LK-201 or compatible) keyboard 
  	DEC ("hockey puck" or compatible) mouse.
  
***************
*** 55,61 ****
  about from time to time:
  	Q-bus Decsystem machines
  	Decstation 5100 machines
! 	PrestoServe NVRAM on Decstation 5100 machines 
  	audio drivers for  Personal Decstation machines
  	floppy driver for Personal Decstation machines
  	TurboChannel audio hardware (LoFi)
--- 58,64 ----
  about from time to time:
  	Q-bus Decsystem machines
  	Decstation 5100 machines
! 	PrestoServe NVRAM on Decstation 5100 and 5000/2xx machines 
  	audio drivers for Personal Decstation machines
  	floppy driver for Personal Decstation machines
  	TurboChannel audio hardware (LoFi)
Index: pmax/install
===================================================================
RCS file: /cvsroot/src/distrib/notes/pmax/install,v
retrieving revision 1.1.2.3
diff -c -w -r1.1.2.3 install
*** install	1997/12/23 15:32:56	1.1.2.3
--- install	1998/05/15 16:02:24
***************
*** 19,24 ****
--- 19,57 ----
  NetBSD/pmax _VER installation tar sets.
  
  
+ Install via the NetBSD CDROM.
+ -----------------------------
+ 
+ You can obtain the disk image or diskless boot tar file from the
+ NetBSD _VER CDROM.
+ 
+ 
+ To mount the CDROM from a NetBSD/pmax host, type
+ 
+ 	mount -r -t cd9660 /dev/rzXc /mnt
+ 
+ and from an Ultrix host
+ 
+ 	mount -r -t cdfs -o nodefperm,noversion /dev/rzXc /mnt
+ 
+ where X is the SCSI id of the CDROM.
+ 
+ 
+ The diskimage file can be found on the CDROM at the following
+ location (relative to the mount point of the CD)
+ 
+ 	NetBSD-_VER/pmax/installation/diskimage/diskimage.gz
+ 
+ and the diskless boot tar file can be found at
+ 
+ 	NetBSD-_VER/pmax/installation/netboot/diskimage.tgz
+ 
+ Once you have located these files, continue on to either the "Install
+ via diskless boot", "Install via diskimage" or "Installing from Ultrix"
+ section later in the INSTALL notes.
+ 
+ 
+ 
  Install via diskless boot.
  --------------------------
  
***************
*** 91,96 ****
--- 124,136 ----
  your swap partition, copy a netbsd.ecoff kernel from the FTP site,
  and proceed from step #5 of the `Upgrade via diskimage' above.
  
+ You should do this from single-user mode, to ensure that swapping is
+ not enabled when you copy the diskimage into the swap partition.
+ 
+ On Ultrix, use the "chpt -q /dev/rz?c" command to be sure your swap
+ partition (typically "b") is big enough to hold the diskimage (32Mbytes
+ or more).
+ 
  Again, be sure to specify the partition where you dd'ed the NetBSD
  diskimage as your root device in step #7!
  
***************
*** 105,116 ****
  
  	Enter pathname of shell or RETURN for sh: 
  
- 
  At this point, press the RETURN key.
  then when you get a standalone root prompt, set your terminal type
  
  	TERM=pmax; export TERM;
  
  
  Next, you need to ensure that the root filesystem is writable so that
  sysinst can create temporary files, temporary disklabels, etc.
--- 145,160 ----
  
  	Enter pathname of shell or RETURN for sh: 
  
  At this point, press the RETURN key.
  then when you get a standalone root prompt, set your terminal type
  
  	TERM=pmax; export TERM;
  
+ for a framebuffer console, or
+ 
+ 	TERM=vt100; export TERM
+ 
+ if using a serial console with a vt100-compatible terminal.
  
  Next, you need to ensure that the root filesystem is writable so that
  sysinst can create temporary files, temporary disklabels, etc.
***************
*** 124,137 ****
  and rz2b for diskimage in swap.)
  
  
! 
! Then, start sysinst.  For the ALPHA release, you should start sysinst
! with an empty release-version string:
! 
! 	sysinst -r ""
! 
! (to stop sysinst automatically inserting the reelase into set names).
! For the BETA or the final relase, just use
  
  	sysinst
  
--- 168,174 ----
  and rz2b for diskimage in swap.)
  
  
! Then, start sysinst
  
  	sysinst
  
Index: pmax/xfer
===================================================================
RCS file: /cvsroot/src/distrib/notes/pmax/xfer,v
retrieving revision 1.1.4.1
diff -c -w -r1.1.4.1 xfer
*** xfer	1997/11/01 06:28:24	1.1.4.1
--- xfer	1998/05/15 16:02:24
***************
*** 17,22 ****
--- 17,23 ----
  	NFS partitions
  	FTP
  	Tape
+ 	CD-ROM
  
  The steps necessary to prepare the distribution sets
  for installation depend on which method of installation