User Tools

Site Tools


pom:installation
no way to compare when less than two revisions

Differences

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


Last revision
pom:installation [2020/05/26 21:59] – external edit 127.0.0.1
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/11/12 10:31 by gmsoft