Installation

Version 155 (Etienne Pallier, 04/13/2017 10:20 am)

1 1 Etienne Pallier
h1. Labinvent 2.0 (cakephp3) - Installation
2 1 Etienne Pallier
3 1 Etienne Pallier
4 20 Etienne Pallier
Cette page décrit la phase d'installation du logiciel.
5 109 Etienne Pallier
La version la plus à jour est sur la page "Installation" du wiki du projet: https://projects.irap.omp.eu/projects/inventirap/wiki/Installation
6 20 Etienne Pallier
7 20 Etienne Pallier
[ [[Labinvent_nouvelle_version|Retour au sommmaire]] ]
8 20 Etienne Pallier
9 20 Etienne Pallier
10 1 Etienne Pallier
{{toc}}
11 1 Etienne Pallier
12 1 Etienne Pallier
13 1 Etienne Pallier
14 1 Etienne Pallier
---
15 1 Etienne Pallier
16 1 Etienne Pallier
h2. LIENS UTILES
17 1 Etienne Pallier
18 133 Thibaud Ajas
* HOWTO Format Redmine Wiki : http://www.redmine.org/projects/redmine/wiki/FrRedmineWikiFormatting
19 1 Etienne Pallier
20 51 Etienne Pallier
* *Fichier README* : https://gitlab.irap.omp.eu/epallier/labinvent/blob/master/README-LABINVENT.md
21 51 Etienne Pallier
22 48 Etienne Pallier
* *Version majeure en cours (2.04)*: https://projects.irap.omp.eu/projects/inventirap/roadmap#version_2.04_-_Impl%C3%A9mentation_des_ACL_(droits)
23 12 Etienne Pallier
24 50 Etienne Pallier
* Liste complète des évolutions: https://gitlab.irap.omp.eu/epallier/labinvent/commits/master
25 50 Etienne Pallier
26 12 Etienne Pallier
* Browse files (gitlab): https://gitlab.irap.omp.eu/epallier/labinvent/tree/master
27 1 Etienne Pallier
28 1 Etienne Pallier
---
29 1 Etienne Pallier
30 1 Etienne Pallier
h2. RECUPERATION
31 1 Etienne Pallier
32 1 Etienne Pallier
33 1 Etienne Pallier
34 113 Etienne Pallier
*1) Deux options*
35 113 Etienne Pallier
36 1 Etienne Pallier
Deux options se présentent à vous :
37 1 Etienne Pallier
38 113 Etienne Pallier
 * a) soit vous récupérez une version statique du logiciel, en le téléchargeant (pas besoin de login, c'est anonyme)
39 113 Etienne Pallier
 * b) soit vous récupérez une version synchronisée, avec git (nécessité d'avoir un login)
40 1 Etienne Pallier
41 113 Etienne Pallier
*a) Téléchargement anonyme (version statique, non synchronisée)*
42 1 Etienne Pallier
43 124 Thibaud Ajas
Vous pouvez télécharger la version actuelle du logiciel.
44 1 Etienne Pallier
45 124 Thibaud Ajas
Pour cela, aller sur : https://gitlab.irap.omp.eu/epallier/labinvent/tree/master
46 1 Etienne Pallier
47 124 Thibaud Ajas
Cliquez sur : "Download zip" dans le coin en haut à droite.
48 1 Etienne Pallier
49 124 Thibaud Ajas
Double-cliquez dessus ou dézippez-le (ou lancez la commande gzip -d labinvent.zip). Vous devriez avoir un dossier "labinvent.git".
50 1 Etienne Pallier
51 124 Thibaud Ajas
Dans sa documentation, le logiciel sera désigné par "LABINVENT".
52 1 Etienne Pallier
53 124 Thibaud Ajas
Vous pouvez renommer "labinvent.git" en "labinvent" si vous le souhaitez ("mv labinvent.git labinvent" ou clic droit->Renommer).
54 1 Etienne Pallier
55 113 Etienne Pallier
*b) Récupérer le logiciel via GIT (version dynamique, synchronisée, nécessité d'un login)*
56 1 Etienne Pallier
57 113 Etienne Pallier
Pour cette option, vous devez avoir un login. Si vous n'avez pas déjà un login, allez sur la page https://gitlab.irap.omp.eu/users/sign_in,
58 113 Etienne Pallier
puis remplissez la section "Sign up". Ensuite, envoyez un email à epallier AT irap. omp. eu
59 113 Etienne Pallier
en demandant l'autorisation d'accéder au gitlab du projet labinvent. On vous donnera alors la procédure à suivre pour vous connecter.
60 113 Etienne Pallier
61 126 Thibaud Ajas
(Si vous utilisez Windows, vous DEVEZ avant tout installer git pour windows, voir plus bas "Obtenir git pour windows")
62 1 Etienne Pallier
63 126 Thibaud Ajas
En récupérant directement le logiciel via git, vous allez avoir une version dynamiquement synchronisée.
64 126 Thibaud Ajas
Vous serez donc en mesure de la mettre à jour dès qu'une nouvelle version sera disponible avec la commande "git pull".
65 1 Etienne Pallier
66 126 Thibaud Ajas
* (Depuis Eclipse : Voir plus bas, section "A L'ATTENTION DES UTILISATEURS D'ECLIPSE")
67 1 Etienne Pallier
68 126 Thibaud Ajas
* Depuis un terminal:
69 1 Etienne Pallier
70 1 Etienne Pallier
<pre>
71 1 Etienne Pallier
git clone https://gitlab.irap.omp.eu/epallier/labinvent.git labinvent
72 1 Etienne Pallier
</pre>
73 1 Etienne Pallier
74 126 Thibaud Ajas
_(Ou aussi depuis ssh : git clone git@gitlab.irap.omp.eu:epallier/labinvent.git labinvent)_
75 1 Etienne Pallier
76 126 Thibaud Ajas
Si vous obtenez ce message d'erreur ... :
77 1 Etienne Pallier
<pre>
78 1 Etienne Pallier
fatal: unable to access 'https://gitlab.irap.omp.eu/epallier/labinvent.git/': Peer's certificate issuer has been marked as not trusted by the user.
79 1 Etienne Pallier
</pre>
80 1 Etienne Pallier
81 126 Thibaud Ajas
...tapez cette commande (et relancez une commade "git clone"):
82 1 Etienne Pallier
<pre>
83 1 Etienne Pallier
$ git config --global http.sslVerify false
84 127 Thibaud Ajas
</pre>
85 1 Etienne Pallier
Puis vérifiez que votre configuration soit OK :
86 128 Thibaud Ajas
<pre>
87 134 Etienne Pallier
$ git config --list
88 134 Etienne Pallier
(ou encore : cat ~/.gitconfig)
89 135 Etienne Pallier
90 1 Etienne Pallier
[user]
91 1 Etienne Pallier
	name = Etienne Pallier
92 1 Etienne Pallier
	email = epallier@irap.omp.eu
93 1 Etienne Pallier
[http]
94 1 Etienne Pallier
	sslVerify = false
95 1 Etienne Pallier
[push]
96 1 Etienne Pallier
	default = simple
97 1 Etienne Pallier
</pre>
98 1 Etienne Pallier
99 126 Thibaud Ajas
(Si vous récupérez le projet pour la première fois, git vous demandera un login et un mot de passe)
100 1 Etienne Pallier
101 136 Etienne Pallier
Git a normalement créé un dossier "labinvent" qui contiendra votre projet (avec un sous dossier ".git" qui sert à la synchronisation avec le dépot git).
102 1 Etienne Pallier
103 136 Etienne Pallier
104 136 Etienne Pallier
*Seulement pour Windows* : 
105 136 Etienne Pallier
106 136 Etienne Pallier
Obtenir git pour windows :
107 136 Etienne Pallier
108 126 Thibaud Ajas
 * Téléchargez git sur https://git-scm.com/download/win
109 126 Thibaud Ajas
 * Lancez l'installation (gardez la configuration par défaut)
110 136 Etienne Pallier
 * Une fois installé, lancer une invite de commande (Touche Windows+R, tapez cmd, touche entrer)
111 1 Etienne Pallier
<pre>
112 1 Etienne Pallier
$ git config --global http.sslVerify false
113 1 Etienne Pallier
</pre>
114 1 Etienne Pallier
Vous pouvez désormais utiliser git depuis une invite de commande ou depuis l'interface graphique de git.
115 136 Etienne Pallier
116 1 Etienne Pallier
117 53 Etienne Pallier
*2) Préparation*
118 1 Etienne Pallier
119 137 Etienne Pallier
* Si jamais votre dossier "labinvent" appartient à root (vous avez fait un "git clone" depuis root...), il serait préférable que vous en soyez vous-mêmes (ou un autre user) le propriétaire : 
120 137 Etienne Pallier
> sudo chown -R nom_utilisateur labinvent/
121 1 Etienne Pallier
122 137 Etienne Pallier
* Placer ce dossier à l'endroit voulu, 2 possibilités :
123 137 Etienne Pallier
- (1) soit vous placez ce dossier directement dans le repertoire des sites webs du serveur web (par exemple /var/www/html/ ou /var/www/html/localhost/public_html/, ...)
124 139 Etienne Pallier
- (2) soit vous le placez n'importe où ailleurs (par exemple dans votre repertoire home), et ensuite vous indiquez au serveur web où trouver ce projet, ou bien vous faites un lien depuis votre /var/www/html/ vers ce dossier labinvent/, ou encore vous créez un Virtual Host (Apache)
125 1 Etienne Pallier
126 1 Etienne Pallier
h2. INSTALLATION
127 1 Etienne Pallier
128 148 Etienne Pallier
h3. A/ Installation des PREREQUIS
129 1 Etienne Pallier
130 61 Etienne Pallier
Le logiciel nécessite une combinaison "AMP" pour fonctionner, soit les 3 pré-requis suivants :
131 62 Etienne Pallier
132 73 Etienne Pallier
* un serveur web Apache
133 73 Etienne Pallier
* un serveur de base de données Mysql
134 73 Etienne Pallier
* le langage Php en version 5.5.9 minimum (5.6 recommandé)
135 1 Etienne Pallier
136 68 Etienne Pallier
Si ce tiercé est déjà présent sur votre OS, vous pouvez passer à l'étape suivante (B/ Installation), et revenir ici seulement en cas de problème de configuration.
137 63 Etienne Pallier
138 61 Etienne Pallier
Sur Windows, vous pouvez utiliser Wampserver ou XAMPP qui regroupent ces 3 éléments (il n'y aura rien d'autre à faire ensuite).
139 61 Etienne Pallier
140 140 Etienne Pallier
Sur Mac, vous pouvez utiliser XAMPP (ou autre équivalent) ou bien installer chacun des 3 éléments séparément soit via MacPort (ou HomeBrew) soit en téléchargeant le paquet binaire Mac correspondant à chaque élément.
141 61 Etienne Pallier
142 141 Etienne Pallier
*Voici la démarche à suivre sur Linux* :
143 1 Etienne Pallier
144 75 Etienne Pallier
h4. *1) Installation des prérequis*
145 72 Etienne Pallier
146 130 Thibaud Ajas
*Exemple pour Cent OS 6.7 (fait en 2016) :*
147 35 Alexandre Cases
148 130 Thibaud Ajas
    Mettre à jour le serveur:
