head	1.31;
access;
symbols
	netbsd-11-0-RC4:1.31
	netbsd-11-0-RC3:1.31
	netbsd-11-0-RC2:1.31
	netbsd-11-0-RC1:1.31
	perseant-exfatfs-base-20250801:1.31
	netbsd-11:1.31.0.12
	netbsd-11-base:1.31
	netbsd-10-1-RELEASE:1.31
	perseant-exfatfs-base-20240630:1.31
	perseant-exfatfs:1.31.0.10
	perseant-exfatfs-base:1.31
	netbsd-8-3-RELEASE:1.30
	netbsd-9-4-RELEASE:1.30.64.1
	netbsd-10-0-RELEASE:1.31
	netbsd-10-0-RC6:1.31
	netbsd-10-0-RC5:1.31
	netbsd-10-0-RC4:1.31
	netbsd-10-0-RC3:1.31
	netbsd-10-0-RC2:1.31
	netbsd-10-0-RC1:1.31
	netbsd-10:1.31.0.8
	netbsd-10-base:1.31
	netbsd-9-3-RELEASE:1.30.64.1
	cjep_sun2x-base1:1.31
	cjep_sun2x:1.31.0.6
	cjep_sun2x-base:1.31
	cjep_staticlib_x-base1:1.31
	netbsd-9-2-RELEASE:1.30.64.1
	cjep_staticlib_x:1.31.0.4
	cjep_staticlib_x-base:1.31
	netbsd-9-1-RELEASE:1.30.64.1
	phil-wifi-20200421:1.31
	phil-wifi-20200411:1.31
	is-mlppp:1.31.0.2
	is-mlppp-base:1.31
	phil-wifi-20200406:1.31
	netbsd-8-2-RELEASE:1.30
	netbsd-9-0-RELEASE:1.30.64.1
	netbsd-9-0-RC2:1.30.64.1
	netbsd-9-0-RC1:1.30.64.1
	phil-wifi-20191119:1.30
	netbsd-9:1.30.0.64
	netbsd-9-base:1.30
	phil-wifi-20190609:1.30
	netbsd-8-1-RELEASE:1.30
	netbsd-8-1-RC1:1.30
	pgoyette-compat-merge-20190127:1.30
	pgoyette-compat-20190127:1.30
	pgoyette-compat-20190118:1.30
	pgoyette-compat-1226:1.30
	pgoyette-compat-1126:1.30
	pgoyette-compat-1020:1.30
	pgoyette-compat-0930:1.30
	pgoyette-compat-0906:1.30
	netbsd-7-2-RELEASE:1.30
	pgoyette-compat-0728:1.30
	netbsd-8-0-RELEASE:1.30
	phil-wifi:1.30.0.62
	phil-wifi-base:1.30
	pgoyette-compat-0625:1.30
	netbsd-8-0-RC2:1.30
	pgoyette-compat-0521:1.30
	pgoyette-compat-0502:1.30
	pgoyette-compat-0422:1.30
	netbsd-8-0-RC1:1.30
	pgoyette-compat-0415:1.30
	pgoyette-compat-0407:1.30
	pgoyette-compat-0330:1.30
	pgoyette-compat-0322:1.30
	pgoyette-compat-0315:1.30
	netbsd-7-1-2-RELEASE:1.30
	pgoyette-compat:1.30.0.60
	pgoyette-compat-base:1.30
	netbsd-7-1-1-RELEASE:1.30
	matt-nb8-mediatek:1.30.0.58
	matt-nb8-mediatek-base:1.30
	perseant-stdc-iso10646:1.30.0.56
	perseant-stdc-iso10646-base:1.30
	netbsd-8:1.30.0.54
	netbsd-8-base:1.30
	prg-localcount2-base3:1.30
	prg-localcount2-base2:1.30
	prg-localcount2-base1:1.30
	prg-localcount2:1.30.0.52
	prg-localcount2-base:1.30
	pgoyette-localcount-20170426:1.30
	bouyer-socketcan-base1:1.30
	pgoyette-localcount-20170320:1.30
	netbsd-7-1:1.30.0.50
	netbsd-7-1-RELEASE:1.30
	netbsd-7-1-RC2:1.30
	netbsd-7-nhusb-base-20170116:1.30
	bouyer-socketcan:1.30.0.48
	bouyer-socketcan-base:1.30
	pgoyette-localcount-20170107:1.30
	netbsd-7-1-RC1:1.30
	pgoyette-localcount-20161104:1.30
	netbsd-7-0-2-RELEASE:1.30
	localcount-20160914:1.30
	netbsd-7-nhusb:1.30.0.46
	netbsd-7-nhusb-base:1.30
	pgoyette-localcount-20160806:1.30
	pgoyette-localcount-20160726:1.30
	pgoyette-localcount:1.30.0.44
	pgoyette-localcount-base:1.30
	netbsd-7-0-1-RELEASE:1.30
	netbsd-7-0:1.30.0.42
	netbsd-7-0-RELEASE:1.30
	netbsd-7-0-RC3:1.30
	netbsd-7-0-RC2:1.30
	netbsd-7-0-RC1:1.30
	netbsd-5-2-3-RELEASE:1.30
	netbsd-5-1-5-RELEASE:1.30
	netbsd-6-0-6-RELEASE:1.30
	netbsd-6-1-5-RELEASE:1.30
	netbsd-7:1.30.0.40
	netbsd-7-base:1.30
	yamt-pagecache-base9:1.30
	yamt-pagecache-tag8:1.30
	netbsd-6-1-4-RELEASE:1.30
	netbsd-6-0-5-RELEASE:1.30
	tls-earlyentropy:1.30.0.38
	tls-earlyentropy-base:1.30
	riastradh-xf86-video-intel-2-7-1-pre-2-21-15:1.30
	riastradh-drm2-base3:1.30
	netbsd-6-1-3-RELEASE:1.30
	netbsd-6-0-4-RELEASE:1.30
	netbsd-5-2-2-RELEASE:1.30
	netbsd-5-1-4-RELEASE:1.30
	netbsd-6-1-2-RELEASE:1.30
	netbsd-6-0-3-RELEASE:1.30
	netbsd-5-2-1-RELEASE:1.30
	netbsd-5-1-3-RELEASE:1.30
	netbsd-6-1-1-RELEASE:1.30
	riastradh-drm2-base2:1.30
	riastradh-drm2-base1:1.30
	riastradh-drm2:1.30.0.30
	riastradh-drm2-base:1.30
	netbsd-6-1:1.30.0.36
	netbsd-6-0-2-RELEASE:1.30
	netbsd-6-1-RELEASE:1.30
	khorben-n900:1.30.0.34
	netbsd-6-1-RC4:1.30
	netbsd-6-1-RC3:1.30
	agc-symver:1.30.0.32
	agc-symver-base:1.30
	netbsd-6-1-RC2:1.30
	netbsd-6-1-RC1:1.30
	yamt-pagecache-base8:1.30
	netbsd-5-2:1.30.0.28
	netbsd-6-0-1-RELEASE:1.30
	yamt-pagecache-base7:1.30
	netbsd-5-2-RELEASE:1.30
	netbsd-5-2-RC1:1.30
	matt-nb6-plus-nbase:1.30
	yamt-pagecache-base6:1.30
	netbsd-6-0:1.30.0.26
	netbsd-6-0-RELEASE:1.30
	netbsd-6-0-RC2:1.30
	tls-maxphys:1.30.0.24
	tls-maxphys-base:1.30
	matt-nb6-plus:1.30.0.22
	matt-nb6-plus-base:1.30
	netbsd-6-0-RC1:1.30
	yamt-pagecache-base5:1.30
	yamt-pagecache-base4:1.30
	netbsd-6:1.30.0.20
	netbsd-6-base:1.30
	netbsd-5-1-2-RELEASE:1.30
	netbsd-5-1-1-RELEASE:1.30
	yamt-pagecache-base3:1.30
	yamt-pagecache-base2:1.30
	yamt-pagecache:1.30.0.18
	yamt-pagecache-base:1.30
	cherry-xenmp:1.30.0.16
	cherry-xenmp-base:1.30
	bouyer-quota2-nbase:1.30
	bouyer-quota2:1.30.0.14
	bouyer-quota2-base:1.30
	matt-mips64-premerge-20101231:1.30
	matt-nb5-mips64-premerge-20101231:1.30
	matt-nb5-pq3:1.30.0.12
	matt-nb5-pq3-base:1.30
	netbsd-5-1:1.30.0.10
	netbsd-5-1-RELEASE:1.30
	netbsd-5-1-RC4:1.30
	matt-nb5-mips64-k15:1.30
	netbsd-5-1-RC3:1.30
	netbsd-5-1-RC2:1.30
	netbsd-5-1-RC1:1.30
	netbsd-5-0-2-RELEASE:1.30
	matt-nb5-mips64-premerge-20091211:1.30
	matt-premerge-20091211:1.30
	matt-nb5-mips64-u2-k2-k4-k7-k8-k9:1.30
	matt-nb4-mips64-k7-u2a-k9b:1.30
	matt-nb5-mips64-u1-k1-k5:1.30
	matt-nb5-mips64:1.30.0.8
	netbsd-5-0-1-RELEASE:1.30
	jym-xensuspend-nbase:1.30
	netbsd-5-0:1.30.0.6
	netbsd-5-0-RELEASE:1.30
	netbsd-5-0-RC4:1.30
	netbsd-5-0-RC3:1.30
	netbsd-5-0-RC2:1.30
	jym-xensuspend:1.30.0.4
	jym-xensuspend-base:1.30
	netbsd-5-0-RC1:1.30
	netbsd-5:1.30.0.2
	netbsd-5-base:1.30
	matt-mips64-base2:1.30
	matt-mips64:1.27.0.26
	netbsd-4-0-1-RELEASE:1.27.16.1
	wrstuden-revivesa-base-3:1.29
	wrstuden-revivesa-base-2:1.29
	wrstuden-fixsa-newbase:1.27.16.1
	wrstuden-revivesa-base-1:1.29
	yamt-pf42-base4:1.29
	yamt-pf42-base3:1.29
	hpcarm-cleanup-nbase:1.29
	yamt-pf42-baseX:1.28
	yamt-pf42-base2:1.29
	wrstuden-revivesa:1.29.0.2
	wrstuden-revivesa-base:1.29
	yamt-pf42:1.28.0.8
	yamt-pf42-base:1.28
	mjf-devfs2:1.28.0.6
	mjf-devfs2-base:1.30
	keiichi-mipv6:1.28.0.4
	keiichi-mipv6-base:1.28
	mjf-devfs:1.28.0.2
	mjf-devfs-base:1.28
	matt-armv6-nbase:1.28
	matt-armv6-prevmlocking:1.27
	wrstuden-fixsa-base-1:1.27.16.1
	netbsd-4-0:1.27.16.1.0.2
	netbsd-4-0-RELEASE:1.27.16.1
	cube-autoconf:1.27.0.24
	cube-autoconf-base:1.27
	netbsd-4-0-RC5:1.27
	netbsd-4-0-RC4:1.27
	netbsd-4-0-RC3:1.27
	netbsd-4-0-RC2:1.27
	netbsd-4-0-RC1:1.27
	matt-armv6:1.27.0.22
	matt-armv6-base:1.28
	matt-mips64-base:1.27
	hpcarm-cleanup:1.27.0.20
	hpcarm-cleanup-base:1.28
	netbsd-3-1-1-RELEASE:1.27
	netbsd-3-0-3-RELEASE:1.27
	wrstuden-fixsa:1.27.0.18
	wrstuden-fixsa-base:1.27.16.1
	abandoned-netbsd-4-base:1.27
	abandoned-netbsd-4:1.27.0.12
	netbsd-3-1:1.27.0.14
	netbsd-3-1-RELEASE:1.27
	netbsd-3-0-2-RELEASE:1.27
	netbsd-3-1-RC4:1.27
	netbsd-3-1-RC3:1.27
	netbsd-3-1-RC2:1.27
	netbsd-3-1-RC1:1.27
	netbsd-4:1.27.0.16
	netbsd-4-base:1.27
	netbsd-3-0-1-RELEASE:1.27
	netbsd-3-0:1.27.0.10
	netbsd-3-0-RELEASE:1.27
	netbsd-3-0-RC6:1.27
	netbsd-3-0-RC5:1.27
	netbsd-3-0-RC4:1.27
	netbsd-3-0-RC3:1.27
	netbsd-3-0-RC2:1.27
	netbsd-3-0-RC1:1.27
	netbsd-2-0-3-RELEASE:1.27
	netbsd-2-1:1.27.0.8
	netbsd-2-1-RELEASE:1.27
	netbsd-2-1-RC6:1.27
	netbsd-2-1-RC5:1.27
	netbsd-2-1-RC4:1.27
	netbsd-2-1-RC3:1.27
	netbsd-2-1-RC2:1.27
	netbsd-2-1-RC1:1.27
	netbsd-2-0-2-RELEASE:1.27
	netbsd-3:1.27.0.6
	netbsd-3-base:1.27
	netbsd-2-0-1-RELEASE:1.27
	netbsd-2:1.27.0.4
	netbsd-2-base:1.27
	netbsd-2-0-RELEASE:1.27
	netbsd-2-0-RC5:1.27
	netbsd-2-0-RC4:1.27
	netbsd-2-0-RC3:1.27
	netbsd-2-0-RC2:1.27
	netbsd-2-0-RC1:1.27
	netbsd-2-0:1.27.0.2
	netbsd-2-0-base:1.27
	netbsd-1-6-PATCH002-RELEASE:1.24.2.2
	netbsd-1-6-PATCH002:1.24.2.2
	netbsd-1-6-PATCH002-RC4:1.24.2.2
	netbsd-1-6-PATCH002-RC3:1.24.2.2
	netbsd-1-6-PATCH002-RC2:1.24.2.2
	netbsd-1-6-PATCH002-RC1:1.24.2.2
	netbsd-1-6-PATCH001:1.24.2.2
	netbsd-1-6-PATCH001-RELEASE:1.24.2.2
	netbsd-1-6-PATCH001-RC3:1.24.2.2
	netbsd-1-6-PATCH001-RC2:1.24.2.2
	netbsd-1-6-PATCH001-RC1:1.24.2.2
	fvdl_fs64_base:1.26
	netbsd-1-6-RELEASE:1.24.2.2
	netbsd-1-6-RC3:1.24.2.2
	netbsd-1-6-RC2:1.24.2.2
	netbsd-1-6-RC1:1.24.2.2
	netbsd-1-6:1.24.0.2
	netbsd-1-6-base:1.24
	netbsd-1-5-PATCH003:1.21.8.1
	netbsd-1-5-PATCH002:1.21.8.1
	netbsd-1-5-PATCH001:1.21.8.1
	netbsd-1-5-RELEASE:1.21.8.1
	netbsd-1-5-BETA2:1.21.8.1
	netbsd-1-5-BETA:1.21
	netbsd-1-4-PATCH003:1.20.2.1
	netbsd-1-5-ALPHA2:1.21
	netbsd-1-5:1.21.0.8
	netbsd-1-5-base:1.21
	minoura-xpg4dl:1.21.0.6
	minoura-xpg4dl-base:1.21
	netbsd-1-4-PATCH002:1.20.2.1
	wrstuden-devbsize-19991221:1.21
	wrstuden-devbsize:1.21.0.4
	wrstuden-devbsize-base:1.21
	comdex-fall-1999:1.21.0.2
	comdex-fall-1999-base:1.21
	netbsd-1-4-PATCH001:1.20.2.1
	netbsd-1-4-RELEASE:1.20
	netbsd-1-4:1.20.0.2
	netbsd-1-4-base:1.20
	netbsd-1-3-PATCH003:1.8.2.6
	netbsd-1-3-PATCH003-CANDIDATE2:1.8.2.6
	netbsd-1-3-PATCH003-CANDIDATE1:1.8.2.6
	netbsd-1-3-PATCH003-CANDIDATE0:1.8.2.6
	netbsd-1-3-PATCH002:1.8.2.6
	netbsd-1-3-PATCH001:1.8.2.5
	netbsd-1-3-RELEASE:1.8.2.4
	netbsd-1-3-BETA:1.8.2.3
	netbsd-1-3:1.8.0.2
	netbsd-1-3-base:1.8
	netbsd-1-2-PATCH001:1.2.4.2
	netbsd-1-2-RELEASE:1.2
	netbsd-1-2-BETA:1.2
	netbsd-1-2-base:1.2
	netbsd-1-2:1.2.0.4
	netbsd-1-1-PATCH001:1.1.1.1.4.1
	netbsd-1-1-RELEASE:1.1.1.1.4.1
	netbsd-1-1:1.1.1.1.0.4
	netbsd-1-1-base:1.1.1.1
	netbsd-1-0-PATCH06:1.1.1.1
	netbsd-1-0-PATCH05:1.1.1.1
	netbsd-1-0-PATCH04:1.1.1.1
	netbsd-1-0-PATCH03:1.1.1.1
	netbsd-1-0-PATCH02:1.1.1.1
	netbsd-1-0-PATCH1:1.1.1.1
	netbsd-1-0-PATCH0:1.1.1.1
	netbsd-1-0-RELEASE:1.1.1.1
	netbsd-1-0:1.1.1.1.0.2
	netbsd-1-0-base:1.1.1.1
	briggs-1_0:1.1.1.1
	briggs:1.1.1;
