Add notes about steps to do after installation that are common to all

platforms; Thanks to Colin Wood and Simon Burge for their comments.
This commit is contained in:
hubertf 1998-08-23 12:42:16 +00:00
parent 66795e62e7
commit 476960b4dc
12 changed files with 155 additions and 162 deletions

View File

@ -1,4 +1,4 @@
$NetBSD: INSTALL,v 1.63 1998/08/21 01:45:14 thorpej Exp $
$NetBSD: INSTALL,v 1.64 1998/08/23 12:42:16 hubertf Exp $
#define _FOR_RELEASE 0 /* 0 == snapshot; 1 == release */
INSTALLATION NOTES for NetBSD/_MACH _VER
@ -358,6 +358,12 @@ Installing the NetBSD System:
#include "install"
Post installation steps:
---- ------------ ------
#include "postinstall"
Upgrading a previously-installed NetBSD System:
--------- - ---------- --------- ------ ------

View File

@ -1,4 +1,4 @@
# $NetBSD: Makefile,v 1.8 1998/01/09 18:34:06 perry Exp $
# $NetBSD: Makefile,v 1.9 1998/08/23 12:42:17 hubertf Exp $
NOPROG= notreally
@ -11,7 +11,7 @@ SRC= ${.CURDIR}/INSTALL
DEP= ${SRC} ${.CURDIR}/mirrors ${.CURDIR}/$M/whatis ${.CURDIR}/$M/contents \
${.CURDIR}/$M/hardware ${.CURDIR}/$M/xfer ${.CURDIR}/$M/prep \
${.CURDIR}/$M/install ${.CURDIR}/$M/upgrade ${.CURDIR}/donations \
${.CURDIR}/legal.common ${.CURDIR}/$M/legal
${.CURDIR}/legal.common ${.CURDIR}/$M/legal ${.CURDIR}/postinstall
CLEANFILES+=${TARG}

View File

