From owner-svn-doc-head@freebsd.org Wed Mar 18 18:41:02 2020 Return-Path: Delivered-To: svn-doc-head@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id AD6CD26912C; Wed, 18 Mar 2020 18:41:02 +0000 (UTC) (envelope-from carlavilla@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) server-signature RSA-PSS (4096 bits) client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 48jJlL2ZKWz4bwX; Wed, 18 Mar 2020 18:41:02 +0000 (UTC) (envelope-from carlavilla@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 95EB92633A; Wed, 18 Mar 2020 18:41:01 +0000 (UTC) (envelope-from carlavilla@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id 02IIf1XW022335; Wed, 18 Mar 2020 18:41:01 GMT (envelope-from carlavilla@FreeBSD.org) Received: (from carlavilla@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id 02IIf1k9022334; Wed, 18 Mar 2020 18:41:01 GMT (envelope-from carlavilla@FreeBSD.org) Message-Id: <202003181841.02IIf1k9022334@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: carlavilla set sender to carlavilla@FreeBSD.org using -f From: Sergio Carlavilla Delgado Date: Wed, 18 Mar 2020 18:41:01 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r53992 - in head: en_US.ISO8859-1/books/handbook/bsdinstall share/images/books/handbook/bsdinstall X-SVN-Group: doc-head X-SVN-Commit-Author: carlavilla X-SVN-Commit-Paths: in head: en_US.ISO8859-1/books/handbook/bsdinstall share/images/books/handbook/bsdinstall X-SVN-Commit-Revision: 53992 X-SVN-Commit-Repository: doc MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 18 Mar 2020 18:41:02 -0000 Author: carlavilla Date: Wed Mar 18 18:41:01 2020 New Revision: 53992 URL: https://svnweb.freebsd.org/changeset/doc/53992 Log: Reorganize the installation section to follow the bsdinstall steps Minor corrections Path by: carlavilla@ Approved by: bcr@(mentor) Differential Revision: https://reviews.freebsd.org/D24116 Modified: head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml head/share/images/books/handbook/bsdinstall/bsdinstall-configure-network-interface.png Modified: head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml Wed Mar 18 12:29:36 2020 (r53991) +++ head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml Wed Mar 18 18:41:01 2020 (r53992) @@ -1086,14 +1086,16 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4. Installing from the Network - The menu shown in only appears when - installing from a -bootonly.iso - CD as this installation media does not hold - copies of the installation files. Since the installation - files must be retrieved over a network connection, this menu - indicates that the network interface must be first - configured. + The menu shown in + only appears + when installing from a -bootonly.iso or + -mini-memstick.img as this installation + media does not hold copies of the installation files. + Since the installation files must be retrieved over a network + connection, this menu indicates that the network interface must + be configured first. If this menu is shown in any step of the + process remember to follow the instructions in + .
Installing from the Network @@ -1105,29 +1107,6 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4.
- - To configure the network connection, press - Enter and follow the instructions in . Once the - interface is configured, select a mirror site that is - located in the same region of the world as the computer on - which &os; is being installed. Files can be retrieved more - quickly when the mirror is close to the target computer, - reducing installation time. - -
- Choosing a Mirror - - - - - - -
- - Installation will then continue as if the installation - files were located on the local installation media. @@ -1943,7 +1922,7 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4. - +
Initializing Encryption @@ -2039,20 +2018,8 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4. - Post-Installation + Accounts, Time Zone, Services and Hardening - Once &os; is installed, - bsdinstall will prompt to configure - several options before booting into the newly installed system. - This section describes these configuration options. - - - Once the system has booted, - bsdconfig provides a menu-driven method for - configuring the system using these and additional - options. - - Setting the <systemitem class="username">root</systemitem> @@ -2077,270 +2044,6 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4.</s </figure> </sect2> - <sect2 xml:id="bsdinstall-config-network-dev"> - <title>Configuring Network Interfaces - - Next, a list of the network interfaces found on the - computer is shown. Select the interface to configure. - - - The network configuration menus will be skipped if the - network was previously configured as part of a - bootonly installation. - - -
- Choose a Network Interface - - - - - - -
- - If an Ethernet interface is selected, the installer will - skip ahead to the menu shown in . If a wireless - network interface is chosen, the system will instead scan for - wireless access points: - -
- Scanning for Wireless Access Points - - - - - - -
- - Wireless networks are identified by a Service Set - Identifier (SSID), a short, unique name - given to each network. SSIDs found during - the scan are listed, followed by a description of the - encryption types available for that network. If the desired - SSID does not appear in the list, select - [ Rescan ] to scan again. If - the desired network still does not appear, check for problems - with antenna connections or try moving the computer closer to - the access point. Rescan after each change is made. - -
- Choosing a Wireless Network - - - - - - -
- - Next, enter the encryption information for connecting to - the selected wireless network. WPA2 - encryption is strongly recommended as older encryption types, - like WEP, offer little security. If the - network uses WPA2, input the password, also - known as the Pre-Shared Key (PSK). For - security reasons, the characters typed into the input box are - displayed as asterisks. - -
- WPA2 Setup - - - - - - -
- - Next, choose whether or not an IPv4 - address should be configured on the Ethernet or wireless - interface: - -
- Choose <acronym>IPv4</acronym> Networking - - - - - - -
- - There are two methods of IPv4 - configuration. DHCP will automatically - configure the network interface correctly and should be used - if the network provides a DHCP server. - Otherwise, the addressing information needs to be input - manually as a static configuration. - - - Do not enter random network information as it will not - work. If a DHCP server is not available, - obtain the information listed in from - the network administrator or Internet service - provider. - - - If a DHCP server is available, select - [ Yes ] in the next menu to - automatically configure the network interface. The installer - will appear to pause for a minute or so as it finds the - DHCP server and obtains the addressing - information for the system. - -
- Choose <acronym>IPv4</acronym> <acronym>DHCP</acronym> - Configuration - - - - - - -
- - If a DHCP server is not available, - select [ No ] and input the - following addressing information in this menu: - -
- <acronym>IPv4</acronym> Static Configuration - - - - - - -
- - - - IP Address - The - IPv4 address assigned to this computer. - The address must be unique and not already in use by - another piece of equipment on the local network. - - - - Subnet Mask - The subnet mask for - the network. - - - - Default Router - The - IP address of the network's default - gateway. - - - - The next screen will ask if the interface should be - configured for IPv6. If - IPv6 is available and desired, choose - [ Yes ] to select it. - -
- Choose IPv6 Networking - - - - - - -
- - IPv6 also has two methods of - configuration. StateLess Address AutoConfiguration - (SLAAC) will automatically request the - correct configuration information from a local router. Refer - to http://tools.ietf.org/html/rfc4862 - for more information. Static configuration requires manual - entry of network information. - - If an IPv6 router is available, select - [ Yes ] in the next menu to - automatically configure the network interface. The installer - will appear to pause for a minute or so as it finds the router - and obtains the addressing information for the system. - -
- Choose IPv6 SLAAC Configuration - - - - - - -
- - If an IPv6 router is not available, - select [ No ] and input the - following addressing information in this menu: - -
- IPv6 Static Configuration - - - - - - -
- - - - IPv6 Address - The - IPv6 address assigned to this computer. - The address must be unique and not already in use by - another piece of equipment on the local network. - - - - Default Router - The - IPv6 address of the network's default - gateway. - - - - The last network configuration menu is used to configure - the Domain Name System (DNS) resolver, - which converts hostnames to and from network addresses. If - DHCP or SLAAC was used - to autoconfigure the network interface, the Resolver - Configuration values may already be filled in. - Otherwise, enter the local network's domain name in the - Search field. DNS #1 - and DNS #2 are the IPv4 - and/or IPv6 addresses of the - DNS servers. At least one - DNS server is required. - -
- DNS Configuration - - - - - - -
-
- Setting the Time Zone @@ -2423,8 +2126,8 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4.The appropriate date is selected using the arrow keys and then pressing - [ Set Date ]. Otherwise, - the date selection can be skipped pressing + [ Set Date ]. + Otherwise, the date selection can be skipped by pressing [ Skip ].
@@ -2440,8 +2143,8 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4.The appropriate time is selected using the arrow keys and then pressing - [ Set Time ]. Otherwise, - the time selection can be skipped pressing + [ Set Time ]. + Otherwise, the time selection can be skipped by pressing [ Skip ]. @@ -2519,7 +2222,7 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4. - + Enabling Hardening Security Options @@ -2611,7 +2314,7 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4. secure_console - When this option - is enabled, the prompt requests the root password when + is enabled, the prompt requests the root password when entering single. @@ -2972,6 +2675,285 @@ Starting sshd. shutdown -p now and the system will shut down cleanly, and if the hardware supports it, turn itself off. + + + + + Network Interfaces + + + Configuring Network Interfaces + + Next, a list of the network interfaces found on the + computer is shown. Select the interface to configure. + +
+ Choose a Network Interface + + + + + + +
+ + If an Ethernet interface is selected, the installer will + skip ahead to the menu shown in . If a wireless + network interface is chosen, the system will instead scan for + wireless access points: + +
+ Scanning for Wireless Access Points + + + + + + +
+ + Wireless networks are identified by a Service Set + Identifier (SSID), a short, unique name + given to each network. SSIDs found during + the scan are listed, followed by a description of the + encryption types available for that network. If the desired + SSID does not appear in the list, select + [ Rescan ] to scan again. If + the desired network still does not appear, check for problems + with antenna connections or try moving the computer closer to + the access point. Rescan after each change is made. + +
+ Choosing a Wireless Network + + + + + + +
+ + Next, enter the encryption information for connecting to + the selected wireless network. WPA2 + encryption is strongly recommended as older encryption types, + like WEP, offer little security. If the + network uses WPA2, input the password, also + known as the Pre-Shared Key (PSK). For + security reasons, the characters typed into the input box are + displayed as asterisks. + +
+ WPA2 Setup + + + + + + +
+ + Next, choose whether or not an IPv4 + address should be configured on the Ethernet or wireless + interface: + +
+ Choose <acronym>IPv4</acronym> Networking + + + + + + +
+ + There are two methods of IPv4 + configuration. DHCP will automatically + configure the network interface correctly and should be used + if the network provides a DHCP server. + Otherwise, the addressing information needs to be input + manually as a static configuration. + + + Do not enter random network information as it will not + work. If a DHCP server is not available, + obtain the information listed in from + the network administrator or Internet service + provider. + + + If a DHCP server is available, select + [ Yes ] in the next menu to + automatically configure the network interface. The installer + will appear to pause for a minute or so as it finds the + DHCP server and obtains the addressing + information for the system. + +
+ Choose <acronym>IPv4</acronym> <acronym>DHCP</acronym> + Configuration + + + + + + +
+ + If a DHCP server is not available, + select [ No ] and input the + following addressing information in this menu: + +
+ <acronym>IPv4</acronym> Static Configuration + + + + + + +
+ + + + IP Address - The + IPv4 address assigned to this computer. + The address must be unique and not already in use by + another piece of equipment on the local network. + + + + Subnet Mask - The subnet mask for + the network. + + + + Default Router - The + IP address of the network's default + gateway. + + + + The next screen will ask if the interface should be + configured for IPv6. If + IPv6 is available and desired, choose + [ Yes ] to select it. + +
+ Choose IPv6 Networking + + + + + + +
+ + IPv6 also has two methods of + configuration. StateLess Address AutoConfiguration + (SLAAC) will automatically request the + correct configuration information from a local router. Refer + to rfc4862 + for more information. Static configuration requires manual + entry of network information. + + If an IPv6 router is available, select + [ Yes ] in the next menu to + automatically configure the network interface. The installer + will appear to pause for a minute or so as it finds the router + and obtains the addressing information for the system. + +
+ Choose IPv6 SLAAC Configuration + + + + + + +
+ + If an IPv6 router is not available, + select [ No ] and input the + following addressing information in this menu: + +
+ IPv6 Static Configuration + + + + + + +
+ + + + IPv6 Address - The + IPv6 address assigned to this computer. + The address must be unique and not already in use by + another piece of equipment on the local network. + + + + Default Router - The + IPv6 address of the network's default + gateway. + + + + The last network configuration menu is used to configure + the Domain Name System (DNS) resolver, + which converts hostnames to and from network addresses. If + DHCP or SLAAC was used + to autoconfigure the network interface, the Resolver + Configuration values may already be filled in. + Otherwise, enter the local network's domain name in the + Search field. DNS #1 + and DNS #2 are the IPv4 + and/or IPv6 addresses of the + DNS servers. At least one + DNS server is required. + +
+ DNS Configuration + + + + + + +
+ + Once the interface is configured, select a mirror site + that is located in the same region of the world as the + computer on which &os; is being installed. Files can be + retrieved more quickly when the mirror is close to the + target computer, reducing installation time. + +
+ Choosing a Mirror + + + + + + +
Modified: head/share/images/books/handbook/bsdinstall/bsdinstall-configure-network-interface.png ============================================================================== Binary file (source and/or target). No diff available.