= $Id: README,v 1.1 2005/06/05 13:14:25 hawesy Exp $
Introduction
Thankyou for downloading the wap54g-log program. This program runs on a PC and listens for connections from a Linksys WAP54G wireless access point.
All of the files in this directory are covered by the GNU Public License. See the LICENSE file for details.
Installation
- Download and untar the file onto your system
- Compile by typing 'make' in the source directory.
- Install by typing 'PREFIX=/usr/local make install' in the source directory as root. Set PREFIX to be the location you want the binary to be installed.
- Start wap54g-log on your machine. If you do not supply any
command-line options the default is to simply output the logs to
the console. Use the '--help' option to find out more. The
options are fairly self-explanitory. Make sure wap54g-log is
running before continuing.
Check the desired log output destination for a line that is similar to the following:
wap54g-log[12345] logger started. Listening on port 514
The line will be slightly different, depending on the log destination. If you do not see the line, it is likely you are not running as root. Retry running wap54g-log as root.
5. Configure your wireless access point to send its logs to your
machine. The details of this are left as an exercise to the user. In brief, enter the WAP54G web frontend and select the "Setup" tab (it's the first one you see anyway). From there, select "Log". On the log screen set the Log option to "Enabled" and enter the IP address of the machine running wap54g-log in the "Send log to" field.
6. Select the "Save Settings" option from the bottom of the
configuration screen. This will bring up another screen with a continue button. Click the Continue button and the access point will reboot.
7. Go to where the logs are being saved (console, output file, syslog)
and ensure that two lines, similar to the following are seen:
Jun 5 22:02:23 wap54g-log[12345] Syslogd started.
Jun 5 22:02:23 wap54g-log[12345] System started.
If the lines are not seen in the wap54g-log output then there is a problem somewhere in the chain. First, ensure that wap54g-log is indeed outputting the line in step 4.
When you have verified that the logger is outputting correctly to the log path (via step 4) check that your machine has allowed connections from the wireless access point to UDP port 514 (the syslog port). This is the primary reason for not seeing any output.
8. If you want to run this as a system daemon, refer to your system
documentation and start the wap54g-log program with the desired output path (and the -d option) somewhere in the system startup procedure. It doesn't really matter where you start it as long as syslog is running and/or the path for the output file is mounted.
9. Sit back and wait for log entries.