README

   1 This is a journaller and dejournaller written in java for the Lightweight event system.
   2
   3 You will need to install maven 2.x in order to build:
   4
   5 % mvn clean package
   6
   7 Running
   8
   9 To start the journaller:
  10 % bin/lwes-journaller -m <multicast_addr> -p <multicast_port> -f <filename>
  11
  12 To stop the journaller:
  13 NOTE: To stop this journaller, you can't just control-c it or kill -9 it. If you do that, the
  14 Java shutdown hook may not catch the signal and the file won't get closed properly. Use the
  15 lwes-journaller-stop script or use kill -15.
  16
  17 % bin/lwes-journaller-stop
  18
  19 To tell the journaller to rotate the log file (you will probably want a cron job for this):
  20
  21 % bin/lwes-rotate-log -m <multicast_addr> -p <multicast_port>
  22
  23 If you are getting bad throughput as far as number of events per second you can process
  24 before you see loss, make sure your operating system udp buffer is set to a reasonable number:
  25
  26 Linux               sysctl -w net.core.rmem_max=8388608
  27 Solaris             ndd -set /dev/udp udp_max_buf 8388608
  28 FreeBSD, Darwin     sysctl -w kern.ipc.maxsockbuf=8388608
  29 AIX                 no -o sb_max=8388608
  30
  31 You can also increase the read buffer on the multicast socket by setting the lwes specific
  32 system property MulticastReceiveBufferSize. For example,
  33
  34 java -DMulticastReceiveBufferSize=8388608 ...
  35
  36 There is a dejournaller utility to view the contents of the files. To run this:
  37
  38 % java -jar dejournaller-[version].jar -f <file_name> [-g]
  39
  40 It will output events one per line so you can grep/awk/perl them.