From 412ac9c56be498c7e6f93c75754a6e4b9ff8fbf4 Mon Sep 17 00:00:00 2001 From: riz Date: Fri, 17 Aug 2012 19:55:14 +0000 Subject: [PATCH] More MI release notes updates, particularly around installing. This could use more love! --- distrib/notes/common/postinstall | 54 +++++++++++++------------------- distrib/notes/common/sysinst | 50 +++++++++++++++++++++++------ 2 files changed, 62 insertions(+), 42 deletions(-) diff --git a/distrib/notes/common/postinstall b/distrib/notes/common/postinstall index 67e504dd1c14..b0ffaedadd2c 100644 --- a/distrib/notes/common/postinstall +++ b/distrib/notes/common/postinstall @@ -1,4 +1,4 @@ -.\" $NetBSD: postinstall,v 1.75 2012/05/26 05:51:13 tsutsui Exp $ +.\" $NetBSD: postinstall,v 1.76 2012/08/17 19:55:14 riz Exp $ .\" .\" Copyright (c) 1999-2004 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -346,28 +346,25 @@ Precompiled binaries can be found at usually in the .Pa \*M/\*V/All subdir. -You can install them with the following commands under -.Xr sh 1 : +If you installed +.Xr pkgin 1 +in the +.Ic sysinst +post-installation configuration menu, you can use it to automatically install +binary packages over the network. +Assuming that +.Pa /usr/pkg/etc/pkgin/repositories.conf +is correctly configured, you can install them with the following commands: .Pp .Bd -unfilled -.Ic # PKG_PATH=ftp://ftp.NetBSD.org/pub/pkgsrc/packages/NetBSD/\*M/\*V/All -.Ic # export PKG_PATH -.Ic # pkg_add -v tcsh -.Ic # pkg_add -v bash -.Ic # pkg_add -v perl -.Ic # pkg_add -v apache -.Ic # pkg_add -v kde -.Ic # pkg_add -v firefox +.Ic # pkgin install tcsh +.Ic # pkgin install bash +.Ic # pkgin install perl +.Ic # pkgin install apache +.Ic # pkgin install kde +.Ic # pkgin install firefox \&... .Ed -.Pp -If you are using -.Xr csh 1 -then replace the first two lines with the following: -.Pp -.Bd -unfilled -.Ic # setenv PKG_PATH ftp://ftp.NetBSD.org/pub/pkgsrc/packages/NetBSD/\*M/\*V/All -.Ed .(Note Some mirror sites don't mirror the .Pa /pub/pkgsrc @@ -378,21 +375,12 @@ The above commands will install the Tenex-csh and Bourne Again shells, the Perl programming language, Apache web server, KDE desktop environment and the Firefox web browser as well as all the packages they depend on. -.(Note -In some cases the -.Xr pkg_add 1 -command will complain about a version mismatch of packages with a message -like the following: -.Dl Warning: package `foo' was built for a different version of the OS: -.Dl NetBSD/i386 M.N (pkg) vs. NetBSD/i386 \*V (this host) , -This warning is harmless if the formal major release numbers are the same -between the pkg and your host. -Please refer to the NetBSD release glossary and graphs at -.Lk http://www.NetBSD.org/releases/release-map.html -for more information about NetBSD's release numbering scheme. -.Note) .It -The framework for compiling packages can be obtained by +If you did not install it from the +.Ic sysinst +post-installation configuration menu, the +.Xr pkgsrc 7 +framework for compiling packages can be obtained by retrieving the file .Lk ftp://ftp.NetBSD.org/pub/pkgsrc/pkgsrc.tar.gz . It is typically extracted into diff --git a/distrib/notes/common/sysinst b/distrib/notes/common/sysinst index c616fbc6171b..ff77842725b2 100644 --- a/distrib/notes/common/sysinst +++ b/distrib/notes/common/sysinst @@ -1,6 +1,6 @@ -.\" $NetBSD: sysinst,v 1.101 2011/05/27 17:50:41 tsutsui Exp $ +.\" $NetBSD: sysinst,v 1.102 2012/08/17 19:55:14 riz Exp $ .\" -.\" Copyright (c) 1999-2004 The NetBSD Foundation, Inc. +.\" Copyright (c) 1999-2012 The NetBSD Foundation, Inc. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without @@ -390,7 +390,11 @@ progress as this may leave the keyboard locked to The main menu will be displayed. .\} \" \n[mac68k] .ie \n[alpha]:\n[amd64]:\n[i386] \{\ -Insert the CD into the drive and boot the computer. +Insert the CD into the drive +.if \n[amd64]:\n[i386] \{\ +or the USB memstick into an available USB port +.\} +and boot the computer from it. .if \n[alpha] \{\ Type .Pp @@ -438,6 +442,7 @@ After language selection, the main menu will be displayed. * c: Re-install sets or install additional sets * * d: Reboot the computer * * e: Utility menu * + * f: Config menu * * x: Exit Install System * .***********************************************. . cs \n(.f @@ -499,7 +504,13 @@ The CD-ROM device is usually cd0 and the partition .\} .el \{\ .Me CD-ROM -as the medium. +as the medium +.if \n[amd64]:\n[i386] \{\ +if booted from CD-ROM, or +.Me Local directory +if booted from USB memstick +.\} +\&. The default values for the path and device should be ok. .\} .It @@ -1603,11 +1614,32 @@ the device node files will be created. If you have already configured networking, you will be asked if you want to use this configuration for normal operation. If so, these values will be installed in the network configuration files. -The next menu will allow you to select the time zone that you're in, -to make sure your clock has the right offset from UTC. -Finally you will be asked to select a password encryption algorithm -and can then set a password for the "root" account, to prevent -the machine from coming up without access restrictions. +.It +.To 2 "Configure additional items" +.Em Configure additional items +.Pp +The next menu will allow you to select a number of additional items +to configure, including the time zone that you're in, +to make sure your clock has the right offset from UTC, +the root user's shell, and the initial root password. +.Pp +You can also enable installation of binary packages, which installs the +.Xr pkgin 1 +tool for managing binary packages for third-party software. +This will +feel familiar to users of other package tools, such as +.Ic apt-get +or +.Ic yum . +Or, you can install the +.Xr pkgsrc 7 +tree for installing third-party software from source. +.Pp +Finally, you can enable some daemons such as +.Xr sshd 8 , +.Xr ntpd 8 , +or +.Xr mdnsd 8 . .if \n[sparc64] \{\ .It .To 2 "Ensure you have the correct kernel installed"