User Tools

Site Tools


pom-ng:installation

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
pom-ng:installation [2012/10/01 15:08] 2001:7e8:2221:600:1854:f5ff:fe53:d2f2pom-ng:installation [2020/05/26 21:59] (current) – external edit 127.0.0.1
Line 1: Line 1:
 ====== Installation ====== ====== Installation ======
  
-There are two parts to pom-ng. The main executable called **pom-ng** and the python scripts that provides friendly console to administer it called **pom-ng-console.py**.+There are two parts to pom-ng. The main executable called **pom-ng**
 +You can then either use the CLI or the web interface.\\ 
 +The CLI consists of python script called pom-ng-console.py and the web interface is a standalone jquery based web interface.
  
 ===== Installing pom-ng ===== ===== Installing pom-ng =====
Line 16: Line 18:
   * Mandatory dependencies   * Mandatory dependencies
       * [[http://www.xmlsoft.org/|libxml2]]       * [[http://www.xmlsoft.org/|libxml2]]
-      * [[http://www.gnu.org/software/libmicrohttpd/|libmicrohttpd]] (>= 0.9.x+      * [[http://www.gnu.org/software/libmicrohttpd/|libmicrohttpd]] (>= 0.9.25
-      * [[http://xmlrpc-c.sourceforge.net/|xmlrpc-c]] +      * [[http://xmlrpc-c.sourceforge.net/|xmlrpc-c]] (package libxmlrpc-core-c3-dev) 
-      * [[http://www.lua.org/|lua]] (>= 5.1)+      * [[http://www.lua.org/|lua]] (= 5.1) (package liblua5.1-dev) 
 +      * [[https://troydhanson.github.io/uthash/|uthash]]
  
   * Optional dependencies   * Optional dependencies
Line 25: Line 28:
       * [[http://www.zlib.net/|zlib]] Used to decompress payloads and packets.       * [[http://www.zlib.net/|zlib]] Used to decompress payloads and packets.
       * [[http://libjpeg-turbo.virtualgl.org/|libjpeg]] Used to analyze jpeg images.       * [[http://libjpeg-turbo.virtualgl.org/|libjpeg]] Used to analyze jpeg images.
-      * [[http://www.sqlite.org/|SQLite]] (>= 3.x) Database backend to store configurations and other.+      * [[http://www.sqlite.org/|SQLite]] (>= 3.x) Database backend to store configurations and other. (on debian wheezy for dev files: libsqlite3-dev) 
 +      * [[http://libexif.sourceforge.net/|libexif]] Used to parse exif data from jpeg images. 
 +      * [[http://www.postgresql.org/|Postgresql]] Another database backend.
  
 You must have at least one database backend. Currently only sqlite3 is supported. 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. **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 git ==== ==== Building from git ====
Line 54: Line 60:
   ln -s /local/path/of/pom-ng/ /usr/local/share/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 :+Then you need to go in the src directory and export the necessary environment variables so that pom-ng can locate its libraries :
   cd src   cd src
   export POM_LIBDIR=modules/.libs   export POM_LIBDIR=modules/.libs
Line 62: Line 68:
   ./pom-ng   ./pom-ng
  
 +
 +===== Installing pom-ng web interface ====
 +
 +The web interface is javascript only. No server side support is needed.
 +
 +==== Installing from git ====
 +
 +You need to clone the git repository in the right directory.
 +
 +  # cd /usr/local/share/pom-ng
 +  # git clone git://github.com/gmsoft-tuxicoman/pom-ng-webui.git
 +
 +This is all you need.
 +
 +==== Extract the tarball ====
 +
 +Alternatively, you can simply extract the webui tarball in /usr/local/share/pom-ng/pom-ng-webui/.
 +
 +
 +=== Connecting to the web interface ====
 +
 +By default, pom-ng will listen on port 8080. Simply point your browser to http://localhost:8080 and the web interface will show up.
  
 ===== Installing pom-ng-console.py ===== ===== Installing pom-ng-console.py =====
Line 84: Line 112:
   ./pom-ng-console.py   ./pom-ng-console.py
      
-Once you are done, continue by reading the [[getting_started::getting started]] section.+Once you are done, continue by reading the [[pom-ng:getting_started|getting started]] section. 
 + 
 + 
 +=====  Troubleshooting ===== 
 + 
 +If after running make install, you have the following error : 
 +  pom-ng: error while loading shared libraries: libpom-ng.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-ng.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-ng/installation.1349104139.txt.gz · Last modified: 2020/05/26 21:59 (external edit)