readme.txt for XWLAN
--------------------
20180722 last update by Andreas Buchinger for v3.14 release

###############################################################################
readme.cmd should start the proper .inf file for your language

!!!!!!!!!!!!!!!!!!!!!!!    READ IT   !!!!!!!!!!!!!!!!!!!!!!!

Especially the prerequisites and installation sections

Please read the WSE presentations from Christian too.
Links can be found at projects home page http://trac.netlabs.org/xwlan/
###############################################################################

If readme.cmd does not work for you change into xcenter\xwlan directory and
double click on xwlaneng.inf.

Installation (short form)
-------------------------
1. run 'yum install dhclient'
2. run 'instwgt.cmd' or 'instexe.cmd'
3. for wpa_supplicant libc, gcc1, ssl10, crypto10 and z1 is needed
   (yum install libc libcx libgcc1 openssl-libs zlib)

Since v3.12 xwlan/wlanstat uses ISC DHCP client instead the OS/2 included one.
If you want to use DHCP which is very common with wireless networking install
it with 'yum install dhclient'. If you don't like the ISC dhcp client you have
to stick with older xwlan versions or use static IP addresses.

With v3.14 wpa_supplicant.exe is included. This is to ease installation as xwlan
needs it at the right place. Maybe this will change in future versions. The
included version is a beta from 2018 development tree which includes KRACK fix.

Troubleshooting after installation. Walk through STEP BY STEP
-------------------------------------------------------------
1 Does XWLAN detect your device?
  Open properties dialog and go to Device page. Driver version must be something
  like 'WRND32x$ V2.xx'. A list of 'Driver capabilities' is shown too. If the
  list does not include 'WPA encryption' you can not use it with this device.
2 When using WPA secured networks wpa_supplicant.exe is needed. For your
  convience it is included with this package. This version was build from trunk
  on official site http://w1.fi/ at beginning of March 2018. This should contain
  all patches for KRACK and identifies itself as 'wpa_supplicant v2.7 (OS/2-v2)'
  Though most tests were made with version v2.2 (eCS-v1). v2.0 was tested too.
  XWLAN should work with all versions above v2.0. Check wpa_supplicant version
  by looking at xwlan properties 'WPA Supplicant' page (page between 'TCP/IP'
  and 'Script') and check the entry at the bottom. Should be something like
  'wpa_supplicant v2.7 (OS/2-v2)'. Hint, if your device does not support WPA
  encryption (or genmac does not support WPA with your device) this page is not
  visible. Sorry, you will not be able to connect to WPA secured networks. If
  wpa_supplicant is not found by xwlan check from command line
  'wpa_supplicant -v' in the directory where the .dim file resides.
3 Proper dhclient installed?
  Go to poperties TCP/IP 2 page. At the bottom must be displayed in blue color
  the version of dhclient found on your system. Something like
  'isc-dhclient-V3.1-ESV-R3/eCS-v3'
4 Set up a profile matching the settings of your access point.
  If you can not connect the reasons can be many. Rule out one by one. Sorry,
  further reading required ;-)
5 Double check your profile settings. Use the included help files to learn how
  to setup a network profile. IT professionals usually knows such settings by
  heart. Ask one if you're not familar with networking.
6 Check your network and IP settings. With OS/2 you can check this with ifconfig
  command. Use 'ifconfig lan0' or 'ifconfig lan1'. More comfortable way to check
  can be done with included ifc2.cmd (ifmon.cmd). You can run this script while
  you switch between wired and wireless connection or start/stop wireless
  connection and watch the changes made by XWLAN.
7 If you've control over the wireless access point settings you can try at first
  with encryption switched off. Activate WPA afterwards when you know everything
  else works fine. HINT - a lot of older wireless hardware do not support WPA2.
8 If using WPA encryption XWLAN has menu option to display output from
  wpa_supplicant. There are different verbosity options too. Right click on the
  XWLAN xcenter widget or WLANSTAT symbol and select the pop-up menu entry
  'WPA Supplicant -> Visible'. The command line window where wpa_supplicant is
  running will be shown now. Of course wpa_supplicant must be running to see
  this window. XWLAN starts it automatically when you 'Enable Radio' and the
  selected profile is configured to use WPA encryption. XWLAN also stops
  wpa_supplicant and the window disappers when you disable radio or select
  another profile which do not need it. If the menu misses this entry see 2. If
  you're using WPA encryption but wpa_supplicant can not establish a connection
  it does not make any sense to read further. Get wpa_supplicant working or use
  network without WPA encryption. Start with Debug level 'Info (normal)'

  wpa_supplicant output should look like the following -
    Successfully initialized wpa_supplicant
    lan2: Trying to associate with SSID 'ANET_WLAN4'
    lan2: Associated with 14:68:2c:71:58:d8
    lan2: WPA: Key negotiation completed with 14:68:2c:71:58:d8 [PTK=TKIP GTK=..
    lan2: CTRL-EVENT-CONNECTED - Connection to 14:68:2c:71:58:d8 completed [id=.

  If all you get are repeated output lines like this -
    lan2: Associated with 59:00:77:5c:06:00
    lan2: Associated with 59:00:77:5c:06:00
    lan2: Associated with 59:00:77:5c:06:00
    lan2: Associated with 59:00:77:5c:06:00
  wpa_supplicant can NOT connect to your access point. Check your profile
  settings.

9 If you've set up your profile to 'Configure automatically using DHCP' dhclient
  is started automatically by XWLAN after the connection is established. When
  there is no connection f.i. your 'Profile - Security' settings are wrong or
  wpa_supplicant is not working dhclient will not start. Do not start any DHCP
  client manually. Dhclient is usually fired up in a hidden window. This can be
  easily found f.i. in the xwp tasklist. Open it and see the logging there. But
  if you configured 'Activate logging' in XWLAN properties TCP/IP page 2
  dhclient output will be redirected to the defined log file instead. Check it
  out. No dhclient window will be created in this case.
10 Additional logging can be catched with the PMPrintf253 package. You need
  pmprintf.dll on your system. With pmprintf.exe you can see logging from
  XWLAN if enabled via ini keys. 'deb.cmd' which is included can set proper
  keys. 'deb on' activates full logging. 'deb' shows current settings.
11 On some installations it was observed that genmac returns wrong lan interface
  number. I reproduced this when both fxwrap.sys and switch.os2 drivers are
  installed. In such scenario genmac returns wireless interface one number
  higher than it actually uses. If you enable radio but XWLAN fails to assign an
  IP address you may be hit by this bug. You can use fixed IP address in this
  case or use the DHCP client override option (TCP/IP page 2). Check 'Use
  different interface instead lan(N)' and select manually lan(N-1). Use this
  option with care! Genmac link.exe would return wrong interface number in such
  case too. You can check with 'ifconfig lanX'. When f.i. wpa_supplicant show
  'lan3: Trying to associate with SSID...' (see 8) but ifc2.cmd only lists lan0
  and lan1 and XWLAN can never establish a connection this may indicate you are
  hit by this bug. Again, currently this problem was only seen when fxwrap.sys
  and switch.os2 are installed at the same time.
