grosse réorganisation
This commit is contained in:
parent
ebcb02e7f4
commit
ebd0416f0c
144
HowtoDUC.md
144
HowtoDUC.md
|
@ -17,6 +17,109 @@ Un paquet est disponible à partir de Debian Stretch.
|
||||||
|
|
||||||
## Utilisation
|
## Utilisation
|
||||||
|
|
||||||
|
### Création de l'indexe
|
||||||
|
|
||||||
|
La première chose à faire est de créer un indexe, c'est la partie qui analyse l'espace disque pour ensuite l'afficher de différentes manières. Par défaut l'indexe sera crée dans `$HOME/.duc.db`, si l'on veut changer le chemin de l'indexe il faudrait utiliser la variable d'environnement `DUC_DATABASE` ou spécifier le chemin avec `-d`.
|
||||||
|
|
||||||
|
L'indexe n'est pas forcément rattaché à un seul chemin, on peut en indexer autant qu'on veut :
|
||||||
|
|
||||||
|
~~~
|
||||||
|
$ duc index -d /tmp/duc.idx /var/
|
||||||
|
$ duc index -d /tmp/duc.idx /usr/
|
||||||
|
~~~
|
||||||
|
|
||||||
|
### Consulter l'indexe
|
||||||
|
|
||||||
|
#### Voir les informations de l'indexe
|
||||||
|
|
||||||
|
~~~
|
||||||
|
$ duc info -d /tmp/duc.idx
|
||||||
|
Date Time Files Dirs Size Path
|
||||||
|
2018-03-02 09:49:38 22.5K 2.4K 2.2G /var
|
||||||
|
2018-03-02 09:49:42 268.0K 24.1K 8.2G /usr
|
||||||
|
~~~
|
||||||
|
|
||||||
|
#### Lister le contenu de l'indexe
|
||||||
|
|
||||||
|
~~~
|
||||||
|
$ duc ls -d /tmp/duc.idx /usr
|
||||||
|
4.3G lib
|
||||||
|
3.0G share
|
||||||
|
606.2M bin
|
||||||
|
210.5M src
|
||||||
|
66.4M include
|
||||||
|
35.3M sbin
|
||||||
|
20.1M local
|
||||||
|
6.4M lib32
|
||||||
|
2.2M libexec
|
||||||
|
1.7M games
|
||||||
|
4.0K etc
|
||||||
|
|
||||||
|
$ duc ls -d /tmp/duc.idx /usr/bin/ | head
|
||||||
|
29.9M hkt
|
||||||
|
28.3M hokey
|
||||||
|
24.2M node
|
||||||
|
19.6M hot
|
||||||
|
17.0M shellcheck
|
||||||
|
15.7M mysql_embedded
|
||||||
|
14.7M fwbuilder
|
||||||
|
11.6M audacity
|
||||||
|
11.1M rawtherapee
|
||||||
|
10.4M qemu-system-x86_64
|
||||||
|
|
||||||
|
$ duc ls -d /tmp/duc.idx /var/log | head
|
||||||
|
197.2M atop
|
||||||
|
30.4M daemon.log.1
|
||||||
|
24.1M daemon.log
|
||||||
|
17.1M installer
|
||||||
|
5.4M syslog.1
|
||||||
|
2.7M messages.1
|
||||||
|
2.4M vbox-install.log
|
||||||
|
2.1M syslog
|
||||||
|
1.9M kern.log.1
|
||||||
|
1.7M ufw.log.1
|
||||||
|
~~~
|
||||||
|
|
||||||
|
#### Lister le contenu de l'indexe avec une interface ncurses
|
||||||
|
|
||||||
|
L'interface ncurses est semblable à celle de ncdu. La touche `h` permettra d'afficher l'aide pour comprendre comment naviguer et interagir avec cette interface.
|
||||||
|
|
||||||
|
~~~
|
||||||
|
# duc ui -d /tmp/duc.idx /usr
|
||||||
|
~~~
|
||||||
|
|
||||||
|
![Interfaces ncurses](/duc.png)
|
||||||
|
|
||||||
|
#### Lister le contenu de l'indexe avec une interface graphique
|
||||||
|
|
||||||
|
Si on est sur un poste ayant un serveur X (ou en `ssh -X`), on pourra utiliser cette interface et utiliser la souris.
|
||||||
|
|
||||||
|
~~~
|
||||||
|
$ duc gui -d /tmp/duc.idx /usr
|
||||||
|
~~~
|
||||||
|
|
||||||
|
![Le GUI de Duc](/duc2.png)
|
||||||
|
|
||||||
|
#### Lister le contenu de l'indexe avec un script CGI
|
||||||
|
|
||||||
|
Il suffit de créer ce script sh dans `/usr/lib/cgi-bin/duc.cgi`, de donner les bons droits et d'y accéder.
|
||||||
|
|
||||||
|
~~~
|
||||||
|
#!/bin/sh
|
||||||
|
/usr/bin/duc cgi -d /backup/duc.idx --list
|
||||||
|
~~~
|
||||||
|
|
||||||
|
~~~
|
||||||
|
# chmod 755 /usr/lib/cgi-bin/duc.cgi
|
||||||
|
# chown www-data: /usr/lib/cgi-bin/duc.cgi
|
||||||
|
# chmod 640 /backup/duc.idx
|
||||||
|
# chgrp www-data /backup/duc.idx
|
||||||
|
~~~
|
||||||
|
|
||||||
|
Il faudra ensuite utiliser un serveur Web comme [HowtoApache](Apache) pour y accéder.
|
||||||
|
|
||||||
|
### Plomberie
|
||||||
|
|
||||||
Quelques exemples :
|
Quelques exemples :
|
||||||
|
|
||||||
Lancer une indexation de /backup/jails :
|
Lancer une indexation de /backup/jails :
|
||||||
|
@ -37,27 +140,12 @@ Pour exclure un répertoire (./backup/ contenant de nombreux fichiers), se place
|
||||||
# duc index -p -e "backup" -d duc.idx .
|
# duc index -p -e "backup" -d duc.idx .
|
||||||
~~~
|
~~~
|
||||||
|
|
||||||
On peut tout aussi bien ajouter dans l'indexe, éléments par éléments, qui peuvent même être indépendant les uns des autres (hiérarchie du système de fichier) :
|
|
||||||
|
|
||||||
~~~
|
|
||||||
# duc index -d duc.idx /var/foo/
|
|
||||||
# duc index -d duc.idx /usr/bar/
|
|
||||||
~~~
|
|
||||||
|
|
||||||
Exemple, analyser /backup, avec un index dans /home :
|
Exemple, analyser /backup, avec un index dans /home :
|
||||||
|
|
||||||
~~~
|
~~~
|
||||||
# duc index -p -d /home/duc_backup.idx /backup
|
# duc index -p -d /home/duc_backup.idx /backup
|
||||||
~~~
|
~~~
|
||||||
|
|
||||||
Afficher l'espace disque avec l'interface ncurses. (q pour quitter, flèche directionnelles pour naviguer).
|
|
||||||
|
|
||||||
~~~
|
|
||||||
# duc ui -d /backup/duc.idx /backup/jails
|
|
||||||
~~~
|
|
||||||
|
|
||||||
![Interfaces ncurses](/duc.png)
|
|
||||||
|
|
||||||
Afficher l'espace disque avec un « ls like ».
|
Afficher l'espace disque avec un « ls like ».
|
||||||
|
|
||||||
~~~
|
~~~
|
||||||
|
@ -70,33 +158,9 @@ Générer un graphique :
|
||||||
# duc graph -d /backup/duc.idx -o /tmp/duc.png -l8 -s 1920 /backup/jails/
|
# duc graph -d /backup/duc.idx -o /tmp/duc.png -l8 -s 1920 /backup/jails/
|
||||||
~~~
|
~~~
|
||||||
|
|
||||||
### En CGI
|
|
||||||
|
|
||||||
Il suffit de créer ce script sh dans `/usr/lib/cgi-bin/duc.cgi`, de donner les bons droits et d'y accéder.
|
|
||||||
|
|
||||||
~~~
|
|
||||||
#!/bin/sh
|
|
||||||
/usr/bin/duc cgi -d /backup/duc.idx --list
|
|
||||||
~~~
|
|
||||||
|
|
||||||
~~~
|
|
||||||
# chmod 755 /usr/lib/cgi-bin/duc.cgi
|
|
||||||
# chown www-data: /usr/lib/cgi-bin/duc.cgi
|
|
||||||
# chmod 640 /backup/duc.idx
|
|
||||||
# chgrp www-data /backup/duc.idx
|
|
||||||
~~~
|
|
||||||
|
|
||||||
#### Apache
|
|
||||||
|
|
||||||
Apache traite les CGI par défaut dans cgi-bin, il n'y a donc rien à faire.
|
|
||||||
|
|
||||||
#### NginX
|
|
||||||
|
|
||||||
À priori impossible à part avec un wrapper CGI…
|
|
||||||
|
|
||||||
### Cron
|
### Cron
|
||||||
|
|
||||||
Cron d'indexation journalier.
|
Il peut être judicieux de créer un cron pour faire une indexation journalière, très pratique quand couplé avec l'interface CGI.
|
||||||
|
|
||||||
~~~
|
~~~
|
||||||
30 6 * * * duc index -q -d /backup/duc.idx /backup/jails && chmod 640 /backup/duc.idx && chgrp www-data /backup/duc.idx
|
30 6 * * * duc index -q -d /backup/duc.idx /backup/jails && chmod 640 /backup/duc.idx && chgrp www-data /backup/duc.idx
|
||||||
|
|
Loading…
Reference in a new issue