locks; strict;
comment	@# @;


1.31
date	2019.11.21.19.23.19;	author martin;	state Exp;
branches;
next	1.30;
commitid	UiYWZno6f1T8KKLB;

1.30
date	2008.09.27.23.15.21;	author tsutsui;	state Exp;
branches
	1.30.62.1
	1.30.64.1;
next	1.29;

1.29
date	2008.04.30.13.10.48;	author martin;	state Exp;
branches;
next	1.28;

1.28
date	2007.12.14.21.15.58;	author pavel;	state Exp;
branches
	1.28.2.1
	1.28.6.1
	1.28.8.1;
next	1.27;

1.27
date	2003.07.26.17.07.06;	author salo;	state Exp;
branches
	1.27.16.1
	1.27.18.1
	1.27.22.1;
next	1.26;

1.26
date	2002.07.19.07.17.51;	author scottr;	state Exp;
branches;
next	1.25;

1.25
date	2002.06.29.23.54.05;	author lukem;	state Exp;
branches;
next	1.24;

1.24
date	2002.04.15.20.57.55;	author gmcgarry;	state Exp;
branches
	1.24.2.1;
next	1.23;

1.23
date	2000.10.29.14.08.07;	author lukem;	state Exp;
branches;
next	1.22;

1.22
date	2000.10.10.12.55.19;	author lukem;	state Exp;
branches;
next	1.21;

1.21
date	99.05.31.06.38.16;	author ender;	state Exp;
branches
	1.21.8.1;
next	1.20;

1.20
date	99.01.13.07.30.06;	author ross;	state Exp;
branches
	1.20.2.1;
next	1.19;

1.19
date	98.08.23.12.42.19;	author hubertf;	state Exp;
branches;
next	1.18;

1.18
date	98.05.19.13.45.01;	author scottr;	state Exp;
branches;
next	1.17;

1.17
date	98.01.12.23.23.38;	author ender;	state Exp;
branches;
next	1.16;

1.16
date	98.01.09.18.46.40;	author perry;	state Exp;
branches;
next	1.15;

1.15
date	97.12.08.01.10.21;	author ender;	state Exp;
branches;
next	1.14;

1.14
date	97.12.07.08.49.43;	author ender;	state Exp;
branches;
next	1.13;

1.13
date	97.12.02.02.05.09;	author ender;	state Exp;
branches;
next	1.12;

1.12
date	97.11.25.17.42.21;	author ender;	state Exp;
branches;
next	1.11;

1.11
date	97.11.25.04.36.38;	author scottr;	state Exp;
branches;
next	1.10;

1.10
date	97.11.24.18.15.15;	author ender;	state Exp;
branches;
next	1.9;

1.9
date	97.11.12.02.16.17;	author ender;	state Exp;
branches;
next	1.8;

1.8
date	97.10.20.00.01.39;	author ender;	state Exp;
branches
	1.8.2.1;
next	1.7;

1.7
date	97.07.25.23.29.42;	author scottr;	state Exp;
branches;
next	1.6;

1.6
date	97.03.03.04.25.39;	author scottr;	state Exp;
branches;
next	1.5;

1.5
date	96.10.10.16.43.47;	author scottr;	state Exp;
branches;
next	1.4;

1.4
date	96.09.26.19.22.43;	author scottr;	state Exp;
branches;
next	1.3;

1.3
date	96.09.24.23.04.43;	author briggs;	state Exp;
branches;
next	1.2;

1.2
date	95.11.28.23.58.20;	author jtc;	state Exp;
branches
	1.2.4.1;
next	1.1;

1.1
date	94.09.18.00.33.40;	author briggs;	state Exp;
branches
	1.1.1.1;
next	;

1.30.62.1
date	2020.04.08.14.03.50;	author martin;	state Exp;
branches;
next	;
commitid	Qli2aW9E74UFuA3C;

1.30.64.1
date	2019.11.21.19.28.40;	author martin;	state Exp;
branches;
next	;
commitid	AxBs2uihE0uNLKLB;

1.28.2.1
date	2007.12.14.21.15.58;	author pavel;	state dead;
branches;
next	1.28.2.2;

1.28.2.2
date	2007.12.14.21.15.59;	author pavel;	state Exp;
branches;
next	;

1.28.6.1
date	2008.06.02.13.21.16;	author mjf;	state Exp;
branches;
next	1.28.6.2;

1.28.6.2
date	2008.09.28.11.09.18;	author mjf;	state Exp;
branches;
next	1.28.6.3;

1.28.6.3
date	2008.10.05.20.10.28;	author mjf;	state dead;
branches;
next	;

1.28.8.1
date	2008.05.18.12.29.37;	author yamt;	state Exp;
branches;
next	;

1.27.16.1
date	2007.12.15.19.34.07;	author bouyer;	state Exp;
branches
	1.27.16.1.2.1;
next	1.27.16.2;

1.27.16.2
date	2008.11.05.20.09.50;	author snj;	state Exp;
branches;
next	;

1.27.16.1.2.1
date	2008.11.05.20.12.19;	author snj;	state Exp;
branches;
next	;

1.27.18.1
date	2008.01.06.05.00.21;	author wrstuden;	state Exp;
branches;
next	;

1.27.22.1
date	2008.01.09.01.28.02;	author matt;	state Exp;
branches;
next	;

1.24.2.1
date	2002.07.02.04.20.10;	author lukem;	state Exp;
branches;
next	1.24.2.2;

1.24.2.2
date	2002.07.20.02.30.48;	author lukem;	state Exp;
branches;
next	;

1.21.8.1
date	2000.11.01.03.48.14;	author tv;	state Exp;
branches;
next	;

1.20.2.1
date	99.06.21.15.24.19;	author perry;	state Exp;
branches;
next	;

1.8.2.1
date	97.11.12.23.56.26;	author mellon;	state Exp;
branches;
next	1.8.2.2;

1.8.2.2
date	97.11.24.23.15.48;	author mellon;	state Exp;
branches;
next	1.8.2.3;

1.8.2.3
date	97.11.26.04.04.42;	author mellon;	state Exp;
branches;
next	1.8.2.4;

1.8.2.4
date	97.12.09.19.39.54;	author thorpej;	state Exp;
branches;
next	1.8.2.5;

1.8.2.5
date	98.01.29.10.14.30;	author mellon;	state Exp;
branches;
next	1.8.2.6;

1.8.2.6
date	98.05.29.04.16.48;	author mycroft;	state Exp;
branches;
next	;

1.2.4.1
date	96.12.06.02.12.59;	author rat;	state Exp;
branches;
next	1.2.4.2;

1.2.4.2
date	97.03.13.00.49.12;	author mycroft;	state Exp;
branches;
next	;

1.1.1.1
date	94.09.18.00.33.41;	author briggs;	state Exp;
branches
	1.1.1.1.2.1
	1.1.1.1.4.1;
next	;

1.1.1.1.2.1
date	94.09.18.00.33.41;	author briggs;	state dead;
branches;
next	1.1.1.1.2.2;

1.1.1.1.2.2
date	94.09.18.00.33.42;	author briggs;	state Exp;
branches;
next	;

1.1.1.1.4.1
date	95.11.21.03.58.12;	author briggs;	state Exp;
branches;
next	;


desc
@@


