docs/docs/newhandbook/WirelessNetwork/index.mdwn

   1 [[!toc  levels=3]]
   2
   3 # Wireless Network Quick Start
   4
   5 This section illustrates the basic procedure to connect a DragonFly system to an existing wireless network.  The next section will go into detail should that be required.
   6
   7 ## Use WPA Supplicant from DPorts
   8
   9 DragonFly comes with WPA Supplicant in base, but it is an older version (2.1) that will not be updated again.  At the time of this writing, the version of WPA Supplicant in DPorts is 2.4.  The version in base can be used as a fallback though.
  10
  11 ### Option 1: Install WPA Supplicant from binary package
  12
  13     > pkg ins wpa_supplicant
  14
  15 ### Option 2: Build WPA Supplicant from source
  16
  17 Assuming DPorts has been installed and is up to date,
  18
  19     > cd /usr/dports/security/wpa_supplicant
  20     > make clean ; make install
  21
  22 ### Update /etc/rc.conf
  23
  24 In order to use the new WPA Supplicant over the base version, it must be configured in rc.conf .  The following will accomplish this on systems using default locations:
  25
  26     > echo wpa_supplicant_program="/usr/local/sbin/wpa_supplicant" >> /etc/rc.conf
  27
  28 ## Credentials
  29
  30 Obtain the SSID (Service Set Identifier) and PSK (Pre-Shared Key) for the wireless network from the network administrator.
  31
  32 ## Wireless Adapter
  33
  34 Identify the wireless adapter. The DragonFly GENERIC kernel includes drivers for many common wireless adapters. If the wireless adapter is one of those models, it will be shown in the output from ifconfig(8):
  35
  36     > ifconfig | grep -B3 -i wireless
  37
  38 If a wireless adapter is not listed, an additional kernel module might be required, or it might be a model not supported by DragonFly.  This example shows the Ralink ral0 wireless adapter.
  39
  40 ## Configure WPA Supplicant
  41
  42 Add an entry for this network to /etc/wpa_supplicant.conf. If the file does not exist, create it. Replace _myssid_ and _mypsk_ with the SSID and PSK provided by the network administrator.
  43
  44     network={
  45         ssid="myssid"
  46         psk="mypsk"
  47     }
  48
  49 ## Configure RC Init
  50
  51 Add entries to /etc/rc.conf to configure the network on startup:
  52
  53     wlans_ral0="wlan0"
  54     ifconfig_wlan0="WPA DHCP"
  55
  56 ## Start wireless service
  57
  58 Restart the computer, or restart the network service to connect to the network:
  59
  60     > service netif restart
  61
  62 # Introduction