149 130 Thibaud Ajas
<pre>
150 1 Etienne Pallier
$ sudo yum kernel
151 1 Etienne Pallier
(restart)
152 1 Etienne Pallier
$ sudo yum update
153 130 Thibaud Ajas
</pre>
154 1 Etienne Pallier
155 130 Thibaud Ajas
    Pour installer Apache, MySQL & PHP 5.3 :
156 130 Thibaud Ajas
    --> https://www.zerostopbits.com/how-to-install-apache-mysql-and-php-on-centos-6-7/
157 35 Alexandre Cases
158 130 Thibaud Ajas
    Pour mettre à jour PHP de la 5.3 à la 5.6
159 130 Thibaud Ajas
    --> https://www.zerostopbits.com/how-to-upgrade-php-5-3-to-php-5-6-on-centos-6-7/
160 1 Etienne Pallier
161 130 Thibaud Ajas
    Mettre à jour Mysql (version 5.1 à 5.5):
162 130 Thibaud Ajas
<pre>
163 71 Etienne Pallier
$ sudo yum update
164 1 Etienne Pallier
</pre>
165 1 Etienne Pallier
166 70 Etienne Pallier
167 129 Thibaud Ajas
*Exemple pour une distribution UBuntu 14.04.4 (fait en 2016) :*
168 1 Etienne Pallier
169 1 Etienne Pallier
170 129 Thibaud Ajas
    Pour commencer il faut mettre à jour les "repository" de apt :
