Date: Wed, 18 Mar 2020 18:41:01 +0000 (UTC) From: Sergio Carlavilla Delgado <carlavilla@FreeBSD.org> 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 Message-ID: <202003181841.02IIf1k9022334@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
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.</s <sect2 xml:id="bsdinstall-netinstall"> <title>Installing from the Network</title> - <para>The menu shown in <xref - linkend="bsdinstall-netinstall-notify"/> only appears when - installing from a <filename>-bootonly.iso</filename> - <acronym>CD</acronym> 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.</para> + <para>The menu shown in + <xref linkend="bsdinstall-netinstall-notify"/> only appears + when installing from a <filename>-bootonly.iso</filename> or + <filename>-mini-memstick.img</filename> 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 + <xref linkend="bsdinstall-config-network-dev"/>.</para> <figure xml:id="bsdinstall-netinstall-notify"> <title>Installing from the Network</title> @@ -1105,29 +1107,6 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4.</s </imageobject> </mediaobject> </figure> - - <para>To configure the network connection, press - <keycap>Enter</keycap> and follow the instructions in <xref - linkend="bsdinstall-config-network-dev"/>. 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.</para> - - <figure xml:id="bsdinstall-netinstall-mirror"> - <title>Choosing a Mirror</title> - - <mediaobject> - <imageobject> - <imagedata - fileref="bsdinstall/bsdinstall-netinstall-mirrorselect"/> - </imageobject> - </mediaobject> - </figure> - - <para>Installation will then continue as if the installation - files were located on the local installation media.</para> </sect2> </sect1> @@ -1943,7 +1922,7 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4.</s </imageobject> </mediaobject> </figure> - + <figure xml:id="bsdinstall-zfs-init-encription"> <title>Initializing Encryption</title> @@ -2039,20 +2018,8 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4.</s </sect1> <sect1 xml:id="bsdinstall-post"> - <title>Post-Installation</title> + <title>Accounts, Time Zone, Services and Hardening</title> - <para>Once &os; is installed, - <application>bsdinstall</application> will prompt to configure - several options before booting into the newly installed system. - This section describes these configuration options.</para> - - <tip> - <para>Once the system has booted, - <command>bsdconfig</command> provides a menu-driven method for - configuring the system using these and additional - options.</para> - </tip> - <sect2 xml:id="bsdinstall-post-root"> <title>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</title> - - <para>Next, a list of the network interfaces found on the - computer is shown. Select the interface to configure.</para> - - <note> - <para>The network configuration menus will be skipped if the - network was previously configured as part of a - <emphasis>bootonly</emphasis> installation.</para> - </note> - - <figure xml:id="bsdinstall-configure-net-interface"> - <title>Choose a Network Interface</title> - - <mediaobject> - <imageobject> - <imagedata - fileref="bsdinstall/bsdinstall-configure-network-interface"/> - </imageobject> - </mediaobject> - </figure> - - <para>If an Ethernet interface is selected, the installer will - skip ahead to the menu shown in <xref - linkend="bsdinstall-configure-net-ipv4"/>. If a wireless - network interface is chosen, the system will instead scan for - wireless access points:</para> - - <figure xml:id="bsdinstall-wireless-scan"> - <title>Scanning for Wireless Access Points</title> - - <mediaobject> - <imageobject> - <imagedata - fileref="bsdinstall/bsdinstall-configure-wireless-scan"/> - </imageobject> - </mediaobject> - </figure> - - <para>Wireless networks are identified by a Service Set - Identifier (<acronym>SSID</acronym>), a short, unique name - given to each network. <acronym>SSIDs</acronym> found during - the scan are listed, followed by a description of the - encryption types available for that network. If the desired - <acronym>SSID</acronym> does not appear in the list, select - <guibutton>[ Rescan ]</guibutton> 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.</para> - - <figure xml:id="bsdinstall-wireless-accesspoints"> - <title>Choosing a Wireless Network</title> - - <mediaobject> - <imageobject> - <imagedata - fileref="bsdinstall/bsdinstall-configure-wireless-accesspoints"/> - </imageobject> - </mediaobject> - </figure> - - <para>Next, enter the encryption information for connecting to - the selected wireless network. <acronym>WPA2</acronym> - encryption is strongly recommended as older encryption types, - like <acronym>WEP</acronym>, offer little security. If the - network uses <acronym>WPA2</acronym>, input the password, also - known as the Pre-Shared Key (<acronym>PSK</acronym>). For - security reasons, the characters typed into the input box are - displayed as asterisks.</para> - - <figure xml:id="bsdinstall-wireless-wpa2"> - <title>WPA2 Setup</title> - - <mediaobject> - <imageobject> - <imagedata - fileref="bsdinstall/bsdinstall-configure-wireless-wpa2setup"/> - </imageobject> - </mediaobject> - </figure> - - <para>Next, choose whether or not an <acronym>IPv4</acronym> - address should be configured on the Ethernet or wireless - interface:</para> - - <figure xml:id="bsdinstall-configure-net-ipv4"> - <title>Choose <acronym>IPv4</acronym> Networking</title> - - <mediaobject> - <imageobject> - <imagedata - fileref="bsdinstall/bsdinstall-configure-network-interface-ipv4"/> - </imageobject> - </mediaobject> - </figure> - - <para>There are two methods of <acronym>IPv4</acronym> - configuration. <acronym>DHCP</acronym> will automatically - configure the network interface correctly and should be used - if the network provides a <acronym>DHCP</acronym> server. - Otherwise, the addressing information needs to be input - manually as a static configuration.</para> - - <note> - <para>Do not enter random network information as it will not - work. If a <acronym>DHCP</acronym> server is not available, - obtain the information listed in <xref - linkend="bsdinstall-collect-network-information"/> from - the network administrator or Internet service - provider.</para> - </note> - - <para>If a <acronym>DHCP</acronym> server is available, select - <guibutton>[ Yes ]</guibutton> 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 - <acronym>DHCP</acronym> server and obtains the addressing - information for the system.</para> - - <figure xml:id="bsdinstall-net-ipv4-dhcp"> - <title>Choose <acronym>IPv4</acronym> <acronym>DHCP</acronym> - Configuration</title> - - <mediaobject> - <imageobject> - <imagedata - fileref="bsdinstall/bsdinstall-configure-network-interface-ipv4-dhcp"/> - </imageobject> - </mediaobject> - </figure> - - <para>If a <acronym>DHCP</acronym> server is not available, - select <guibutton>[ No ]</guibutton> and input the - following addressing information in this menu:</para> - - <figure xml:id="bsdinstall-net-ipv4-static"> - <title><acronym>IPv4</acronym> Static Configuration</title> - - <mediaobject> - <imageobject> - <imagedata - fileref="bsdinstall/bsdinstall-configure-network-interface-ipv4-static"/> - </imageobject> - </mediaobject> - </figure> - - <itemizedlist> - <listitem> - <para><literal>IP Address</literal> - The - <acronym>IPv4</acronym> address assigned to this computer. - The address must be unique and not already in use by - another piece of equipment on the local network.</para> - </listitem> - - <listitem> - <para><literal>Subnet Mask</literal> - The subnet mask for - the network.</para> - </listitem> - - <listitem> - <para><literal>Default Router</literal> - The - <acronym>IP</acronym> address of the network's default - gateway.</para> - </listitem> - </itemizedlist> - - <para>The next screen will ask if the interface should be - configured for <acronym>IPv6</acronym>. If - <acronym>IPv6</acronym> is available and desired, choose - <guibutton>[ Yes ]</guibutton> to select it.</para> - - <figure xml:id="bsdinstall-net-ipv6"> - <title>Choose IPv6 Networking</title> - - <mediaobject> - <imageobject> - <imagedata - fileref="bsdinstall/bsdinstall-configure-network-interface-ipv6"/> - </imageobject> - </mediaobject> - </figure> - - <para><acronym>IPv6</acronym> also has two methods of - configuration. StateLess Address AutoConfiguration - (<acronym>SLAAC</acronym>) will automatically request the - correct configuration information from a local router. Refer - to <link - xlink:href="http://tools.ietf.org/html/rfc4862">http://tools.ietf.org/html/rfc4862</link>; - for more information. Static configuration requires manual - entry of network information.</para> - - <para>If an <acronym>IPv6</acronym> router is available, select - <guibutton>[ Yes ]</guibutton> 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.</para> - - <figure xml:id="bsdinstall-net-ipv6-slaac"> - <title>Choose IPv6 SLAAC Configuration</title> - - <mediaobject> - <imageobject> - <imagedata - fileref="bsdinstall/bsdinstall-configure-network-interface-slaac"/> - </imageobject> - </mediaobject> - </figure> - - <para>If an <acronym>IPv6</acronym> router is not available, - select <guibutton>[ No ]</guibutton> and input the - following addressing information in this menu:</para> - - <figure xml:id="bsdinstall-net-ipv6-static"> - <title>IPv6 Static Configuration</title> - - <mediaobject> - <imageobject> - <imagedata - fileref="bsdinstall/bsdinstall-configure-network-interface-ipv6-static"/> - </imageobject> - </mediaobject> - </figure> - - <itemizedlist> - <listitem> - <para><literal>IPv6 Address</literal> - The - <acronym>IPv6</acronym> address assigned to this computer. - The address must be unique and not already in use by - another piece of equipment on the local network.</para> - </listitem> - - <listitem> - <para><literal>Default Router</literal> - The - <acronym>IPv6</acronym> address of the network's default - gateway.</para> - </listitem> - </itemizedlist> - - <para>The last network configuration menu is used to configure - the Domain Name System (<acronym>DNS</acronym>) resolver, - which converts hostnames to and from network addresses. If - <acronym>DHCP</acronym> or <acronym>SLAAC</acronym> was used - to autoconfigure the network interface, the <literal>Resolver - Configuration</literal> values may already be filled in. - Otherwise, enter the local network's domain name in the - <literal>Search</literal> field. <literal>DNS #1</literal> - and <literal>DNS #2</literal> are the <acronym>IPv4</acronym> - and/or <acronym>IPv6</acronym> addresses of the - <acronym>DNS</acronym> servers. At least one - <acronym>DNS</acronym> server is required.</para> - - <figure xml:id="bsdinstall-net-dns-config"> - <title>DNS Configuration</title> - - <mediaobject> - <imageobject> - <imagedata - fileref="bsdinstall/bsdinstall-configure-network-ipv4-dns"/> - </imageobject> - </mediaobject> - </figure> - </sect2> - <sect2 xml:id="bsdinstall-timezone"> <title>Setting the Time Zone</title> @@ -2423,8 +2126,8 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4.</s <para>The appropriate date is selected using the arrow keys and then pressing - <guibutton>[ Set Date ]</guibutton>. Otherwise, - the date selection can be skipped pressing + <guibutton>[ Set Date ]</guibutton>. + Otherwise, the date selection can be skipped by pressing <guibutton>[ Skip ]</guibutton>.</para> <figure xml:id="bsdinstall-timezone-time"> @@ -2440,8 +2143,8 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4.</s <para>The appropriate time is selected using the arrow keys and then pressing - <guibutton>[ Set Time ]</guibutton>. Otherwise, - the time selection can be skipped pressing + <guibutton>[ Set Time ]</guibutton>. + Otherwise, the time selection can be skipped by pressing <guibutton>[ Skip ]</guibutton>.</para> </sect2> @@ -2519,7 +2222,7 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4.</s </listitem> </itemizedlist> </sect2> - + <sect2 xml:id="bsdinstall-hardening"> <title>Enabling Hardening Security Options</title> @@ -2611,7 +2314,7 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4.</s <listitem> <para><literal>secure_console</literal> - When this option - is enabled, the prompt requests the root password when + is enabled, the prompt requests the root password when entering single.</para> </listitem> @@ -2972,6 +2675,285 @@ Starting sshd.</screen> <command>shutdown -p now</command> and the system will shut down cleanly, and if the hardware supports it, turn itself off.</para> + </sect2> + </sect1> + + <sect1 xml:id="bsdinstall-network"> + <title>Network Interfaces</title> + + <sect2 xml:id="bsdinstall-config-network-dev"> + <title>Configuring Network Interfaces</title> + + <para>Next, a list of the network interfaces found on the + computer is shown. Select the interface to configure.</para> + + <figure xml:id="bsdinstall-configure-net-interface"> + <title>Choose a Network Interface</title> + + <mediaobject> + <imageobject> + <imagedata + fileref="bsdinstall/bsdinstall-configure-network-interface"/> + </imageobject> + </mediaobject> + </figure> + + <para>If an Ethernet interface is selected, the installer will + skip ahead to the menu shown in <xref + linkend="bsdinstall-configure-net-ipv4"/>. If a wireless + network interface is chosen, the system will instead scan for + wireless access points:</para> + + <figure xml:id="bsdinstall-wireless-scan"> + <title>Scanning for Wireless Access Points</title> + + <mediaobject> + <imageobject> + <imagedata + fileref="bsdinstall/bsdinstall-configure-wireless-scan"/> + </imageobject> + </mediaobject> + </figure> + + <para>Wireless networks are identified by a Service Set + Identifier (<acronym>SSID</acronym>), a short, unique name + given to each network. <acronym>SSIDs</acronym> found during + the scan are listed, followed by a description of the + encryption types available for that network. If the desired + <acronym>SSID</acronym> does not appear in the list, select + <guibutton>[ Rescan ]</guibutton> 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.</para> + + <figure xml:id="bsdinstall-wireless-accesspoints"> + <title>Choosing a Wireless Network</title> + + <mediaobject> + <imageobject> + <imagedata + fileref="bsdinstall/bsdinstall-configure-wireless-accesspoints"/> + </imageobject> + </mediaobject> + </figure> + + <para>Next, enter the encryption information for connecting to + the selected wireless network. <acronym>WPA2</acronym> + encryption is strongly recommended as older encryption types, + like <acronym>WEP</acronym>, offer little security. If the + network uses <acronym>WPA2</acronym>, input the password, also + known as the Pre-Shared Key (<acronym>PSK</acronym>). For + security reasons, the characters typed into the input box are + displayed as asterisks.</para> + + <figure xml:id="bsdinstall-wireless-wpa2"> + <title>WPA2 Setup</title> + + <mediaobject> + <imageobject> + <imagedata + fileref="bsdinstall/bsdinstall-configure-wireless-wpa2setup"/> + </imageobject> + </mediaobject> + </figure> + + <para>Next, choose whether or not an <acronym>IPv4</acronym> + address should be configured on the Ethernet or wireless + interface:</para> + + <figure xml:id="bsdinstall-configure-net-ipv4"> + <title>Choose <acronym>IPv4</acronym> Networking</title> + + <mediaobject> + <imageobject> + <imagedata + fileref="bsdinstall/bsdinstall-configure-network-interface-ipv4"/> + </imageobject> + </mediaobject> + </figure> + + <para>There are two methods of <acronym>IPv4</acronym> + configuration. <acronym>DHCP</acronym> will automatically + configure the network interface correctly and should be used + if the network provides a <acronym>DHCP</acronym> server. + Otherwise, the addressing information needs to be input + manually as a static configuration.</para> + + <note> + <para>Do not enter random network information as it will not + work. If a <acronym>DHCP</acronym> server is not available, + obtain the information listed in <xref + linkend="bsdinstall-collect-network-information"/> from + the network administrator or Internet service + provider.</para> + </note> + + <para>If a <acronym>DHCP</acronym> server is available, select + <guibutton>[ Yes ]</guibutton> 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 + <acronym>DHCP</acronym> server and obtains the addressing + information for the system.</para> + + <figure xml:id="bsdinstall-net-ipv4-dhcp"> + <title>Choose <acronym>IPv4</acronym> <acronym>DHCP</acronym> + Configuration</title> + + <mediaobject> + <imageobject> + <imagedata + fileref="bsdinstall/bsdinstall-configure-network-interface-ipv4-dhcp"/> + </imageobject> + </mediaobject> + </figure> + + <para>If a <acronym>DHCP</acronym> server is not available, + select <guibutton>[ No ]</guibutton> and input the + following addressing information in this menu:</para> + + <figure xml:id="bsdinstall-net-ipv4-static"> + <title><acronym>IPv4</acronym> Static Configuration</title> + + <mediaobject> + <imageobject> + <imagedata + fileref="bsdinstall/bsdinstall-configure-network-interface-ipv4-static"/> + </imageobject> + </mediaobject> + </figure> + + <itemizedlist> + <listitem> + <para><literal>IP Address</literal> - The + <acronym>IPv4</acronym> address assigned to this computer. + The address must be unique and not already in use by + another piece of equipment on the local network.</para> + </listitem> + + <listitem> + <para><literal>Subnet Mask</literal> - The subnet mask for + the network.</para> + </listitem> + + <listitem> + <para><literal>Default Router</literal> - The + <acronym>IP</acronym> address of the network's default + gateway.</para> + </listitem> + </itemizedlist> + + <para>The next screen will ask if the interface should be + configured for <acronym>IPv6</acronym>. If + <acronym>IPv6</acronym> is available and desired, choose + <guibutton>[ Yes ]</guibutton> to select it.</para> + + <figure xml:id="bsdinstall-net-ipv6"> + <title>Choose IPv6 Networking</title> + + <mediaobject> + <imageobject> + <imagedata + fileref="bsdinstall/bsdinstall-configure-network-interface-ipv6"/> + </imageobject> + </mediaobject> + </figure> + + <para><acronym>IPv6</acronym> also has two methods of + configuration. StateLess Address AutoConfiguration + (<acronym>SLAAC</acronym>) will automatically request the + correct configuration information from a local router. Refer + to <link + xlink:href="http://tools.ietf.org/html/rfc4862">rfc4862</link>; + for more information. Static configuration requires manual + entry of network information.</para> + + <para>If an <acronym>IPv6</acronym> router is available, select + <guibutton>[ Yes ]</guibutton> 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.</para> + + <figure xml:id="bsdinstall-net-ipv6-slaac"> + <title>Choose IPv6 SLAAC Configuration</title> + + <mediaobject> + <imageobject> + <imagedata + fileref="bsdinstall/bsdinstall-configure-network-interface-slaac"/> + </imageobject> + </mediaobject> + </figure> + + <para>If an <acronym>IPv6</acronym> router is not available, + select <guibutton>[ No ]</guibutton> and input the + following addressing information in this menu:</para> + + <figure xml:id="bsdinstall-net-ipv6-static"> + <title>IPv6 Static Configuration</title> + + <mediaobject> + <imageobject> + <imagedata + fileref="bsdinstall/bsdinstall-configure-network-interface-ipv6-static"/> + </imageobject> + </mediaobject> + </figure> + + <itemizedlist> + <listitem> + <para><literal>IPv6 Address</literal> - The + <acronym>IPv6</acronym> address assigned to this computer. + The address must be unique and not already in use by + another piece of equipment on the local network.</para> + </listitem> + + <listitem> + <para><literal>Default Router</literal> - The + <acronym>IPv6</acronym> address of the network's default + gateway.</para> + </listitem> + </itemizedlist> + + <para>The last network configuration menu is used to configure + the Domain Name System (<acronym>DNS</acronym>) resolver, + which converts hostnames to and from network addresses. If + <acronym>DHCP</acronym> or <acronym>SLAAC</acronym> was used + to autoconfigure the network interface, the <literal>Resolver + Configuration</literal> values may already be filled in. + Otherwise, enter the local network's domain name in the + <literal>Search</literal> field. <literal>DNS #1</literal> + and <literal>DNS #2</literal> are the <acronym>IPv4</acronym> + and/or <acronym>IPv6</acronym> addresses of the + <acronym>DNS</acronym> servers. At least one + <acronym>DNS</acronym> server is required.</para> + + <figure xml:id="bsdinstall-net-dns-config"> + <title>DNS Configuration</title> + + <mediaobject> + <imageobject> + <imagedata + fileref="bsdinstall/bsdinstall-configure-network-ipv4-dns"/> + </imageobject> + </mediaobject> + </figure> + + <para>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.</para> + + <figure xml:id="bsdinstall-netinstall-mirror"> + <title>Choosing a Mirror</title> + + <mediaobject> + <imageobject> + <imagedata + fileref="bsdinstall/bsdinstall-netinstall-mirrorselect"/> + </imageobject> + </mediaobject> + </figure> </sect2> </sect1> Modified: head/share/images/books/handbook/bsdinstall/bsdinstall-configure-network-interface.png ============================================================================== Binary file (source and/or target). No diff available.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202003181841.02IIf1k9022334>