metron-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mmiklavc <...@git.apache.org>
Subject [GitHub] incubator-metron pull request #256: Metron 257 Enable pcap result pagination...
Date Fri, 16 Sep 2016 04:56:33 GMT
GitHub user mmiklavc opened a pull request:

    https://github.com/apache/incubator-metron/pull/256

    Metron 257 Enable pcap result pagination from the Pcap CLI

    This builds on efforts from [https://github.com/apache/incubator-metron/pull/217](https://github.com/apache/incubator-metron/pull/217)
    
    This closes [https://issues.apache.org/jira/browse/METRON-257](https://issues.apache.org/jira/browse/METRON-257)
    
    The purpose for this PR is to give the user the ability to specify how many records per
file should be written by the PCAP CLI tool. For example, if 1,000 records are returned by
a PCAP query and the user specifies 200 records per file, then the user should expect 5 PCAP
files to be written to the current working directory.
    
    **Testing**
    Get PCAP data into Metron: Install and setup pycapa - the instructions below reference/mirror
those in [PR-93](https://github.com/apache/incubator-metron/pull/93#issue-151705836)
    
    1. Install the pycapa library & utility ```$ cd /opt/pycapa/pycapa && pip
install -r requirements.txt && python setup.py install```
    2. (if using singlenode vagrant) Kill the enrichment and sensor topologies via for i in
bro enrichment yaf snort;do storm kill $i;done
    3. Start the pcap topology via /usr/metron/0.2.0BETA/bin/start_pcap_topology.sh
    4. Start the pycapa packet capture producer on eth1 via /usr/bin/pycapa --producer --topic
pcap -i eth1 -k node1:6667
    5. Watch the topology in the Storm UI and kill the packet capture utility from before,
when the number of packets ingested is over 3k.
    6. Ensure that at at least 3 files exist on HDFS by running hadoop fs -ls /apps/metron/pcap
    7. Choose a file (denoted by $FILE) and dump a few of the contents using the pcap_inspector
utility via /usr/metron/0.2.0BETA/bin/pcap_inspector.sh -i $FILE -n 5
    8. Choose one of the lines and note the protocol.
    9. Note that when you run the commands below, the resulting file will be placed in the
execution directory where you kicked off the job from.
    
    ### Fixed filter
    
    1. Run a fixed filter query by executing the following command with the values noted above
(match your start_time format to the date format provided - default is to use millis since
epoch)
    2. `/usr/metron/0.2.0BETA/bin/pcap_query.sh fixed -st <start_time> -df "yyyyMMdd"
-p <protocol_num> -rpf 500`
    3. Verify the MR job finishes successfully. Upon completion, you should see multiple files
named with relatively current datestamps in your current directory, e.g. pcap-data-20160617160549737+0000.pcap
    4. Copy the files to your local machine and verify you can them it in Wireshark. I chose
a middle file and the last file. The middle file should have 500 records (per the records_per_file
option), and the last one will likely have a number of records <= 500.
    
    ### Query filter
    
    1. Run a Stellar query filter query by executing a command similar to the following, with
the values noted above (match your start_time format to the date format provided - default
is to use millis since epoch)
    2. `/usr/metron/0.2.0BETA/bin/pcap_query.sh query -st "20160617" -df "yyyyMMdd" -query
"protocol == '6'"  -rpf 500`
    3. Verify the MR job finishes successfully. Upon completion, you should see multiple files
named with relatively current datestamps in your current directory, e.g. pcap-data-20160617160549737+0000.pcap
    4. Copy the files to your local machine and verify you can them it in Wireshark. I chose
a middle file and the last file. The middle file should have 500 records (per the records_per_file
option), and the last one will likely have a number of records <= 500.
    
    **References:**
    - https://github.com/apache/incubator-metron/pull/217
    - https://github.com/apache/incubator-metron/pull/156
    - https://github.com/apache/incubator-metron/pull/93#issue-151705836
    - https://github.com/apache/incubator-metron/tree/master/metron-sensors/pycapa

You can merge this pull request into a Git repository by running:

    $ git pull https://github.com/mmiklavc/incubator-metron METRON-257

Alternatively you can review and apply these changes as the patch at:

    https://github.com/apache/incubator-metron/pull/256.patch

To close this pull request, make a commit to your master/trunk branch
with (at least) the following in the commit message:

    This closes #256
    
----
commit a06fd0b918bfd4d363d58ffb5c5c2dba015e7c57
Author: Michael Miklavcic <michael.miklavcic@gmail.com>
Date:   2016-09-15T01:54:50Z

    Refactor pcap cli tests. Fix num reducers

commit cc06349495315a6e1e7b393cd4871bf3e855bc3b
Author: Michael Miklavcic <michael.miklavcic@gmail.com>
Date:   2016-09-16T04:43:43Z

    METRON-257 Enable pcap result pagination from the Pcap CLI

----


---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---

Mime
View raw message