171 129 Thibaud Ajas
<pre>
172 1 Etienne Pallier
$ sudo apt-get update && sudo apt-get upgrade
173 129 Thibaud Ajas
</pre>
174 1 Etienne Pallier
175 129 Thibaud Ajas
    Installer un serveur web (Apache) :
176 129 Thibaud Ajas
<pre>
177 72 Etienne Pallier
$ sudo apt-get install apache2
178 129 Thibaud Ajas
</pre>
179 1 Etienne Pallier
180 129 Thibaud Ajas
    Installer un serveur de base de données (MySQL):
181 1 Etienne Pallier
<pre>
182 1 Etienne Pallier
$ sudo apt-get install mysql-server 
183 1 Etienne Pallier
</pre>
184 72 Etienne Pallier
185 129 Thibaud Ajas
    Installer le langage PHP en version 5.5.9 minimum (5.6 recommandé)
186 129 Thibaud Ajas
<pre>
187 1 Etienne Pallier
$ sudo apt-get install php5 php-pear
188 63 Etienne Pallier
$ sudo apt-get install php5-mysql
189 1 Etienne Pallier
</pre>
190 119 Etienne Pallier
191 130 Thibaud Ajas
*Exemple pour une distribution Fedora 20+ (fait en avril 2017) :*
192 114 Etienne Pallier
193 130 Thibaud Ajas
    https://www.digitalocean.com/community/tutorials/how-to-install-lamp-linux-apache-mysql-php-on-fedora
