One of the less common use cases for NetWitness is to process PCAP data that has been collected elsewhere for analysis. That is, the Decoder is not plugged into a TAP or SPAN port that is collecting live data. Instead, PCAP files can be fed into the Decoder a number of ways but file transfers happen over the management interface... not a capture port. For this to work the Decoder is set to Stop Capture, as below.
Importing a PCAP manually from the Administrator tool is possible by clicking on the Import Packets button. This is great for a small numbers of PCAP files but it doesn't work well out-of-hours or when you want to take leave. An automated, scripted process for importing PCAP files is needed in these situations.
Automating PCAP importing
Other than the Administrator tool, there are a number of other ways to import PCAP files in NetWitness that can potentially be used in a script.
REST API import
The first method is the use of the REST API to upload PCAP files from literally anywhere. This method has the benefit of being very easy to script as it uses html commands to the REST port (50104) on a Decoder.
<?xml version="1.0" encoding="UTF-8"?>
<data filename="data.pcap" packets="5230072" size="744026236">Success</data>
There is only one drawback to using this method that I can see and that is the PCAP file doesn't create meta associated with the filename and path. This was an optional but useful feature of using the Administrator tool to import data.
The other method I am aware of is the use of the NwConsole command.
[root@NWDECODER ~]# NwConsole
NetWitness Console 18.104.22.168
Copyright 2001-2012, NetWitness Corporation. All Rights Reserved.
> login localhost:50004 admin netwitness
Successfully logged in as session 10596
[localhost:50004] /> import data.pcap
Sending packets to Decoder from file "data.pcap"
... 20% ... 40% ... 60% ... 80% ... 100%
My question to the NW community is have you addressed this issue and come up with an elegant solution you can share? It would be great to hear of your approaches and any tricks you learnt along the way. Also, if anyone knows a magic REST API tag that will enable the Track Filename functionality please let me know too.