1.31
log
@Pass the set suffix (either .tgz or .tar.xz) from the makefile.
Document the rescue set.
@
text
@.\"	$NetBSD: install,v 1.30 2008/09/27 23:15:21 tsutsui Exp $
.\"
.\" Copyright (c) 1999, 2000 The NetBSD Foundation, Inc.
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.
.so ../common/sysinst --------------------------------------------
.br_ne 7P
.
.Ss "Installing the NetBSD System (Traditional Method)"
The Traditional method of
installation can be broken down into three basic steps:
.Pp
.(bullet -compact
Run Mkfs to build a file system or file systems.
.It
Run the Installer to load the files onto your file systems.
.It
Run the Booter to boot the system.
.bullet)
.
.Ss2 Preparing the file system(s)
.
Double-click on the Mkfs application icon to start it up. It will ask you
for the SCSI-ID (SCSI target number) of the drive that you are installing
.Nx
on. Once this is
selected, it will present a list of the partitions on that disk. You must
first convert the partitions to a type which
.Nx
can understand. Select
each partition on which you wish to build a file system and click on the
.Ic Change
button. If you are placing the entire installation on a single
partition, select the
.Ic NetBSD Root\*[Am]Usr
radio button. If you are using
multiple partitions, select
.Ic NetBSD Root
for the root partition
.Pq Pa /
and
.Ic NetBSD Usr
for all the other partitions. You should select
.Ic NetBSD Swap
for the swap partition.
.Pp
When you have finished converting each partition, select each partition and
click on the
.Ic Format
button. You will now be asked for a bunch of
parameters for the hard drive and the file system. Usually, you can just
take the defaults. If you are installing onto removable media (e.g. a Zip,
Jaz, or Syquest), please see the FAQ. Note that although this dialog only
has the
.Ic OK
button, you are not committed, yet. Once you get the values
you want, press the
.Ic OK
button. A dialog will be presented at this point
with two options:
.Ic Format
and
.Ic Cancel .
If you choose
.Ic Cancel ,
nothing will be written to your drive. If you choose
.Ic Format ,
the program will
proceed to make a file system.
.Pp
Mkfs is not a well-behaved Macintosh application. It will not allow any
other tasks to run while it does (cooperative multitasking at its best).
When it's finished, the program will put up a dialog to ask if you have
scanned the output for any error messages. Usually there won't have been
any errors, but do scan the output to make sure. Simply click on the
.Ic "I Read It"
button and the program will quit.
.Pp
Repeat as necessary for any extra partitions that you wish to make
file systems on. Note that you do
.Em not
need a file system on your swap partition.
.Pp
When you are finished, click on the
.Ic Done
button and choose
.Ic Quit
from the
.Ic File
menu to exit Mkfs.
.
.Ss2 Installing the files
.
Before using the Installer, it is probably a good idea to increase its
memory allocation. Select the Installer icon by clicking on it and choose
.Ic Get Info
from the File menu. Increase both the Minimum and Preferred
sizes to as much as you can spare.
.Pp
Double-click on the Installer icon to start it up. The Installer will
present the same SCSI-ID menu that Mkfs did. Select the same SCSI-ID
(SCSI target number) that
you did for Mkfs - i.e., the one you are installing
.Nx
on.
.Pp
If you are installing onto a single root partition
.Pq Pa / ,
proceed to the
.Sx Installation\ of\ base\ files
section, below.
.Pp
If you have not created file systems for
.Pa /
(root),
.Pa usr ,
and any other file systems, go back to
.Sx Preparing the file system(s)
above.
.Pp
When you started the Installer, it mounted your root partition
.Pq Pa / .
Just before it printed
.Pp
.Dl "Mounting partition 'A' as /"
.Pp
it printed lines like:
.Pp
.Dl "sd1 at scsi ID 5"
.Pp
This means that the device for SCSI target 5 ("SCSI ID 5") is
.Li sd1 .
The partitions
are signified by a trailing letter. For instance,
.Li sd1a
would be
the root partition
.Pq Pa /
of the second SCSI disk in the chain, and
.Li sd0g
would be the first Usr partition on the first SCSI disk.
.Pp
You will need to know the proper device to mount the remaining
partition(s) by hand:
.(enum -offset indent
Select
.Ic Build Devices
from the
.Ic File
menu.
.It
Select
.Ic Mini Shell
from the
.Ic File
menu.
.It
You can use the
.Ic disklabel
command to get a listing of
the available partitions and their types and sizes.
.It
Create the directory mount point(s) with the command:
.Pp
.Dl # Ic "mkdir path"
.Pp
E.g. for the
.Pa /usr
partition type:
.Pp
.Dl # Ic "mkdir /usr"
.It
Mount the file systems you wish with the command:
.Pp
.Dl # Ic "mount device path"
For example, if you wish to mount a
.Pa /usr
partition from the first SCSI disk
.Li sd0 ,
on
.Pa /usr , No you would type:
.Pp
.Dl # Ic "mount /dev/sd0g /usr"
.It
Type
.Dl # Ic "fstab force"
to create a proper
.Pa /etc/fstab
file.
.It
Type
.Ic quit
after you have mounted all the file systems.
.bullet)
.
.Ss2 Installation of base files
.
Select the
.Ic Install
menu item from the
.Ic File
menu and install
.Pa base.\*[setsuffix] , etc.\*[setsuffix] , either kern-GENERIC.\*[setsuffix] or kern-GENERICSBC.\*[setsuffix] ,
and any other sets you wish to
install	at this time (see the
.Sx NetBSD\ \*V\ Release\ Contents
for information
about what's in each set). The Installer will print out the
filename of each file as it is installed, and will take quite some
time to install everything (the base package alone can take over two
hours on a slow hard drive).
.Pp
As is the case with Mkfs, this is not a particularly well-behaved
Macintosh application and the machine will be completely tied up
while the installation takes place.
.Pp
At some point after installing the base set, select the
.Ic Build Devices
option from the
.Ic File
menu if you have not already done
so. This will create a bunch of device nodes for you and will
create your initial
.Pa /etc/fstab .
The Installer program also has an
option to give you a mini-shell. Do not use this unless you are
sure know what you are doing.
.Pp
When you are finished installing all of the sets you wish to
install, exit the Installer by choosing
.Ic Quit No from the Ic File
.No menu.
.
.Ss2 Booting the system
.
Prior to attempting to boot
.Nx*M ,
please verify that all of
the following are true:
.(enum
32-bit addressing is enabled [2] in the Memory control panel;
.It
All forms of virtual memory are disabled (the Memory control
panel, RAM Doubler, or other software-based memory enhancement
products); and
.It
Your system is in B\*[Am]W mode (1-bit color or grayscale) as shown
by the Monitors control panel. You may choose to have the
Booter do this for you automatically by selecting the appropriate
check box and radio button in the
.Ic Monitors No dialog on the
.Ic Options No menu .
.enum)
.Pp
It is probably best to boot your machine with all extensions turned
off [2]. You can do this by booting into
.Tn Mac OS
with the SHIFT key held
down. You may have to restart your Macintosh for changes to take effect
before proceeding.
.(tag [2]
.It [2]
If your version of the Memory control panel does not have a 32-bit
addressing mode radio button, this means that your system is already
32-bit clean and is running in 32-bit addressing mode by default.  If the
Booter complains that you are not in 32-bit mode, it may be necessary
for you to press the
.Ic Use Defaults
button in the Memory control panel to
restore 32-bit addressing.  You should probably reboot after doing so.
If you have an older II-class system (including the II, IIx, IIcx,
and SE/30), it is necessary to install Connectix's MODE32 to work around
ROM issues which prevent you from enabling 32-bit addressing. Please see the
.Nx*M
FAQ at
.Lk http://www.NetBSD.org/ports/\*M/faq/
for more information.
.tag)
.Pp
Double-click on the
.Nx*M
Booter icon to start the application.
Select
.Ic Booting
from the
.Ic Options
menu. Check that all of the items in
the resulting dialog look sane - especially the SCSI target number.
If not, correct
them to your preference (the SCSI target number, or "SCSI ID",
should be the only thing you need to
change). When you are satisfied with your choices, try booting
.Nx
by selecting
.Ic Boot Now No from the
.Ic Options No menu.
.Pp
If you wish to save your preferences, choose
.Ic Save Options
from the
.Ic File
menu before Booting (your preferences will not be saved if you
forget to do this).
.Pp
If the system does not come up, send mail to
.Mt port-\*M@@NetBSD.org
describing your software, your hardware, and as complete a description of
the problem as you can.
.Pp
If the system does come up, congratulations, you have successfully installed
.Nx \*V .
@


1.30
log
@Use `\*[Am]' rather than `\*&' for ampersand.
@
text
@d1 1
a1 1
.\"	$NetBSD: install,v 1.29 2008/04/30 13:10:48 martin Exp $
d225 1
a225 1
.Pa base.tgz , etc.tgz , either kern-GENERIC.tgz or kern-GENERICSBC.tgz ,
@


1.30.62.1
log
@Merge changes from current as of 20200406
@
text
@d1 1
a1 1
.\"	$NetBSD$
d225 1
a225 1
.Pa base.\*[setsuffix] , etc.\*[setsuffix] , either kern-GENERIC.\*[setsuffix] or kern-GENERICSBC.\*[setsuffix] ,
@


1.30.64.1
log
@Pull up the following revisions:

	distrib/notes/Makefile.inc			1.44
	distrib/notes/acorn32/contents			1.5
	distrib/notes/alpha/contents			1.19
	distrib/notes/amd64/contents			1.8
	distrib/notes/amiga/contents			1.23
	distrib/notes/amiga/install			1.37
	distrib/notes/arc/contents			1.5
	distrib/notes/atari/contents			1.23
	distrib/notes/atari/xfer			1.18
	distrib/notes/bebox/contents			1.5
	distrib/notes/cats/contents			1.5
	distrib/notes/common/contents			1.179
	distrib/notes/common/legal.common		1.99
	distrib/notes/common/main			1.552
	distrib/notes/common/main			1.553
	distrib/notes/common/netboot			1.37
	distrib/notes/common/postinstall		1.84
	distrib/notes/common/sysinst			1.108
	distrib/notes/common/xfer			1.76
	distrib/notes/emips/contents			1.5
	distrib/notes/emips/install			1.3
	distrib/notes/evbarm/contents			1.5
	distrib/notes/evbarm/install			1.10
	distrib/notes/evbppc/contents			1.6
	distrib/notes/ews4800mips/contents		1.5
	distrib/notes/hp300/contents			1.20
	distrib/notes/hp300/upgrade			1.20
	distrib/notes/hpcarm/contents			1.6
	distrib/notes/hpcmips/contents			1.13
	distrib/notes/hpcsh/contents			1.6
	distrib/notes/hppa/contents			1.5
	distrib/notes/i386/contents			1.32
	distrib/notes/landisk/contents			1.6
	distrib/notes/mac68k/contents			1.23
	distrib/notes/mac68k/install			1.31
	distrib/notes/mac68k/prep			1.18
	distrib/notes/mac68k/xfer			1.21
	distrib/notes/macppc/contents			1.17
	distrib/notes/macppc/install			1.42
	distrib/notes/mmeye/contents			1.6
	distrib/notes/mvme68k/contents			1.16
	distrib/notes/mvme68k/xfer			1.20
	distrib/notes/news68k/contents			1.9
	distrib/notes/newsmips/contents			1.5
	distrib/notes/next68k/contents			1.10
	distrib/notes/ofppc/contents			1.6
	distrib/notes/pmax/contents			1.20
	distrib/notes/pmax/install			1.43
	distrib/notes/prep/contents			1.5
	distrib/notes/rs6000/contents			1.5
	distrib/notes/sandpoint/contents		1.5
	distrib/notes/sgimips/contents			1.5
	distrib/notes/sgimips/install			1.11
	distrib/notes/shark/contents			1.5
	distrib/notes/shark/install			1.6
	distrib/notes/sparc/contents			1.24
	distrib/notes/sparc/install			1.59
	distrib/notes/sparc64/contents			1.8
	distrib/notes/sun2/contents			1.5
	distrib/notes/sun3/contents			1.19
	distrib/notes/sun3/upgrade			1.15
	distrib/notes/vax/contents			1.14
	distrib/notes/vax/xfer				1.15
	distrib/notes/x68k/contents			1.20

Add missing .bullet) and replace some versions (more todo later)
Pass the set suffix (either .tgz or .tar.xz) from the makefile.
Document the rescue set.
@
text
@d1 1
a1 1
.\"	$NetBSD: install,v 1.30 2008/09/27 23:15:21 tsutsui Exp $
d225 1
a225 1
.Pa base.\*[setsuffix] , etc.\*[setsuffix] , either kern-GENERIC.\*[setsuffix] or kern-GENERICSBC.\*[setsuffix] ,
@


1.29
log
@Convert TNF licenses to new 2 clause variant
@
text
@d1 1
a1 1
.\"	$NetBSD: install,v 1.28 2007/12/14 21:15:58 pavel Exp $
d57 1
a57 1
.Ic NetBSD Root\*&Usr
d269 1
a269 1
Your system is in B\*&W mode (1-bit color or grayscale) as shown
@


1.28
log
@Update URLs after website reorganization. patch by OKANO Takayoshi, from
PR 37070.
@
text
@d1 1
a1 1
.\"	$NetBSD: install,v 1.27 2003/07/26 17:07:06 salo Exp $
a13 7
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"        This product includes software developed by the NetBSD
.\"        Foundation, Inc. and its contributors.
.\" 4. Neither the name of The NetBSD Foundation nor the names of its
.\"    contributors may be used to endorse or promote products derived
.\"    from this software without specific prior written permission.
@


1.28.2.1
log
@file install was added on branch mjf-devfs on 2007-12-14 21:15:59 +0000
@
text
@d1 340
@


