Repository files navigation

• Online:

  • GitHub Wiki Pages:https://github.com/pmacct/pmacct/wiki
  • GitHub master code:https://github.com/pmacct/pmacct/

• Distribution tarball:

  • ChangeLog: History of features version by version
  • CONFIG-KEYS: Available configuration directives explained
  • QUICKSTART: Examples, command-lines, quickstart guides
  • FAQS: FAQ document
  • docs/: Miscellaneous internals, UNIX signals, SQL triggers documents
  • examples/: Sample configs, maps, AMQP/Kafka consumers, clients
  • sql/: SQL documentation, default SQL schemas and customization tips

Official pmacct docker images can be found indocker hub. To use them, simply (e.g.sfacctd):

~# docker pull pmacct/sfacctd:latest~# docker run -v /path/to/sfacctd.conf:/etc/pmacct/sfacctd.conf pmacct/sfacctd

For more details, options and troubleshooting please read theDocker documentation section

Resolve dependencies, ie.:

• apt-get install libpcap-dev pkg-config libtool autoconf automake make bash libstdc++-dev g++ for[Debian/Ubuntu]
• yum install libpcap-devel pkgconfig libtool autoconf automake make bash libstdc++-devel gcc-c++ for[CentOS/RHEL]

Build GitHub code:

~# git clone https://github.com/pmacct/pmacct.git~# cd pmacct~# ./autogen.sh~# ./configure #check-out available configure knobs via ./configure --help~# make~# make install #with super-user permission

The pmacct project is looking to make its code base available under a more permissiveBSD-style license. More information about the motivation and process can be found inthisannouncement.

• Prerequisites:

  • Set up git:https://help.github.com/articles/set-up-git/
  • [Specify username, a commit email address matching the GitHub profile one, and a SSH key]

• Code:

  • Fork the pmacct repo:https://help.github.com/articles/fork-a-repo/
  • [Jot down your code in the local clone of your fork, commit and push code changes to your fork]
  • Generate a Pull Request:https://help.github.com/articles/about-pull-requests/

• Wiki (documentation and diagrams):

  • Ask by unicast email to be added to the project collaborators
  • [Edit wiki content online or clone it locally and commit and push changes]
  • If having to add a diagram:https://gist.github.com/subfuzion/0d3f19c4f780a7d75ba2