Difference between revisions of "Install/Network/en"

From Funtoo
Jump to: navigation, search
(Importing a new version from external source)
 
(Updating to match new version of source page)
Line 1: Line 1:
<noinclude>
+
{{InstallNavigation|num=15|prev=Bootloader|next=Finishing|title=Network}}
{{InstallPart|Network configuration}}
 
</noinclude>=== Configuring your network ===
 
  
 
It's important to ensure that you will be able to connect to your local-area network after you reboot into Funtoo Linux. There are three approaches you can use for configuring your network: NetworkManager, dhcpcd, and the [[Funtoo Linux Networking]] scripts. Here's how to choose which one to use based on the type of network you want to set up.
 
It's important to ensure that you will be able to connect to your local-area network after you reboot into Funtoo Linux. There are three approaches you can use for configuring your network: NetworkManager, dhcpcd, and the [[Funtoo Linux Networking]] scripts. Here's how to choose which one to use based on the type of network you want to set up.
  
==== Wi-Fi ====
+
==== Wi-Fi ====  
Most wifi cards require firmware, some do not, such as netgears wg311t atheros AR5212/AR5213.
 
{{console|body=(chroot) # ##i##emerge linux-firmware}}
 
===== Using NetworkManager =====
 
For laptop/mobile systems where you will be using Wi-Fi, roaming, and connecting to various networks NetworkManager is strongly recommended.  See the {{package|net-misc/networkmanager}} package for steps involved in setting up NetworkManager.
 
  
===== Using wpa_supplicant =====
+
For laptop/mobile systems where you will be using Wi-Fi, roaming, and connecting to various networks NetworkManager is strongly recommended.   
wpa_supplicant is a good choice for home wireless network connections where roaming is to a minimumSee the {{package|net-wireless/wpa_supplicant}} package for steps involved in setting up wpa_supplicant.
+
Since Wi-Fi cards require firmware to operate, it is also recommended that you emerge the linux-firmware ebuild:
  
==== Desktop (Wired Ethernet) ====
+
{{console|body=(chroot) # ##i##emerge linux-firmware networkmanager
 +
}}
  
For a home desktop or workstation with wired Ethernet that will use DHCP, the simplest and most effective option to enable network connectivity is to simply add {{c|dhcpcd}} to the default runlevel:
+
Depending on your architecture, you might now see a message similar to the following:
  
 
{{console|body=
 
{{console|body=
(chroot) # ##i##rc-update add dhcpcd default
+
The following USE changes are necessary to proceed
 +
...
 +
}}
 +
This means that your USE flags need to be updated to allow this installation. For now, you can let portage handle this for you by adding the flag <code>--autounmask-write</code>:
 +
{{console|body=(chroot) # ##i##emerge linux-firmware networkmanager --autounmask-write
 
}}
 
}}
 +
After this, update the config:
 +
{{console|body=(chroot) # ##i##dispatch-conf
 +
}}
 +
Accept the new config by pressing <code>u</code>. Then, you can proceed to install NetworkManager:
  
 +
{{console|body=(chroot) # ##i##emerge linux-firmware networkmanager
 +
(chroot) ###i## rc-update add NetworkManager default
 +
}}
 +
The above command will ensure that NetworkManager starts after you boot into Funtoo Linux. Once you've completed these installation steps and have booted into Funtoo Linux, you can use the {{c|nmtui}} command (which has an easy-to-use console-based interface) to configure NetworkManager so that it will connect (and automatically reconnect, after reboot) to a Wi-Fi access point:
 +
{{console|body=# ##i##nmtui}}
 +
For more information about NetworkManager, see the [[Package:NetworkManager|NetworkManager package page]].
 +
 +
{{Note|wpa_supplicant is also a good choice for wireless network connections. See the {{package|net-wireless/wpa_supplicant}} package for steps involved in setting up wpa_supplicant.}}
 +
 +
==== Desktop (Wired DHCP) ====
 +
 +
For a home desktop or workstation with wired Ethernet that will use DHCP, the simplest and most effective option to enable network connectivity is to simply add {{c|dhcpcd}} to the default runlevel:
 +
 +
{{console|body=
 +
(chroot) # ##i##rc-update add dhcpcd default}}
 
When you reboot, {{c|dhcpcd}} will run in the background and manage all network interfaces and use DHCP to acquire network addresses from a DHCP server.
 
When you reboot, {{c|dhcpcd}} will run in the background and manage all network interfaces and use DHCP to acquire network addresses from a DHCP server.
  
 
If your upstream DHCP server is dnsmasq, it can be configured to assign addresses via mac address to make servers on DHCP feasible.
 
If your upstream DHCP server is dnsmasq, it can be configured to assign addresses via mac address to make servers on DHCP feasible.
  
==== Server (Static IP) ====
+
==== Server (Static IP) ====  
===== Funtoo Networking Scripts =====
+
 
 
For servers, the [[Funtoo Linux Networking]] scripts are recommended. They are optimized for static configurations and things like virtual ethernet bridging for virtualization setups. See [[Funtoo Linux Networking]] for information on how to use Funtoo Linux's template-based network configuration system.
 
For servers, the [[Funtoo Linux Networking]] scripts are recommended. They are optimized for static configurations and things like virtual ethernet bridging for virtualization setups. See [[Funtoo Linux Networking]] for information on how to use Funtoo Linux's template-based network configuration system.
 
===== Iproute2 / Net-Tools =====
 
A lesser prefered way to configure static ip addresses and routes is by the legacy net-tools, or iproute2 package.  See: {{package|sys-apps/iproute2}}
 
  
 
==== Hostname ====
 
==== Hostname ====

Revision as of 04:25, September 12, 2018

Install Guide, Chapter 15 < Prev Next >

It's important to ensure that you will be able to connect to your local-area network after you reboot into Funtoo Linux. There are three approaches you can use for configuring your network: NetworkManager, dhcpcd, and the Funtoo Linux Networking scripts. Here's how to choose which one to use based on the type of network you want to set up.

Wi-Fi

For laptop/mobile systems where you will be using Wi-Fi, roaming, and connecting to various networks NetworkManager is strongly recommended. Since Wi-Fi cards require firmware to operate, it is also recommended that you emerge the linux-firmware ebuild:

(chroot) # emerge linux-firmware networkmanager

Depending on your architecture, you might now see a message similar to the following:

The following USE changes are necessary to proceed
...

This means that your USE flags need to be updated to allow this installation. For now, you can let portage handle this for you by adding the flag --autounmask-write:

(chroot) # emerge linux-firmware networkmanager --autounmask-write

After this, update the config:

(chroot) # dispatch-conf

Accept the new config by pressing u. Then, you can proceed to install NetworkManager:

(chroot) # emerge linux-firmware networkmanager
(chroot) # rc-update add NetworkManager default

The above command will ensure that NetworkManager starts after you boot into Funtoo Linux. Once you've completed these installation steps and have booted into Funtoo Linux, you can use the nmtui command (which has an easy-to-use console-based interface) to configure NetworkManager so that it will connect (and automatically reconnect, after reboot) to a Wi-Fi access point:

root # nmtui

For more information about NetworkManager, see the NetworkManager package page.

   Note

wpa_supplicant is also a good choice for wireless network connections. See the net-wireless/wpa_supplicant package for steps involved in setting up wpa_supplicant.

Desktop (Wired DHCP)

For a home desktop or workstation with wired Ethernet that will use DHCP, the simplest and most effective option to enable network connectivity is to simply add dhcpcd to the default runlevel:

(chroot) # rc-update add dhcpcd default

When you reboot, dhcpcd will run in the background and manage all network interfaces and use DHCP to acquire network addresses from a DHCP server.

If your upstream DHCP server is dnsmasq, it can be configured to assign addresses via mac address to make servers on DHCP feasible.

Server (Static IP)

For servers, the Funtoo Linux Networking scripts are recommended. They are optimized for static configurations and things like virtual ethernet bridging for virtualization setups. See Funtoo Linux Networking for information on how to use Funtoo Linux's template-based network configuration system.

Hostname

By default Funtoo uses "localhost" as hostname. Although the system will work perfectly fine using this name, some ebuilds refuse to install when detecting localhost as hostname. It also may create confusion if several systems use the same hostname. Therefore, it is advised to change it to a more meaningful name. The hostname itself is arbitrary, meaning you can choose almost any combination of characters, as long as it makes sense to the system administrator. To change the hostname, edit

(chroot) # nano /etc/conf.d/hostname

Look for the line starting with hostname and change the entry between the quotes. Save the file, on the next boot Funtoo will use the new hostname.

   Warning

Do not use special characters in the hostname, as the shell may interpret these, leading to unpredictable results. Use the Latin alphabet: a-z, A-Z, 0-9

   Tip

Use short hostnames (up to 8 or 10 characters) to prevent the terminal screen being filled with the hostname, leaving little space for the command itself. This become particularly poignant when coding long command strings in various programming languages like Bash, Python, SQL and Perl