1.28.2.2
log
@Update URLs after website reorganization. patch by OKANO Takayoshi, from
PR 37070.
@
text
@a0 340
.\"	$NetBSD: install,v 1.28 2007/12/14 21:15:58 pavel Exp $
.\"
.\" Copyright (c) 1999, 2000 The NetBSD Foundation, Inc.
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"        This product includes software developed by the NetBSD
.\"        Foundation, Inc. and its contributors.
.\" 4. Neither the name of The NetBSD Foundation nor the names of its
.\"    contributors may be used to endorse or promote products derived
.\"    from this software without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.
.so ../common/sysinst --------------------------------------------
.br_ne 7P
.
.Ss "Installing the NetBSD System (Traditional Method)"
The Traditional method of
installation can be broken down into three basic steps:
.Pp
.(bullet -compact
Run Mkfs to build a file system or file systems.
.It
Run the Installer to load the files onto your file systems.
.It
Run the Booter to boot the system.
.bullet)
.
.Ss2 Preparing the file system(s)
.
Double-click on the Mkfs application icon to start it up. It will ask you
for the SCSI-ID (SCSI target number) of the drive that you are installing
.Nx
on. Once this is
selected, it will present a list of the partitions on that disk. You must
first convert the partitions to a type which
.Nx
can understand. Select
each partition on which you wish to build a file system and click on the
.Ic Change
button. If you are placing the entire installation on a single
partition, select the
.Ic NetBSD Root\*&Usr
radio button. If you are using
multiple partitions, select
.Ic NetBSD Root
for the root partition
.Pq Pa /
and
.Ic NetBSD Usr
for all the other partitions. You should select
.Ic NetBSD Swap
for the swap partition.
.Pp
When you have finished converting each partition, select each partition and
click on the
.Ic Format
button. You will now be asked for a bunch of
parameters for the hard drive and the file system. Usually, you can just
take the defaults. If you are installing onto removable media (e.g. a Zip,
Jaz, or Syquest), please see the FAQ. Note that although this dialog only
has the
.Ic OK
button, you are not committed, yet. Once you get the values
you want, press the
.Ic OK
button. A dialog will be presented at this point
with two options:
.Ic Format
and
.Ic Cancel .
If you choose
.Ic Cancel ,
nothing will be written to your drive. If you choose
.Ic Format ,
the program will
proceed to make a file system.
.Pp
Mkfs is not a well-behaved Macintosh application. It will not allow any
other tasks to run while it does (cooperative multitasking at its best).
When it's finished, the program will put up a dialog to ask if you have
scanned the output for any error messages. Usually there won't have been
any errors, but do scan the output to make sure. Simply click on the
.Ic "I Read It"
button and the program will quit.
.Pp
Repeat as necessary for any extra partitions that you wish to make
file systems on. Note that you do
.Em not
need a file system on your swap partition.
.Pp
When you are finished, click on the
.Ic Done
button and choose
.Ic Quit
from the
.Ic File
menu to exit Mkfs.
.
.Ss2 Installing the files
.
Before using the Installer, it is probably a good idea to increase its
memory allocation. Select the Installer icon by clicking on it and choose
.Ic Get Info
from the File menu. Increase both the Minimum and Preferred
sizes to as much as you can spare.
.Pp
Double-click on the Installer icon to start it up. The Installer will
present the same SCSI-ID menu that Mkfs did. Select the same SCSI-ID
(SCSI target number) that
you did for Mkfs - i.e., the one you are installing
.Nx
on.
.Pp
If you are installing onto a single root partition
.Pq Pa / ,
proceed to the
.Sx Installation\ of\ base\ files
section, below.
.Pp
If you have not created file systems for
.Pa /
(root),
.Pa usr ,
and any other file systems, go back to
.Sx Preparing the file system(s)
above.
.Pp
When you started the Installer, it mounted your root partition
.Pq Pa / .
Just before it printed
.Pp
.Dl "Mounting partition 'A' as /"
.Pp
it printed lines like:
.Pp
.Dl "sd1 at scsi ID 5"
.Pp
This means that the device for SCSI target 5 ("SCSI ID 5") is
.Li sd1 .
The partitions
are signified by a trailing letter. For instance,
.Li sd1a
would be
the root partition
.Pq Pa /
of the second SCSI disk in the chain, and
.Li sd0g
would be the first Usr partition on the first SCSI disk.
.Pp
You will need to know the proper device to mount the remaining
partition(s) by hand:
.(enum -offset indent
Select
.Ic Build Devices
from the
.Ic File
menu.
.It
Select
.Ic Mini Shell
from the
.Ic File
menu.
.It
You can use the
.Ic disklabel
command to get a listing of
the available partitions and their types and sizes.
.It
Create the directory mount point(s) with the command:
.Pp
.Dl # Ic "mkdir path"
.Pp
E.g. for the
.Pa /usr
partition type:
.Pp
.Dl # Ic "mkdir /usr"
.It
Mount the file systems you wish with the command:
.Pp
.Dl # Ic "mount device path"
For example, if you wish to mount a
.Pa /usr
partition from the first SCSI disk
.Li sd0 ,
on
.Pa /usr , No you would type:
.Pp
.Dl # Ic "mount /dev/sd0g /usr"
.It
Type
.Dl # Ic "fstab force"
to create a proper
.Pa /etc/fstab
file.
.It
Type
.Ic quit
after you have mounted all the file systems.
.bullet)
.
.Ss2 Installation of base files
.
Select the
.Ic Install
menu item from the
.Ic File
menu and install
.Pa base.tgz , etc.tgz , either kern-GENERIC.tgz or kern-GENERICSBC.tgz ,
and any other sets you wish to
install	at this time (see the
.Sx NetBSD\ \*V\ Release\ Contents
for information
about what's in each set). The Installer will print out the
filename of each file as it is installed, and will take quite some
time to install everything (the base package alone can take over two
hours on a slow hard drive).
.Pp
As is the case with Mkfs, this is not a particularly well-behaved
Macintosh application and the machine will be completely tied up
while the installation takes place.
.Pp
At some point after installing the base set, select the
.Ic Build Devices
option from the
.Ic File
menu if you have not already done
so. This will create a bunch of device nodes for you and will
create your initial
.Pa /etc/fstab .
The Installer program also has an
option to give you a mini-shell. Do not use this unless you are
sure know what you are doing.
.Pp
When you are finished installing all of the sets you wish to
install, exit the Installer by choosing
.Ic Quit No from the Ic File
.No menu.
.
.Ss2 Booting the system
.
Prior to attempting to boot
.Nx*M ,
please verify that all of
the following are true:
.(enum
32-bit addressing is enabled [2] in the Memory control panel;
.It
All forms of virtual memory are disabled (the Memory control
panel, RAM Doubler, or other software-based memory enhancement
products); and
.It
Your system is in B\*&W mode (1-bit color or grayscale) as shown
by the Monitors control panel. You may choose to have the
Booter do this for you automatically by selecting the appropriate
check box and radio button in the
.Ic Monitors No dialog on the
.Ic Options No menu .
.enum)
.Pp
It is probably best to boot your machine with all extensions turned
off [2]. You can do this by booting into
.Tn Mac OS
with the SHIFT key held
down. You may have to restart your Macintosh for changes to take effect
before proceeding.
.(tag [2]
.It [2]
If your version of the Memory control panel does not have a 32-bit
addressing mode radio button, this means that your system is already
32-bit clean and is running in 32-bit addressing mode by default.  If the
Booter complains that you are not in 32-bit mode, it may be necessary
for you to press the
.Ic Use Defaults
button in the Memory control panel to
restore 32-bit addressing.  You should probably reboot after doing so.
If you have an older II-class system (including the II, IIx, IIcx,
and SE/30), it is necessary to install Connectix's MODE32 to work around
ROM issues which prevent you from enabling 32-bit addressing. Please see the
.Nx*M
FAQ at
.Lk http://www.NetBSD.org/ports/\*M/faq/
for more information.
.tag)
.Pp
Double-click on the
.Nx*M
Booter icon to start the application.
Select
.Ic Booting
from the
.Ic Options
menu. Check that all of the items in
the resulting dialog look sane - especially the SCSI target number.
If not, correct
them to your preference (the SCSI target number, or "SCSI ID",
should be the only thing you need to
change). When you are satisfied with your choices, try booting
.Nx
by selecting
.Ic Boot Now No from the
.Ic Options No menu.
.Pp
If you wish to save your preferences, choose
.Ic Save Options
from the
.Ic File
menu before Booting (your preferences will not be saved if you
forget to do this).
.Pp
If the system does not come up, send mail to
.Mt port-\*M@@NetBSD.org
describing your software, your hardware, and as complete a description of
the problem as you can.
.Pp
If the system does come up, congratulations, you have successfully installed
.Nx \*V .
@


1.28.6.1
log
@Sync with HEAD.
@
text
@d1 1
a1 1
.\"	$NetBSD$
d14 7
@


1.28.6.2
log
@Sync with HEAD.
@
text
@d57 1
a57 1
.Ic NetBSD Root\*[Am]Usr
d269 1
a269 1
Your system is in B\*[Am]W mode (1-bit color or grayscale) as shown
@


1.28.6.3
log
@Sync with HEAD.
@
text
@d1 1
a1 1
.\"	$NetBSD: install,v 1.28.6.2 2008/09/28 11:09:18 mjf Exp $
@


1.28.8.1
log
@sync with head.
@
text
@d1 1
a1 1
.\"	$NetBSD: install,v 1.28 2007/12/14 21:15:58 pavel Exp $
d14 7
@


1.27
log
@netbsd.org->NetBSD.org
@
text
@d1 1
a1 1
.\"	$NetBSD: install,v 1.26 2002/07/19 07:17:51 scottr Exp $
d305 1
a305 1
.Lk http://www.NetBSD.org/Ports/\*M/faq/
@


1.27.22.1
log
@sync with HEAD
@
text
@d1 1
a1 1
.\"	$NetBSD$
d305 1
a305 1
.Lk http://www.NetBSD.org/ports/\*M/faq/
@


1.27.18.1
log
@Catch up to netbsd-4.0 release.
@
text
@d1 1
a1 1
.\"	$NetBSD: install,v 1.27.16.1 2007/12/15 19:34:07 bouyer Exp $
d305 1
a305 1
.Lk http://www.NetBSD.org/ports/\*M/faq/
@


1.27.16.1
log
@Pull up following revisions (requested by jnemeth in ticket #1017):
	distrib/notes/common/contents			patch
	distrib/notes/common/list-setsizes.sh		patch
	distrib/notes/pmppc/hardware			patch
	distrib/notes/Makefile.inc			1.39, 1.40
	distrib/notes/acorn32/prep.RISCOS		1.18
	distrib/notes/alpha/install			1.32
	distrib/notes/common/main			1.367, 1.368, 1.370 - 1.382
	distrib/notes/common/netboot			1.31
	distrib/notes/common/postinstall		1.64, 1.65
	distrib/notes/common/sysinst			1.82, 1.83
	distrib/notes/common/xfer			1.58 - 1.60
	distrib/notes/evbppc/hardware			1.3
	distrib/notes/ews4800mips/hardware		1.2
	distrib/notes/hp300/hardware			1.19
	distrib/notes/hp300/prep			1.21
	distrib/notes/hp700/hardware			1.3
	distrib/notes/i386/hardware			1.121
	distrib/notes/i386/whatis			1.22
	distrib/notes/mac68k/hardware			1.23
	distrib/notes/mac68k/install			1.28
	distrib/notes/macppc/hardware			1.44
	distrib/notes/macppc/install			1.36
	distrib/notes/macppc/prep			1.42
	distrib/notes/macppc/prep.OPENFIRMWARE 		1.9
	distrib/notes/news68k/hardware			1.5
	distrib/notes/newsmips/hardware			1.4
	distrib/notes/next68k/hardware			1.8
	distrib/notes/pmax/install			1.39
	distrib/notes/sandpoint/hardware		1.6
	distrib/notes/sparc/hardware			1.33
	distrib/notes/sparc64/hardware			1.23
	distrib/notes/sparc64/install			1.28
	distrib/notes/vax/xfer				1.13
Sync release notes with reality
@
text
@d1 1
a1 1
.\"	$NetBSD$
d305 1
a305 1
.Lk http://www.NetBSD.org/ports/\*M/faq/
@


1.27.16.1.2.1
log
@Pull up following revision(s) (requested by tsutsui in ticket #1219):
	distrib/notes/common/main: revision 1.421
	distrib/notes/mac68k/install: revision 1.30
	distrib/notes/common/sysinst: revision 1.95
	distrib/notes/i386/hardware: revision 1.124
Use `\*[Am]' rather than `\*&' for ampersand.
@
text
@d1 1
a1 1
.\"	$NetBSD: install,v 1.27.16.1 2007/12/15 19:34:07 bouyer Exp $
d64 1
a64 1
.Ic NetBSD Root\*[Am]Usr
d276 1
a276 1
Your system is in B\*[Am]W mode (1-bit color or grayscale) as shown
@


1.27.16.2
log
@Pull up following revision(s) (requested by tsutsui in ticket #1219):
	distrib/notes/common/main: revision 1.421
	distrib/notes/mac68k/install: revision 1.30
	distrib/notes/common/sysinst: revision 1.95
	distrib/notes/i386/hardware: revision 1.124
Use `\*[Am]' rather than `\*&' for ampersand.
@
text
@d1 1
a1 1
.\"	$NetBSD: install,v 1.27.16.1 2007/12/15 19:34:07 bouyer Exp $
d64 1
a64 1
.Ic NetBSD Root\*[Am]Usr
d276 1
a276 1
Your system is in B\*[Am]W mode (1-bit color or grayscale) as shown
@


1.26
log
@This is a complete refit of the mac68k documentation.

Of particular note is documentation on the new preferred method of
installation using sysinst, provided (and updated) by Bob Nestor.
@
text
@d1 1
a1 1
.\"	$NetBSD: install,v 1.24 2002/04/15 20:57:55 gmcgarry Exp $
d305 1
a305 1
.Lk http://www.netbsd.org/Ports/\*M/faq/
d335 1
a335 1
.Mt port-\*M@@netbsd.org
@


1.25
log
@clean up whitespace and formatting
@
text
@d3 1
a3 1
.\" Copyright (c) 1999-2002 The NetBSD Foundation, Inc.
d34 7
a40 1
The installation can be broken down into three basic steps:
d52 6
a57 4
Double-click on the Mkfs application icon to start it up.
It will ask you for the SCSI-ID of the drive that you are installing upon.
Once this is selected, it will present a list of the partitions on that disk.
You must first convert the partitions to a type which
d59 9
a67 9
can understand.
Select each partition on which you wish to build a file system and click on the
.Dq Change
button.
If you are placing the entire installation on a single partition, select the
.Dq NetBSD Root\*&Usr
radio button.
If you are using multiple partitions, select
.Dq NetBSD Root
d71 3
a73 4
.Dq NetBSD Usr
for all the other partitions.
You should select
.Dq NetBSD Swap
d78 13
a90 15
.Dq Format
button.
You will now be asked for a bunch of
parameters for the hard drive and the file system.
Usually, you can just take the defaults.
If you are installing onto removable media (e.g. a Zip, Jaz, or Syquest),
please see the FAQ.
Note that although this dialog only has the
.Dq OK
button, you are not committed, yet.
Once you get the values you want, press the
.Dq OK
button.
A dialog will be presented at this point with two options:
.Dq Format
d92 1
a92 1
.Dq Cancel .
d94 3
a96 4
.Dq Cancel ,
nothing will be written to your drive.
If you choose
.Dq Format ,
d100 2
a101 3
Mkfs is not a well-behaved Macintosh application.
It will not allow any other tasks to run while it does
(cooperative multitasking at its best).
d103 3
a105 4
scanned the output for any error messages.
Usually there won't have been any errors, but do scan the output to make sure.
Simply click on the
.Dq "I Read It"
d109 1
a109 2
file systems on.
Note that you do
d114 1
a114 1
.Dq Done
d116 1
a116 1
.Dq Quit
d118 1
a118 1
.Dq File
d124 11
a134 11
memory allocation.
Select the Installer icon by clicking on it and choose
.Dq Get Info
from the File menu.
Increase both the Minimum and Preferred sizes to as much as you can spare.
.Pp
Double-click on the Installer icon to start it up.
The Installer will
present the same SCSI-ID menu that Mkfs did.
Select the same SCSI-ID that you did for Mkfs \(em
i.e., the one you are installing onto.
d152 1
a152 1
Just before it printed,
d154 1
a154 1
.Dl "Mounting partition 'A' as / ",
d158 1
a158 1
.Dl "sd1 at scsi ID 5" .
d160 1
a160 1
This means that the device for SCSI-ID 5 is
d163 1
a163 2
are signified by a trailing letter.
For instance,
d176 1
a176 1
.Dq Build Devices
d178 1
a178 1
.Dq File
d182 1
a182 1
.Dq Mini Shell
d184 1
a184 1
.Dq File
d232 1
a232 1
.Pa base.tgz , etc.tgz , netbsd.tgz ,
d234 4
a237 3
install	at this time.
(See the contents section for information about what's in each set.)
The Installer will print out the
d239 2
a240 2
time to install everything (the base package alone can take over an
hour on a slow hard drive).
d250 2
a251 2
menu if you have not already done so.
This will create a bunch of device nodes for you and will
d255 2
a256 2
option to give you a mini-shell.
Do not use this unless you are sure know what you are doing.
d270 1
a270 1
32-bit addressing is enabled [1] in the Memory control panel;
d277 3
a279 3
by the Monitors control panel.
You may choose to have the Booter do this for you automatically by
selecting the appropriate check box and radio button in the
d285 4
a288 7
off [1].
You can do this by booting into
.Tn MacOS
with the
.Key SHIFT
key held down.
You may have to restart your Macintosh for changes to take effect
d290 2
a291 2
.(tag [1]
.It [1]
d294 6
a299 6
32-bit clean and is running in 32-bit addressing mode by default.
If the Booter complains that you are not in 32-bit mode,
it may be necessary for you to press the
.Dq Use Defaults
button in the Memory control panel to restore 32-bit addressing.
You should probably reboot after doing so.
d302 4
a305 5
ROM issues which prevent you from enabling 32-bit addressing.
Please see
.if !dHTML .br
.Lk http://www.netbsd.org/Ports/\*M/faq/ the\ FAQ
.if !dHTML .br
d316 6
a321 6
menu.
Check that all of the items in the resulting dialog look sane \(em
especially the SCSI-ID.
If not, correct them to your preference
(the SCSI-ID should be the only thing you need to change).
When you are satisfied with your choices, try booting
@


1.24
log
@typo
@
text
@d1 1
a1 1
.\"	$NetBSD: install,v 1.23 2000/10/29 14:08:07 lukem Exp $
d3 1
a3 1
.\" Copyright (c) 1999, 2000 The NetBSD Foundation, Inc.
d46 4
a49 4
Double-click on the Mkfs application icon to start it up. It will ask you
for the SCSI-ID of the drive that you are installing upon. Once this is
selected, it will present a list of the partitions on that disk. You must
first convert the partitions to a type which
d51 2
a52 2
can understand. Select
each partition on which you wish to build a file system and click on the
d54 2
a55 2
button. If you are placing the entire installation on a single
partition, select the
d57 2
a58 2
radio button. If you are using
multiple partitions, select
d64 2
a65 1
for all the other partitions. You should select
d72 7
a78 5
button. You will now be asked for a bunch of
parameters for the hard drive and the file system. Usually, you can just
take the defaults. If you are installing onto removable media (e.g. a Zip,
Jaz, or Syquest), please see the FAQ. Note that although this dialog only
has the
d80 2
a81 2
button, you are not committed, yet. Once you get the values
you want, press the
d83 2
a84 2
button. A dialog will be presented at this point
with two options:
d90 2
a91 1
nothing will be written to your drive. If you choose
d96 3
a98 2
Mkfs is not a well-behaved Macintosh application. It will not allow any
other tasks to run while it does (cooperative multitasking at its best).
d100 3
a102 2
scanned the output for any error messages. Usually there won't have been
any errors, but do scan the output to make sure. Simply click on the
d107 2
a108 1
file systems on. Note that you do
d123 2
a124 1
memory allocation. Select the Installer icon by clicking on it and choose
d126 2
a127 2
from the File menu. Increase both the Minimum and Preferred
sizes to as much as you can spare.
d129 5
a133 3
Double-click on the Installer icon to start it up. The Installer will
present the same SCSI-ID menu that Mkfs did. Select the same SCSI-ID that
you did for Mkfs - i.e., the one you are installing onto.
d162 2
a163 1
are signified by a trailing letter. For instance,
d234 3
a236 2
install	at this time. (See the contents section for information
about what's in each set.) The Installer will print out the
d249 2
a250 2
menu if you have not already done
so. This will create a bunch of device nodes for you and will
d254 2
a255 2
option to give you a mini-shell. Do not use this unless you are
sure know what you are doing.
d276 3
a278 3
by the Monitors control panel. You may choose to have the
Booter do this for you automatically by selecting the appropriate
check box and radio button in the
d284 2
a285 1
off [1]. You can do this by booting into
d287 4
a290 2
with the SHIFT key held
down. You may have to restart your Macintosh for changes to take effect
d296 3
a298 3
32-bit clean and is running in 32-bit addressing mode by default.  If the
Booter complains that you are not in 32-bit mode, it may be necessary
for you to press the
d300 2
a301 2
button in the Memory control panel to
restore 32-bit addressing.  You should probably reboot after doing so.
d304 2
a305 1
ROM issues which prevent you from enabling 32-bit addressing. Please see
d319 6
a324 4
menu. Check that all of the items in
the resulting dialog look sane - especially the SCSI-ID. If not, correct
them to your preference (the SCSI-ID should be the only thing you need to
change). When you are satisfied with your choices, try booting
@


1.24.2.1
log
@manually sync distrib/notes/** to -current, excluding pmppc (which isn't in 1.6)
@
text
@d1 1
a1 1
.\"	$NetBSD: install,v 1.25 2002/06/29 23:54:05 lukem Exp $
d3 1
a3 1
.\" Copyright (c) 1999-2002 The NetBSD Foundation, Inc.
d46 4
a49 4
Double-click on the Mkfs application icon to start it up.
It will ask you for the SCSI-ID of the drive that you are installing upon.
Once this is selected, it will present a list of the partitions on that disk.
You must first convert the partitions to a type which
d51 2
a52 2
can understand.
Select each partition on which you wish to build a file system and click on the
d54 2
a55 2
button.
If you are placing the entire installation on a single partition, select the
d57 2
a58 2
radio button.
If you are using multiple partitions, select
d64 1
a64 2
for all the other partitions.
You should select
d71 5
a75 7
button.
You will now be asked for a bunch of
parameters for the hard drive and the file system.
Usually, you can just take the defaults.
If you are installing onto removable media (e.g. a Zip, Jaz, or Syquest),
please see the FAQ.
Note that although this dialog only has the
d77 2
a78 2
button, you are not committed, yet.
Once you get the values you want, press the
d80 2
a81 2
button.
A dialog will be presented at this point with two options:
d87 1
a87 2
nothing will be written to your drive.
If you choose
d92 2
a93 3
Mkfs is not a well-behaved Macintosh application.
It will not allow any other tasks to run while it does
(cooperative multitasking at its best).
d95 2
a96 3
scanned the output for any error messages.
Usually there won't have been any errors, but do scan the output to make sure.
Simply click on the
d101 1
a101 2
file systems on.
Note that you do
d116 1
a116 2
memory allocation.
Select the Installer icon by clicking on it and choose
d118 2
a119 2
from the File menu.
Increase both the Minimum and Preferred sizes to as much as you can spare.
d121 3
a123 5
Double-click on the Installer icon to start it up.
The Installer will
present the same SCSI-ID menu that Mkfs did.
Select the same SCSI-ID that you did for Mkfs \(em
i.e., the one you are installing onto.
d152 1
a152 2
are signified by a trailing letter.
For instance,
d223 2
a224 3
install	at this time.
(See the contents section for information about what's in each set.)
The Installer will print out the
d237 2
a238 2
menu if you have not already done so.
This will create a bunch of device nodes for you and will
d242 2
a243 2
option to give you a mini-shell.
Do not use this unless you are sure know what you are doing.
d264 3
a266 3
by the Monitors control panel.
You may choose to have the Booter do this for you automatically by
selecting the appropriate check box and radio button in the
d272 1
a272 2
off [1].
You can do this by booting into
d274 2
a275 4
with the
.Key SHIFT
key held down.
You may have to restart your Macintosh for changes to take effect
d281 3
a283 3
32-bit clean and is running in 32-bit addressing mode by default.
If the Booter complains that you are not in 32-bit mode,
it may be necessary for you to press the
d285 2
a286 2
button in the Memory control panel to restore 32-bit addressing.
You should probably reboot after doing so.
d289 1
a289 2
ROM issues which prevent you from enabling 32-bit addressing.
Please see
d303 4
a306 6
menu.
Check that all of the items in the resulting dialog look sane \(em
especially the SCSI-ID.
If not, correct them to your preference
(the SCSI-ID should be the only thing you need to change).
When you are satisfied with your choices, try booting
@


1.24.2.2
log
@Pull up revision 1.26 (requested by scottr in ticket #525):
This is a complete refit of the mac68k documentation.
Of particular note is documentation on the new preferred method of
installation using sysinst, provided (and updated) by Bob Nestor.
@
text
@d1 1
a1 1
.\"	$NetBSD$
d3 1
a3 1
.\" Copyright (c) 1999, 2000 The NetBSD Foundation, Inc.
d34 1
a34 7
.
.so ../common/sysinst --------------------------------------------
.br_ne 7P
.
.Ss "Installing the NetBSD System (Traditional Method)"
The Traditional method of
installation can be broken down into three basic steps:
d46 4
a49 6
Double-click on the Mkfs application icon to start it up. It will ask you
for the SCSI-ID (SCSI target number) of the drive that you are installing
.Nx
on. Once this is
selected, it will present a list of the partitions on that disk. You must
first convert the partitions to a type which
d51 9
a59 9
can understand. Select
each partition on which you wish to build a file system and click on the
.Ic Change
button. If you are placing the entire installation on a single
partition, select the
.Ic NetBSD Root\*&Usr
radio button. If you are using
multiple partitions, select
.Ic NetBSD Root
d63 4
a66 3
.Ic NetBSD Usr
for all the other partitions. You should select
.Ic NetBSD Swap
d71 15
a85 13
.Ic Format
button. You will now be asked for a bunch of
parameters for the hard drive and the file system. Usually, you can just
take the defaults. If you are installing onto removable media (e.g. a Zip,
Jaz, or Syquest), please see the FAQ. Note that although this dialog only
has the
.Ic OK
button, you are not committed, yet. Once you get the values
you want, press the
.Ic OK
button. A dialog will be presented at this point
with two options:
.Ic Format
d87 1
a87 1
.Ic Cancel .
d89 4
a92 3
.Ic Cancel ,
nothing will be written to your drive. If you choose
.Ic Format ,
d96 3
a98 2
Mkfs is not a well-behaved Macintosh application. It will not allow any
other tasks to run while it does (cooperative multitasking at its best).
d100 4
a103 3
scanned the output for any error messages. Usually there won't have been
any errors, but do scan the output to make sure. Simply click on the
.Ic "I Read It"
d107 2
a108 1
file systems on. Note that you do
d113 1
a113 1
.Ic Done
d115 1
a115 1
.Ic Quit
d117 1
a117 1
.Ic File
d123 11
a133 11
memory allocation. Select the Installer icon by clicking on it and choose
.Ic Get Info
from the File menu. Increase both the Minimum and Preferred
sizes to as much as you can spare.
.Pp
Double-click on the Installer icon to start it up. The Installer will
present the same SCSI-ID menu that Mkfs did. Select the same SCSI-ID
(SCSI target number) that
you did for Mkfs - i.e., the one you are installing
.Nx
on.
d151 1
a151 1
Just before it printed
d153 1
a153 1
.Dl "Mounting partition 'A' as /"
d157 1
a157 1
.Dl "sd1 at scsi ID 5"
d159 1
a159 1
This means that the device for SCSI target 5 ("SCSI ID 5") is
d162 2
a163 1
are signified by a trailing letter. For instance,
d176 1
a176 1
.Ic Build Devices
d178 1
a178 1
.Ic File
d182 1
a182 1
.Ic Mini Shell
d184 1
a184 1
.Ic File
d232 1
a232 1
.Pa base.tgz , etc.tgz , either kern-GENERIC.tgz or kern-GENERICSBC.tgz ,
d234 3
a236 4
install	at this time (see the
.Sx NetBSD\ \*V\ Release\ Contents
for information
about what's in each set). The Installer will print out the
d238 2
a239 2
time to install everything (the base package alone can take over two
hours on a slow hard drive).
d249 2
a250 2
menu if you have not already done
so. This will create a bunch of device nodes for you and will
d254 2
a255 2
option to give you a mini-shell. Do not use this unless you are
sure know what you are doing.
d269 1
a269 1
32-bit addressing is enabled [2] in the Memory control panel;
d276 3
a278 3
by the Monitors control panel. You may choose to have the
Booter do this for you automatically by selecting the appropriate
check box and radio button in the
d284 7
a290 4
off [2]. You can do this by booting into
.Tn Mac OS
with the SHIFT key held
down. You may have to restart your Macintosh for changes to take effect
d292 2
a293 2
.(tag [2]
.It [2]
d296 6
a301 6
32-bit clean and is running in 32-bit addressing mode by default.  If the
Booter complains that you are not in 32-bit mode, it may be necessary
for you to press the
.Ic Use Defaults
button in the Memory control panel to
restore 32-bit addressing.  You should probably reboot after doing so.
d304 5
a308 4
ROM issues which prevent you from enabling 32-bit addressing. Please see the
.Nx*M
FAQ at
.Lk http://www.netbsd.org/Ports/\*M/faq/
d319 6
a324 6
menu. Check that all of the items in
the resulting dialog look sane - especially the SCSI target number.
If not, correct
them to your preference (the SCSI target number, or "SCSI ID",
should be the only thing you need to
change). When you are satisfied with your choices, try booting
@


1.23
log
@more work:
- use .Tn, .Bx, .Ul, .Key, .Sq, .Dq, .Li, .Dl, (etc) ... as appropriate
- be more consistent between various ports' install notes
- other cleanups
@
text
@d1 1
a1 1
.\"	$NetBSD: install,v 1.22 2000/10/10 12:55:19 lukem Exp $
d282 1
a282 1
Booter complains that your are not in 32-bit mode, it may be necessary
@


1.22
log
@major terraform (this is MUCH more than a rototill :-), including:
- update for 1.5 (still more MD stuff to check)
- use new macros in ../common/macros as appropriate
- introduce some CONSISTENCY between the various ports' install docs
- use various mdoc macros as appropriate, including .Li, .Pa, .Sy, and .Ic.
- migrate more stuff into ../common/*
- whitespace cleanup
- lots of other little things i'm sure...
@
text
@d1 1
a1 1
.\"	$NetBSD: install,v 1.21 1999/05/31 06:38:16 ender Exp $
d37 1
a37 1
Run Mkfs to build a filesystem or filesystems.
d39 1
a39 1
Run the Installer to load the files onto your filesystems.
d44 1
a44 1
.Ss2 Preparing the filesystem(s)
d47 1
a47 1
for the SCSI ID of the drive that you are installing upon. Once this is
d52 14
a65 5
each partition on which you wish to build a filesystem and click on the
"Change" button. If you are placing the entire installation on a single
partition, select the "NetBSD Root\*&Usr" radio button. If you are using
multiple partitions, select "NetBSD Root" for the root partition and
"NetBSD Usr" for all the other partitions. You should select "NetBSD Swap"
d69 4
a72 2
click on the "Format" button. You will now be asked for a bunch of
parameters for the hard drive and the filesystem. Usually, you can just
d75 16
a90 5
has the "OK" button, you are not committed, yet. Once you get the values
you want, press the "OK" button. A dialog will be presented at this point
with two options: "Format" and "Cancel." If you choose "Cancel," nothing
will be written to your drive. If you choose "Format," the program will
proceed to make a filesystem.
d96 3
a98 2
any errors, but do scan the output to make sure. Simply click on the "I
Read It" button and the program will quit.
d101 11
a111 5
filesystems on. Note that you do _not_ need a filesystem on your swap
partition.
.Pp
When you are finished, click on the "Done" button and choose "Quit" from
the "File" menu to exit Mkfs.
d117 2
a118 1
"Get Info" from the File menu. Increase both the Minimum and Preferred
d122 2
a123 2
present the same SCSI ID menu that Mkfs did. Select the same SCSI ID that
you did for Mkfs--i.e., the one you are installing onto.
d125 3
a127 1
If you are installing onto a single root partition, proceed to the
d131 6
a136 2
If you have not created filesystems for the root, usr, and
any other filesystems, go back to "Preparing the filesystem(s),"
d139 21
a159 8
When you started the Installer, it mounted your root partition.
Just before it printed, "Mounting partition 'A' as /," it printed
lines like:
.Dl sd1 at scsi ID 5.
This means that the device for scsi ID 5 is sd1. The partitions
are signified by a trailing letter. For instance, sd1a would be
the root partition of the second scsi disk in the chain, and sd0g
would be the first Usr partition on the first scsi disk.
d163 19
a181 2
.(bullet
Select "Build Devices" from the "File" menu.
d183 1
a183 1
Select "Mini Shell" from the "File" menu.
d185 1
a185 6
You can use the 'disklabel' command to get a listing of
the available partitions and their types and sizes.
.Pp
Create the directory mount point(s) with the command:
.Dl mkdir path
(e.g. for the
a187 1
.Ic mkdir /usr )
d189 10
a198 4
Mount the filesystems you wish with the command:
.Dl mount device path
For example, if you wish to mount a usr partition from
the first scsi disk, sd0, on
a199 1
.Dl mount /dev/sd0g /usr
d201 6
a206 2
.No Type Ic fstab force
.No to create a proper Pa /etc/fstab
d208 1
a208 1
.Pp
d211 1
a211 1
after you have mounted all the filesystems.
d272 3
a274 2
off [1]. You can do this by booting into MacOS with the
.Tn SHIFT No key held
d283 3
a285 1
for you to press the "Use Defaults" button in the Memory control panel to
d291 1
a291 1
.Lk http://www.netbsd.org/Ports/mac68k/faq/ the\ FAQ
d304 2
a305 2
the resulting dialog look sane--especially the SCSI ID. If not, correct
them to your preference (the SCSI ID should be the only thing you need to
d320 1
a320 1
.Mt port-mac68k@@netbsd.org
@


1.21
log
@Add a note about 32-bit addressing when the Memory control panel does not
give you the option.

Should fix PR 6320 from John Refling (refling@@comet.lbl.gov).
@
text
@d1 1
a1 1
.\"	$NetBSD: install,v 1.20 1999/01/13 07:30:06 ross Exp $	
d3 1
a3 1
.\" Copyright (c) 1999 The NetBSD Foundation, Inc.
d36 1
a36 2
.Bl -bullet -compact
.It
d42 1
a42 1
.El
d98 1
a98 2
.Bl -item
.It
d102 1
a102 1
.It
d111 1
a111 1
.It
d114 1
a114 2
.Bl -bullet
.It
d116 1
a116 2

.It
d118 1
a118 2

.It
d121 1
a121 2

.It
d128 1
a128 2

.It
d135 1
a135 1
.It
d139 1
a139 1
.It
d143 1
a143 2
.El
.El
d145 1
a145 1
.Ss2 Installation of base files:
a146 2
.Bl -item
.It
d149 1
a149 1
menu item from the 
d159 1
a159 1
.It
d163 1
a163 1
.It
d166 1
a166 1
option from the 
d175 1
a175 1
.It
a179 1
.El
d183 3
a185 1
Prior to attempting to boot NetBSD/mac68k, please verify that all of
d187 2
a188 3
.Bl -enum
.It
32-bit addressing is enabled[*] in the Memory control panel;
d198 1
a198 1
.Ic Monitors No dialog on the 
d200 1
a200 1
.El
d203 1
a203 1
off[*]. You can do this by booting into MacOS with the
d207 2
a208 1
.(tag Em [*]Note:
d224 4
a227 2
Double-click on the NetBSD/mac68k Booter icon to start the application.
Select 
d229 1
a229 1
from the 
@


1.21.8.1
log
@Sync to HEAD as of 20001101 03:43 GMT [lukem]:
Complete rework of install notes for 1.5 from several authors.
@
text
@d1 1
a1 1
.\"	$NetBSD: install,v 1.23 2000/10/29 14:08:07 lukem Exp $
d3 1
a3 1
.\" Copyright (c) 1999, 2000 The NetBSD Foundation, Inc.
d36 1
a36 2
.(bullet -compact
Run Mkfs to build a file system or file systems.
d38 3
a40 1
Run the Installer to load the files onto your file systems.
d43 1
a43 1
.bullet)
d45 1
a45 1
.Ss2 Preparing the file system(s)
d48 1
a48 1
for the SCSI-ID of the drive that you are installing upon. Once this is
d53 5
a57 14
each partition on which you wish to build a file system and click on the
.Dq Change
button. If you are placing the entire installation on a single
partition, select the
.Dq NetBSD Root\*&Usr
radio button. If you are using
multiple partitions, select
.Dq NetBSD Root
for the root partition
.Pq Pa /
and
.Dq NetBSD Usr
for all the other partitions. You should select
.Dq NetBSD Swap
d61 2
a62 4
click on the
.Dq Format
button. You will now be asked for a bunch of
parameters for the hard drive and the file system. Usually, you can just
d65 5
a69 16
has the
.Dq OK
button, you are not committed, yet. Once you get the values
you want, press the
.Dq OK
button. A dialog will be presented at this point
with two options:
.Dq Format
and
.Dq Cancel .
If you choose
.Dq Cancel ,
nothing will be written to your drive. If you choose
.Dq Format ,
the program will
proceed to make a file system.
d75 2
a76 3
any errors, but do scan the output to make sure. Simply click on the
.Dq "I Read It"
button and the program will quit.
d79 5
a83 11
file systems on. Note that you do
.Em not
need a file system on your swap partition.
.Pp
When you are finished, click on the
.Dq Done
button and choose
.Dq Quit
from the
.Dq File
menu to exit Mkfs.
d89 1
a89 2
.Dq Get Info
from the File menu. Increase both the Minimum and Preferred
d93 2
a94 2
present the same SCSI-ID menu that Mkfs did. Select the same SCSI-ID that
you did for Mkfs - i.e., the one you are installing onto.
d96 1
a96 3
If you are installing onto a single root partition
.Pq Pa / ,
proceed to the
d99 4
a102 7
.Pp
If you have not created file systems for
.Pa /
(root),
.Pa usr ,
and any other file systems, go back to
.Sx Preparing the file system(s)
d104 10
a113 23
.Pp
When you started the Installer, it mounted your root partition
.Pq Pa / .
Just before it printed,
.Pp
.Dl "Mounting partition 'A' as / ",
.Pp
it printed lines like:
.Pp
.Dl "sd1 at scsi ID 5" .
.Pp
This means that the device for SCSI-ID 5 is
.Li sd1 .
The partitions
are signified by a trailing letter. For instance,
.Li sd1a
would be
the root partition
.Pq Pa /
of the second SCSI disk in the chain, and
.Li sd0g
would be the first Usr partition on the first SCSI disk.
.Pp
d116 4
a119 6
.(enum -offset indent
Select
.Dq Build Devices
from the
.Dq File
menu.
d121 2
a122 5
Select
.Dq Mini Shell
from the
.Dq File
menu.
d124 1
a124 3
You can use the
.Ic disklabel
command to get a listing of
d126 1
d129 2
a130 4
.Pp
.Dl # Ic "mkdir path"
.Pp
E.g. for the
d133 2
a134 2
.Pp
.Dl # Ic "mkdir /usr"
d136 4
a139 8
Mount the file systems you wish with the command:
.Pp
.Dl # Ic "mount device path"
For example, if you wish to mount a
.Pa /usr
partition from the first SCSI disk
.Li sd0 ,
on
d141 1
a141 2
.Pp
.Dl # Ic "mount /dev/sd0g /usr"
d143 2
a144 4
Type
.Dl # Ic "fstab force"
to create a proper
.Pa /etc/fstab
d149 3
a151 2
after you have mounted all the file systems.
.bullet)
d153 1
a153 1
.Ss2 Installation of base files
d155 2
d159 1
a159 1
menu item from the
d169 1
a169 1
.Pp
d173 1
a173 1
.Pp
d176 1
a176 1
option from the
d185 1
a185 1
.Pp
d190 1
d194 1
a194 3
Prior to attempting to boot
.Nx*M ,
please verify that all of
d196 3
a198 2
.(enum
32-bit addressing is enabled [1] in the Memory control panel;
d208 1
a208 1
.Ic Monitors No dialog on the
d210 1
a210 1
.enum)
d213 2
a214 3
off [1]. You can do this by booting into
.Tn MacOS
with the SHIFT key held
d217 1
a217 2
.(tag [1]
.It [1]
d222 1
a222 3
for you to press the
.Dq Use Defaults
button in the Memory control panel to
d228 1
a228 1
.Lk http://www.netbsd.org/Ports/\*M/faq/ the\ FAQ
d233 2
a234 4
Double-click on the
.Nx*M
Booter icon to start the application.
Select
d236 1
a236 1
from the
d239 2
a240 2
the resulting dialog look sane - especially the SCSI-ID. If not, correct
them to your preference (the SCSI-ID should be the only thing you need to
d255 1
a255 1
.Mt port-\*M@@netbsd.org
@


1.20
log
@Markup for -mdoc and -mdoc2html.
@
text
@d1 1
a1 1
.\"	$NetBSD: install,v 1.19 1998/08/23 12:42:19 hubertf Exp $	
d218 6
@


1.20.2.1
log
@pullup 1.20->1.21 (ender)
@
text
@d1 1
a1 1
.\"	$NetBSD: install,v 1.21 1999/05/31 06:38:16 ender Exp $	
a217 6
If your version of the Memory control panel does not have a 32-bit
addressing mode radio button, this means that your system is already
32-bit clean and is running in 32-bit addressing mode by default.  If the
Booter complains that your are not in 32-bit mode, it may be necessary
for you to press the "Use Defaults" button in the Memory control panel to
restore 32-bit addressing.  You should probably reboot after doing so.
@


1.19
log
@Add notes about steps to do after installation that are common to all
platforms; Thanks to Colin Wood and Simon Burge for their comments.
@
text
@d1 33
a33 2
	$NetBSD: install,v 1.18 1998/05/19 13:45:01 scottr Exp $	

d35 14
a48 8
	* Run Mkfs to build a filesystem or filesystems.
	* Run the Installer to load the files onto your filesystems.
	* Run the Booter to boot the system.

**** Preparing the filesystem(s)

Double-click on the Mkfs application icon to start it up.  It will ask you
for the SCSI ID of the drive that you are installing upon.  Once this is
d50 3
a52 1
first convert the partitions to a type which NetBSD can understand. Select
d54 2
a55 2
"Change" button.  If you are placing the entire installation on a single
partition, select the "NetBSD Root&Usr" radio button.  If you are using
d57 3
a59 3
"NetBSD Usr" for all the other partitions.  You should select "NetBSD Swap"
for the swap partition. 

d61 5
a65 5
click on the "Format" button.  You will now be asked for a bunch of
parameters for the hard drive and the filesystem.  Usually, you can just
take the defaults.  If you are installing onto removable media (e.g. a Zip,
Jaz, or Syquest), please see the FAQ.  Note that although this dialog only
has the "OK" button, you are not committed, yet.  Once you get the values
d67 2
a68 2
with two options: "Format" and "Cancel."  If you choose "Cancel," nothing
will be written to your drive.  If you choose "Format," the program will
d70 2
a71 2

Mkfs is not a well-behaved Macintosh application.  It will not allow any
d74 2
a75 2
scanned the output for any error messages.  Usually there won't have been
any errors, but do scan the output to make sure.  Simply click on the "I
d77 1
a77 1

d79 1
a79 1
filesystems on.  Note that you do _not_ need a filesystem on your swap
d81 1
a81 1

d84 3
a86 3

**** Installing the files

d88 2
a89 2
memory allocation.  Select the Installer icon by clicking on it and choose
"Get Info" from the File menu.  Increase both the Minimum and Preferred
d91 5
a95 5

Double-click on the Installer icon to start it up.  The Installer will
present the same SCSI ID menu that Mkfs did.  Select the same SCSI ID that
you did for Mkfs--i.e., the one you are installing onto. 

d97 97
a193 65
"Installation of base files" section, below.

	If you have not created filesystems for the root, usr, and
	any other filesystems, go back to "Preparing the filesystem(s),"
	above.

	When you started the Installer, it mounted your root partition.
	Just before it printed, "Mounting partition 'A' as /," it printed
	lines like:
		sd1 at scsi ID 5.
	This means that the device for scsi ID 5 is sd1.  The partitions
	are signified by a trailing letter.  For instance, sd1a would be
	the root partition of the second scsi disk in the chain, and sd0g
	would be the first Usr partition on the first scsi disk.

	You will need to know the proper device to mount the remaining
	partition(s) by hand:

		* Select "Build Devices" from the "File" menu.

		* Select "Mini Shell" from the "File" menu.

		* You can use the 'disklabel' command to get a listing of
		  the available partitions and their types and sizes.

		* Create the directory mount point(s) with the command:
			mkdir path
		  (e.g. for the /usr partition type: mkdir /usr)

		* Mount the filesystems you wish with the command:
			mount device path
		  For example, if you wish to mount a usr partition from
		  the first scsi disk, sd0, on /usr, you would type:
			mount /dev/sd0g /usr

		* Type "fstab force" to create a proper /etc/fstab file

		* Type "quit" after you have mounted all the filesystems.

Installation of base files:

	Select the "Install" menu item from the "File" menu and install
	base.tgz, etc.tgz, netbsd.tgz, and any other sets you wish to
	install	at this time (see the contents section for information
	about what's in each set).  The Installer will print out the
	filename of each file as it is installed, and will take quite some 
	time to install everything (the base package alone can take over an
	hour on a slow hard drive).

	As is the case with Mkfs, this is not a particularly well-behaved
	Macintosh application and the machine will be completely tied up
	while the installation takes place.

	At some point after installing the base set, select the "Build
	Devices" option from the "File" menu if you have not already done
	so.  This will create a bunch of device nodes for you and will
	create your initial /etc/fstab.  The Installer program also has an
	option to give you a mini-shell.  Do not use this unless you are
	sure know what you are doing.

	When you are finished installing all of the sets you wish to
	install, exit the Installer by choosing "Quit" from the "File" menu.
	
**** Booting the system

d196 16
a211 13

	1) 32-bit addressing is enabled[*] in the Memory control panel;

	2) All forms of virtual memory are disabled (the Memory control
	   panel, RAM Doubler, or other software-based memory enhancement
	   products); and

	3) Your system is in B&W mode (1-bit color or grayscale) as shown
	   by the Monitors control panel.  You may choose to have the 
	   Booter do this for you automatically by selecting the appropriate
	   check box and radio button in the "Monitors" dialog on the
	   "Options" menu.

d213 6
a218 5
off[*].  You can do this by booting into MacOS with the SHIFT key held
down.  You may have to restart your Macintosh for changes to take effect
before proceeding.  

[* NOTE:  If you have an older II-class system (including the II, IIx, IIcx,
d220 7
a226 3
ROM issues which prevent you from enabling 32-bit addressing.  Please see
<http://www.netbsd.org/Ports/mac68k/faq/> for more information.]

d228 6
a233 2
Select "Booting" from the "Options" menu.  Check that all of the items in
the resulting dialog look sane--especially the SCSI ID.  If not, correct
d235 11
a245 5
change).  When you are satisfied with your choices, try booting NetBSD by
selecting "Boot Now" from the "Options" menu.

If you wish to save your preferences, choose "Save Options" from the
"File" menu before Booting (your preferences will not be saved if you
d247 3
a249 2

If the system does not come up, send mail to port-mac68k@@netbsd.org
d252 3
a254 3

If the system does come up, congratulations, you have successfully
installed NetBSD _VER. 
@


1.18
log
@Revert the section from v1.8 that put my email address back into the
document, instead of the mailing list.
@
text
@d1 1
a1 1
	$NetBSD: install,v 1.17 1998/01/12 23:23:38 ender Exp $	
d164 1
a164 37
installed NetBSD _VER.  When you first boot into NetBSD, it will
automatically drop you into single-user mode with the root filesystem
mounted read-write.  The system will ask you to choose a shell.  Simply hit
return to get to a prompt.  If you are asked for a terminal type, respond
with 'vt220' and hit return.  At this point, you need to configure at least
one file in the /etc directory.  Change to the /etc directory and take a
look at the /etc/rc.conf file.  Modify it to your tastes, making sure that
you set "rc_configured=YES" so that your changes will be enabled and a
multi-user boot can proceed.  If your /usr directory is on a separate
partition and you do not know how to use 'ed' or 'ex', you will have to
mount your /usr partition to gain access to 'vi'.  Do the following:

mount /usr
export TERM=vt220

You can then edit /etc/rc.conf with 'vi'.  When you have finished, type
'exit' at the prompt to leave the single-user shell and continue with the
multi-user boot.  You should log in as "root" at the login prompt.  There
is no initial password, but if you're using the machine in a networked
environment, you should create yourself an account and protect it and the
"root" account with good passwords.  Please see the adduser(8) man page for
more information on how to add a new user. 

Some of the files in the NetBSD _VER distribution might need to be
tailored for your site.  In particular, if you have installed the X11
distribution sets, you will need to edit the /etc/ld.so.conf file to
look something like:

# add the X shared libraries to the runtime linker search path
/usr/X11R6/lib

Also, don't forget to add /usr/X11R6/bin to your path in your shell's dot
file so that you have access to the X binaries.  Many other files in /etc
will probably need to be modified, as well.  Most of these files are
described in section 5 of the manual pages.  If you are unfamiliar with
UN*X-like operating systems or system administration, it's recommended that
you buy a book that discusses it.  
@


1.17
log
@Fix an oversight in the multi-partition install procedure.
Noticed by Gunnar Helliesen <gunnar@@bitcon.no>
@
text
@d1 1
a1 1
	$NetBSD: install,v 1.16 1998/01/09 18:46:40 perry Exp $	
d159 3
a161 3
If the system does not come up, send mail to scottr@@netbsd.org describing
your software, your hardware, and as complete a description of the
problem as you can.
@


1.16
log
@RCS Id Police.
@
text
@d1 1
a1 1
	$NetBSD$	
d82 4
@


1.15
log
@o Delete a reference to the non-existent intro(5)
@
text
@d1 2
@


1.14
log
@Cleanup a minor nit
@
text
@d192 3
a194 4
described in section 5 of the manual pages.  See intro(5) for more
information.  If you are unfamiliar with UN*X-like operating systems or
system administration, it's recommended that you buy a book that discusses
it.  
@


1.13
log
@o Noted how to setup for X
o Brought legal up to date finally
o General cleanup
@
text
@d191 1
a191 1
will probably need to be modified, as well.  Many of these files are
@


1.12
log
@o Fix some lossage from the last commit
o Capitalize Ethernet
@
text
@d182 14
a195 6
tailored for your site.  In particular, the /etc/resolv.conf file will
almost definitely need to be adjusted, and other files in /etc will
probably need to be modified, as well.  Many of these files are described
in section 5 of the manual pages.  See intro(5) for more information.  If
you are unfamiliar with UN*X-like system administration, it's recommended
that you buy a book that discusses it. 
@


1.11
log
@Resolve conflicts that somehow got committed (mmmm, CVS); add several
noteworthy contributors to the legal document; fix a few unclear
statements I noticed along the way.
@
text
@d184 4
a187 5
probably need to be modified, as well.  In particular, you will want to
take a look at /etc/rc.conf and modify it to your tastes.  Make sure
that you set "rc_configured=YES" so that your changes will be enabled.
If you are unfamiliar with UN*X-like system administration, it's
recommended that you buy a book that discusses it.
@


1.10
log
@o Updated for new release(7) directory hierarchy
o Noted procedure for configuring /etc/rc.conf on first boot
@
text
@a183 11
<<<<<<< install
probably need to be modified, as well.  Many of these files are described
in section 5 of the manual pages.  See intro(5) for more information.  If
you are unfamiliar with UN*X-like system administration, it's recommended
that you buy a book that discusses it. 
||||||| 1.8
probably need to be modified, as well.  If you are unfamiliar with
UN*X-like system administration, it's recommended that you buy a book
that discusses it.

=======
a188 2

>>>>>>> 1.9
@


1.9
log
@o Added a section on the X11 distribution sets to contents
o Added recently supported hardware
o Noted setup of rc.conf in install
o Added a new upgrade procedure
o Explained 1.3 enhancements in whatis
o Converted Mac-side utility names to be more version independent
@
text
@d8 10
a17 10
Double-click on the Mkfs application icon to start it up.  It will ask
you for the SCSI ID of the drive that you are installing upon.  Once
this is selected, it will present a list of the partitions on that disk.
You must first convert the partitions to a type which NetBSD can
understand. Select each partition on which you wish to build a filesystem
and click on the "Change" button.  If you are placing the entire
installation on a single partition, select the "NetBSD Root&Usr" radio
button.  If you are using multiple partitions, select "NetBSD Root" for
the root partition and "NetBSD Usr" for all the other partitions.  You
should select "NetBSD Swap" for the swap partition.
d19 2
a20 2
When you have finished converting each partition, select each partition
and click on the "Format" button.  You will now be asked for a bunch of
d22 14
a35 14
take the defaults.  If you are installing onto removable media (e.g. a
Zip, Jaz, or Syquest), please see the FAQ.  Note that although this
dialog only has the "OK" button, you are not committed, yet.  Once you
get the values you want, press the "OK" button. A dialog will be
presented at this point with two options: "Format" and "Cancel."  If you
choose "Cancel," nothing will be written to your drive.  If you choose
"Format," the program will proceed to make a filesystem.

Mkfs is not a well-behaved Macintosh application.  It will not allow
any other tasks to run while it does (cooperative multitasking at its
best).  When it's finished, the program will put up a dialog to ask if
you have scanned the output for any error messages.  Usually there won't
have been any errors, but do scan the output to make sure.  Simply click
on the "I Read It" button and the program will quit.
d47 7
a53 7
memory allocation.  Select the Installer icon by clicking on it and
choose "Get Info" from the File menu.  Increase both the Minimum and
Preferred sizes to as much as you can spare.

Double-click on the Installer icon to start it up.  The Installer
will present the same SCSI ID menu that Mkfs did.  Select the same SCSI
ID that you did for mkfs--i.e., the one you are installing onto.
d69 1
a69 1
	would be the first usr partition on the first scsi disk.
d94 6
a99 6
	base13, etc13, netbsd13, and any other packages you wish to install 		 
	at this time (see the contents section for information about what's
	in each package).  The Installer will print out the filename of
	each file as it is installed, and will take quite some time to
	install everything (the base package alone can take over an hour
	on a slow hard drive).
d105 6
a110 6
	At some point after installing the base package, select the "Build
	Devices" option from the "File" menu if you have not already done so. 	
	This will create a bunch of device nodes for you and will create your 
	initial /etc/fstab.  The Installer program also has an option to give 	
	you a mini-shell.  Do not use this unless you are sure know what you 
	are doing.
d112 1
a112 1
	When you are finished installing all of the packages you wish to 
d132 4
a135 2
You may have to restart your Macintosh for changes to take effect before
proceding.
d150 2
a151 3
"File" menu, then quit the application and restart it.  Due to a
long-standing bug, the preferences will not be saved unless you quit and
restart the Booter.
d158 22
a179 5
installed NetBSD _VER.  When you reboot into NetBSD, you should log
in as "root" at the login prompt.  There is no initial password, but
if you're using the machine in a networked environment, you should
create yourself an account and protect it and the "root" account with
good passwords.
d182 1
a182 1
tailored for your site.  In particular, the /etc/sendmail.cf file will
d184 11
d201 1
@


1.8
log
@o Updated distribution notes to reflect latest installation procedures
  and hardware support
o Made note of the X11 distribution sets in the contents section
@
text
@d166 5
a170 3
probably need to be modified, as well.  If you are unfamiliar with
UN*X-like system administration, it's recommended that you buy a book
that discusses it.
@


1.8.2.1
log
@Pull rev 1.9 up from trunk (ender)
@
text
@d166 3
a168 5
probably need to be modified, as well.  In particular, you will want to
take a look at /etc/rc.conf and modify it to your tastes.  Make sure
that you set "rc_configured=YES" so that your changes will be enabled.
If you are unfamiliar with UN*X-like system administration, it's
recommended that you buy a book that discusses it.
@


1.8.2.2
log
@Pull rev 1.10 up from trunk (ender)
@
text
@d8 10
a17 10
Double-click on the Mkfs application icon to start it up.  It will ask you
for the SCSI ID of the drive that you are installing upon.  Once this is
selected, it will present a list of the partitions on that disk. You must
first convert the partitions to a type which NetBSD can understand. Select
each partition on which you wish to build a filesystem and click on the
"Change" button.  If you are placing the entire installation on a single
partition, select the "NetBSD Root&Usr" radio button.  If you are using
multiple partitions, select "NetBSD Root" for the root partition and
"NetBSD Usr" for all the other partitions.  You should select "NetBSD Swap"
for the swap partition. 
d19 2
a20 2
When you have finished converting each partition, select each partition and
click on the "Format" button.  You will now be asked for a bunch of
d22 14
a35 14
take the defaults.  If you are installing onto removable media (e.g. a Zip,
Jaz, or Syquest), please see the FAQ.  Note that although this dialog only
has the "OK" button, you are not committed, yet.  Once you get the values
you want, press the "OK" button. A dialog will be presented at this point
with two options: "Format" and "Cancel."  If you choose "Cancel," nothing
will be written to your drive.  If you choose "Format," the program will
proceed to make a filesystem.

Mkfs is not a well-behaved Macintosh application.  It will not allow any
other tasks to run while it does (cooperative multitasking at its best).
When it's finished, the program will put up a dialog to ask if you have
scanned the output for any error messages.  Usually there won't have been
any errors, but do scan the output to make sure.  Simply click on the "I
Read It" button and the program will quit.
d47 7
a53 7
memory allocation.  Select the Installer icon by clicking on it and choose
"Get Info" from the File menu.  Increase both the Minimum and Preferred
sizes to as much as you can spare.

Double-click on the Installer icon to start it up.  The Installer will
present the same SCSI ID menu that Mkfs did.  Select the same SCSI ID that
you did for Mkfs--i.e., the one you are installing onto. 
d69 1
a69 1
	would be the first Usr partition on the first scsi disk.
d94 6
a99 6
	base.tgz, etc.tgz, netbsd.tgz, and any other sets you wish to
	install	at this time (see the contents section for information
	about what's in each set).  The Installer will print out the
	filename of each file as it is installed, and will take quite some 
	time to install everything (the base package alone can take over an
	hour on a slow hard drive).
d105 6
a110 6
	At some point after installing the base set, select the "Build
	Devices" option from the "File" menu if you have not already done
	so.  This will create a bunch of device nodes for you and will
	create your initial /etc/fstab.  The Installer program also has an
	option to give you a mini-shell.  Do not use this unless you are
	sure know what you are doing.
d112 1
a112 1
	When you are finished installing all of the sets you wish to
d132 2
a133 4
It is probably best to boot your machine with all extensions turned
off[*].  You can do this by booting into MacOS with the SHIFT key held
down.  You may have to restart your Macintosh for changes to take effect
before proceeding.  
d148 3
a150 2
"File" menu before Booting (your preferences will not be saved if you
forget to do this).
d157 5
a161 22
installed NetBSD _VER.  When you first boot into NetBSD, it will
automatically drop you into single-user mode with the root filesystem
mounted read-write.  The system will ask you to choose a shell.  Simply hit
return to get to a prompt.  If you are asked for a terminal type, respond
with 'vt220' and hit return.  At this point, you need to configure at least
one file in the /etc directory.  Change to the /etc directory and take a
look at the /etc/rc.conf file.  Modify it to your tastes, making sure that
you set "rc_configured=YES" so that your changes will be enabled and a
multi-user boot can proceed.  If your /usr directory is on a separate
partition and you do not know how to use 'ed' or 'ex', you will have to
mount your /usr partition to gain access to 'vi'.  Do the following:

mount /usr
export TERM=vt220

You can then edit /etc/rc.conf with 'vi'.  When you have finished, type
'exit' at the prompt to leave the single-user shell and continue with the
multi-user boot.  You should log in as "root" at the login prompt.  There
is no initial password, but if you're using the machine in a networked
environment, you should create yourself an account and protect it and the
"root" account with good passwords.  Please see the adduser(8) man page for
more information on how to add a new user. 
d164 1
a164 1
tailored for your site.  In particular, the /etc/resolv.conf file will
a165 11
<<<<<<< install
probably need to be modified, as well.  Many of these files are described
in section 5 of the manual pages.  See intro(5) for more information.  If
you are unfamiliar with UN*X-like system administration, it's recommended
that you buy a book that discusses it. 
||||||| 1.8
probably need to be modified, as well.  If you are unfamiliar with
UN*X-like system administration, it's recommended that you buy a book
that discusses it.

=======
a171 1
>>>>>>> 1.9
@


1.8.2.3
log
@Pull rev 1.11 and 1.12 up from trunk (ender)
@
text
@d184 1
d189 13
@


1.8.2.4
log
@Sync w/ trunk: don't reference non-existent documentation.
@
text
@d182 6
a187 13
tailored for your site.  In particular, if you have installed the X11
distribution sets, you will need to edit the /etc/ld.so.conf file to
look something like:

# add the X shared libraries to the runtime linker search path
/usr/X11R6/lib

Also, don't forget to add /usr/X11R6/bin to your path in your shell's dot
file so that you have access to the X binaries.  Many other files in /etc
will probably need to be modified, as well.  Most of these files are
described in section 5 of the manual pages.  If you are unfamiliar with
UN*X-like operating systems or system administration, it's recommended that
you buy a book that discusses it.  
@


1.8.2.5
log
@Pull up 1.17 (ender)
@
text
@a0 2
	$NetBSD: install,v 1.17 1998/01/12 23:23:38 ender Exp $	

a79 4

		* Create the directory mount point(s) with the command:
			mkdir path
		  (e.g. for the /usr partition type: mkdir /usr)
@


1.8.2.6
log
@Pull up 1.18, per request of scottr.
@
text
@d1 1
a1 1
	$NetBSD: install,v 1.8.2.5 1998/01/29 10:14:30 mellon Exp $	
d159 3
a161 3
If the system does not come up, send mail to port-mac68k@@netbsd.org
describing your software, your hardware, and as complete a description of
the problem as you can.
@


1.7
log
@Add critical information for successfully booting NetBSD/mac68k.  (How
could this have been missed for so long?)  Based on additions by Ken Nakata
<kenn@@eden.rutgers.edu> in PRs 3839.
@
text
@d3 2
a4 2
	* Run Install Utility to load the files onto your filesystems.
	* Run the booter to boot the system.
d11 18
a28 9
Select the partition on which you wish to build a filesystem and click
on the "Format" button.  You will now be asked for a bunch of parameters
for the hard drive and the filesystem.  Usually, you can just take the
defaults.  If you are installing onto a Syquest, please see the FAQ.
Note that although this dialog only has the "OK" button, you are not
committed, yet.  Once you get the values you want, press the "OK" button.
A dialog will be presented at this point with two options: "Format" and
"Cancel."  If you choose "Cancel," nothing will be written to your drive.
If you choose "Format," the program will proceed to make a filesystem.
d41 3
d46 7
a52 2
Double-click on the Install Utility icon to start it up.  The installer
will present the same SCSI ID menu that mkfs did.  Select the same SCSI
d62 1
a62 1
	When you started the installer, it mounted your root partition.
d78 3
d87 2
d94 3
a96 3
	base12, netbsd, and any other packages you wish to install at
	this time (see the contents section for information about what's
	in each package).  The installer will print out the filename of
d98 2
a99 1
	install everything.
d106 9
a114 5
	Devices" option from the "File" menu.  This will create a bunch of
	device nodes for you and will create your initial /etc/fstab.  The
	installer program also has an option to give you a mini-shell.  Do
	not use this unless you know what you are doing.

d127 4
a130 1
	   by the Monitors control panel.
d135 2
a136 2
[* NOTE:  If you have an older II-class system (including the II, the IIx,
and the IIcx), it is necessary to install Connectix's MODE32 to work around
d138 1
a138 1
<http://www.netbsd.org/Ports/mac68k/faq/faq.html> for more information.]
d141 14
a154 14
Check that the options in the Booting dialog look sane -- especially the
SCSI ID.  If not, correct them to your preference.  When you are satisfied
with your choices, try booting NetBSD.

If you wish to save your preferences, choose the "Save Preferences"
option in the "File" menu, then quit the application and restart.  Due
to a long-standing bug, the preferences will not be saved unless you
quit.

If the system does not come up, send mail to port-mac68k@@NetBSD.ORG
describing your software, your hardware, and as complete a description
of the problem as you can.  You might also consider subscribing to the
port-mac68k mailing list, since there may already be others who have
successfully identified and resolved the problem you're seeing.
d156 2
a157 2
If the system does come up, congratulations!  You have successfully
installed NetBSD 1.2.  When you reboot into NetBSD, you should log
d163 1
a163 1
Some of the files in the NetBSD 1.2 distribution might need to be
d169 1
@


1.6
log
@Remove my email address, giving a pointer to the port-mac68k list instead.
@
text
@d90 20
@


1.5
log
@Updated booter information.
@
text
@d91 1
a91 1
Check that the options in the Booting dialog look sane--especially the
d100 5
a104 3
If the system does not come up, send mail to scottr@@netbsd.org describing
your software, your hardware, and as complete a description of the
problem as you can.
d106 1
a106 1
If the system does come up, congratulations, you have successfully
@


1.4
log
@Second pass cleanup
@
text
@d90 4
a93 4
Double-click on the MacBSD Booter icon to start the application.  Check
that the options in the Booting dialog look sane--especially the SCSI ID.
If not, correct them to your preference.  When you are satisfied with
your choices, try booting NetBSD.
@


1.3
log
@Make a pass for 1.2.
@
text
@d72 1
a72 1
	base11, netbsd, and any other packages you wish to install at
d100 3
a102 6
If the system does not come up:
	* Check the "diagnostic gray bars" check-box.
	* Count the number of "gray bars" you see.
	* Send mail to alice@@cray-ymp.acm.stuorg.vt.edu describing
	  your software, your hardware, and the number of bars that
	  you saw.
@


1.2
log
@merge in changes from 1.1 release branch
@
text
@d108 1
a108 1
installed NetBSD 1.1.  When you reboot into NetBSD, you should log
d114 1
a114 1
Some of the files in the NetBSD 1.1 distribution might need to be
@


1.2.4.1
log
@Pullup request from Scott Reynolds <scottr@@og.org>

>Several important changes didn't make it under the deadline for the release.
@
text
@d72 1
a72 1
	base12, netbsd, and any other packages you wish to install at
d90 4
a93 4
Double-click on the NetBSD/mac68k Booter icon to start the application.
Check that the options in the Booting dialog look sane--especially the
SCSI ID.  If not, correct them to your preference.  When you are satisfied
with your choices, try booting NetBSD.
d100 6
a105 3
If the system does not come up, send mail to scottr@@netbsd.org describing
your software, your hardware, and as complete a description of the
problem as you can.
d108 1
a108 1
installed NetBSD 1.2.  When you reboot into NetBSD, you should log
d114 1
a114 1
Some of the files in the NetBSD 1.2 distribution might need to be
@


1.2.4.2
log
@1.2 -> 1.2.1, foo12 -> foo121
@
text
@d72 1
a72 1
	base121, netbsd, and any other packages you wish to install at
d105 1
a105 1
installed NetBSD 1.2.1.  When you reboot into NetBSD, you should log
d111 1
a111 1
Some of the files in the NetBSD 1.2.1 distribution might need to be
@


1.1
log
@Initial revision
@
text
@d72 1
a72 1
	base10, netbsd, and any other packages you wish to install at
d108 1
a108 1
installed NetBSD 1.0.  When you reboot into NetBSD, you should log
d114 1
a114 1
Some of the files in the NetBSD 1.0 distribution might need to be
@


1.1.1.1
log
@Make a pass at mac68k install documentation.
@
text
@@


1.1.1.1.2.1
log
@file install was added on branch netbsd-1-0 on 1994-09-18 00:33:42 +0000
@
text
@d1 119
@


1.1.1.1.2.2
log
@Make a pass at mac68k install documentation.
@
text
@a0 119
The installation can be broken down into three basic steps:
	* Run Mkfs to build a filesystem or filesystems.
	* Run Install Utility to load the files onto your filesystems.
	* Run the booter to boot the system.

**** Preparing the filesystem(s)

Double-click on the Mkfs application icon to start it up.  It will ask
you for the SCSI ID of the drive that you are installing upon.  Once
this is selected, it will present a list of the partitions on that disk.
Select the partition on which you wish to build a filesystem and click
on the "Format" button.  You will now be asked for a bunch of parameters
for the hard drive and the filesystem.  Usually, you can just take the
defaults.  If you are installing onto a Syquest, please see the FAQ.
Note that although this dialog only has the "OK" button, you are not
committed, yet.  Once you get the values you want, press the "OK" button.
A dialog will be presented at this point with two options: "Format" and
"Cancel."  If you choose "Cancel," nothing will be written to your drive.
If you choose "Format," the program will proceed to make a filesystem.

Mkfs is not a well-behaved Macintosh application.  It will not allow
any other tasks to run while it does (cooperative multitasking at its
best).  When it's finished, the program will put up a dialog to ask if
you have scanned the output for any error messages.  Usually there won't
have been any errors, but do scan the output to make sure.  Simply click
on the "I Read It" button and the program will quit.

Repeat as necessary for any extra partitions that you wish to make
filesystems on.  Note that you do _not_ need a filesystem on your swap
partition.

**** Installing the files

Double-click on the Install Utility icon to start it up.  The installer
will present the same SCSI ID menu that mkfs did.  Select the same SCSI
ID that you did for mkfs--i.e., the one you are installing onto.

If you are installing onto a single root partition, proceed to the
"Installation of base files" section, below.

	If you have not created filesystems for the root, usr, and
	any other filesystems, go back to "Preparing the filesystem(s),"
	above.

	When you started the installer, it mounted your root partition.
	Just before it printed, "Mounting partition 'A' as /," it printed
	lines like:
		sd1 at scsi ID 5.
	This means that the device for scsi ID 5 is sd1.  The partitions
	are signified by a trailing letter.  For instance, sd1a would be
	the root partition of the second scsi disk in the chain, and sd0g
	would be the first usr partition on the first scsi disk.

	You will need to know the proper device to mount the remaining
	partition(s) by hand:

		* Select "Build Devices" from the "File" menu.

		* Select "Mini Shell" from the "File" menu.

		* Mount the filesystems you wish with the command:
			mount device path
		  For example, if you wish to mount a usr partition from
		  the first scsi disk, sd0, on /usr, you would type:
			mount /dev/sd0g /usr

		* Type "quit" after you have mounted all the filesystems.

Installation of base files:

	Select the "Install" menu item from the "File" menu and install
	base10, netbsd, and any other packages you wish to install at
	this time (see the contents section for information about what's
	in each package).  The installer will print out the filename of
	each file as it is installed, and will take quite some time to
	install everything.

	As is the case with Mkfs, this is not a particularly well-behaved
	Macintosh application and the machine will be completely tied up
	while the installation takes place.

	At some point after installing the base package, select the "Build
	Devices" option from the "File" menu.  This will create a bunch of
	device nodes for you and will create your initial /etc/fstab.  The
	installer program also has an option to give you a mini-shell.  Do
	not use this unless you know what you are doing.

**** Booting the system

Double-click on the MacBSD Booter icon to start the application.  Check
that the options in the Booting dialog look sane--especially the SCSI ID.
If not, correct them to your preference.  When you are satisfied with
your choices, try booting NetBSD.

If you wish to save your preferences, choose the "Save Preferences"
option in the "File" menu, then quit the application and restart.  Due
to a long-standing bug, the preferences will not be saved unless you
quit.

If the system does not come up:
	* Check the "diagnostic gray bars" check-box.
	* Count the number of "gray bars" you see.
	* Send mail to alice@@cray-ymp.acm.stuorg.vt.edu describing
	  your software, your hardware, and the number of bars that
	  you saw.

If the system does come up, congratulations, you have successfully
installed NetBSD 1.0.  When you reboot into NetBSD, you should log
in as "root" at the login prompt.  There is no initial password, but
if you're using the machine in a networked environment, you should
create yourself an account and protect it and the "root" account with
good passwords.

Some of the files in the NetBSD 1.0 distribution might need to be
tailored for your site.  In particular, the /etc/sendmail.cf file will
almost definitely need to be adjusted, and other files in /etc will
probably need to be modified, as well.  If you are unfamiliar with
UN*X-like system administration, it's recommended that you buy a book
that discusses it.
@


1.1.1.1.4.1
log
@1.0 -> 1.1 and a few other minor updates.
@
text
@d72 1
a72 1
	base11, netbsd, and any other packages you wish to install at
d108 1
a108 1
installed NetBSD 1.1.  When you reboot into NetBSD, you should log
d114 1
a114 1
Some of the files in the NetBSD 1.1 distribution might need to be
@