SysLog Source Manual

1. setup environment
source /u/glchen/work/solar/script/env.rc

2. start a Planet (assume you are on tahoe)
java solar.Planet -cfg /u/glchen/work/solar/script/solar.cfg

3. start syslog source
ssh jobildunc
/u/glchen/work/script/syslog/parse_syslog.pl < /net/jobildunc/syslog-wireless-fifo | /u/glchen/work/script/add_timestamp.pl 03 | java campus.syslog.SyslogSource -host tahoe -port 5470

4. subscribe to the syslog source
java solar.test.EventPrinter -host tahoe -port 5470 -query "[source=syslog]"


=====================================
written by yurong, need to be updated.


server: jobildunc

Events:
 8.12:  changed to read from syslog_parse.pl
 8.21    added three operators 
 8.28    correct the category of building, now the name are come from AP
  
attribute:
  see part 4 output event 
Constants:
    see the defnination in SyslogConstants.java
    (// Constants for syslog
    public static final int AUTHENTICATED        = 0;
    public static final int ASSOCIATED        = 1;
    public static final int REASSOCIATED    = 2;
    public static final int ROAMED      = 3;
    public static final int DISASSOCIATED    = 4;
    public static final int DEAUTHENTICATED     = 5;
    public static final int UNKNOWN     = -100;
    )
constants definination:
   SyslogConstants.java  
example graph scripts:
    operator.xml

Q&A:

1. How to run?
   1.1 run solar
       java solar.Planet -cfg script/solar.cfg
       remember the server where solar runs.
        
   1.2 run source 
       v 0.1
       java WiFiSource -hosts tahoe(the server where solar runs) 
       v 0.1.1 (new)
       more syslog-wireless-fifo | parse_syslog.pl | java WiFiSource   -host  tahoe.cs.dartmouth.edu 

2. How to get event?  
   2.1 solar-1.0.1
      java solar.test.EventPrinter -planet tahoe.cs.dartmouth.edu -query "[source=WiFiSource]"


3. test  (WiFiSource)
     more test.txt | parse_syslog.pl | java SyslogSource  -host  tahoe.cs.dartmouth.edu 


4. output Event 
  4.1 SyslogSource 

  1. timestamp   (when the event is received)
  2. msg_Type 
  3. aP_name     (AP name)
  4. client_Host
  5. client_Mac          12. MAC      (the MAC of Client )
  6. client_Action         13. action      (the action of Client)
  7. client_Info   

  4.2 CategoryOperator
     options: 
       catalog = categories.csv

  +
   1. building_Category

  4.3 APInfoOperator
     options: 
      aplocation= aplocation.data
      apconfiguration = apconfiguration.dat

  +
   1. AP_Name, (old one )
   2. AP_Mac
   3. Building_Name, 
  
  4.4  APLocationOperator

   options: 
     aplocation= aplocation.data
     apconfiguration = apconfiguration.dat

  +
   1. AP_X,
   2. AP_Y, 
   3. AP_Floor
   4. Building_Name,
