deblan-report/README.md
2019-06-12 14:18:30 +02:00

68 lines
1.5 KiB
Markdown

Deblan report
=============
Projet qui génère un rapport générique sur une distribution Debian GNU/Linux (+ Ubuntu).
* Nom du système
* État des paquets et uptime
* Points de montage
* Espaces disques
* Rapport Smartmontools
*
Ce rapport pourra être enregistré dans un fichier et/ou envoyé par mail.
![](https://upload.deblan.org/u/2019-06/5d00ed7a.jpg)
Installation
------------
```
$ sudo apt install gettext-base coreutils smartmontools
$ git clone https://gitnet.fr/deblan/deblan-report.git
```
Configuration
-------------
`./report` va lancer des scripts qui vont analyser des variables d'environnement.
Générér un mail (assurez-vous d'avoir la commande `sendmail` qui fonctionne) :
```
export EMAIL_RECIPIENT=you@example.com
export EMAIL_SENDER=system@example.com
export EMAIL_SUBJECT="Rapport de $(hostname)"
```
Générér un fichier :
```
export HTML_OUTPUT=/var/www/html/report.html
```
Inclure l'analyse S.M.A.R.T via smartmontools :
```
export SMART_DEVICES="/dev/sdXX /dev/sdYY"
```
Inclure les graphiques du jour générés par Munin (rapport mail uniquement) :
```
export MUNIN_DIRECTORY="/var/cache/munin/www/foo/bar/"
```
Le projet inclut un rendu HTML et un rendu en texte. Le rendu par défaut est l'HTML.
Vous pouvez créer vos templates (se référer au code source).
```
# HTML
export TEMPLATE=/path/to/deblan-report/templates/deblan/
# Text
export TEMPLATE=/path/to/deblan-report/templates/deblan-text/
```
Une fois les variables d'environnement ajoutées, il suffit de lancer `sudo ./report`.