1. Basic Requirements¶

This section describes the third-party software that eProsima Non-Intrusive DDS Recorder needs in order to run. Once these requirements are met, please refer to Non-Intrusive DDS Recorder on Windows or Non-Intrusive DDS Recorder on Linux to install the application itself.

1.1. Windows¶

1.1.1. Latest Microsoft Visual C++ Redistributable package¶

eProsima Non-Intrusive DDS Recorder requires the latest Microsoft Visual C++ Redistributable package. The distributed installer checks whether the package is present in the system and, if it is not, prompts the user to install it.

1.1.2. Packet capture runtime¶

eProsima Non-Intrusive DDS Recorder reads capture files through libpcap, which on Windows is supplied by a separate runtime rather than by the operating system. Install Npcap, which provides wpcap.dll and Packet.dll.

Important

Install Npcap rather than the older WinPcap. WinPcap 4.1.3, its last release, embeds libpcap 1.0, which predates the pcapng format that recent versions of Wireshark write by default. With it eProsima Non-Intrusive DDS Recorder cannot open a pcapng capture at all. See Capture file formats.

eProsima Non-Intrusive DDS Recorder only reads capture files and never opens a network interface, so only these libraries are used at run time; the capture driver the runtime also installs is needed by the sniffer that produces the file, not by eProsima Non-Intrusive DDS Recorder.

1.2. Linux distributions¶

The binary distribution of eProsima Non-Intrusive DDS Recorder links against the libraries listed below. Install them using the package manager of the corresponding Linux distribution.

Table 1.1 Runtime dependencies on Linux¶
Dependency	Purpose	Debian/Ubuntu package
libpcap	Reads the PCAP capture file.	`libpcap-dev`
SQLite3	Stores the recorded traffic.	`libsqlite3-dev`
Boost	Utility libraries (chrono, date_time, thread and system).	`libboost-all-dev`

On Debian based distributions the three of them can be installed with a single command:

sudo apt install libpcap-dev libsqlite3-dev libboost-all-dev

eProsima Non-Intrusive DDS Recorder also uses the eProsima Fast CDR library to deserialize the CDR representation of the recorded samples. eProsima Fast CDR is distributed together with the application, and Non-Intrusive DDS Recorder on Linux explains how to install it.