User Tools

Site Tools


pom:installation

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

pom:installation [2020/05/26 21:59] (current)
Line 1: Line 1:
 +===== Installation =====
 +
 +==== Dependencies ====
 +  * libxml2 : Required for parsing and writing the configuration.
 +  * libpcap : Required for input_pcap, target_pcap,​ target_tcpkill and target_inject.
 +  * xmlrpc-c : Required for XML-RPC interface and the web interface.
 +  * MySQL : Required to build datastore_mysql.
 +  * PostgreSQL : Required to build datastore_postgres.
 +  * SQLite 3 : Required to build datastore_sqlite.
 +
 +**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.
 +
 +==== Building from svn ====
 +
 +You can obtain the source from the subversion repository by running the following command :
 +  svn checkout https://​svn.tuxicoman.be/​svn/​packet-o-matic/​trunk packet-o-matic
 +
 +You need at least autoconf-2.61. Once you have checked out the repository, you need to run autoreconf to create the configure script.
 +  autoreconf -f -i
 +
 +When this is done, proceed as explained below.
 +
 +For Gentoo users, a ebuild is available here : [[http://​www.packet-o-matic.org/​downloads/​packet-o-matic-svn-1.ebuild]]
 +
 +==== Building from tarball ====
 +
 +You can obtain a snapshot of the source here : [[http://​www.packet-o-matic.org/​downloads/​]]
 +
 +First extract the tarball :
 +  tar -xzvf packet-o-matic-svn-XXXXXXXX.tar.gz
 +
 +Then run the following commands :
 +  cd packet-o-matic
 +  ./configure
 +  make
 +  make install
 +
 +
 +==== Running it ====
 +
 +If you did make install, you are fine. The program will be able to find the libraries using automatic resolving or hardcoded library path.
 +
 +If you did not run make install, you have to set the variable LD_LIBRARY_PATH to the correct path. By default, libtool creates the libs into the src/.libs directory.
 +  export LD_LIBRARY_PATH=src/​.libs
 +
 +Also if you didn't ran make install, you may want to create a symbolic link for the share directory that points to your current packet-o-matic folder. This will help for the web interface and target_http.
 +  cd /​usr/​local/​share/​
 +  ln -s /​folder/​of/​packet-o-matic/​
 +
 +Some modules such as input_pcap requires root privileges in order to perform their operation.
 +
 +====  Troubleshooting ====
 +
 +If after running make install, you have the following error :
 +  packet-o-matic:​ error while loading shared libraries: libpom.so.0:​ cannot open shared object file: No such file or directory
 +
 +It means that your system doesn'​t search at the correct place for libpom.so. To solve this problem add "/​usr/​local/​lib/"​ in /​etc/​ld.so.conf. The following command will do it :
 +  echo "/​usr/​local/​lib"​ >> /​etc/​ld.so.conf;​ ldconfig
 +
  
pom/installation.txt ยท Last modified: 2020/05/26 21:59 (external edit)