Docs

INSTALLATION

Download YAJNGI and unzip/untar the conpressed file in your preferred directory.

Dir “lib” contains the YAJNGI jar and the third party lib necessary for the correct execution of the program

Dir “cache” is the default location where YAJNGI store the last id of processed newsgroups articles

Dir “conf” is the default location where YAJNGI load the configuration file named yajngi-config.xml

Dir “log” is the deafult location where YAJNGI log the activity

CONFIGURATION

Open in your favorite editor the yajngi-config.sample.xml, make your changes ad save as a yajngi-config.xml

yajngi-config.sample.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- 
  news server, if your news server require authentication 
  put attributes "username" and "password" in newsserver element like
  <newsserver name="server" port="port" username="aa" password="bb">

-->
<newsserver name="the.server.address" port="119">
 
  <!-- log file -->
  <logfile>../log/yajngi.log</logfile>
 
  <!-- cache file -->
  <cachestore>../cache</cachestore>
 
  <!-- 
  with an interval of 60 minutes inspect alt.binaries.pictures and 
  1. save locally UUEncoded attachments if the message contains
     "jpg", "jpeg" or "gif" words and contain a valid attachment
  -->
  <newsgroup scaninterval="60" name="alt.binaries.pictures" match="jpg|gif|jpeg">
    <action class="SaveAttachment">
      <params>
        <path>../dir/where/to/save/attachments</path>
      </params>
    </action>
  </newsgroup>
 
  <!-- 
  with an interval of 30 minutes inspect it.comp.java and 
  1. send an "alert" email with the report and attached messages for every post 
     that match into header, subject or body the "yajngi" or "cristian" words.
  -->
  <newsgroup scaninterval="30" name="it.comp.java" match="yajngi|cristian">
    <action class="Email">
      <params>
            <subject></subject>
            <from>cristian.porta@example.com</from>
            <ssl>false</ssl>
            <transport>smtp</transport>
            <smtphost>smtp.example.com</smtphost>
            <mailto>cristian.porta@example.com,crx@example.com</mailto>
            <user></user>
            <password></password>
            <debug>false</debug>
            <attachMatcherMessages>true</attachMatcherMessages>
      </params>
    </action>
  </newsgroup>
 
  <!-- 
  with an interval of 60 minutes inspect it.comp.database and 
  1. send an "alert" email 
     with a report of post that match into header, subject or body the "stored procedure" phrase
  2. save the post locally into defined path of action "SaveMessage"
  -->
  <newsgroup scaninterval="60" name="it.comp.database" match="stored procedures">
 
    <action class="SaveMessage">
      <params>
        <path>../dir/where/to/save/messages</path>
      </params>
    </action>
 
    <action class="Email">
      <params>
            <subject></subject>
            <from>cristian.porta@example.com</from>
            <ssl>false</ssl>
            <transport>smtp</transport>
            <smtphost>smtp.example.com</smtphost>
            <mailto>cristian.porta@example.com</mailto>
            <user></user>
            <password></password>
            <debug>false</debug>
            <attachMatcherMessages>false</attachMatcherMessages>
      </params>
    </action>
  </newsgroup>
 
  <!-- more newsgroups and actions here! -->
 
</newsserver>

The properties of node newsserver” are:

  • name: the newsserver where to connect
  • port: the port of connection(default 119)
  • username: username only for server that require authentication
  • password: password only for server that require authentication

The properties of node “newsgroup” are:

  • scaninterval: the scan interval for this newsgroup expressed in minutes
  • name: the newsgroup name to inspect
  • match: the words, phrase or REGEXP to search

Available “actions” when a match is found:

  • Email: send a report email with or without attached original messages
  • SaveAttachment: save binary attachment(picture specialized)
  • SaveMessage: save in your path the original messages

RUN YAJGNI

YAJGNI is platform indipendent.

Change dir into bin

For Unix user:
$ chmod a+x ./yajngi.sh
$ ./yajngi.sh

For Windows users:
click the yajngi.bat or type yajngi

Alternatively using direct command:

Change dir into lib and:
$ java -jar -cp .:* yajngi.jar [path2ConfigFile]

Or use a complete yajngi software including libs

$ java -jar yajngi-wlibs.jar [path2ConfigFile]

The first time YAJNGI make only the cache file, if you want to go back and inspect older articles you have to change the reletad cache file.

REQUIREMENTS
YAJNGI require a version of Java >= 1.5

No Comments

Comments are closed.