Projet

Général

Profil

Info-tech » Historique » Version 27

Gérald Schwartzmann, 13/12/2013 14:18

1 1 Lionel Morin
h1. Informations techniques
2 1 Lionel Morin
3 1 Lionel Morin
h2. Installation
4 1 Lionel Morin
5 1 Lionel Morin
Installation habituelle avec : 
6 1 Lionel Morin
<pre>
7 26 Lionel Morin
apt-eole install eole-eop
8 1 Lionel Morin
reconfigure
9 1 Lionel Morin
</pre>
10 1 Lionel Morin
Tous les paquets supplémentaires sont tirés lors du reconfigure.
11 20 Lionel Morin
Mettre aussi à jour controle-vnc (paquets controle-vnc-server et eole-controle-vnc) et eole-web.
12 1 Lionel Morin
13 7 Lionel Morin
L'application est accessible sur l'url : http://[votre-scribe]/eop/documents.
14 1 Lionel Morin
15 1 Lionel Morin
h2. Vérifications en cas de problème
16 1 Lionel Morin
17 16 Lionel Morin
EOP est une application "flask":http://flask.pocoo.org/ servie par "gunicorn":http://gunicorn.org/, dialoguant avec controle-vnc grâce à une clé secrète et gérée par apache en reverse-proxy (attachment:eop.pdf).
18 1 Lionel Morin
19 21 Lionel Morin
h3. Service eoleflask (conteneur web)
20 2 Lionel Morin
21 11 Lionel Morin
* Vérifier les logs dans "/var/log/eoleflask/gunicorn-error.log" et "/var/log/eoleflask/gunicorn-access.log"
22 4 Lionel Morin
* S'il y a une erreur "NoApplicationError: No application loaded" alors vérifier la présence d'un lien symbolique dans "/etc/eole/flask/enabled/" pointant vers le fichier "/etc/eole/flask/available/eop.conf"
23 14 Lionel Morin
* S'il y a une erreur "CookieError: Invalid Attribute envole.user", c'est un problème connu (#5356), mettre à jour eole-posh pour le résoudre (ou supprimer le cookie $envole.user)
24 1 Lionel Morin
* Relancer le service :
25 1 Lionel Morin
<pre>
26 1 Lionel Morin
service eoleflask restart
27 1 Lionel Morin
</pre>
28 3 Lionel Morin
29 22 Lionel Morin
h3. Service controle-vnc (conteneur fichier)
30 3 Lionel Morin
31 27 Gérald Schwartzmann
* Contrôler les logs dans "/var/log/controle-vnc/main.log"
32 4 Lionel Morin
* Vérifier que le service est bien à l'écoute sur le port 8788 :
33 3 Lionel Morin
<pre>
34 3 Lionel Morin
netstat -ndtal | grep 8788
35 1 Lionel Morin
</pre>
36 25 Lionel Morin
* Et que le port 8788 n'est pas bloqué par le firewall (seulement pour le mode conteneur) :
37 8 Lionel Morin
<pre>
38 8 Lionel Morin
iptables -L | grep 8788
39 8 Lionel Morin
</pre>
40 3 Lionel Morin
* S'assurer de la correspondance de la clé secrète contenue dans "/etc/controlevnc/.secret" et la variable SECRET_KEY du fichier "/etc/eole/flask/available/eop.conf"
41 5 Lionel Morin
42 23 Lionel Morin
h3. Service apache (conteneur web)
43 5 Lionel Morin
44 5 Lionel Morin
* Vérifier que les modules apache pour le reverse proxy sont bien activés :
45 5 Lionel Morin
<pre>
46 5 Lionel Morin
a2enmod proxy proxy_http
47 5 Lionel Morin
service apache stop
48 5 Lionel Morin
service apache start
49 5 Lionel Morin
</pre>
50 10 Lionel Morin
* Tester EOP sans passer par le reverse proxy (de l'extérieur par tunnel ssh) : 
51 5 Lionel Morin
<pre>
52 15 Lionel Morin
ssh -L 9999:127.0.0.1:5000 root@[IP du scribe]
53 5 Lionel Morin
</pre>
54 15 Lionel Morin
Puis entrer dans un navigateur l'url : http://localhost:9999/documents.
55 13 Lionel Morin
56 24 Lionel Morin
h3. EOP (conteneur web)
57 13 Lionel Morin
58 13 Lionel Morin
Les logs de l'application EOP sont accessibles dans le fichier "/var/log/eoleflask/eop.log".