/phpipam-agent

phpipam scan agent

Primary LanguagePHP

Description

phpipam-agent is a scanning agent for a phpipam server to be deployed to remote servers

License

phpipam is released under the GPL v3 license. See misc/gpl-3.0.txt.

Requirements

  • 64bit PHP version 5.4+ with following modules
    • pdo, pdo_mysql : Adds support for mysql connections (if type=mysql)
    • gmp : Adds support for dev-libs/gmp (GNU MP library) -> to calculate IPv6 networks
    • json : Adds supports for JSON data-interexchange format
    • pcntl : Adds supports for threading via CLI ( not supported by windows )
  • PHP PEAR support (dev-php/pear)

Install

git clone --recursive https://github.com/phpipam/phpipam-agent/ phpipam-agent

Just run index.php script with discover or update as argument.

  • Make sure this client has read/write access to main phpipam database.
    GRANT SELECT on `phpipam`.* TO 'username'@'hostname' identified by "password";
    GRANT INSERT,UPDATE on `phpipam`.`ipaddresses` TO 'username'@'hostname' identified by "password";
    GRANT UPDATE on phpipam.scanAgents TO 'username'@'hostname' identified by "password";
  • If you will remove inactive dhcp/autodiscovered also this is needed
    GRANT DELETE on `phpipam`.`ipaddresses` TO 'username'@'hostname' identified by "password";

Update

cd phpipam-agent
git pull
git submodule update --init --recursive

Scheduled scans

For scheduled scans you have to run a script from cron. Add something like the following to your cron to scan every 15 minutes:

*/15 * * * * php /where/your/agent/index.php update
*/15 * * * * php /where/your/agent/index.php discover

Contact

miha.petkovsek@gmail.com