Ahenk/README.md

ahenk

Lider Ahenk is an open source project which provides solutions to manage, monitor and audit unlimited number of different systems and users on a network.

Ahenk is a Linux agent written in Python which enables Lider to manage & monitor clients remotely.

Add new repo with this file

Documentation

• See Ahenk wiki to get started!
• See how to setup development environment
• Learn how to run ahenk.
• Create Ahenk distribution as .deb package

Packaging

Install necessary packages

sudo apt install build-essential git-buildpackage debhelper debmake

Clone the project and switch to branch 'debian'

git clone https://github.com/Pardus-LiderAhenk/ahenk.git
cd ahenk/
git checkout debian

Install build dependencies via git-buildpackage

sudo mk-build-deps -ir

Build binary package

gbp buildpackage --git-export-dir=/tmp/build-area -b -us -uc
#check the output directory
ls -1 /tmp/build-area
#output should be like this
ahenk_1.0.0-2_all.deb
ahenk_1.0.0-2_amd64.build
ahenk_1.0.0-2_amd64.buildinfo
ahenk_1.0.0-2_amd64.changes
ahenk_1.0.0.orig.tar.gz

Build source package

gbp buildpackage --git-export-dir=/tmp/build-area -S -us -uc
#check the output directory
ls -1 /tmp/build-area
#output should be like this
ahenk_1.0.0-2.debian.tar.xz
ahenk_1.0.0-2.dsc
ahenk_1.0.0-2_source.build
ahenk_1.0.0-2_source.buildinfo
ahenk_1.0.0-2_source.changes
ahenk_1.0.0.orig.tar.gz

If the master has new version tagged (eg: 1.0.2), debian branch should rebased

git rebase 1.0.2

Changelog should be updated after rebase and new debian tag should be created

gbp dch -Rc
gbp buildpackage --git-tag-only

Contribution

We encourage contributions to the project. To contribute:

• Fork the project and create a new bug or feature branch.
• Make your commits with clean, understandable comments
• Perform a pull request

Other Lider Ahenk Projects

• Lider: Business layer running on Karaf container.
• Lider Console: Administration console built as Eclipse RCP project.
• Lider Ahenk Installer: Installation wizard for Ahenk and Lider (and also its LDAP, database, XMPP servers).
• Lider Ahenk Archetype: Maven archetype for easy plugin development.

Changelog

See changelog to learn what we have been up to.

Roadmap

Today

• 30+ plugins
• Linux agent service written in Python
• Administration console built as Eclipse RCP
• Open sourced, easy to access and setup, stable Lider Ahenk v1.0.0

2017

• Agents for Windows and mobile platforms
• Platform-independent administration console
• Inventory scan & management
• Printer management

2016

• Scalable infrastructure suitable for million+ users & systems
• 10+ new plugins (such as file distribution via torrent, remote installation)
• New reporting module & dashboard

License

Lider Ahenk and its sub projects are licensed under the LGPL v3.