os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Reorganize the installation section to follow the bsdinstall steps

Browse source 
Minor corrections

Path by:	carlavilla@
Approved by:	bcr@(mentor)
Differential Revision:	https://reviews.freebsd.org/D24116
This commit is contained in:
Sergio Carlavilla Delgado 2020-03-18 18:41:01 +00:00
parent b37b441846
commit f6186b71ea
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=53992
2 changed files with 297 additions and 315 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

612
en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml
View file

@ -1086,14 +1086,16 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4.</screen>
<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.</screen>
</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.</screen>
</imageobject>
</mediaobject>
</figure>
<figure xml:id="bsdinstall-zfs-init-encription">
<title>Initializing Encryption</title>
@ -2039,19 +2018,7 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4.</screen>
</sect1>
<sect1 xml:id="bsdinstall-post">
<title>Post-Installation</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>
<title>Accounts, Time Zone, Services and Hardening</title>
<sect2 xml:id="bsdinstall-post-root">
<title>Setting the
@ -2077,270 +2044,6 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4.</screen>
</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>[&nbsp;Rescan&nbsp;]</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>[&nbsp;Yes&nbsp;]</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>[&nbsp;No&nbsp;]</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>[&nbsp;Yes&nbsp;]</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>[&nbsp;Yes&nbsp;]</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>[&nbsp;No&nbsp;]</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.</screen>
<para>The appropriate date is selected using the arrow keys
and then pressing
<guibutton>[&nbsp;Set&nbsp;Date&nbsp;]</guibutton>. Otherwise,
the date selection can be skipped pressing
<guibutton>[&nbsp;Set&nbsp;Date&nbsp;]</guibutton>.
Otherwise, the date selection can be skipped by pressing
<guibutton>[&nbsp;Skip&nbsp;]</guibutton>.</para>
<figure xml:id="bsdinstall-timezone-time">
@ -2440,8 +2143,8 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4.</screen>
<para>The appropriate time is selected using the arrow keys
and then pressing
<guibutton>[&nbsp;Set&nbsp;Time&nbsp;]</guibutton>. Otherwise,
the time selection can be skipped pressing
<guibutton>[&nbsp;Set&nbsp;Time&nbsp;]</guibutton>.
Otherwise, the time selection can be skipped by pressing
<guibutton>[&nbsp;Skip&nbsp;]</guibutton>.</para>
</sect2>
@ -2519,7 +2222,7 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4.</screen>
</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.</screen>
<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>
@ -2975,6 +2678,285 @@ Starting sshd.</screen>
</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>[&nbsp;Rescan&nbsp;]</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>[&nbsp;Yes&nbsp;]</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>[&nbsp;No&nbsp;]</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>[&nbsp;Yes&nbsp;]</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>[&nbsp;Yes&nbsp;]</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>[&nbsp;No&nbsp;]</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>
<sect1 xml:id="bsdinstall-install-trouble">
<title>Troubleshooting</title>

BIN
share/images/books/handbook/bsdinstall/bsdinstall-configure-network-interface.png
View file

Binary file not shown.
Side by side Swipe Overlay

Before

Width:  |  Height:  |  Size: 2.3 KiB

After

Width:  |  Height:  |  Size: 4.4 KiB