@ -1,4 +1,4 @@
$NetBSD: install,v 1.11 1998/07/05 13:59:25 ross Exp $
$NetBSD: install,v 1.12 1998/08/23 12:42:17 hubertf Exp $
0. Introduction
@ -409,25 +409,3 @@
cd /usr/local
tar xpfz .../toolchain.tgz
5. Configuring NetBSD
Configuring your NetBSD system requires editing the /etc/rc.conf
file. Most of this file is fairly self-explanatory, but you
can `man rc.conf' for further explanations. Remember to set
`rc_configured' to YES so you will boot multi-user, set `hostname'
and possibly `defaultroute', and add an ifconfig_int for your
interface <int>, along the lines of
ifconfig_de0="inet 123.45.67.89 netmask 255.255.255.0"
or, if you have myname.my.dom in /etc/hosts:
ifconfig_de0="inet myname.my.dom netmask 255.255.255.0"
You will also want either to run named or add an /etc/resolv.conf
file (`man resolv.conf' for information on this), use `vipw' to add
accounts to your system, edit /etc/aliases to forward root mail to
the right place (run `newaliases' afterwards) and edit /etc/rc.local
to run any local daemons you use.

View File

@ -1,4 +1,4 @@
$NetBSD: install,v 1.2 1998/01/09 18:45:57 perry Exp $
$NetBSD: install,v 1.3 1998/08/23 12:42:18 hubertf Exp $
Installing NetBSD is a relatively complex process, but if you have
this document in hand and are careful to read and remember the
@ -379,15 +379,4 @@ Completing your installation:
the device nodes for the newly-installed system.
Congratulations, you have successfully 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.
Some of the files in the NetBSD _VER 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.
Congratulations, you have successfully installed NetBSD _VER.

View File

@ -1,4 +1,4 @@
$NetBSD: install,v 1.20 1998/07/04 18:51:00 is Exp $
$NetBSD: install,v 1.21 1998/08/23 12:42:18 hubertf Exp $
0. Introduction
@ -457,25 +457,3 @@
Congratulations, you have successfully installed NetBSD _VER.
You can now reboot the machine, and boot from harddisk.
After reboot, you can log in "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.
You should now edit the /etc/rc.conf file to configure the system
to suit your needs, and then reboot the system again.
Some other files in the NetBSD _VER 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.
If you have installed the X window system, look at the files in
/usr/X11R6/lib/X11/doc for information. You will need to set up
a configuration file. An example of such a file is
/usr/X11R6/lib/X11/XF86Config.eg. See http://www.xfree86.org/
and the XFree86 manual page for more information.

View File

@ -1,4 +1,4 @@
$NetBSD: install,v 1.18 1998/05/19 13:45:01 scottr Exp $
$NetBSD: install,v 1.19 1998/08/23 12:42:19 hubertf Exp $
The installation can be broken down into three basic steps:
* Run Mkfs to build a filesystem or filesystems.
@ -161,40 +161,4 @@ describing your software, your hardware, and as complete a description of
the problem as you can.
If the system does come up, congratulations, you have successfully
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.
installed NetBSD _VER.

View File

@ -1,4 +1,4 @@
$NetBSD: install,v 1.6 1998/01/19 20:34:35 phil Exp $
$NetBSD: install,v 1.7 1998/08/23 12:42:19 hubertf Exp $
(IF you already have NetBSD/pc532 installed and you only want to update
your system, see the next section.)
@ -197,19 +197,13 @@ The Install Procedure:
k) Edit the information in /etc
- rc.conf - Many of the following things can be configured here
- rc.conf - Many things can be configured here
- hosts - host name and address information
- myname - your host name
- mygate - hostname of gateway (assuming you have one)
- resolv.conf - which nameserver to use
- ifconfig.{sl0,ppp0,plip0} - interface hostname
- netstart - configures the network and says if sendmail should
be started
- ttys - make sure the console entry has the correct speed
- gettytab - I find "ap" instead of "ep" in the default entry
works better for me.
- fstab - make sure it includes all partitions you want mounted
- localtime - this is usually a link into /usr/share/zoneinfo
Now you can adjust the kernel's default baud rate to match your
monitor's default baud rate. Do the following:
@ -226,4 +220,3 @@ The Install Procedure:
you got it configured correctly.
m) Enjoy! And help fix bugs and improve NetBSD/pc532!

View File

@ -1,4 +1,4 @@
$NetBSD: install,v 1.7 1998/01/09 18:47:12 perry Exp $
$NetBSD: install,v 1.8 1998/08/23 12:42:19 hubertf Exp $
Reminder:
Always back up files before installing or upgrading.
@ -144,24 +144,3 @@ and set "rc_configured" to YES when you are done. If you're doing an
upgrade, merge your old etc from /etc.old into /etc.
You're then ready to reboot!
Post-intallation notes:
----------------------
Some of the files in the NetBSD _VER 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. If you are unfamiliar with UN*X-like
system administration, it's recommended that you buy a book that
discusses it.
NetBSD/pmax 1.3 uses an X11R5 X server. These servers cannot read the
compressed fonts which are shipped with standard X11R6 configurations.
If you installed X11 and want to run a local Xserver, you must take
post-installation steps to make the X11R5 server work that are
standard for X11R6.3. The distribution file /usr/X11R6/bin/README.pmax
contains information on how to choose an Xserver and how to access
compressed fonts via a font server or to decompress the X fonts
after installation. Please follow the directions there.

131
distrib/notes/postinstall Normal file
View File

@ -0,0 +1,131 @@
Once you've got the operating system running, there are a few
things you need to do in order to bring the system into a propperly
configured state, with the most important ones described below.
1. Configuring /etc/rc.conf
If you haven't done any configuration of /etc/rc.conf, the system
will drop you into single user mode on first reboot with the
message
/etc/rc.conf is not configured. Multiuser boot aborted.
and the root filesystem mounted read-write. When the system
asks you to choose a shell, simply hit return to get to a
prompt. If you are asked for a terminal type, respond with
'vt220' (or whatever is appropriate for your terminal type)
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
If you have /var on a seperate partition, you need to repeat
that step for it. After that, you can 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.
Other values that need to be set in /etc/rc.conf for a networked
environment are `hostname' and possibly `defaultroute', furthermore
add an ifconfig_int for your interface <int>, along the lines of
ifconfig_de0="inet 123.45.67.89 netmask 255.255.255.0"
or, if you have myname.my.dom in /etc/hosts:
ifconfig_de0="inet myname.my.dom netmask 255.255.255.0"
To enable proper hostname resolution, you will also want to add an
/etc/resolv.conf file or (if you are feeling a little more
adventurous) run named. See resolv.conf(5) or named(8) for more
information.
2. Logging in
After reboot, you can 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 an account for yourself
(see below) and protect it and the "root" account with good
passwords.
3. Adding accounts
Use the `vipw' command to add accounts to your system, DO NOT
edit /etc/passwd directly. See adduser(8) for more information
on the process of how to add a new user to the system.
4. The X Window System
If you have installed the X window system, look at the files in
/usr/X11R6/lib/X11/doc for information.
On NetBSD/i386 and NetBSD/arm32, you will need to set up a
configuration file, see /usr/X11R6/lib/X11/XF86Config.eg for an
example. See http://www.xfree86.org/ and the XFree86 manual page
for more information.
NetBSD/pmax _VER uses an X11R5 X server. These servers cannot read
the compressed fonts which are shipped with standard X11R6
configurations. You must take post-installation steps to make the
X11R5 server work with the fonts that are standard for X11R6.3.
The distribution file /usr/X11R6/bin/README.pmax contains
information on how to choose an Xserver and how to access
compressed fonts via a font server or to decompress the X fonts
after installation. Please follow the directions there.
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.
5. Installing 3rd party packages
There is a lot of software freely available for Unix based systems,
which usually runs on NetBSD, too, sometimes with some
modifications. The NetBSD packages collection incorporates any such
changes necessary to make that software run on NetBSD, and makes
the installation (and deinstallation) of the software packages
easy. There's also the option of building a package from source, in
case there's no precompiled binary available.
Precompiled binaries can be found at
ftp://ftp.netbsd.org/pub/NetBSD/packages/
Package sources for compiling packages can be obtained by
retrieving the file
ftp://ftp.netbsd.org/pub/NetBSD/NetBSD-current/tar_files/pkgsrc.tar.gz
and extracting it into /usr/pkgsrc. See /usr/pkgsrc/README then for
more information.
6. Misc
- To adjust the system to your local timezone, point the /etc/localtime
symlink to the appropriate file under /usr/share/zoneinfo.
- Edit /etc/aliases to forward root mail to the right place (run
`newaliases' afterwards)
- The /etc/sendmail.cf file will almost definitely need to be adjusted;
files aiding in this can be found in /usr/share/sendmail. See the
README-file there for more information.
- Edit /etc/rc.local to run any local daemons you use.
- Many of the /etc files are documented in section 5 of the manual; so
just invoking "man <filename>" is likely to give you more information on
these files.

View File

@ -1,4 +1,4 @@
$NetBSD: install,v 1.16 1998/01/09 18:47:23 perry Exp $
$NetBSD: install,v 1.17 1998/08/23 12:42:20 hubertf Exp $
Installing NetBSD is a relatively complex process, but if you have
this document in hand it shouldn't be too much trouble.
@ -294,16 +294,4 @@ On version 2 OpenBOOT ROMs:
ok setenv boot-device /sbus/esp/sd@0,0
Congratulations, you have successfully 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.
Some of the files in the NetBSD _VER 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. If you are unfamiliar with UN*X-like
system administration, it's recommended that you buy a book that
discusses it.
Congratulations, you have successfully installed NetBSD _VER.

View File

@ -1,4 +1,4 @@
$NetBSD: install,v 1.2 1998/01/09 18:47:54 perry Exp $
$NetBSD: install,v 1.3 1998/08/23 12:42:20 hubertf Exp $
Installing NetBSD/vax may be a little bit complex, but it shouldn't be too
hard if you have this document available.
@ -308,5 +308,3 @@ Halt/Reboot the machine NOW.
?02 EXT HLT
PC = 001005F3
>>>

View File

@ -1,4 +1,4 @@
$NetBSD: install,v 1.3 1998/01/09 18:48:04 perry Exp $
$NetBSD: install,v 1.4 1998/08/23 12:42:21 hubertf Exp $
Installing NetBSD is a relatively complex process, but if you have
this document in hand and are careful to read and remember the
@ -378,7 +378,7 @@ Kernel Installation:
Enter "halt" at the prompt to halt the system. When the
system is halted, remove the "inst12" floppy from the floppy
drive, and replace it with the NetBSD 1.2 kernel-copy floppy
drive, and replace it with the NetBSD _VER kernel-copy floppy
that you previously booted from. Reboot with that floppy.
with that floppy.
@ -407,15 +407,4 @@ Kernel Installation:
Once the system is halted, remove the kernel-copy floppy from
the floppy disk drive, and hit any key to reboot.
Congratulations, you have successfully installed NetBSD 1.2. 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.2 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.
Congratulations, you have successfully installed NetBSD _VER.