194 1 Etienne Pallier
195 130 Thibaud Ajas
    Pour commencer il faut mettre à jour l'OS :
196 129 Thibaud Ajas
<pre>
197 114 Etienne Pallier
$ sudo dnf update dnf
198 1 Etienne Pallier
$ sudo dnf update kernel
199 1 Etienne Pallier
$ sudo dnf update
200 129 Thibaud Ajas
</pre>
201 115 Etienne Pallier
202 130 Thibaud Ajas
    Installer git:
203 129 Thibaud Ajas
<pre>
204 115 Etienne Pallier
$ sudo dnf install git
205 1 Etienne Pallier
</pre>
206 115 Etienne Pallier
207 130 Thibaud Ajas
    Installer php :
208 129 Thibaud Ajas
<pre>
209 115 Etienne Pallier
$ sudo dnf install php
210 1 Etienne Pallier
$ sudo dnf install php-mysql
211 129 Thibaud Ajas
</pre>
212 115 Etienne Pallier
213 130 Thibaud Ajas
    Installer un serveur web (Apache) :
214 129 Thibaud Ajas
<pre>
215 115 Etienne Pallier
$ sudo dnf install httpd
216 116 Etienne Pallier
$ sudo systemctl enable httpd
217 116 Etienne Pallier
(ln -s '/usr/lib/systemd/system/httpd.service' '/etc/systemd/system/multi-user.target.wants/httpd.service')
218 116 Etienne Pallier
$ sudo systemctl start httpd
219 129 Thibaud Ajas
</pre>
220 1 Etienne Pallier
221 130 Thibaud Ajas
    Installer un serveur de base de données (MySQL):
222 129 Thibaud Ajas
<pre>
223 115 Etienne Pallier
$ sudo dnf install mariadb mariadb-server -y
224 116 Etienne Pallier
$ sudo systemctl enable mariadb
225 116 Etienne Pallier
(ln -s '/usr/lib/systemd/system/mariadb.service' '/etc/systemd/system/multi-user.target.wants/mariadb.service')
226 115 Etienne Pallier
$ sudo systemctl start mariadb
227 118 Etienne Pallier
$ sudo mysql_secure_installation
228 129 Thibaud Ajas
</pre>
229 118 Etienne Pallier
230 142 Etienne Pallier
    (OPTIONNEL) Installer phpmyadmin (par defaut accessible uniquement depuis localhost) :
231 129 Thibaud Ajas
<pre>
232 118 Etienne Pallier
$ sudo dnf install phpmyadmin
233 114 Etienne Pallier
$ sudo systemctl restart httpd
234 114 Etienne Pallier
</pre>
235 114 Etienne Pallier
236 75 Etienne Pallier
h4. *2) Configuration des prérequis*
237 1 Etienne Pallier
238 78 Etienne Pallier
* *(optionnel) Configuration du serveur web (Apache)*
239 76 Etienne Pallier
240 143 Etienne Pallier
Ces configurations sont nécessaires sur Ubuntu, mais pas forcément sur CentOS/Fedora :
241 143 Etienne Pallier
242 1 Etienne Pallier
 * KeepAlive:
243 143 Etienne Pallier
Editer le fichier de configuration du serveur web (/etc/apache2/apache2.conf sur Ubuntu, /etc/httpd/conf/http.conf sur CentOS/Fedora) et mettre le paramêtre "KeepAlive" à "Off" :
244 63 Etienne Pallier
<pre>
245 63 Etienne Pallier
KeepAlive Off
246 63 Etienne Pallier
</pre>
247 63 Etienne Pallier
248 79 Etienne Pallier
 * event et prefork modules:
249 64 Etienne Pallier
Par défaut Apache utilise un "event module" et PHP un "prefork module".
250 63 Etienne Pallier
Il faut désactiver le 1er module et activer le second :
251 63 Etienne Pallier
<pre>
252 63 Etienne Pallier
sudo a2dismod mpm_event
253 63 Etienne Pallier
sudo a2enmod mpm_prefork
254 1 Etienne Pallier
</pre>
255 64 Etienne Pallier
256 86 Etienne Pallier
 * Activer le mode rewrite de Apache:
257 86 Etienne Pallier
<pre>
258 86 Etienne Pallier
sudo a2enmod rewrite
259 86 Etienne Pallier
</pre>
260 86 Etienne Pallier
261 153 Etienne Pallier
 * Autoriser les fichiers .htaccess sur le site :
