There are two parts to pom-ng. The main executable called pom-ng and the python scripts that provides a friendly console to administer it called pom-ng-console.py.

In order to compile pom-ng, there are several mandatory and non mandatory dependencies as well as build dependencies.

• Build dependencies
  • gcc/binutils/make and all the base package for compiling a C application
  • autotools
  • libtool
  • pkg-config

• Mandatory dependencies
  • libxml2
  • libmicrohttpd (>= 0.9.x)
  • xmlrpc-c
  • lua (>= 5.1)

• Optional dependencies
  • libmagic Comes with the file utility on linux. This allow identification of unknown payloads.
  • libpcap Used to capture packets from live interface as well as reading and saving pcap files. A must have !
  • zlib Used to decompress payloads and packets.
  • libjpeg Used to analyze jpeg images.
  • SQLite (>= 3.x) Database backend to store configurations and other.

You must have at least one database backend. Currently only sqlite3 is supported.

IMPORTANT If you want to use targets and inputs that uses libpcap or any other feature that requires some special dependency, make sure that you install them before running the ./configure script. On some distributions (e.g. Debian, Ubuntu) you will need to install the -dev package that contains the include files. For example on Debian you would execute “apt-get install libpcap-dev”. The package pkg-config is also very important for the configure script. Make sure you have it installed on your system.

You can obtain a copy of the source code from github by running the following command :

# git clone git://github.com/gmsoft-tuxicoman/pom-ng.git

You then need to to run autoreconf to create the configure script :

# autoreconf -f -i

If you encounter any errors, make sure you have all the build dependencies, especially libtool and pkg-config.

The run the following commands to compile and install it :

# ./configure
# make
# make install

To run it, simply issue the command

# pom-ng

When you are coding on pom-ng, it's sometimes useful to run it without having to install it on the system. To do so, you need to perform several things. First you must create a symbolic link to your local copy of pom-ng :

ln -s /local/path/of/pom-ng/ /usr/local/share/pom-ng/

Then you need to go in the src directory and export the nescessary environment variables so that pom-ng can locate its libraries :

cd src
export POM_LIBDIR=modules/.libs
export LD_LIBRARY_PATH=.libs

You can then run it localy :

./pom-ng

The console depends on python 3.

Installing the console is a lot easier. First you need to fetch it from github :

git clone git://github.com/gmsoft-tuxicoman/pom-ng-console.git

You can then install the console with the following command :

cd pom-ng-console
python setup.py install

Once done, you can run it :

pom-ng-console.py

Alternativaly, you can run it directly from the local directory without installing it :

cd pom-ng-console
./pom-ng-console.py