From 476960b4dc42aeff32494b9ff9409156d628362a Mon Sep 17 00:00:00 2001 From: hubertf Date: Sun, 23 Aug 1998 12:42:16 +0000 Subject: [PATCH] Add notes about steps to do after installation that are common to all platforms; Thanks to Colin Wood and Simon Burge for their comments. --- distrib/notes/INSTALL | 8 ++- distrib/notes/Makefile | 4 +- distrib/notes/alpha/install | 24 +------ distrib/notes/arm32/install | 15 +--- distrib/notes/i386/install | 24 +------ distrib/notes/mac68k/install | 40 +---------- distrib/notes/pc532/install | 11 +-- distrib/notes/pmax/install | 23 +----- distrib/notes/postinstall | 131 +++++++++++++++++++++++++++++++++++ distrib/notes/sparc/install | 16 +---- distrib/notes/vax/install | 4 +- distrib/notes/x68k/install | 17 +---- 12 files changed, 155 insertions(+), 162 deletions(-) create mode 100644 distrib/notes/postinstall diff --git a/distrib/notes/INSTALL b/distrib/notes/INSTALL index 5fa771ef6588..fcbc44b9795f 100644 --- a/distrib/notes/INSTALL +++ b/distrib/notes/INSTALL @@ -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: --------- - ---------- --------- ------ ------ diff --git a/distrib/notes/Makefile b/distrib/notes/Makefile index 40a1ddda3a53..50d52f59b4d2 100644 --- a/distrib/notes/Makefile +++ b/distrib/notes/Makefile @@ -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} diff --git a/distrib/notes/alpha/install b/distrib/notes/alpha/install index 212646bc31c6..e9bf609033b5 100644 --- a/distrib/notes/alpha/install +++ b/distrib/notes/alpha/install @@ -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 , 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. diff --git a/distrib/notes/arm32/install b/distrib/notes/arm32/install index e1e9014dc0cf..8b49dac72623 100644 --- a/distrib/notes/arm32/install +++ b/distrib/notes/arm32/install @@ -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. diff --git a/distrib/notes/i386/install b/distrib/notes/i386/install index eb8711a38d5d..eaff9547024e 100644 --- a/distrib/notes/i386/install +++ b/distrib/notes/i386/install @@ -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. diff --git a/distrib/notes/mac68k/install b/distrib/notes/mac68k/install index 0e0afcf6db28..2f1a41410c9d 100644 --- a/distrib/notes/mac68k/install +++ b/distrib/notes/mac68k/install @@ -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. diff --git a/distrib/notes/pc532/install b/distrib/notes/pc532/install index a96272e4ed44..68eb510f9912 100644 --- a/distrib/notes/pc532/install +++ b/distrib/notes/pc532/install @@ -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! - diff --git a/distrib/notes/pmax/install b/distrib/notes/pmax/install index 003813d37101..4270574af78f 100644 --- a/distrib/notes/pmax/install +++ b/distrib/notes/pmax/install @@ -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. diff --git a/distrib/notes/postinstall b/distrib/notes/postinstall new file mode 100644 index 000000000000..62f7a5a590a2 --- /dev/null +++ b/distrib/notes/postinstall @@ -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 , 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 " is likely to give you more information on + these files. diff --git a/distrib/notes/sparc/install b/distrib/notes/sparc/install index 33c49e0350c5..9879aa55c85d 100644 --- a/distrib/notes/sparc/install +++ b/distrib/notes/sparc/install @@ -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. diff --git a/distrib/notes/vax/install b/distrib/notes/vax/install index b52a02635d72..5b3119d92c42 100644 --- a/distrib/notes/vax/install +++ b/distrib/notes/vax/install @@ -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 >>> - - diff --git a/distrib/notes/x68k/install b/distrib/notes/x68k/install index 1c5609d7ae14..34033ba3ec34 100644 --- a/distrib/notes/x68k/install +++ b/distrib/notes/x68k/install @@ -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.