Ahenk/README.md

114 lines
3.6 KiB
Markdown
Raw Normal View History

2016-04-15 11:06:41 +03:00
# ahenk
2016-02-25 11:46:25 +02:00
2016-04-15 11:06:41 +03:00
**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.
2016-02-25 11:46:25 +02:00
2016-04-15 11:06:41 +03:00
Ahenk is a Linux agent written in Python which enables Lider to manage & monitor clients remotely.
2016-02-25 11:46:25 +02:00
2017-01-02 16:05:50 +03:00
>Add new repo with [this](https://github.com/Pardus-LiderAhenk/lider-ahenk-installer/blob/master/ahenk-installer/conf/liderahenk.list) file
2016-06-01 17:30:12 +03:00
2016-04-15 11:06:41 +03:00
## Documentation
2016-02-25 11:46:25 +02:00
2017-01-02 16:05:50 +03:00
* See [Ahenk wiki](https://github.com/Pardus-LiderAhenk/ahenk/wiki) to get started!
* See how to [setup development environment](https://github.com/Pardus-LiderAhenk/ahenk/wiki/01.-Setup-Development-Environment)
* Learn how to [run](https://github.com/Pardus-LiderAhenk/ahenk/wiki/02.-Running) ahenk.
* Create [Ahenk distribution](https://github.com/Pardus-LiderAhenk/ahenk/wiki/03.-Ahenk-Distribution) as .deb package
2016-02-25 11:46:25 +02:00
2017-11-22 15:32:23 +03:00
## Packaging
Install necessary packages
```bash
sudo apt install build-essential git-buildpackage debhelper debmake
```
Clone the project and switch to branch 'debian'
```bash
git clone https://github.com/Pardus-LiderAhenk/ahenk.git
cd ahenk/
git checkout debian
```
Install build dependencies via git-buildpackage
```bash
sudo mk-build-deps -ir
```
Build binary package
```bash
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
```bash
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
```bash
git rebase 1.0.2
```
Changelog should be updated after rebase and new debian tag should be created
```bash
gbp dch -Rc
gbp buildpackage --git-tag-only
```
2016-04-15 11:06:41 +03:00
## Contribution
2016-02-25 11:46:25 +02:00
2016-04-15 11:06:41 +03:00
We encourage contributions to the project. To contribute:
2016-03-14 10:55:28 +02:00
2016-04-15 11:06:41 +03:00
* Fork the project and create a new bug or feature branch.
* Make your commits with clean, understandable comments
* Perform a pull request
2016-02-25 11:46:25 +02:00
2016-04-15 11:06:41 +03:00
## Other Lider Ahenk Projects
2016-02-25 11:46:25 +02:00
2017-01-02 16:05:50 +03:00
* [Lider](https://github.com/Pardus-LiderAhenk/lider): Business layer running on Karaf container.
* [Lider Console](https://github.com/Pardus-LiderAhenk/lider-console): Administration console built as Eclipse RCP project.
* [Lider Ahenk Installer](https://github.com/Pardus-LiderAhenk/lider-ahenk-installer): Installation wizard for Ahenk and Lider (and also its LDAP, database, XMPP servers).
* [Lider Ahenk Archetype](https://github.com/Pardus-LiderAhenk/lider-ahenk-archetype): Maven archetype for easy plugin development.
2016-02-25 11:46:25 +02:00
2016-04-15 11:06:41 +03:00
## Changelog
2016-02-25 11:46:25 +02:00
2017-01-02 16:05:50 +03:00
See [changelog](https://github.com/Pardus-LiderAhenk/ahenk/wiki/Changelog) to learn what we have been up to.
2016-04-15 11:06:41 +03:00
## 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
#### 2016
* Scalable infrastructure suitable for million+ users & systems
* 10+ new plugins (such as file distribution via torrent, remote installation)
* New reporting module & dashboard
#### 2017
* Agents for Windows and mobile platforms
* Platform-independent administration console
* Inventory scan & management
* Printer management
## License
2017-01-02 16:05:50 +03:00
Lider Ahenk and its sub projects are licensed under the [LGPL v3](https://github.com/Pardus-LiderAhenk/ahenk/blob/master/LICENSE).