262 153 Etienne Pallier
(cf http://book.cakephp.org/3.0/fr/installation.html#url-rewriting)
263 153 Etienne Pallier
Allez dans le fichier /etc/apache2/apache2.conf (ou httpd.conf sur CentOS), vérifier que la propriété 'AllowOverride' soit à la valeur 'All' pour le dossier Labinvent : 
264 153 Etienne Pallier
<pre>
265 153 Etienne Pallier
<Directory /var/www/html/labinvent>
266 153 Etienne Pallier
  Options FollowSymLinks
267 153 Etienne Pallier
  AllowOverride All
268 153 Etienne Pallier
</Directory>
269 154 Etienne Pallier
</pre>
270 153 Etienne Pallier
NB : Si Labinvent n'est pas dans le repertoire des sites webs :
271 153 Etienne Pallier
- faire un lien dans le dossier web racine de Apache (/var/www/html/) vers le repertoire d'installation de Labinvent
272 153 Etienne Pallier
- vous pouvez aussi tenter de mettre son chemin absolu :
273 154 Etienne Pallier
<pre>
274 153 Etienne Pallier
<Directory /chemin/abosolu/vers/labinvent>
275 154 Etienne Pallier
</pre>
276 153 Etienne Pallier
NB: Une autre solution plus "propre" consisterait à créer un virtual host dédié pour Labinvent, sur un port 808x (8081, 8082, ...)
277 153 Etienne Pallier
(TODO: mettre ici un exemple de config)
278 153 Etienne Pallier
279 153 Etienne Pallier
 * Redémarrer Apache 
280 153 Etienne Pallier
281 64 Etienne Pallier
282 30 Alexandre Cases
* *Configuration de Php*
283 1 Etienne Pallier
284 145 Etienne Pallier
 * *Extension PHP "intl"*:
285 145 Etienne Pallier
Vérifier qu'elle est activée dans le php.ini:
286 1 Etienne Pallier
<pre>
287 80 Etienne Pallier
php --ini|grep intl
288 80 Etienne Pallier
Sinon, l'ajouter dans le php.ini:
289 1 Etienne Pallier
extension=intl.so
290 144 Etienne Pallier
</pre>
291 1 Etienne Pallier
Vérifier qu'elle est bien installée :
292 1 Etienne Pallier
<pre>
293 1 Etienne Pallier
$ php -m| grep intl
294 1 Etienne Pallier
(ça devrait retourner "intl")
295 76 Etienne Pallier
Sinon, l'installer
296 1 Etienne Pallier
Ubuntu:
297 76 Etienne Pallier
$ sudo apt-get install php5-intl
298 76 Etienne Pallier
CentOS:
299 76 Etienne Pallier
$ sudo yum install php-intl
300 76 Etienne Pallier
MacOS avec XAMPP: 
301 1 Etienne Pallier
cf http://stackoverflow.com/questions/27886117/php-intl-installation-on-xampp
302 1 Etienne Pallier
Il se pourrait que vous ayez besoin de ré-exécuter l'installeur de XAMPP afin de cocher l'option "XAMPP Developer Files", si vous ne l'aviez pas déjà fait lors de votre installation de XAMPP
303 1 Etienne Pallier
cd /Applications/XAMPP/bin
304 1 Etienne Pallier
sudo ./pecl install intl
305 1 Etienne Pallier
(Vérifier qu'elle a bien été installée dans /Applications/XAMPP/xamppfiles/lib/php/extensions/no-debug-non-zts-20131226/)
306 1 Etienne Pallier
</pre>
307 1 Etienne Pallier
308 146 Etienne Pallier
 * *Dossier de log (optionnel)*:
309 146 Etienne Pallier
Dans le fichier /etc/php5/apache2/php.ini (ou /etc/php.ini sur CentOS), vous devez positionner votre répertoire de log :
310 76 Etienne Pallier
<pre>
311 76 Etienne Pallier
error_reporting = E_ALL
312 76 Etienne Pallier
error_log = /var/log/php/error.log
313 76 Etienne Pallier
max_input_time = 30
314 76 Etienne Pallier
</pre>
315 146 Etienne Pallier
Ensuite il vous faudra peut-être créer le dossier en question et donner à Apache les droits sur ce dossier (www-data pour Ubuntu, apache pour CentOS...):
316 76 Etienne Pallier
<pre>
317 76 Etienne Pallier
sudo mkdir /var/log/php
318 76 Etienne Pallier
sudo chown www-data /var/log/php
319 76 Etienne Pallier
</pre>
320 1 Etienne Pallier
321 147 Etienne Pallier
 * *Recharger la configuration du serveur Web*
322 83 Etienne Pallier
<pre>
323 82 Etienne Pallier
$ sudo service httpd reload
324 146 Etienne Pallier
(CentOS: $ sudo systemctl reload httpd)
325 83 Etienne Pallier
</pre>
326 82 Etienne Pallier
327 149 Etienne Pallier
h3. B/ Installation du logiciel LabInvent
328 1 Etienne Pallier
329 150 Etienne Pallier
<pre>
330 26 Etienne Pallier
cd install/
331 26 Etienne Pallier
./installation.sh
332 150 Etienne Pallier
</pre>
333 150 Etienne Pallier
334 1 Etienne Pallier
(vous pourriez éventuellement le faire en tant qu'administrateur "root", mais ça n'est pas nécessaire, le script fera quelques petits "sudo" seulement au besoin).
335 1 Etienne Pallier
(Conseil : à la plupart des questions, laissez les réponses par défaut)
336 23 Etienne Pallier
337 96 Etienne Pallier
---
338 96 Etienne Pallier
339 85 Etienne Pallier
h3. C/ CONFIGURATION DU SITE WEB
340 1 Etienne Pallier
341 121 Thibaud Ajas
Le site est maintenant installé, il vous faut maintenant le configurer.
342 121 Thibaud Ajas
Si vous voulez le conserver, le script de creation de la BD est database/build.sql.
343 151 Etienne Pallier
Votre fichier de configuration app.php (s'il existait) a été écrasé, mais il a été sauvegardé dans app.php.ORIG.
344 121 Thibaud Ajas
345 87 Etienne Pallier
* Tester l'accès web à l'application : http://localhost/labinvent/
346 98 Etienne Pallier
Vous devriez arriver par défaut sur une page correspondant au mode install, elle vous indique la bonne configuration de l'application et de ses dépendances.
347 1 Etienne Pallier
Vérifier simplement (point vert) si votre base de données est bien reliée à votre application, si les droits donnés aux dossiers temporaires sont suffisants, et si toutes les extensions sont bien intallées...
348 98 Etienne Pallier
(La page affichera un message si l'URL-Rewriting ne fonctionne pas correctement).
349 98 Etienne Pallier
Si tout est au vert, passez à l'étape suivante (D/ Configuration de l'application).
350 90 Etienne Pallier
S'il y a des points rouges, reportez-vous ci-dessous à l'extension qui pose problème, pour l'installer ou la configurer:
351 1 Etienne Pallier
352 89 Etienne Pallier
* Extension PHP "mbstring" et librairie "zlib"
353 90 Etienne Pallier
La collection de librairies est normalement déja installée avec PHP en tant que dépendance, sinon faire :
354 90 Etienne Pallier
<pre>
355 90 Etienne Pallier
sudo apt-get install libapache2-mod-php5
356 90 Etienne Pallier
</pre>
357 90 Etienne Pallier
=> Redémarrer votre serveur et vérifier que la ligne correspondant à l'extension soit passée au vert.
358 6 Alexandre Cases
359 6 Alexandre Cases
* Librairie PHP "php-gd" 
360 90 Etienne Pallier
<pre>
361 90 Etienne Pallier
sudo apt-get install php5-gd
362 90 Etienne Pallier
</pre>
363 90 Etienne Pallier
=> Redémarrer votre serveur et vérifier que la ligne correspondant à l'extension soit passée au vert.
364 1 Etienne Pallier
Si ce n'est toujours pas le cas, aller dans le fichier /etc/php5/apache2/php.ini :
365 1 Etienne Pallier
Vérifier que la ligne suivante est présente et décommentée (absence de ";" devant la ligne) sinon il faut la rajouter : 
366 6 Alexandre Cases
<pre>
367 6 Alexandre Cases
extension=gd.so
368 6 Alexandre Cases
</pre>
369 1 Etienne Pallier
370 90 Etienne Pallier
* (Optionnel) Il est aussi conseillé d'avoir un "phpmyadmin" installé pour pouvoir gérer manuellement la base de données.
371 90 Etienne Pallier
<pre>
372 90 Etienne Pallier
sudo apt-get php5-mcrypt
373 90 Etienne Pallier
sudo apt-get install phpmyadmin
374 90 Etienne Pallier
Pensez à activer l'extension mcrypt : sudo php5enmod mcrypt
375 90 Etienne Pallier
</pre>
376 1 Etienne Pallier
377 90 Etienne Pallier
* Redémarrer votre serveur Web et vérifier que la ligne correspondant à l'extension soit passée au vert.
378 90 Etienne Pallier
<pre>
379 90 Etienne Pallier
sudo service apache2 restart
380 1 Etienne Pallier
(ou simplement le recharger: utiliser "reload" au lieu de "restart")
381 90 Etienne Pallier
</pre>
382 1 Etienne Pallier
383 1 Etienne Pallier
* URL-Rewriting
384 1 Etienne Pallier
Il est possible que le mode rewrite ne fonctionne pas correctement si les fichiers .htaccess dans la racine et dans webroot disparaissent. Sur certains systèmes les fichiers commençant par un point peuvent disparaitre lors d'une copie. Si c'est le cas pour vous, voici le contenu de ces deux fichiers et leurs emplacements : 
385 1 Etienne Pallier
<pre>
386 7 Alexandre Cases
Fichier ./.htaccess : 
387 1 Etienne Pallier
<IfModule mod_rewrite.c>
388 1 Etienne Pallier
    RewriteEngine on
389 1 Etienne Pallier
    RewriteRule    ^$    webroot/    [L]
390 1 Etienne Pallier
    RewriteRule    (.*) webroot/$1    [L]
391 1 Etienne Pallier
</IfModule>
392 27 Etienne Pallier
393 29 Etienne Pallier
Fichier ./webroot/.htaccess : 
394 27 Etienne Pallier
<IfModule mod_rewrite.c>
395 1 Etienne Pallier
    RewriteEngine On
396 1 Etienne Pallier
    RewriteCond %{REQUEST_FILENAME} !-f
397 27 Etienne Pallier
    RewriteRule ^ index.php [L]
398 27 Etienne Pallier
</IfModule>
399 32 Etienne Pallier
</pre>
400 94 Etienne Pallier
401 1 Etienne Pallier
402 95 Etienne Pallier
---
403 95 Etienne Pallier
404 97 Etienne Pallier
h3. D/ CONFIGURATION DU LOGICIEL D'INVENTAIRE
405 94 Etienne Pallier
406 99 Etienne Pallier
* Depuis la page web de configuration "Configurer votre Labinvent", cliquez sur le lien "Editer la configuration générale" (en bas à gauche) pour configurer le logiciel, puis cliquez sur "Valider".
407 34 Alexandre Cases
408 99 Etienne Pallier
* Maintenant, sortez du "mode installation" en cliquant sur le bouton "Stopper le mode installation"
409 1 Etienne Pallier
410 99 Etienne Pallier
* Allez dans le dossier config à la racine du projet, et ouvrez le fichier config/app.php
411 34 Alexandre Cases
<pre>
412 11 Alexandre Cases
Allez à la ligne 12 :
413 11 Alexandre Cases
'debug' => filter_var(env('DEBUG', true), FILTER_VALIDATE_BOOLEAN),
414 1 Etienne Pallier
415 11 Alexandre Cases
Et remplacer le true par false :
416 11 Alexandre Cases
'debug' => filter_var(env('DEBUG', false), FILTER_VALIDATE_BOOLEAN),
417 11 Alexandre Cases
</pre>
418 1 Etienne Pallier
419 104 Etienne Pallier
* Connectez-vous à l'aide du login utilisateur créé lors de la création de la base, SANS mot de passe
420 28 Etienne Pallier
421 99 Etienne Pallier
* Si vous n'avez pas configuré l'application avec le mode install
422 14 Alexandre Cases
Dans le menu latéral, cliquez sur le lien "Outils", puis sur "Configuration générale de l'application".
423 99 Etienne Pallier
Sur cette page vous pouvez voir la configuration de votre application (nom, mode, ...) et l'éditer.
424 14 Alexandre Cases
425 99 Etienne Pallier
* Ensuite retournez dans la liste des outils et cliquez sur "Gérer le contenu variable de l'application".
426 21 Alexandre Cases
427 99 Etienne Pallier
* Sur cette page vous aurez accès à toutes les données statiques communes aux matériels (catégories, groupes métier et techniques, types de suivi, ...). Vous pouvez en ajouter, en supprimer ou les éditer..
428 94 Etienne Pallier
429 1 Etienne Pallier
430 95 Etienne Pallier
---
431 94 Etienne Pallier
432 94 Etienne Pallier
h3. E/ TESTS
433 94 Etienne Pallier
434 123 Thibaud Ajas
* Verifiez que la BD d'inventaire ($bddName) à bien été créée (avec phpmyadmin par exemple).
435 1 Etienne Pallier
436 123 Thibaud Ajas
* Verifiez que les tests passent, placez vous à la racine du projet, exécutez la commande 'vendor/bin/phpunit'. Si la commande ne fonctionne pas, essayez 'vendor/phpunit/phpunit/phpunit'.
437 94 Etienne Pallier
438 123 Thibaud Ajas
* Allez sur l'application, vous devriez arriver par défaut sur un mode install vous donnant des informations sur la configuration de votre application, vérifiez que tous les points sont bien validés (verts), sinon rajoutez les extensions manquantes.
439 122 Thibaud Ajas
440 132 Thibaud Ajas
* Testez l'accès à l'application par le web. Le compte que le script vous à demandé de créé n'a pas de mot de passe par défaut. Les autres comptes que le script aura créé auront tous le même mot de passe par défaut : login .
441 47 Etienne Pallier
442 101 Etienne Pallier
h3. F/ Gestion de l'authentification des utilisateurs via un annuaire LDAP
443 43 Etienne Pallier
444 100 Etienne Pallier
Labinvent peut être utilisé avec un LDAP. Si vous utilisez ce mode, ceci vous concerne :
445 37 Etienne Pallier
446 100 Etienne Pallier
* Une fois la connexion au LDAP configurée (configuration générale de l'application), toute personne enregistrée dans l'annuaire LDAP peut désormais se connecter au logiciel.
447 44 Etienne Pallier
448 100 Etienne Pallier
* Par défaut, un utilisateur provenant du LDAP a un statut de simple "utilisateur". Pour lui attribuer un rôle supérieur (privilégié), il faut aller dans "Gérer les utilisateurs privilégiés" du menu "Outils" pour l'y ajouter (liste déroulante des utilisateurs du LDAP), en lui attribuant un rôle.
449 44 Etienne Pallier
450 37 Etienne Pallier
---
451 43 Etienne Pallier
452 110 Etienne Pallier
h2. Utilisation du logiciel
453 110 Etienne Pallier
454 111 Etienne Pallier
Voir la page wiki "Utilisation" [[Documentation_utilisateurs]]
455 110 Etienne Pallier
456 112 Etienne Pallier
---
457 112 Etienne Pallier
458 1 Etienne Pallier
h2. MISE A JOUR du logiciel 
459 43 Etienne Pallier
460 1 Etienne Pallier
1) Mettre à jour le code
461 45 Etienne Pallier
462 43 Etienne Pallier
Aller sur la racine du projet et exécuter :
463 1 Etienne Pallier
464 43 Etienne Pallier
<pre>
465 1 Etienne Pallier
$ git pull
466 57 Alexandre Cases
</pre>
467 57 Alexandre Cases
468 56 Alexandre Cases
2) [Seulement si nécessaire] Mettre à jour la base de données
469 44 Etienne Pallier
470 56 Alexandre Cases
Aller dans le dossier database/update/
471 44 Etienne Pallier
472 56 Alexandre Cases
*Exécuter tous les scripts qui sont d'une date postérieure à la date de votre version du logiciel* (sur la page d'accueil en bas à droite).
473 1 Etienne Pallier
Attention, il faut les exécuter *dans l'ordre chronologique*, un par un
474 1 Etienne Pallier
475 44 Etienne Pallier
Exemple:
476 54 Etienne Pallier
<pre>
477 57 Alexandre Cases
Placez vous dans ./database/update et éxécutez les commandes correspondantes : 
478 58 Alexandre Cases
479 57 Alexandre Cases
./db-update-2016-06-03.sh
480 57 Alexandre Cases
481 57 Alexandre Cases
./db-update-2016-06-06.sh
482 57 Alexandre Cases
483 57 Alexandre Cases
./db-update-2016-06-07.sh
484 57 Alexandre Cases
</pre>
485 54 Etienne Pallier
486 43 Etienne Pallier
487 56 Alexandre Cases
488 41 Etienne Pallier
Remarques : 
489 103 Etienne Pallier
* Le fichier README-LABINVENT.md contient la liste des mises à jour.
490 55 Etienne Pallier
491 1 Etienne Pallier
---
492 55 Etienne Pallier
493 55 Etienne Pallier
h2. MODE PANIQUE
494 55 Etienne Pallier
495 55 Etienne Pallier
Vous avez changé la configuration du LDAP et elle ne fonctionne plus !
496 55 Etienne Pallier
Du coup, vous ne pouvez plus vous connecter au site !
497 106 Etienne Pallier
Pas de panique, le mode panique est là !
498 106 Etienne Pallier
Il suffit de repasser le logiciel en mode INSTALL pour pouvoir y accéder sans connexion.
499 105 Etienne Pallier
Pour cela, exécuter le script mode_panique.sh qui se trouve dans le dossier database/ :
500 1 Etienne Pallier
501 1 Etienne Pallier
<pre>
502 105 Etienne Pallier
./mode_panique.sh
503 1 Etienne Pallier
</pre>
504 1 Etienne Pallier
505 107 Etienne Pallier
(
506 108 Etienne Pallier
_Si vous préférez, vous pouvez aussi exécuter manuellement la requête sql set_mode_install.sql qui se trouve dans le même dossier:_
507 105 Etienne Pallier
mysql -u login -p labinvent2 < set_mode_install.sql
508 1 Etienne Pallier
_Remplacer 'login' par le 'username' défini dans votre fichier config/app.php dans la section Datasources (default)_
509 1 Etienne Pallier
_Remplacer 'labinvent2' par le 'database' défini au même endroit_
510 107 Etienne Pallier
_Ou bien exécuter cette requête depuis phpmyadmin_
511 105 Etienne Pallier
)