Difference between revisions of "Network Configuration/9.2"

From PC-BSD Wiki
Jump to: navigation, search
 
(75 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<noinclude>{{NavHeader|back=Scanner|forward=Firewall Manager}}</noinclude>
+
<noinclude><translate>
During installation, PC-BSD configures your network interfaces to use DHCP. In most cases, this means that your connected interfaces should "just work" whenever you use your PC-BSD system.
+
  
Beginning with PC-BSD 9.0, a wireless configuration icon is included in the system tray. If you have an enabled wireless interface, PC-BSD will automatically scan for wireless networks and, if you have created any network profiles, try to associate using the listed order of your profiles. If you hover over the wireless icon, as seen in Figure 7.7a, it will indicate if the interface is associated and provide information regarding the IP address, IPv6 address, SSID, connection strength, connection speed, MAC address, and type of wireless device.
+
<!--T:1-->
 +
{{UseTOC{{putVers}}|Nav}}</noinclude>
  
'''Figure 7.7a: Wireless Information in System Tray''' SHOULD UPDATE IMAGE to match current updater icon
+
<!--T:2-->
 +
During installation, PC-BSD® configures your Ethernet interfaces to use DHCP and provides a {{local|link=Connect to a Wireless Network|post-install configuration screen to configure your wireless connection}}. In most cases, this means that your connected interfaces should "just work" whenever you use your PC-BSD® system.
  
[[File:Wireless.jpeg]]
+
<!--T:3-->
 +
For desktops that provide a system tray, a wireless configuration icon will appear if PC-BSD® detects a supported wireless card. If you hover over the wireless icon, shown in Figure 8.16a, it will indicate if the interface is associated and provide information regarding the IP address, IPv6 address, SSID, connection strength, connection speed, MAC address, and type of wireless device.
  
If you right-click the wireless icon, you will see a listing of all found wireless networks. Simply click the name of a network to associate with it. The right-click menu also provides options to configure the wireless device, start the Network Manager, restart the network (useful if you need to renew your DHCP address), and to close the network monitor so that the icon no longer shows in the system tray. If you have multiple wireless devices, each will have its own icon in the system tray. If you don't use one of the devices, use "close the network monitor" to remove it from the tray.
+
<!--T:4-->
 +
[[File:Wireless.png|thumb|260px|'''Figure 8.16a: Wireless Information in System Tray''']]
  
You still have the ability to view or manually configure your network settings using Control Panel ➜ Network Configuration, seen in Figure 7.7b.  
+
<!--T:5-->
 +
If you right-click the wireless icon, you will see a list of detected wireless networks. Simply click the name of a network to associate with it. The right-click menu also provides options to configure the wireless device, start the Network Manager, restart the network (useful if you need to renew your DHCP address), and to close the Network Monitor so that the icon no longer shows in the system tray. If you have multiple wireless devices, each will have its own icon in the system tray. If you do not use one of the devices, click ''Close the Network Monitor'' to remove it from the tray.
  
'''Figure 7.7b: Network Configuration Utility'''
+
<!--T:6-->
 +
To view or manually configure all of your network interfaces click {{traverse|Control Panel|Network Configuration|here=Network Configuration}} or type '''pc-su pc-netmanager'''. If a new device has been inserted (e.g. a USB wireless interface), a pop-up message will open when you start Network Configuration, indicate the name of the new device, and ask if you would like to enable it. Click ''Yes'' and the new device will be displayed with the list of network interfaces that PC-BSD® recognizes. In the example seen in Figure 8.16b, the system has one Realtek Ethernet interface that uses the ''em'' driver and a wireless interface that uses the ''wlan'' driver.
  
[[File:Network4a.png]]
+
<!--T:7-->
 +
[[File:Network4b.png|thumb|393px|'''Figure 8.16b: Network Configuration Utility''']]
  
If a new device has been inserted (e.g. a USB wireless interface), a pop-up message will open when you start Network Configuration, indicate the name of the new device and ask if you would like to enable it. Click Yes and the new device will be displayed with the list of network interfaces that PC-BSD recognizes. In the example seen in Figure 7.7b, this system has one Realtek Ethernet interface that uses the ''re'' driver and a wireless interface that uses the ''wlan'' driver.
+
<!--T:8-->
 +
The rest of this section describes each tab of the Network Configuration utility and demonstrate how to view and configure the network settings for both Ethernet and wireless devices. It will then present some common troubleshooting scenarios, known issues, and suggestions for when a device does not have a built-in driver.
  
'''Note:''' the 0 next to each driver name indicates that it is the first interface that uses that driver. If, for example, the system had two Realtek cards, the second interface would be labeled as ''re1''. You can learn more about the capabilities of a driver by reading its manpage (without the number). In this example, the associated man pages are '''man re''' and '''man wlan'''.
+
=== Devices: Ethernet Adapters === <!--T:9-->
  
The rest of this section will describe each tab of the Network Configuration utility and demonstrate how to view and configure the network settings for both Ethernet and wireless devices. It will then present some common troubleshooting scenarios, known issues, and suggestions for when a device does not have a built-in driver.
+
<!--T:10-->
 +
If you highlight an Ethernet interface in the ''Devices'' tab and either click the ''Configure'' button or double-click the interface name, you will see the screen shown in Figure 8.16c:
  
=== Devices: Ethernet Adapters ===
+
<!--T:11-->
 +
[[File:Networkmanager1a.png|thumb|393px|'''Figure 8.16c: Network Settings for an Ethernet Interface''']]
  
If you highlight an Ethernet interface in the Devices tab and either click the Configure button or double-click the interface name, you will see the screen shown in  Figure 7.7c:
+
<!--T:12-->
 +
There are two ways to configure an Ethernet interface:<br>
 +
# '''Use DHCP:''' this method assumes that your Internet provider or network assigns your addressing information automatically using the DHCP protocol. Most networks are already setup to do this. This method is recommended as it should "just work".<br>
 +
# '''Manually type in the IP addressing information:''' this method requires you to understand the basics of TCP/IP addressing or to know which IP address you should be using on your network. If you do not know which IP address or subnet mask to use, you will have to ask your Internet provider or network administrator.<br>
  
'''Figure 7.7c: Network Settings for an Example re0 Ethernet Interface'''
+
<!--T:13-->
 +
By default, PC-BSD® will attempt to obtain an address from a DHCP server. If you wish to manually type in your IP address, check the box "Assign static IP address". Type in the IP address, using the right arrow key or the mouse to move between octets. Then, double-check that the subnet mask (Netmask) is the correct value and change it if it is not.
  
[[File:Networkmanager1a.png]]
+
<!--T:14-->
 +
If the Ethernet network uses 802.1x authentication, check the box "Enable WPA authentication" which will enable the "Configure WPA" button. Click this button to select the network and to input the authentication values required by the network.
  
There are two ways to configure an Ethernet interface:
+
<!--T:15-->
 +
By default, the "Disable this network device" box is unchecked. If you check this checkbox, PC-BSD® will immediately stop the interface from using the network. The interface will remain inactive until this checkbox is unchecked.
  
1. '''Use DHCP:''' this method assumes that your Internet provider or network assigns your addressing information automatically using the DHCP protocol. Most networks are already setup to do this. This method is recommended as it should "just work".
+
<!--T:16-->
 +
The "Advanced" tab, seen in Figure 8.16d, allows advanced users to change their {{citelink|wp|url=MAC_address|txt=MAC address}} and to use DHCP to automatically obtain an {{citelink|wp|url=IPv6_address|txt=IPv6 address}}. Both boxes should remain checked unless you are an advanced user who has a reason to change the default MAC or IPv6 address and you understand how to input an appropriate replacement address.
  
2. '''Manually type in the IP addressing information:''' this method requires you to understand the basics of TCP/IP addressing or to know which IP address you should be using on your network. If you don't know which IP address or subnet mask to use, you will have to ask your Internet provider or network administrator.
+
<!--T:17-->
 +
[[File:Networkmanager2b.png|thumb|'''Figure 8.16d: Advanced Tab of an Ethernet Interface's Network Settings''']]
  
By default, PC-BSD will attempt to obtain an address from a DHCP server. If you wish to manually type in your IP address, check the box "Assign static IP address". Type in the IP address, using the right arrow key or the mouse to move between octets. Then, double-check that the subnet mask (Netmask) is the correct value and change it if it is not.
+
<!--T:18-->
 +
The "Info" tab, seen in Figure 8.16e, will display the current network address settings and some traffic statistics.  
  
If the Ethernet network requires authentication (i.e. uses 802.1x), check the box "Enable WPA authentication" which will enable the "Configure WPA" button. Click this button to select the network and to input the authentication values required by the network.
+
<!--T:19-->
 +
[[File:Networkmanager3a.png|thumb|'''Figure 8.16e: Info Tab of an Ethernet Interface's Network Settings''']]
  
By default, the "Disable this network device" box is unchecked. If you do not want this interface card to be configured whenever you boot your computer, uncheck this box. If you decide later that you do want to use this network card, go back into the Network Configuration utility and recheck this box.
+
<!--T:20-->
 
+
If you make any changes within any of the tabs, click the "Apply" button to activate them. Click the "OK" button when you are finished to go back to the main Network Configuration window.
The Advanced tab, seen in Figure 7.7d, allows advanced users to change their {{citelink|url=http://en.wikipedia.org/wiki/Mac_address|MAC address}} and to use DHCP to automatically obtain an {{citelink|url=http://en.wikipedia.org/wiki/IPv6_address|IPv6 address}}. Both boxes should remain checked unless you are an advanced user who has a reason to change the default MAC or IPv6 address and you understand how to input an appropriate replacement address.
+
 
+
'''Figure 7.7d: Advanced Tab of an Ethernet Interface's Network Settings'''
+
 
+
[[File:Networkmanager2.png]]
+
 
+
The Info tab, seen in Figure 7.7e, will display the current network address settings and some traffic statistics. If you check the checkbox to disable the network device, it will immediately stop the interface from using the network. The interface will stay inactive until this checkbox is unchecked.
+
 
+
'''Figure 7.7e: Viewing an Ethernet Interface's Network Settings and Traffic Statistics Using the Info Tab'''
+
 
+
[[File:Networkmanager3.png]]
+
 
+
If you make any changes within any of the tabs, click the Apply button to activate them. Click the OK button when you are finished to go back to the main Network Configuration window.
+
  
 +
<!--T:21-->
 
You can repeat this procedure for each network interface that you wish to view or configure.
 
You can repeat this procedure for each network interface that you wish to view or configure.
  
=== Devices: Wireless Adapters ===
+
=== Devices: Wireless Adapters === <!--T:22-->
  
If your wireless interface does not automatically associate with a wireless network, you probably need to configure a wireless profile that contains the security settings required by the wireless network. To access these settings, either double-click the wireless icon in the system tray or highlight the wireless interface displayed in the Devices tab of Network Configuration and click the Configure button. Figure 7.7f demonstrates that this system's wireless interface is currently not associated with any wireless networks as there aren't any listed in the "Configured Network Profiles" section:
+
<!--T:23-->
 +
If your wireless interface does not automatically associate with a wireless network, you probably need to configure a wireless profile that contains the security settings required by the wireless network. Double-click the wireless icon in the system tray or highlight the wireless interface displayed in the "Devices" tab of Network Configuration and click the "Configure" button. Figure 8.16f demonstrates that this system's wireless interface is currently not associated with any wireless networks as none are listed in the "Configured Network Profiles" section:
  
'''Figure 7.7f: Wireless Configuration Window of Network Configuration Utility'''
+
<!--T:24-->
 +
[[File:Hidden1.png|thumb|393px|'''Figure 8.16f: Wireless Configuration Window of Network Configuration Utility''']]
  
[[File:Hidden1.png]]
+
<!--T:25-->
 +
To associate with a wireless network, click the "Scan" button to receive the list of possible wireless networks to connect to. Highlight the network you wish to associate with and click the "Add Selected" button. If the network requires authentication, a pop-up window will prompt you for the authentication details. Input the values required by the network then click the "Close" button. PC-BSD® will add an entry for the network in the "Configured Network Profiles" section.  
  
To associate with a wireless network, click the Scan button to receive the list of possible wireless networks to connect to. Highlight the network you wish to associate with and click the "Add Selected" button. If the network requires authentication, a pop-up window will prompt you for the authentication details. Input the values required by the network then click the Close button. PC-BSD will add an entry for the network in the "Configured Network Profiles" section. If you wish to add multiple networks, use the arrow keys to place them in the desired connection order. PC-BSD will try to connect to the first profile in the list and will move down the list in order if it is unable to connect. When finished, click the Apply button. A pop-up message will indicate that PC-BSD is restarting the network. If all went well, there should be an IP address and status of "associated" when you hover over the wireless icon in the system tray. If this is not the case, double-check for typos in your configuration values and read the section on [[#Troubleshooting Network Settings|Troubleshooting Network Settings]].
+
<!--T:26-->
 +
If the network is hidden, click the ''Add Hidden'' button, input the name of the network in the pop-up window, and click “OK”.
  
PC-BSD supports the types of authentication shown in Figure 7.7g. You can access this screen (and change your authentication settings) by highlighting an entry in the "Configured Network Profiles" section and clicking the Edit button.
+
<!--T:27-->
 +
If you add multiple networks, use the arrow keys to place them in the desired connection order. PC-BSD® will try to connect to the first profile in the list and will move down the list in order if it is unable to connect. When finished, click the "Apply" button. A pop-up message will indicate that PC-BSD® is restarting the network. If all went well, there should be an IP address and status of "associated" when you hover over the wireless icon in the system tray. If this is not the case, double-check for typos in your configuration values and read the section on {{local|link=Network Configuration|anchor=Troubleshooting Network Settings|Troubleshooting Network Settings}}.
  
'''Figure 7.7g: Configuring Wireless Authentication Settings'''
+
<!--T:28-->
 +
PC-BSD® supports the types of authentication shown in Figure 8.16g. You can access this screen (and change your authentication settings) by highlighting an entry in the "Configured Network Profiles" section and clicking the "Edit" button.
  
[[File:Network81.jpeg]]
+
<!--T:29-->
 +
[[File:Network8c.png|thumb|'''Figure 8.16g: Configuring Wireless Authentication Settings''']]
  
 +
<!--T:30-->
 
This screen allows you to configure the following types of wireless security:
 
This screen allows you to configure the following types of wireless security:
  
* '''Disabled:''' indicates that the network is open and no additional configuration is required.
+
<!--T:31-->
 +
* '''Disabled:''' if the network is open, no additional configuration is required.
  
* '''WEP:''' this type of network can be configured to use either a hex or a plaintext key. If you click WEP then the Configure button, you will see the screen shown in Figure 7.7h. Type the key into both network key boxes. If the key is complex, check the "Show Key" box to make sure that the passwords are correct and that they match; you can uncheck this box when you are finished to replace the characters in the key with the * symbol. A wireless access point that uses WEP can store up to 4 keys; the number in the key index indicates which key you wish to use.
+
<!--T:32-->
 +
* '''WEP:''' this type of network can be configured to use either a hex or a plaintext key. If you click WEP then the "Configure" button, you will see the screen shown in Figure 8.16h. Type the key into both network key boxes. If the key is complex, check the ''Show Key'' box to make sure that the passwords are correct and that they match. Uncheck this box when you are finished to replace the characters in the key with the * symbol. A wireless access point that uses WEP can store up to 4 keys; the number in the key index indicates which key you wish to use.
  
* '''WPA Personal:''' this type of network uses a plaintext key. If you click WPA Personal then the Configure button, you will see the screen shown in Figure 7.7i. Type in the key twice to verify it. If the key is complex, you can check the "Show Key" box to make sure the passwords match.
+
<!--T:33-->
 +
* '''WPA Personal:''' this type of network uses a plaintext key. If you click WPA Personal then the ''Configure'' button, you will see the screen shown in Figure 8.16i. Type in the key twice to verify it. If the key is complex, you can check the ''Show Key'' box to make sure the passwords match.
  
* '''WPA Enterprise:''' if you click WPA Enterprise then the Configure button, you will see the screen shown in Figure 7.7j. Select the authentication method (EAP-TLS, EAP-TTLS, or EAP-PEAP), input the EAP identity, browse for the CA certificate, client certificate and private key file, and input and verify the password.  
+
<!--T:34-->
 +
* '''WPA Enterprise:''' if you click WPA Enterprise then the ''Configure'' button, you will see the screen shown in Figure 8.16j. Select the authentication method (EAP-TLS, EAP-TTLS, or EAP-PEAP); input the EAP identity; browse for the CA certificate, client certificate and private key file; and input and verify the password.  
  
'''NOTE:'''If you are unsure which type of encryption is being used, ask the person who setup the wireless router. They should also be able to give you the value of any of the settings seen in these configuration screens.  
+
<!--T:35-->
 +
{{note|width=auto|icon64=if you are unsure which type of encryption is being used, ask the person who setup the wireless router. They should also be able to give you the value of any of the settings seen in these configuration screens.}}
  
'''Figure 7.7h: WEP Security Settings'''
+
<!--T:36-->
 +
[[File:Network8a.jpeg|thumb|393px|'''Figure 8.16h: WEP Security Settings''']]
  
[[File:Network8a.jpeg]]
+
<!--T:37-->
 +
[[File:Network8b.jpeg|thumb|393px|'''Figure 8.16i: WPA Personal Security Settings''']]
  
'''Figure 7.7i: WPA Personal Security Settings'''
+
<!--T:38-->
 +
[[File:Network8d.png|thumb|393px|'''Figure 8.16j: WPA Enterprise Security Settings''']]
  
[[File:Network8b.jpeg]]
+
<!--T:39-->
 +
If you wish to disable this wireless interface, check the ''Disable this wireless device'' box. This setting can be desirable if you want to temporarily prevent the wireless interface from connecting to untrusted wireless networks.  
  
'''Figure 7.7j: WPA Enterprise Security Settings'''
+
<!--T:40-->
 +
The ''Advanced'' tab, seen in Figure 8.16k, allows you to configure the following:
  
[[File:Network8c.jpeg]]
+
<!--T:41-->
 +
* a custom MAC address. This setting is for advanced users and requires the ''Use hardware default MAC address'' box to be unchecked.
  
If you wish to disable this wireless interface, check the box "Disable this wireless device". This setting can be desirable if you want to temporarily prevent the wireless interface from connecting to untrusted wireless networks.  
+
<!--T:42-->
 +
* how the interface receives its IP address information. If the network contains a DHCP server, check the ''Obtain IP automatically (DHCP)'' box. Otherwise, input the IP address and subnet mask to use on the network.
  
The Advanced tab, seen in Figure 7.7k, allows you to input a custom MAC address or to assign a static IP address. This is similar to the Advanced tab for an Ethernet interface in that these settings are meant for advanced users.  
+
<!--T:43-->
 +
* the country code. This setting is not required if you are in North America. For other countries, check the ''Set Country Code'' box and select your country from the drop-down menu.
  
'''Figure 7.7k: Advanced Tab of a Wireless Interface'''
+
<!--T:44-->
 +
[[File:Network10a.png|thumb|'''Figure 8.16k: Advanced Tab of a Wireless Interface''']]
  
[[File:Network10.jpeg]]
+
<!--T:45-->
 +
The ''Info'' tab, seen in Figure 8.16l, shows the current network status and statistics for the wireless interface:
  
The Info tab, seen in Figure 7.7l, shows the current network status and statistics for the wireless interface:
+
<!--T:46-->
 +
[[File:Network11a.png|thumb|'''Figure 8.16l: Info Tab of a Wireless Interface''']]
  
'''Figure 7.7l: Info Tab of a Wireless Interface Displays its Network Status and Statistics'''
+
=== Network Configuration (Advanced) === <!--T:47-->
  
[[File:Network11.jpeg]]
+
<!--T:48-->
 +
The ''Network Configuration (Advanced)'' tab of the Network Configuration utility is seen in Figure 8.16m. The displayed information is for the currently highlighted interface. If you wish to edit these settings, make sure that the interface that you wish to configure is highlighted in the ''Devices'' tab.
  
=== Network Configuration (Advanced) ===
+
<!--T:49-->
 +
[[File:Networkmanager5d.png|thumb|343px|'''Figure 8.16m: Network Configuration (Advanced) tab of the Network Configuration Utility''']]
  
The Network Configuration (Advanced) tab of the Network Configuration utility is seen in Figure 7.7m:
+
<!--T:50-->
 +
If the interface receives its IP address information from a DHCP server, this screen allows you to view the received DNS information. If you wish to override the default DNS settings or set them manually, check the ''Enable Custom DNS'' box. You can then set the following:
  
'''Figure 7.7m: Network Configuration (Advanced) tab of the Network Configuration Utility'''
+
<!--T:51-->
 
+
'''DNS 1:''' the IP address of the primary DNS server. If you do not know which IP address to use, click the ''Public servers'' button to select a public DNS server.
[[File:Networkmanager5c.png]]
+
 
+
This tab is divided into three sections. If you wish to edit these settings, make sure that the interface that you wish to configure is highlighted in the Devices tab.
+
 
+
The following settings can be modified in the "System configuration settings" section:
+
 
+
'''DNS 1:''' the IP address of the primary DNS server.
+
  
 +
<!--T:52-->
 
'''DNS 2:''' the IP address of the secondary DNS server.
 
'''DNS 2:''' the IP address of the secondary DNS server.
  
 +
<!--T:53-->
 
'''Search Domain:''' the name of the domain served by the DNS server.
 
'''Search Domain:''' the name of the domain served by the DNS server.
  
'''Hostname:''' the name of your computer.
+
<!--T:54-->
 
+
If you wish to change or set the default gateway, check the ''Enable Custom Gateway'' box and input the IP address of the default gateway.
'''Gateway:''' the IP address of the network's default gateway.
+
  
The following settings can be modified in the "Enable IPv6 Support" section:
+
<!--T:55-->
 +
The following settings can be modified in the IPv6 section:
  
'''Enable IPv6 support:''' if this box is checked, the specified interface can participate in IPv6 networks and the IPv6 settings will no longer be greyed out.
+
<!--T:56-->
 +
'''Enable IPv6 support:''' if this box is checked, the specified interface can participate in IPv6 networks.
  
 +
<!--T:57-->
 
'''IPv6 gateway:''' the IPv6 address of the default gateway used on the IPv6 network.
 
'''IPv6 gateway:''' the IPv6 address of the default gateway used on the IPv6 network.
  
'''IPv6 DNS 1:''' the IPv6 address of the primary DNS server used on the IPv6 network.
+
<!--T:58-->
 +
'''IPv6 DNS 1:''' the IPv6 address of the primary DNS server used on the IPv6 network. If you do not know which IP address to use, click the ''Public servers'' button to select a public DNS server.
  
 +
<!--T:59-->
 
'''IPv6 DNS 2:''' the IPv6 address of the secondary DNS server used on the IPv6 network.
 
'''IPv6 DNS 2:''' the IPv6 address of the secondary DNS server used on the IPv6 network.
  
The Misc section contains one configurable option:
+
<!--T:60-->
 +
The ''Misc'' section allows you to configure these options:
  
'''Enable wireless/wired failover via lagg0 interface:''' the {{citelink|url=http://www.freebsd.org/cgi/man.cgi?query=lagg|lagg}} interface allows you to seamlessly switch between using an Ethernet interface and a wireless interface. If you want this functionality, check this box.  
+
<!--T:61-->
 +
'''System Hostname:''' the name of your computer. It must be unique on your network.
  
'''NOTE:''' some users experience problems using lagg. If you have problems connecting to a network using an interface that previously worked, uncheck this box and remove any references to "lagg" in your ''/etc/rc.conf'' file.
+
<!--T:62-->
+
'''Enable wireless/wired failover via lagg0 interface:''' the {{citelink|url=http://www.freebsd.org/cgi/man.cgi?query=lagg|txt=lagg}} interface allows you to seamlessly switch between using an Ethernet interface and a wireless interface. If you want this functionality, check this box.  
If you make any changes within this window, click the Save button to apply them.
+
  
=== Proxy Settings ===
+
<!--T:63-->
 +
{{note|width=auto|icon64=some users experience problems using lagg. If you have problems connecting to a network using an interface that previously worked, uncheck this box and remove any references to "lagg" in your ''/etc/rc.conf'' file.}}
 +
 +
If you make any changes within this window, click the ''Save'' button to apply them.
  
The proxy settings tab, shown in Figure 7.7o, is used when your network requires you to go through a proxy server in order to access the Internet.
+
=== Proxy Settings === <!--T:64-->
  
'''Figure 7.7o: Proxy Settings Configuration'''
+
<!--T:65-->
 +
The ''Proxy'' tab, shown in Figure 8.16n, is used when your network requires you to go through a proxy server in order to access the Internet.
  
[[File:Network3d.png]]
+
<!--T:66-->
 +
[[File:Network3d.png|thumb|343px|'''Figure 8.16n: Proxy Settings Configuration''']]
  
Check the "Proxy Configuration" check box to activate the settings. The follow settings can be configured in this screen:
+
<!--T:67-->
 +
Check the ''Proxy Configuration'' check box to activate the settings. The follow settings can be configured in this screen:
  
 +
<!--T:68-->
 
'''Server Address:''' enter the IP address or hostname of the proxy server.
 
'''Server Address:''' enter the IP address or hostname of the proxy server.
  
 +
<!--T:69-->
 
'''Port Number:''' enter the port number used to connect to the proxy server.
 
'''Port Number:''' enter the port number used to connect to the proxy server.
  
'''Proxy Type:''' choices are Basic (sends the username and password unencrypted to the server) and Digest (never transfers the actual password across the network, but instead uses it to encrypt a value sent from the server). Don't select Digest unless you know that the proxy server supports it.
+
<!--T:70-->
 +
'''Proxy Type:''' choices are "Basic" (sends the username and password unencrypted to the server) and "Digest" (never transfers the actual password across the network, but instead uses it to encrypt a value sent from the server). Do not select "Digest" unless you know that the proxy server supports it.
  
 +
<!--T:71-->
 
'''Specify a Username/Password:''' check this box and input the username and password if they are required to connect to the proxy server.  
 
'''Specify a Username/Password:''' check this box and input the username and password if they are required to connect to the proxy server.  
  
Proxy settings are saved to the user's ''/etc/profile'' and ''/etc/csh.cshrc'' files so that the settings are available to the PC-BSD utilities as well as any application that uses '''fetch'''.
+
<!--T:72-->
 +
Proxy settings are saved to the ''/etc/profile'' and ''/etc/csh.cshrc'' files so that they are available to the PC-BSD® utilities as well as any application that uses '''fetch'''.
  
 +
<!--T:73-->
 
Applications that did not come with the operating system, such as web browsers, may require you to configure proxy support using that application's configuration utility.
 
Applications that did not come with the operating system, such as web browsers, may require you to configure proxy support using that application's configuration utility.
  
=== Troubleshooting Network Settings ===
+
<!--T:112-->
 +
If you save any changes to this tab, a pop-up message will warn that you may have to logout and back in in order for the proxy settings to take effect.
  
While Ethernet networking usually "just works" on a PC-BSD system, users sometimes encounter problems, especially when connecting to wireless networks. Sometimes the problem is due to a configuration error; sometimes a driver is buggy or is not yet available. This section is meant to help you pinpoint the problem so that you can either fix it yourself or give the developers the information they need to fix or create the driver.
+
=== Troubleshooting Network Settings === <!--T:74-->
  
==== Useful Files and Commands ====
+
<!--T:75-->
 +
While Ethernet networking usually "just works" on a PC-BSD® system, users sometimes encounter problems, especially when connecting to wireless networks. Sometimes the problem is due to a configuration error; sometimes a driver is buggy or is not yet available. This section is meant to help you pinpoint the problem so that you can either fix it yourself or give the developers the information they need to fix or create the driver.
  
When troubleshooting your network configuration, you need to be aware of the following files and commands:
+
==== Useful Files and Commands ==== <!--T:76-->
  
1. '''/etc/rc.conf'''
+
<!--T:77-->
 +
When troubleshooting your network configuration, use the following files and commands:
  
This file is read when the system boots up. In order for the system to configure an interface at boot time, an entry must exist for it in this file. Entries are automatically created for you during installation for each interface that is active. An entry will be added (if it does not exist) or modified (if it already exists) when you use the Configuration section of an interface using the Network Configuration utility.  
+
<!--T:78-->
 +
'''/etc/rc.conf'''
  
Here is an example of the ''rc.conf'' entries for an ethernet driver (''re0'') and a wireless driver (''run0''):
+
<!--T:79-->
 +
This file is read when the system boots up. In order for the system to configure an interface at boot time, an entry must exist for it in this file. Entries are automatically created for you during installation for each interface that is active. An entry will be added (if it does not exist) or modified (if it already exists) when you configure an interface using the Network Configuration utility.
  
ifconfig_re0="DHCP"
+
<!--T:80-->
wlans_run0="wlan0"
+
Here is an example of the ''rc.conf'' entries for an ethernet driver (''em0'') and a wireless driver (''run0''):
ifconfig_wlan0="WPA"
+
  
 +
<!--T:81-->
 +
{{txtbox|box=ifconfig_em0="DHCP"
 +
wlans_run0="wlan0"
 +
ifconfig_wlan0="WPA SYNCDHCP"}}
 +
 +
<!--T:82-->
 
When reading through your own file, look for lines that begin with ''ifconfig''. For a wireless interface, also look for lines containing ''wlans''.
 
When reading through your own file, look for lines that begin with ''ifconfig''. For a wireless interface, also look for lines containing ''wlans''.
  
'''NOTE:''' unlike Linux interface driver names, FreeBSD/PC-BSD interface driver names indicate the type of chipset. Each driver name has an associated man page where you can learn which devices use that chipset and if there are any configuration options or limitations for the driver. When reading the man page, don't include the interface number. In the above example, you could read '''man re''' and '''man run'''.
+
<!--T:83-->
 +
{{note|width=auto|icon64=unlike Linux interface driver names, FreeBSD/PC-BSD® interface driver names indicate the type of chipset. Each driver name has an associated man page where you can learn which devices use that chipset and if there are any configuration options or limitations for the driver. When reading the man page, do not include the interface number. In the above example, you could read '''man em''' and '''man run'''.}}
 +
 
 +
<!--T:84-->
 +
'''/etc/wpa_supplicant.conf'''
  
2. '''/etc/wpa_supplicant.conf'''
+
<!--T:85-->
 +
This file is used by wireless interfaces and contains the information needed to connect to a WPA network. If this file does not already exist, it is created for you when you enter the "Configuration" screen of a wireless interface.
  
This file is used by wireless interfaces and contains the information needed to connect to a WPA network. If this file does not already exist, it is created for you when you enter the Configuration screen of a wireless interface.
+
<!--T:86-->
 +
'''ifconfig'''
  
3. '''ifconfig''' this command shows the current state of your interfaces. When reading through its output, check that your interface is listed, has a status of "active", and has an IP address. Here is a sample '''ifconfig''' output showing the entries for the ''re0'' Ethernet interface and the ''run0'' wireless interface:
+
<!--T:87-->
 +
This command shows the current state of your interfaces. When reading through its output, check that your interface is listed, has a status of "active", and has an IP address. Here is a sample '''ifconfig''' output showing the entries for the ''re0'' Ethernet interface and the ''run0'' wireless interface:
  
re0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> metric 0 mtu 1500
+
<!--T:88-->
        options=389b<RXCSUM,TXCSUM,VLAN_MTU,VLAN_HWTAGGING,VLAN_HWCSUM,WOL_UCAST,WOL_MCAST,WOL_MAGIC>
+
{{txtbox|box=re0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> metric 0 mtu 1500
        ether 60:eb:69:0b:dd:4d
+
&nbsp;      options=389b<RXCSUM,TXCSUM,VLAN_MTU,VLAN_HWTAGGING,VLAN_HWCSUM,WOL_UCAST
        inet 192.168.1.3 netmask 0xffffff00 broadcast 192.168.1.255
+
,WOL_MCAST,WOL_MAGIC>
        media: Ethernet autoselect (100baseTX <full-duplex>)
+
&nbsp;      ether 60:eb:69:0b:dd:4d
        status: active
+
&nbsp;      inet 192.168.1.3 netmask 0xffffff00 broadcast 192.168.1.255
run0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> metric 0 mtu 2290
+
&nbsp;      media: Ethernet autoselect (100baseTX <full-duplex>)
        ether 00:25:9c:9f:a2:30
+
&nbsp;      status: active
        media: IEEE 802.11 Wireless Ethernet autoselect mode 11g
+
run0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> metric 0 mtu 2290
        status: associated
+
&nbsp;      ether 00:25:9c:9f:a2:30
wlan0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> metric 0 mtu 1500
+
&nbsp;      media: IEEE 802.11 Wireless Ethernet autoselect mode 11g
        ether 00:25:9c:9f:a2:30
+
&nbsp;      status: associated
        media: IEEE 802.11 Wireless Ethernet autoselect (autoselect)
+
wlan0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> metric 0 mtu 1500
        status: no carrier
+
&nbsp;      ether 00:25:9c:9f:a2:30
        ssid "" channel 10 (2457 MHz 11g)
+
&nbsp;      media: IEEE 802.11 Wireless Ethernet autoselect (autoselect)
        country US authmode WPA1+WPA2/802.11i privacy ON deftxkey UNDEF
+
&nbsp;      status: no carrier
        txpower 0 bmiss 7 scanvalid 60 protmode CTS wme roaming MANUAL
+
&nbsp;      ssid "" channel 10 (2457 MHz 11g)
        bintval 0
+
&nbsp;      country US authmode WPA1+WPA2/802.11i privacy ON deftxkey UNDEF
 +
&nbsp;      txpower 0 bmiss 7 scanvalid 60 protmode CTS wme roaming MANUAL
 +
&nbsp;      bintval 0}}
  
 +
<!--T:89-->
 
In this example, the ethernet interface (''re0'') is active and has an IP address. However, the wireless interface (''run0'', which is associated with ''wlan0'') has a status of "no carrier" and does not have an IP address. In other words, it has not yet successfully connected to the wireless network.
 
In this example, the ethernet interface (''re0'') is active and has an IP address. However, the wireless interface (''run0'', which is associated with ''wlan0'') has a status of "no carrier" and does not have an IP address. In other words, it has not yet successfully connected to the wireless network.
  
4. '''dmesg'''  
+
<!--T:90-->
 +
'''dmesg'''  
  
This command lists the hardware that was probed during boot time and will indicate if the associated driver was loaded. If you wish to search the output of this command for specific information, pipe it to '''grep''' as seen in the following examples:
+
<!--T:91-->
 +
This command lists the hardware that was probed during boot time and will indicate if the associated driver was loaded. If you wish to search the output of this command for specific information, pipe to '''grep''' as seen in the following examples:
  
'''dmesg | grep Ethernet'''
+
<!--T:92-->
re0: <RealTek 8168/8111 B/C/CP/D/DP/E PCIe Gigabit Ethernet> port 0xc000-0xc0ff mem 0xd0204000-0xd0204fff,0xd0200000-0xd0203fff irq 17 at  device 0.0 on pci8
+
{{txtbox|wrap|box='''dmesg {{pipe}} grep Ethernet'''
re0: Ethernet address: 60:eb:69:0b:dd:4d
+
re0: <RealTek 8168/8111 B/C/CP/D/DP/E PCIe Gigabit Ethernet> port 0xc000-0xc0ff mem 0xd0204000-0xd0204fff,0xd0200000-0xd0203fff irq 17 at  device 0.0 on pci8
 +
re0: Ethernet address: 60:eb:69:0b:dd:4d
  
'''dmesg |grep re0'''
+
<!--T:93-->
re0: <RealTek 8168/8111 B/C/CP/D/DP/E PCIe Gigabit Ethernet> port 0xc000-0xc0ff mem 0xd0204000-0xd0204fff,0xd0200000-0xd0203fff irq 17 at  device 0.0 on pci8
+
'''dmesg {{pipe}} grep re0'''
re0: Using 1 MSI messages
+
re0: <RealTek 8168/8111 B/C/CP/D/DP/E PCIe Gigabit Ethernet> port 0xc000-0xc0ff mem 0xd0204000-0xd0204fff,0xd0200000-0xd0203fff irq 17 at  device 0.0 on pci8
re0: Chip rev. 0x28000000
+
re0: Using 1 MSI messages
re0: MAC rev. 0x00000000
+
re0: Chip rev. 0x28000000
miibus0: <MII bus> on re0
+
re0: MAC rev. 0x00000000
re0: Ethernet address: 60:eb:69:0b:dd:4d
+
miibus0: <MII bus> on re0
re0: [FILTER]
+
re0: Ethernet address: 60:eb:69:0b:dd:4d
re0: link state changed to DOWN
+
re0: [FILTER]
re0: link state changed to UP
+
re0: link state changed to DOWN
 +
re0: link state changed to UP
  
'''dmesg | grep run0'''
+
<!--T:94-->
run0: <1.0> on usbus3
+
'''dmesg {{pipe}} grep run0'''
run0: MAC/BBP RT3070 (rev 0x0201), RF RT2020 (MIMO 1T1R), address 00:25:9c:9f:a2:30
+
run0: <1.0> on usbus3
run0: firmware RT2870 loaded
+
run0: MAC/BBP RT3070 (rev 0x0201), RF RT2020 (MIMO 1T1R), address 00:25:9c:9f:a2:30
 +
run0: firmware RT2870 loaded}}
  
5. '''pciconf'''
+
<!--T:95-->
 +
'''pciconf'''
  
 +
<!--T:96-->
 
If your interface does not show up in '''ifconfig''' or '''dmesg''', it is possible that a driver for this card is not provided with the operating system. If the interface is built into the motherboard of the computer, you can use the '''pciconf''' command to find out the type of card. Here is an example:
 
If your interface does not show up in '''ifconfig''' or '''dmesg''', it is possible that a driver for this card is not provided with the operating system. If the interface is built into the motherboard of the computer, you can use the '''pciconf''' command to find out the type of card. Here is an example:
  
'''pciconf -lv | grep Ethernet'''
+
<!--T:97-->
device    = 'Gigabit Ethernet NIC(NDIS 6.0) (RTL8168/8111/8111c)'
+
{{txtbox|box='''pciconf -lv {{pipe}} grep Ethernet'''
 +
device    = 'Gigabit Ethernet NIC(NDIS 6.0) (RTL8168/8111/8111c)'
  
'''pciconf -lv | grep wireless'''
+
<!--T:98-->
device    = 'Realtek RTL8191SE wireless LAN 802.11N PCI-E NIC (RTL8191SE ?)'
+
'''pciconf -lv {{pipe}} grep wireless'''
 +
device    = 'Realtek RTL8191SE wireless LAN 802.11N PCI-E NIC (RTL8191SE ?)'}}
  
In this example, there is a built-in Ethernet device that uses a driver that supports the RTL8168/8111/8111c chipsets. As we saw earlier, that driver is ''re0''. The built-in wireless device was also found but the ? indicates that a driver for the RTL8191SE chipset was not found. A web search for "FreeBSD RTL8191SE" will give an indication if a driver exists (perhaps in a version of FreeBSD that has not been released yet) or if a driver is being developed. You can also use a web search to locate a Windows driver and try using the '''ndisgen''' command, as described on this {{citelink|url=http://blog.pcbsd.org/2010/11/looking-for-ndis-testers-freebsd-and-pc-bsd/|testing page}}, to convert it to a FreeBSD driver.
+
<!--T:99-->
 +
In this example, there is a built-in Ethernet device that uses a driver that supports the RTL8168/8111/8111c chipsets. As we saw earlier, that driver is ''re0''. The built-in wireless device was also found but the "?" indicates that a driver for the RTL8191SE chipset was not found. A web search for "FreeBSD RTL8191SE" will give an indication of whether a driver exists (perhaps in a version of FreeBSD that has not been released yet) or if a driver is being developed. You can also use a web search to locate a Windows driver and try using the '''ndisgen''' command, as described in this {{citelink|url=http://blog.pcbsd.org/2010/11/looking-for-ndis-testers-freebsd-and-pc-bsd/|txt=PC-BSD{{RM}}blog post}}, to convert it to a FreeBSD driver.
  
The FreeBSD Handbook chapter on {{citelink|url=http://www.freebsd.org/doc/handbook/network-wireless.html|Wireless Networking}} provides a good overview of how wireless works and offers some troubleshooting suggestions.
+
<!--T:100-->
 +
The FreeBSD Handbook chapter on {{citelink|fbsdh|url=network-wireless.html|txt=Wireless Networking}} provides a good overview of how wireless works and offers some troubleshooting suggestions.
  
=== If a Driver Does Not Exist ===
+
=== If a Driver Does Not Exist === <!--T:101-->
  
If your driver does not exist, you may be able to convert a Windows driver to a FreeBSD kernel module using the instructions on the [[Wireless Testing]] page. If your chipset is not listed in Table 1 of that page, please add an entry indicating whether or not you were able to successfully convert and use the driver for your architecture.
+
<!--T:102-->
 +
If a FreeBSD driver does not exist for your wireless card, you may be able to convert a Windows driver to a FreeBSD kernel module using the instructions on the {{local|link=Wireless Testing}} page. If your chipset is not listed in Table 1 of that page, please add an entry indicating whether or not you were able to successfully convert and use the driver.
  
If you are still unable to get your network interface to work, see the section on [[Finding Help]]. When describing your problem, include the following information:
+
<!--T:103-->
 +
If you are still unable to get your network interface to work, {{local|link=PC-BSD® Bug Reporting|create a bug report}}. When describing your problem, include the following information:
  
* the version and architecture of PC-BSD you are using (e.g. PC-BSD 9.0, 32-bit)
+
<!--T:104-->
 +
* the version of PC-BSD® you are using
  
 +
<!--T:105-->
 
* the name of the chipset used by the interface
 
* the name of the chipset used by the interface
  
 +
<!--T:106-->
 
* the applicable entries in ''/etc/rc.conf''
 
* the applicable entries in ''/etc/rc.conf''
  
* if you include the ''/etc/wpa_supplicant.conf'' for your wireless adapter, sanitize the psk value so you don't tell the world what the password is on your wireless network (e.g. replace the actual password with ***** or something similar)
+
<!--T:107-->
 +
* if you include the ''/etc/wpa_supplicant.conf'' for your wireless adapter, sanitize the {{citelink|wp|url=Pre-shared_key|txt=psk}} value so you do not tell the world what the password is on your wireless network (e.g. replace the actual password with ***** or something similar)
  
=== Known Issues ===
+
=== Known Issues === <!--T:108-->
  
The bge(4) Ethernet driver has a known issue where the interface is seen but does not respond to networking requests. Carefully adding this line to ''/boot/loader.conf'' and rebooting should solve this issue.
+
<!--T:109-->
 +
The bge(4) Ethernet driver has a {{citelink|url=http://www.freebsd.org/cgi/query-pr.cgi?pr=155442|txt=known issue}} where the interface is seen but does not respond to networking requests. Carefully adding this line to ''/boot/loader.conf'' and rebooting should solve this issue.
  
hw.pci.enable_msi="0"
+
<!--T:110-->
 +
{{txtbox|box=hw.pci.enable_msi="0"}}
  
<noinclude>{{refheading}}</noinclude>
+
<!--T:111-->
 
<noinclude>
 
<noinclude>
[[category:handbook]]
+
{{refheading}}
[[category:Control Panel]]
+
 
[[category:Network Configuration]]
 
[[category:Network Configuration]]
 +
[[category:Control Panel]]
 +
[[category:handbook]]
 
[[category:troubleshooting]]
 
[[category:troubleshooting]]
 +
</translate>
 +
<languages/>
 
</noinclude>
 
</noinclude>

Latest revision as of 00:02, 16 December 2013


Contents


During installation, PC-BSD® configures your Ethernet interfaces to use DHCP and provides a post-install configuration screen to configure your wireless connection. In most cases, this means that your connected interfaces should "just work" whenever you use your PC-BSD® system.

For desktops that provide a system tray, a wireless configuration icon will appear if PC-BSD® detects a supported wireless card. If you hover over the wireless icon, shown in Figure 8.16a, it will indicate if the interface is associated and provide information regarding the IP address, IPv6 address, SSID, connection strength, connection speed, MAC address, and type of wireless device.

Figure 8.16a: Wireless Information in System Tray

If you right-click the wireless icon, you will see a list of detected wireless networks. Simply click the name of a network to associate with it. The right-click menu also provides options to configure the wireless device, start the Network Manager, restart the network (useful if you need to renew your DHCP address), and to close the Network Monitor so that the icon no longer shows in the system tray. If you have multiple wireless devices, each will have its own icon in the system tray. If you do not use one of the devices, click Close the Network Monitor to remove it from the tray.

To view or manually configure all of your network interfaces click Control Panel → Network Configuration or type pc-su pc-netmanager. If a new device has been inserted (e.g. a USB wireless interface), a pop-up message will open when you start Network Configuration, indicate the name of the new device, and ask if you would like to enable it. Click Yes and the new device will be displayed with the list of network interfaces that PC-BSD® recognizes. In the example seen in Figure 8.16b, the system has one Realtek Ethernet interface that uses the em driver and a wireless interface that uses the wlan driver.

Figure 8.16b: Network Configuration Utility

The rest of this section describes each tab of the Network Configuration utility and demonstrate how to view and configure the network settings for both Ethernet and wireless devices. It will then present some common troubleshooting scenarios, known issues, and suggestions for when a device does not have a built-in driver.

[edit] Devices: Ethernet Adapters

If you highlight an Ethernet interface in the Devices tab and either click the Configure button or double-click the interface name, you will see the screen shown in Figure 8.16c:

Figure 8.16c: Network Settings for an Ethernet Interface

There are two ways to configure an Ethernet interface:

  1. Use DHCP: this method assumes that your Internet provider or network assigns your addressing information automatically using the DHCP protocol. Most networks are already setup to do this. This method is recommended as it should "just work".
  2. Manually type in the IP addressing information: this method requires you to understand the basics of TCP/IP addressing or to know which IP address you should be using on your network. If you do not know which IP address or subnet mask to use, you will have to ask your Internet provider or network administrator.

By default, PC-BSD® will attempt to obtain an address from a DHCP server. If you wish to manually type in your IP address, check the box "Assign static IP address". Type in the IP address, using the right arrow key or the mouse to move between octets. Then, double-check that the subnet mask (Netmask) is the correct value and change it if it is not.

If the Ethernet network uses 802.1x authentication, check the box "Enable WPA authentication" which will enable the "Configure WPA" button. Click this button to select the network and to input the authentication values required by the network.

By default, the "Disable this network device" box is unchecked. If you check this checkbox, PC-BSD® will immediately stop the interface from using the network. The interface will remain inactive until this checkbox is unchecked.

The "Advanced" tab, seen in Figure 8.16d, allows advanced users to change their MAC address[1] and to use DHCP to automatically obtain an IPv6 address[2]. Both boxes should remain checked unless you are an advanced user who has a reason to change the default MAC or IPv6 address and you understand how to input an appropriate replacement address.

Figure 8.16d: Advanced Tab of an Ethernet Interface's Network Settings

The "Info" tab, seen in Figure 8.16e, will display the current network address settings and some traffic statistics.

Figure 8.16e: Info Tab of an Ethernet Interface's Network Settings

If you make any changes within any of the tabs, click the "Apply" button to activate them. Click the "OK" button when you are finished to go back to the main Network Configuration window.

You can repeat this procedure for each network interface that you wish to view or configure.

[edit] Devices: Wireless Adapters

If your wireless interface does not automatically associate with a wireless network, you probably need to configure a wireless profile that contains the security settings required by the wireless network. Double-click the wireless icon in the system tray or highlight the wireless interface displayed in the "Devices" tab of Network Configuration and click the "Configure" button. Figure 8.16f demonstrates that this system's wireless interface is currently not associated with any wireless networks as none are listed in the "Configured Network Profiles" section:

Figure 8.16f: Wireless Configuration Window of Network Configuration Utility

To associate with a wireless network, click the "Scan" button to receive the list of possible wireless networks to connect to. Highlight the network you wish to associate with and click the "Add Selected" button. If the network requires authentication, a pop-up window will prompt you for the authentication details. Input the values required by the network then click the "Close" button. PC-BSD® will add an entry for the network in the "Configured Network Profiles" section.

If the network is hidden, click the Add Hidden button, input the name of the network in the pop-up window, and click “OK”.

If you add multiple networks, use the arrow keys to place them in the desired connection order. PC-BSD® will try to connect to the first profile in the list and will move down the list in order if it is unable to connect. When finished, click the "Apply" button. A pop-up message will indicate that PC-BSD® is restarting the network. If all went well, there should be an IP address and status of "associated" when you hover over the wireless icon in the system tray. If this is not the case, double-check for typos in your configuration values and read the section on Troubleshooting Network Settings.

PC-BSD® supports the types of authentication shown in Figure 8.16g. You can access this screen (and change your authentication settings) by highlighting an entry in the "Configured Network Profiles" section and clicking the "Edit" button.

Figure 8.16g: Configuring Wireless Authentication Settings

This screen allows you to configure the following types of wireless security:

  • Disabled: if the network is open, no additional configuration is required.
  • WEP: this type of network can be configured to use either a hex or a plaintext key. If you click WEP then the "Configure" button, you will see the screen shown in Figure 8.16h. Type the key into both network key boxes. If the key is complex, check the Show Key box to make sure that the passwords are correct and that they match. Uncheck this box when you are finished to replace the characters in the key with the * symbol. A wireless access point that uses WEP can store up to 4 keys; the number in the key index indicates which key you wish to use.
  • WPA Personal: this type of network uses a plaintext key. If you click WPA Personal then the Configure button, you will see the screen shown in Figure 8.16i. Type in the key twice to verify it. If the key is complex, you can check the Show Key box to make sure the passwords match.
  • WPA Enterprise: if you click WPA Enterprise then the Configure button, you will see the screen shown in Figure 8.16j. Select the authentication method (EAP-TLS, EAP-TTLS, or EAP-PEAP); input the EAP identity; browse for the CA certificate, client certificate and private key file; and input and verify the password.
NOTE: If you are unsure which type of encryption is being used, ask the person who setup the wireless router. They should also be able to give you the value of any of the settings seen in these configuration screens.
Figure 8.16h: WEP Security Settings
Figure 8.16i: WPA Personal Security Settings
Figure 8.16j: WPA Enterprise Security Settings

If you wish to disable this wireless interface, check the Disable this wireless device box. This setting can be desirable if you want to temporarily prevent the wireless interface from connecting to untrusted wireless networks.

The Advanced tab, seen in Figure 8.16k, allows you to configure the following:

  • a custom MAC address. This setting is for advanced users and requires the Use hardware default MAC address box to be unchecked.
  • how the interface receives its IP address information. If the network contains a DHCP server, check the Obtain IP automatically (DHCP) box. Otherwise, input the IP address and subnet mask to use on the network.
  • the country code. This setting is not required if you are in North America. For other countries, check the Set Country Code box and select your country from the drop-down menu.
Figure 8.16k: Advanced Tab of a Wireless Interface

The Info tab, seen in Figure 8.16l, shows the current network status and statistics for the wireless interface:

Figure 8.16l: Info Tab of a Wireless Interface

[edit] Network Configuration (Advanced)

The Network Configuration (Advanced) tab of the Network Configuration utility is seen in Figure 8.16m. The displayed information is for the currently highlighted interface. If you wish to edit these settings, make sure that the interface that you wish to configure is highlighted in the Devices tab.

Figure 8.16m: Network Configuration (Advanced) tab of the Network Configuration Utility

If the interface receives its IP address information from a DHCP server, this screen allows you to view the received DNS information. If you wish to override the default DNS settings or set them manually, check the Enable Custom DNS box. You can then set the following:

DNS 1: the IP address of the primary DNS server. If you do not know which IP address to use, click the Public servers button to select a public DNS server.

DNS 2: the IP address of the secondary DNS server.

Search Domain: the name of the domain served by the DNS server.

If you wish to change or set the default gateway, check the Enable Custom Gateway box and input the IP address of the default gateway.

The following settings can be modified in the IPv6 section:

Enable IPv6 support: if this box is checked, the specified interface can participate in IPv6 networks.

IPv6 gateway: the IPv6 address of the default gateway used on the IPv6 network.

IPv6 DNS 1: the IPv6 address of the primary DNS server used on the IPv6 network. If you do not know which IP address to use, click the Public servers button to select a public DNS server.

IPv6 DNS 2: the IPv6 address of the secondary DNS server used on the IPv6 network.

The Misc section allows you to configure these options:

System Hostname: the name of your computer. It must be unique on your network.

Enable wireless/wired failover via lagg0 interface: the lagg[3] interface allows you to seamlessly switch between using an Ethernet interface and a wireless interface. If you want this functionality, check this box.

NOTE: Some users experience problems using lagg. If you have problems connecting to a network using an interface that previously worked, uncheck this box and remove any references to "lagg" in your /etc/rc.conf file.

If you make any changes within this window, click the Save button to apply them.

[edit] Proxy Settings

The Proxy tab, shown in Figure 8.16n, is used when your network requires you to go through a proxy server in order to access the Internet.

Figure 8.16n: Proxy Settings Configuration

Check the Proxy Configuration check box to activate the settings. The follow settings can be configured in this screen:

Server Address: enter the IP address or hostname of the proxy server.

Port Number: enter the port number used to connect to the proxy server.

Proxy Type: choices are "Basic" (sends the username and password unencrypted to the server) and "Digest" (never transfers the actual password across the network, but instead uses it to encrypt a value sent from the server). Do not select "Digest" unless you know that the proxy server supports it.

Specify a Username/Password: check this box and input the username and password if they are required to connect to the proxy server.

Proxy settings are saved to the /etc/profile and /etc/csh.cshrc files so that they are available to the PC-BSD® utilities as well as any application that uses fetch.

Applications that did not come with the operating system, such as web browsers, may require you to configure proxy support using that application's configuration utility.

If you save any changes to this tab, a pop-up message will warn that you may have to logout and back in in order for the proxy settings to take effect.

[edit] Troubleshooting Network Settings

While Ethernet networking usually "just works" on a PC-BSD® system, users sometimes encounter problems, especially when connecting to wireless networks. Sometimes the problem is due to a configuration error; sometimes a driver is buggy or is not yet available. This section is meant to help you pinpoint the problem so that you can either fix it yourself or give the developers the information they need to fix or create the driver.

[edit] Useful Files and Commands

When troubleshooting your network configuration, use the following files and commands:

/etc/rc.conf

This file is read when the system boots up. In order for the system to configure an interface at boot time, an entry must exist for it in this file. Entries are automatically created for you during installation for each interface that is active. An entry will be added (if it does not exist) or modified (if it already exists) when you configure an interface using the Network Configuration utility.

Here is an example of the rc.conf entries for an ethernet driver (em0) and a wireless driver (run0):

ifconfig_em0="DHCP"

wlans_run0="wlan0"

ifconfig_wlan0="WPA SYNCDHCP"

When reading through your own file, look for lines that begin with ifconfig. For a wireless interface, also look for lines containing wlans.

NOTE: Unlike Linux interface driver names, FreeBSD/PC-BSD® interface driver names indicate the type of chipset. Each driver name has an associated man page where you can learn which devices use that chipset and if there are any configuration options or limitations for the driver. When reading the man page, do not include the interface number. In the above example, you could read man em and man run.

/etc/wpa_supplicant.conf

This file is used by wireless interfaces and contains the information needed to connect to a WPA network. If this file does not already exist, it is created for you when you enter the "Configuration" screen of a wireless interface.

ifconfig

This command shows the current state of your interfaces. When reading through its output, check that your interface is listed, has a status of "active", and has an IP address. Here is a sample ifconfig output showing the entries for the re0 Ethernet interface and the run0 wireless interface:

re0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> metric 0 mtu 1500

  options=389b<RXCSUM,TXCSUM,VLAN_MTU,VLAN_HWTAGGING,VLAN_HWCSUM,WOL_UCAST ,WOL_MCAST,WOL_MAGIC>   ether 60:eb:69:0b:dd:4d   inet 192.168.1.3 netmask 0xffffff00 broadcast 192.168.1.255   media: Ethernet autoselect (100baseTX <full-duplex>)   status: active run0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> metric 0 mtu 2290   ether 00:25:9c:9f:a2:30   media: IEEE 802.11 Wireless Ethernet autoselect mode 11g   status: associated wlan0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> metric 0 mtu 1500   ether 00:25:9c:9f:a2:30   media: IEEE 802.11 Wireless Ethernet autoselect (autoselect)   status: no carrier   ssid "" channel 10 (2457 MHz 11g)   country US authmode WPA1+WPA2/802.11i privacy ON deftxkey UNDEF   txpower 0 bmiss 7 scanvalid 60 protmode CTS wme roaming MANUAL

  bintval 0

In this example, the ethernet interface (re0) is active and has an IP address. However, the wireless interface (run0, which is associated with wlan0) has a status of "no carrier" and does not have an IP address. In other words, it has not yet successfully connected to the wireless network.

dmesg

This command lists the hardware that was probed during boot time and will indicate if the associated driver was loaded. If you wish to search the output of this command for specific information, pipe to grep as seen in the following examples:

dmesg | grep Ethernet

re0: <RealTek 8168/8111 B/C/CP/D/DP/E PCIe Gigabit Ethernet> port 0xc000-0xc0ff mem 0xd0204000-0xd0204fff,0xd0200000-0xd0203fff irq 17 at device 0.0 on pci8 re0: Ethernet address: 60:eb:69:0b:dd:4d

dmesg | grep re0 re0: <RealTek 8168/8111 B/C/CP/D/DP/E PCIe Gigabit Ethernet> port 0xc000-0xc0ff mem 0xd0204000-0xd0204fff,0xd0200000-0xd0203fff irq 17 at device 0.0 on pci8 re0: Using 1 MSI messages re0: Chip rev. 0x28000000 re0: MAC rev. 0x00000000 miibus0: <MII bus> on re0 re0: Ethernet address: 60:eb:69:0b:dd:4d re0: [FILTER] re0: link state changed to DOWN re0: link state changed to UP

dmesg | grep run0 run0: <1.0> on usbus3 run0: MAC/BBP RT3070 (rev 0x0201), RF RT2020 (MIMO 1T1R), address 00:25:9c:9f:a2:30

run0: firmware RT2870 loaded

pciconf

If your interface does not show up in ifconfig or dmesg, it is possible that a driver for this card is not provided with the operating system. If the interface is built into the motherboard of the computer, you can use the pciconf command to find out the type of card. Here is an example:

pciconf -lv | grep Ethernet

device = 'Gigabit Ethernet NIC(NDIS 6.0) (RTL8168/8111/8111c)'

pciconf -lv | grep wireless

device = 'Realtek RTL8191SE wireless LAN 802.11N PCI-E NIC (RTL8191SE ?)'

In this example, there is a built-in Ethernet device that uses a driver that supports the RTL8168/8111/8111c chipsets. As we saw earlier, that driver is re0. The built-in wireless device was also found but the "?" indicates that a driver for the RTL8191SE chipset was not found. A web search for "FreeBSD RTL8191SE" will give an indication of whether a driver exists (perhaps in a version of FreeBSD that has not been released yet) or if a driver is being developed. You can also use a web search to locate a Windows driver and try using the ndisgen command, as described in this PC-BSD®blog post[4], to convert it to a FreeBSD driver.

The FreeBSD Handbook chapter on Wireless Networking[5] provides a good overview of how wireless works and offers some troubleshooting suggestions.

[edit] If a Driver Does Not Exist

If a FreeBSD driver does not exist for your wireless card, you may be able to convert a Windows driver to a FreeBSD kernel module using the instructions on the Wireless Testing page. If your chipset is not listed in Table 1 of that page, please add an entry indicating whether or not you were able to successfully convert and use the driver.

If you are still unable to get your network interface to work, create a bug report. When describing your problem, include the following information:

  • the version of PC-BSD® you are using
  • the name of the chipset used by the interface
  • the applicable entries in /etc/rc.conf
  • if you include the /etc/wpa_supplicant.conf for your wireless adapter, sanitize the psk[6] value so you do not tell the world what the password is on your wireless network (e.g. replace the actual password with ***** or something similar)

[edit] Known Issues

The bge(4) Ethernet driver has a known issue[7] where the interface is seen but does not respond to networking requests. Carefully adding this line to /boot/loader.conf and rebooting should solve this issue.

hw.pci.enable_msi="0"


References


  1. http://en.wikipedia.org/wiki/MAC_address
  2. http://en.wikipedia.org/wiki/IPv6_address
  3. http://www.freebsd.org/cgi/man.cgi?query=lagg
  4. http://blog.pcbsd.org/2010/11/looking-for-ndis-testers-freebsd-and-pc-bsd/
  5. http://www.freebsd.org/doc/en/books/handbook/network-wireless.html
  6. http://en.wikipedia.org/wiki/Pre-shared_key
  7. http://www.freebsd.org/cgi/query-pr.cgi?pr=155442
Other languages:German 4% • ‎English 100% • ‎French 2%
Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox