Ce serveur Gitlab sera éteint le 30 juin 2020, pensez à migrer vos projets vers les serveurs gitlab-research.centralesupelec.fr et gitlab-student.centralesupelec.fr !

README.md 2.06 KB
Newer Older
chirac's avatar
chirac committed
1
# Re2o
chirac's avatar
chirac committed
2

chirac's avatar
chirac committed
3 4
Gnu public license v2.0

chirac's avatar
chirac committed
5
## Avant propos 
chirac's avatar
chirac committed
6 7 8 9 10 11

Re2o est un logiciel d'administration développé initiallement au rezometz. Il se veut agnostique au réseau considéré, de manière à être installable en quelques clics.

Il utilise le framework django avec python3. Il permet de gérer les adhérents, les machines, les factures, les droits d'accès, les switchs et la topologie du réseau.
De cette manière, il est possible de pluguer très facilement des services dessus, qui accèdent à la base de donnée en passant par django (ex : dhcp), en chargeant la liste de toutes les mac-ip, ou la liste des mac-ip autorisées sur le réseau (adhérent à jour de cotisation).

chirac's avatar
chirac committed
12
## Installation
chirac's avatar
chirac committed
13 14 15

Dépendances :

root's avatar
root committed
16
Avec apt (recommandé):
chirac's avatar
chirac committed
17 18 19
 * python3-django (1.8, jessie-backports)
 * python3-django-macaddress (stretch)
 * python3-dateutil (jessie-backports)
root's avatar
root committed
20 21 22
 * texlive-latex-base (jessie)
 * texlive-fonts-recommended (jessie)
 * python3-djangorestframework (stretch)
chirac's avatar
chirac committed
23
 * python3-django-reversion (stretch)
root's avatar
root committed
24 25 26 27

Avec pip3:
 * django-bootstrap3 (pip install)
 * django-ldapdb
chirac's avatar
chirac committed
28 29 30 31

Moteur de db conseillé (mysql), postgresql fonctionne également.
Pour mysql, il faut installer :

chirac's avatar
chirac committed
32 33
 * python3-mysqldb (jessie-backports)

chirac's avatar
chirac committed
34 35 36 37
Sur le serveur mysql :
 * mysql-server (jessie)


chirac's avatar
chirac committed
38
## Configuration 
chirac's avatar
chirac committed
39 40 41 42 43

Le site est prêt a fonctionner, il faut simplement créer la base de donnée (par défaut re2o), et régler les variables présentes dans setting_local.py
Un fichier d'exemple est disponible.
Ensuite, effectuer les migrations. Un squelette de base de donnée, via un mysqldump peut être fourni.

chirac's avatar
chirac committed
44
## Mise en production avec apache
chirac's avatar
chirac committed
45 46

re2o/wsgi.py permet de fonctionner avec apache2 en production
47 48 49 50 51

## Fonctionnement avec les services

Pour charger les objets django, il suffit de faire User.objects.all() pour tous les users par exemple. 
Cependant, pour que les services fonctionnent de manière simple, des fonctions toutes prètes existent deja pour charger la liste des users autorisés à se connecter ( has_access(user)), etc. Ces fonctions sont personnalisables, et permettent un fonctionnement très simple des services.