xref: /netbsd-src/distrib/notes/pmax/install (revision 2a399c6883d870daece976daec6ffa7bb7f934ce)
1Reminder:
2	Always back up files before installing or upgrading.
3	If installing from source,  always install and boot a new kernel
4	before installing a new userland!
5
6
7If at all possible, you should consult the ``Installation Guide''
8document on the NetBSD/pmax web page, at http://www.netbsd.org/Ports/pmax.
9It has not been possible to reproduce the pmax installation Web page
10in fixed-font hardcopy format for the _VER release.  You must either visit
11the URL above, or request a rendered version (e.g., PostScript).
12
13Please check the NetbSD/pmax _VER installation instructions at
14
15    http://www.netbsd.org/Ports/pmax/pmax-install.html
16
17now, and return to this document when you used those instructions to
18install a diskimage, and used sysinst to label a disk and extract the
19NetBSD/pmax _VER installation tar sets.
20
21
22Install via diskless boot.
23--------------------------
24
25The preferred path is to upgrade or install by diskless-booting a
26minimal system via NFS, and using that to upgrade or install.  The
27file
28	installation/netboot/diskimage.tar.gz
29
30contains a suitable set of files. (it is a tar copy of the contents of
31a root filesystem diskimage) .  You will need to find an NFS server,
32unpack the tarfile, and setup BOOTP/dhcp service for your pmax.
33Complete instructions are in the installation notes or the pmax web
34page.
35
36Since the system install utility, sysinst, requires a read/write root,
37netbooting is only feasible if your NFS server exports the diskless
38root read-write.  If this is not possible, you should install via
39diskimage.
40
41
42
43Install via diskimage.
44----------------------
45
46If netbooting with a _writable_ NFS root is not possible, the
47recommended installation is to unpack and copy a diskimage onto the
48raw partition of a disk.  The diskimage file is in
49
50installation/diskimage/diskimage.gz
51
52is shipped compressed and is around 8020 kBytes; it uncompresses to
53exactly 32Mbytes.
54
55To install the diskimage onto disk rzX  on a NetBSD/pmax system, do:
56	disklabel -W /dev/rrzXc
57	gunzip -c diskimage.gz | dd of=/dev/rrzX2c bs=10240
58
59Most other NetBSD ports are similar, but use  rsdXc instead of rrzXc.
60
61On NetBSD/i386, the `raw disk partition' is the 'd' parttion, so do:
62	disklabel -W /dev/rsdXd
63	gunzip -c diskimage.gz | dd of=/dev/rsdXd bs=10240
64
65On NetBSD, be sure to use disklabel -W to enable writing to the label
66area of the disk. If you forget this and/or use the `block' device,
67the dd command will silently fail.
68
69On MS-DOS, use an unzip utlility, then use rawrite.
70
71Then boot using, e.g,
72	>> boot -f rz(0,X,0)netbsd		# 3100
73	>> boot 5/rzX/netbsd 			# 5000/200
74	>> boot 3/rzX/netbsd			# other machines
75
76	(NOTE: replace the X with the unit number of your disk:
77         boot 3/rz2/netbsd to boot drive 2 on a 5000/xxx.)
78
79then continue from ``Once you've booted the diskimage''.
80
81
82
83Installing from Ultrix
84----------------------
85
86The Ultrix bootloader can boot ECOFF-format NetBSD kernels.
87So the technique of dd'ing a disk image into swap, copying
88a kernel to the root, and then booting via the "n" argument
89should work with Ultrix too.  Since Ultrix cannot mount
904.4BSD format FFS filesystems, just dd the diskimage into
91your swap partition, copy a netbsd.ecoff kernel from the FTP site,
92and proceed from step #5 of the `Upgrade via diskimage' above.
93
94Again, be sure to specify the partition where you dd'ed the NetBSD
95diskimage as your root device in step #7!
96
97
98
99Once you've booted the diskimage
100---------------------------
101
102Once you'e booted a diskimage and pointed the kernel at the approriate
103devices to use for root, and dump, NetBSD kernel will prompt you for
104a single-user shell;
105
106	Enter pathname of shell or RETURN for sh:
107
108
109At this point, press the RETURN key.
110then when you get a standalone root prompt, set your terminal type
111
112	TERM=pmax; export TERM;
113
114
115Next, you need to ensure that the root filesystem is writable so that
116sysinst can create temporary files, temporary disklabels, etc.
117If you booted via NFS, the diskless root should already be writable.
118If you booted from disk, type
119
120	mount /dev/rzXY
121
122where X is the disk unit you booted from, and Y is either a or b,
123(e.g., use /dev/rz2a for drive 2 with diskimage in the 'a' partition,
124and rz2b for diskimage in swap.)
125
126
127
128Then, start sysinst.  For the ALPHA release, you should start sysinst
129with an empty release-version string:
130
131	sysinst -r ""
132
133(to stop sysinst automatically inserting the reelase into set names).
134For the BETA or the final relase, just use
135
136	sysinst
137
138Then, choose   'install' or 'upgrade'.
139
140When you've finished the install/upgrade, be sure to edit /etc/rc.conf
141and set "rc_configured" to YES when you are done.  If you're doing an
142upgrade, merge your old etc from /etc.old into /etc.
143
144You're then ready to reboot!
145
146
147
148Post-intallation notes:
149----------------------
150Some of the files in the NetBSD _VER distribution might need to be
151tailored for your site.  In particular, the /etc/sendmail.cf file will
152almost definitely need to be adjusted, and other files in /etc will
153probably need to be modified.  If you are unfamiliar with UN*X-like
154system administration, it's recommended that you buy a book that
155discusses it.
156
157NetBSD/pmax 1.3 uses an X11R5 X server. These servers cannot read the
158compressed fonts which are shipped with standard X11R6 configurations.
159
160If you installed X11 and want to run a local Xserver, you must take
161post-installation steps to make the X11R5 server work that are
162standard for X11R6.3. The distribution file /usr/X11R6/bin/README.pmax
163contains information on how to choose an Xserver and how to access
164compressed fonts via a font server or to decompress the X fonts
165after installation.  Please follow the directions there.
166