Difference between revisions of "Slogan"
|Line 143:||Line 143:|
Latest release is 1.
Latest release is 1.
Revision as of 17:58, 30 September 2012
slogan is a console tool to analyze monthly log files created by DXSPIDER. It gives you an overall picture regarding connected users, helps to identify power users, loads, etc.
The program also helps to find possible frauds displaying the country of the IP address, indicating a different country than the callsign itself.
Slogan lists end users connected to the system during the period and display the following information:
- Date and time of first connection
- Date and time of last connection (if there are more)
- Number of connections
- Total connected time
- Number of different IP addresses used
- IP address of last connection
- Country where the last IP is allocated
Some summary information is also displayed:
- Name of log file analyzed
- Date of creation
- Date and time of forst log entry
- Date and time of last log entry
- Number of different callsigns connected
- Number of stations already connected when log starts
- Number of max conencted users
- Date and time when max users connected
- Number of log errors (connect/disconnect sequence)
The program is written in PYTHON, a free scripting language. Usually it is already installed on a LINUX system. No special modules are required. Compatible with any Python 2.x versions. Python 3.x is intentionally not backward compatible, therefore slogan may need to be modified to work properly. Stick with 2.5 or later version.
For WINDOWS download it from http://www.python.org
Program is developed and tested on LINUX (CentOS), WINDOWS XP and VISTA. It is expected to work on any modern LINUX system and other OS where PYTHON is available, including WINDOWS 7.
Extract the archive and copy slogan.py, geoip.py and ip-to-country.csv to a directory which is included in the shell path. On most LINUX systems /usr/local/bin is a good choice, but it may vary.
Check file permissions and change it to 644 if necessary. On some systems 777 would be needed.
No configuration is required.
An installed DXSPIDER system is not necessary, only the log file is processed. Program can be run on a different machine.
No online connection required, the Internet is not used at all.
WINDOWS - the hard way
If you do not have Python already installed, follow instructions below.
Installation is tested on WINDOWS XP and VISTA. WINDOWS 2000 and WINDOWS 7 must be similar.
- Download latest Python (2.7.2 at the time writing) from www.python.org and install
- Open Control panel/System 'Advanced' tab
- Click 'Environment variables' on the bottom
- Click Path in the lower window (system variables)
- Add the Python install path, default is C:\Python27 (use ; as a separator)
Now WINDOWS knows where to find Python.
Copy slogan, geoip.py and ip-to-country.cvs to a directory of your choice. Open a command line window, enter to the directory where slogan files are and type in a DOS window:
python slogan.py <log file>
It works without any modification, renaming etc. of the original files.
WINDOWS - the easy way
There is also a precompiled WINDOWS executable version provided.
- Download slogan1xwin.zip
- Extract files to any directory
- Run slogan.exe in a DOS window
No installation needed, application is portable.
Program requires only one argument, the name of the log file. In case of typical DXSPIDER installation log files are stored in the /spider/data/log/ directory in a subdirectory for each year.
For example to analyze the March 2008 log type in the console:
You can save output to a file on the usual way:
slogan.py /spider/data/log/2008/03.dat > report0803.txt
Using precompiled WINDOWS binary just replacw slogan.py with slogan.exe
New versions will be announced on the DXSPIDER mailing list.
The IP to country database is updated regularly, latest version is available at http://ip-to-country.webhosting.info
Program including the geoip.py module can be used, shared or modified freely with no restrictions. For the licensing info of the IP to country database visit http://ip-to-country.webhosting.info
Your feedback, error reports, feature requests are welcome. Send email to email@example.com
When you report a bug please send the following information:
- Slogan version
- Python version
- Type and version of host operating system running slogan
- Screen copy of error message
- Log file processed
Latest release is 1.4