pom-ng:installation
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
pom-ng:installation [2012/09/26 15:33] – gmsoft | pom-ng:installation [2020/05/26 21:59] (current) – external edit 127.0.0.1 | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== Installation ====== | ====== Installation ====== | ||
- | ===== Dependencies | + | 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 a python script called pom-ng-console.py and the web interface is a standalone jquery based web interface. | ||
+ | |||
+ | ===== Installing pom-ng | ||
+ | |||
+ | ==== Dependencies | ||
In order to compile pom-ng, there are several mandatory and non mandatory dependencies as well as build dependencies. | In order to compile pom-ng, there are several mandatory and non mandatory dependencies as well as build dependencies. | ||
Line 12: | Line 18: | ||
* Mandatory dependencies | * Mandatory dependencies | ||
* [[http:// | * [[http:// | ||
- | * [[http:// | + | * [[http:// |
- | * [[http:// | + | * [[http:// |
- | * [[http:// | + | * [[http:// |
+ | * [[https:// | ||
* Optional dependencies | * Optional dependencies | ||
Line 21: | Line 28: | ||
* [[http:// | * [[http:// | ||
* [[http:// | * [[http:// | ||
- | * [[http:// | + | * [[http:// |
+ | * [[http:// | ||
+ | * [[http:// | ||
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. | ||
Line 27: | Line 36: | ||
**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 " | **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 " | ||
- | ===== Building from git ===== | + | |
+ | ==== Building from git ==== | ||
You can obtain a copy of the source code from [[https:// | You can obtain a copy of the source code from [[https:// | ||
- | git clone git:// | + | |
You then need to to run autoreconf to create the configure script : | 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, | + | If you encounter any errors, make sure you have all the build dependencies, |
The run the following commands to compile and install it : | The run the following commands to compile and install it : | ||
- | ./ | + | |
- | make | + | |
- | make install | + | |
+ | |||
+ | ==== Running it ==== | ||
+ | To run it, simply issue the command | ||
+ | # pom-ng | ||
+ | |||
+ | ==== Running it without make install ==== | ||
+ | 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 / | ||
+ | |||
+ | 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 | ||
+ | export POM_LIBDIR=modules/ | ||
+ | export LD_LIBRARY_PATH=.libs | ||
+ | |||
+ | You can then run it localy : | ||
+ | ./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 / | ||
+ | # git clone git:// | ||
+ | |||
+ | This is all you need. | ||
+ | |||
+ | ==== Extract the tarball ==== | ||
+ | |||
+ | Alternatively, | ||
+ | |||
+ | |||
+ | === Connecting to the web interface ==== | ||
+ | |||
+ | By default, pom-ng will listen on port 8080. Simply point your browser to http:// | ||
+ | |||
+ | ===== Installing pom-ng-console.py ===== | ||
+ | |||
+ | ==== Dependency ==== | ||
+ | |||
+ | The console depends on python 3. | ||
+ | |||
+ | ==== Installation procedure ==== | ||
+ | Installing the console is a lot easier. First you need to fetch it from [[https:// | ||
+ | git clone 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, | ||
+ | cd pom-ng-console | ||
+ | ./ | ||
+ | |||
+ | Once you are done, continue by reading the [[pom-ng: | ||
+ | |||
+ | |||
+ | ===== Troubleshooting ===== | ||
+ | |||
+ | If after running make install, you have the following error : | ||
+ | pom-ng: error while loading shared libraries: libpom-ng.so.0: | ||
+ | |||
+ | It means that your system doesn' | ||
+ | echo "/ |
pom-ng/installation.1348673622.txt.gz · Last modified: 2020/05/26 21:59 (external edit)