[](LICENSE)
[](https://travis-ci.org/zerodayz/citellus)
[](https://coveralls.io/github/zerodayz/citellus?branch=master)
[](https://github.com/zerodayz/citellus/releases)
[](https://badge.fury.io/py/citellus)
[](https://microbadger.com/images/citellus/citellus "Get your own image badge on microbadger.com")
<img src="doc/citellus.png" width="20%" border=0 align="right">
# Introduction
Citellus is a framework to help with system configuration validation on either live system or any sort of snapshot of the filesystem.
Via execution of 'plugins' it reports status on each one execution against the system that gives you an idea on health status, actual problems or problems that will reveal themselves if no preventive action is taken.
Please if you have any idea on any improvements please do not hesitate to open an issue.
## Highlights
- Plugins written in your language of choice.
- Allows to dump output to json file to be processed by other tools.
- Allow to visualize html from json output.
- Check our sample at: [Citellus-www](http://htmlpreview.github.io/?https://github.com/zerodayz/citellus/blob/master/doc/sampleweb/citellus.html)
- Ansible playbook support.
- Save / restore default settings
Check latest changes on [Changelog.md](Changelog.md)
Check for plugins listing on [citellusclient/plugins/](citellusclient/plugins/)
Framework contains additional readmes for the tools included:
- [Citellus README](README.citellus.md)
- [Magui README](README.magui.md)
## Installation
Check `README` above for detailed instructions outside os simple ones:
- Just clone the git repository and execute it from there 'or'
- use 'pipsi' or create a python virtual env to install package 'citellus'
- Give it a try running as 'root' on your system with: `./citellus.py -l -F"` so it will show `live execution` and only `Failed` tests.
## How does it looks like?
Check how does it look in an execution at:
[](https://asciinema.org/a/169814)
## HTML Interface
<img src="doc/images/www.png" height="40%" border=0>
## Additional resources
- Devconf.cz 2018 Presentation:
- Slot link [devconf.cz 2018!!](https://devconfcz2018.sched.com/event/DJXG/detect-pitfalls-of-osp-deployments-with-citellus)
- Slides <doc/devconfcz2018-presentation-revealmd.md>
- Recording <https://www.youtube.com/watch?v=SDzzqrUdn5A>
- Blog posts
- <https://iranzo.github.io/blog/2017/07/26/Citellus-framework-for-detecting-known-issues/>
- <https://iranzo.github.io/blog/2017/07/31/Magui-for-analysis-of-issues-across-several-hosts/>
- <https://iranzo.github.io/blog/2017/08/17/Jenkins-for-running-CI-tests/>
- <https://iranzo.github.io/blog/2017/10/26/i18n-and-bash8-in-bash/>
- <https://iranzo.github.io/blog/2018/01/16/recent-changes-in-magui-and-citellus/>
## Collaborate
- Open issues/feature requests, etc at <https://github.com/zerodayz/citellus/issues>
- Read the [Contributing](CONTRIBUTING.md) document on how to submit patches
- Provide sosreports to check against via <https://www.dropbox.com/request/8LGneF9i9nc9RB6aqXge>, specially if running Debian based distributions and or Fedora/CentOS based ones so that we can improve support for it
## Contact us!!
You can reach to us via:
- irc at #citellus in Freenode
- our mailing list:
- <mailto:citellus-dev@redhat.com>
- <https://www.redhat.com/mailman/listinfo/citellus-dev>
[](https://travis-ci.org/zerodayz/citellus)
[](https://coveralls.io/github/zerodayz/citellus?branch=master)
[](https://github.com/zerodayz/citellus/releases)
[](https://badge.fury.io/py/citellus)
[](https://microbadger.com/images/citellus/citellus "Get your own image badge on microbadger.com")
<img src="doc/citellus.png" width="20%" border=0 align="right">
# Introduction
Citellus is a framework to help with system configuration validation on either live system or any sort of snapshot of the filesystem.
Via execution of 'plugins' it reports status on each one execution against the system that gives you an idea on health status, actual problems or problems that will reveal themselves if no preventive action is taken.
Please if you have any idea on any improvements please do not hesitate to open an issue.
## Highlights
- Plugins written in your language of choice.
- Allows to dump output to json file to be processed by other tools.
- Allow to visualize html from json output.
- Check our sample at: [Citellus-www](http://htmlpreview.github.io/?https://github.com/zerodayz/citellus/blob/master/doc/sampleweb/citellus.html)
- Ansible playbook support.
- Save / restore default settings
Check latest changes on [Changelog.md](Changelog.md)
Check for plugins listing on [citellusclient/plugins/](citellusclient/plugins/)
Framework contains additional readmes for the tools included:
- [Citellus README](README.citellus.md)
- [Magui README](README.magui.md)
## Installation
Check `README` above for detailed instructions outside os simple ones:
- Just clone the git repository and execute it from there 'or'
- use 'pipsi' or create a python virtual env to install package 'citellus'
- Give it a try running as 'root' on your system with: `./citellus.py -l -F"` so it will show `live execution` and only `Failed` tests.
## How does it looks like?
Check how does it look in an execution at:
[](https://asciinema.org/a/169814)
## HTML Interface
<img src="doc/images/www.png" height="40%" border=0>
## Additional resources
- Devconf.cz 2018 Presentation:
- Slot link [devconf.cz 2018!!](https://devconfcz2018.sched.com/event/DJXG/detect-pitfalls-of-osp-deployments-with-citellus)
- Slides <doc/devconfcz2018-presentation-revealmd.md>
- Recording <https://www.youtube.com/watch?v=SDzzqrUdn5A>
- Blog posts
- <https://iranzo.github.io/blog/2017/07/26/Citellus-framework-for-detecting-known-issues/>
- <https://iranzo.github.io/blog/2017/07/31/Magui-for-analysis-of-issues-across-several-hosts/>
- <https://iranzo.github.io/blog/2017/08/17/Jenkins-for-running-CI-tests/>
- <https://iranzo.github.io/blog/2017/10/26/i18n-and-bash8-in-bash/>
- <https://iranzo.github.io/blog/2018/01/16/recent-changes-in-magui-and-citellus/>
## Collaborate
- Open issues/feature requests, etc at <https://github.com/zerodayz/citellus/issues>
- Read the [Contributing](CONTRIBUTING.md) document on how to submit patches
- Provide sosreports to check against via <https://www.dropbox.com/request/8LGneF9i9nc9RB6aqXge>, specially if running Debian based distributions and or Fedora/CentOS based ones so that we can improve support for it
## Contact us!!
You can reach to us via:
- irc at #citellus in Freenode
- our mailing list:
- <mailto:citellus-dev@redhat.com>
- <https://www.redhat.com/mailman/listinfo/citellus-dev>
Release files for citellus 0.1.9.360072410.20180329224459
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| citellus-0.1.9.360072410.20180329224459.tar.gz | 1.2 MB | Details |
Release files / citellus-0.1.9.360072410.20180329224459.tar.gz
| Download URL | citellus-0.1.9.360072410.20180329224459.tar.gz |
|---|---|
| Size | 1.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d76e723196ddcf0f3a6c8645d31c1b5c5e9d11b1c96827eb783fbdc2160af4e8
|
|
BLAKE2b-256 checksum How to use checksums |
e0c1b13c33260cba7bf4555c96b16e10be909d9b3b1ee9bcc6496ed659862155
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
