Installation

Version 7 (Alexandre Cases, 05/06/2016 02:14 pm)

1 1 Etienne Pallier
h1. Labinvent 2.0 (cakephp3) - Installation
2 1 Etienne Pallier
3 1 Etienne Pallier
4 1 Etienne Pallier
{{toc}}
5 1 Etienne Pallier
6 1 Etienne Pallier
7 1 Etienne Pallier
8 1 Etienne Pallier
---
9 1 Etienne Pallier
10 1 Etienne Pallier
h2. LIENS UTILES
11 1 Etienne Pallier
12 1 Etienne Pallier
Activité sur le projet (gitlab): https://gitlab.irap.omp.eu/epallier/labinvent
13 1 Etienne Pallier
14 1 Etienne Pallier
Browse files (gitlab): https://gitlab.irap.omp.eu/epallier/labinvent/tree/master
15 1 Etienne Pallier
16 1 Etienne Pallier
---
17 1 Etienne Pallier
18 1 Etienne Pallier
h2. RECUPERATION
19 1 Etienne Pallier
20 1 Etienne Pallier
1) Authenticate to https://gitlab.irap.omp.eu/epallier/labinvent
21 1 Etienne Pallier
22 1 Etienne Pallier
In order to get this software, you must first authenticate on the IRAP gitlab.
23 1 Etienne Pallier
24 1 Etienne Pallier
For this, just go to https://gitlab.irap.omp.eu/epallier/labinvent
25 1 Etienne Pallier
and either sign in with your LDAP account (if you are from IRAP),
26 1 Etienne Pallier
or register via the "Sign up" form (then, confirm your registration by answering an email sent by gitlab,
27 1 Etienne Pallier
and wait for the "SI" to authorize your registration)
28 1 Etienne Pallier
29 1 Etienne Pallier
If you want, you can browse the code online (from gitlab) :
30 1 Etienne Pallier
31 1 Etienne Pallier
https://gitlab.irap.omp.eu/epallier/labinvent/tree/master
32 1 Etienne Pallier
33 1 Etienne Pallier
2) Récupérer le logiciel
34 1 Etienne Pallier
35 1 Etienne Pallier
Deux options se présentent à vous :
36 1 Etienne Pallier
37 1 Etienne Pallier
 * a) soit vous récupérez une version statique du logiciel, en le téléchargeant
38 1 Etienne Pallier
 * b) soit vous récupérez une version synchronisée, avec git
39 1 Etienne Pallier
40 1 Etienne Pallier
a) Download it (static version, not synchronized)...
41 1 Etienne Pallier
42 1 Etienne Pallier
You can download the current version of the software.
43 1 Etienne Pallier
44 1 Etienne Pallier
Go to https://gitlab.irap.omp.eu/epallier/labinvent/tree/master
45 1 Etienne Pallier
46 1 Etienne Pallier
Click on "Download zip" on the up right hand corner.
47 1 Etienne Pallier
48 1 Etienne Pallier
Double-click on it to unzip it (or run "gzip -d labinvent.zip")
49 1 Etienne Pallier
50 1 Etienne Pallier
You should get a "labinvent.git" folder.
51 1 Etienne Pallier
52 1 Etienne Pallier
In this documentation, this software folder will be referenced as "LABINVENT".
53 1 Etienne Pallier
54 1 Etienne Pallier
(you can rename "labinvent.git" as "labinvent" if you want : "mv labinvent.git labinvent")
55 1 Etienne Pallier
56 1 Etienne Pallier
b) ... or Get it from GIT (dynamic version, synchronized)
57 1 Etienne Pallier
58 1 Etienne Pallier
(If you are using Windows, you must first get the git software, see below "Get git for Windows")
59 1 Etienne Pallier
60 1 Etienne Pallier
By getting the software from git, you will get a dynamically synchronized version,
61 1 Etienne Pallier
which means that you will be able to update your version as soon as a new version is available
62 1 Etienne Pallier
(with the command : "git pull").
63 1 Etienne Pallier
64 1 Etienne Pallier
* From Eclipse : See below, section "NOTES FOR ECLIPSE USERS"
65 1 Etienne Pallier
66 1 Etienne Pallier
* From the terminal
67 1 Etienne Pallier
68 1 Etienne Pallier
<pre>
69 1 Etienne Pallier
git clone https://gitlab.irap.omp.eu/epallier/labinvent.git labinvent
70 1 Etienne Pallier
</pre>
71 1 Etienne Pallier
72 1 Etienne Pallier
_(or also : git clone git@gitlab.irap.omp.eu:epallier/labinvent.git labinvent)_
73 1 Etienne Pallier
74 1 Etienne Pallier
If you ever get this error message... :
75 1 Etienne Pallier
<pre>
76 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.
77 1 Etienne Pallier
</pre>
78 1 Etienne Pallier
79 1 Etienne Pallier
...then, type this command (and then run again the "git clone" command):
80 1 Etienne Pallier
<pre>
81 1 Etienne Pallier
$ git config --global http.sslVerify false
82 1 Etienne Pallier
83 1 Etienne Pallier
Then check that your config is ok:
84 1 Etienne Pallier
85 1 Etienne Pallier
$ cat ~/.gitconfig 
86 1 Etienne Pallier
[user]
87 1 Etienne Pallier
	name = Etienne Pallier
88 1 Etienne Pallier
	email = epallier@irap.omp.eu
89 1 Etienne Pallier
[http]
90 1 Etienne Pallier
	sslVerify = false
91 1 Etienne Pallier
[push]
92 1 Etienne Pallier
	default = simple
93 1 Etienne Pallier
</pre>
94 1 Etienne Pallier
95 1 Etienne Pallier
96 1 Etienne Pallier
(Also, the first time you get the project, git will ask you for a login and password)
97 1 Etienne Pallier
98 1 Etienne Pallier
This creates a labinvent/ folder containing the project (with a .git/ subfolder for synchronization with the git repository)
99 1 Etienne Pallier
100 1 Etienne Pallier
101 1 Etienne Pallier
(Windows only) : Get git for Windows:
102 1 Etienne Pallier
103 1 Etienne Pallier
 * Download git at https://git-scm.com/download/win
104 1 Etienne Pallier
 * Run setup (keep default configurations)
105 1 Etienne Pallier
 * Once installed, open cmd
106 1 Etienne Pallier
<pre>
107 1 Etienne Pallier
$ git config --global http.sslVerify false
108 1 Etienne Pallier
</pre>
109 1 Etienne Pallier
You can now use your git from the cmd or the graphic client !
110 1 Etienne Pallier
111 1 Etienne Pallier
112 1 Etienne Pallier
3) Préparation
113 1 Etienne Pallier
114 1 Etienne Pallier
* Vérifier que vous etes le propriétaire du dossier (il ne doit pas appartenir à "root"), sinon faire : 
115 1 Etienne Pallier
> sudo chown -R nom_utilisateur LABINVENT
116 1 Etienne Pallier
117 1 Etienne Pallier
* Placer cette archive à l'endroit voulu, 2 possibilités :
118 1 Etienne Pallier
- (1) soit vous placez cette archive directement dans le repertoire des sites webs du serveur web (par exemple /var/www/html/localhost/public_html/)
119 1 Etienne Pallier
- (2) soit vous la placez n'importe où ailleurs (par exemple dans votre repertoire home), et ensuite vous indiquerez au serveur web où trouver ce projet
120 1 Etienne Pallier
121 1 Etienne Pallier
h2. INSTALLATION
122 1 Etienne Pallier
123 1 Etienne Pallier
h3. A/ PREREQUIS
124 1 Etienne Pallier
125 1 Etienne Pallier
(L'exemple est donné ici pour une distribution linux UBuntu 14.04.4)
126 1 Etienne Pallier
127 1 Etienne Pallier
* Pour commencer il faut mettre à jour les "repository" de apt : 
128 1 Etienne Pallier
> sudo apt-get update && sudo apt-get upgrade
129 1 Etienne Pallier
130 1 Etienne Pallier
* Un serveur web (apache avec le mod_rewrite actif)
131 1 Etienne Pallier
> sudo apt-get install apache2
132 1 Etienne Pallier
133 1 Etienne Pallier
> Editer le fichier /etc/apache2/apache2.conf et mettre le paramêtre "KeepAlive" à "Off" :
134 1 Etienne Pallier
<pre>
135 1 Etienne Pallier
KeepAlive Off
136 1 Etienne Pallier
</pre>
137 1 Etienne Pallier
=> (pas nécessaire sur Mac OS avec Xampp)
138 1 Etienne Pallier
139 1 Etienne Pallier
> Par défaut Apache utilise un "event module" et PHP un "prefork module".
140 1 Etienne Pallier
> Il faut désactiver le 1er module et activer le second :
141 1 Etienne Pallier
> > sudo a2dismod mpm_event
142 1 Etienne Pallier
> > sudo a2enmod mpm_prefork
143 1 Etienne Pallier
=> (pas nécessaire sur Mac OS avec Xampp)
144 1 Etienne Pallier
145 1 Etienne Pallier
* Un serveur de base de données (MySQL)
146 1 Etienne Pallier
> sudo apt-get install mysql-server 
147 1 Etienne Pallier
148 1 Etienne Pallier
* PHP 5.5.9 ou plus 
149 1 Etienne Pallier
> sudo apt-get install php5 php-pear
150 1 Etienne Pallier
> sudo apt-get install php5-mysql
151 1 Etienne Pallier
152 1 Etienne Pallier
> Dans le fichier /etc/php5/apache2/php.ini, vous devez positionner votre répertoire de log :
153 1 Etienne Pallier
<pre>
154 1 Etienne Pallier
error_reporting = E_ALL
155 1 Etienne Pallier
error_log = /var/log/php/error.log
156 1 Etienne Pallier
max_input_time = 30
157 1 Etienne Pallier
</pre>
158 1 Etienne Pallier
159 1 Etienne Pallier
> Ensuite il faut créer le dossier en question et donner à apache (ici www-data) les droits sur ce dossier :
160 1 Etienne Pallier
> > sudo mkdir /var/log/php
161 1 Etienne Pallier
> > sudo chown www-data /var/log/php
162 1 Etienne Pallier
=> (pas nécessaire sur Mac OS avec Xampp)
163 1 Etienne Pallier
164 1 Etienne Pallier
h3. B/ INSTALLATION
165 1 Etienne Pallier
166 1 Etienne Pallier
Nous vous préconisons d'installer le logiciel en mode "SANS LDAP", et d'activer le mode "AVEC LDAP" par la suite, si vous en avez besoin.
167 1 Etienne Pallier
168 1 Etienne Pallier
169 1 Etienne Pallier
* Aller dans le repertoire d'installation :
170 1 Etienne Pallier
cd LABINVENT/install/
171 1 Etienne Pallier
172 1 Etienne Pallier
173 1 Etienne Pallier
* Exécuter le script d'installation :
174 1 Etienne Pallier
./installation.sh
175 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).
176 1 Etienne Pallier
(Conseil : à la plupart des questions, laissez les réponses par défaut)
177 1 Etienne Pallier
(Comme expliqué au début, faites une installation en mode "sans LDAP")
178 1 Etienne Pallier
179 1 Etienne Pallier
180 1 Etienne Pallier
* Autoriser les fichiers .htaccess sur le site :
181 1 Etienne Pallier
(cf http://book.cakephp.org/3.0/fr/installation.html#url-rewriting)
182 1 Etienne Pallier
183 7 Alexandre Cases
Allez dans le fichier /etc/apache2/apache2.conf, vérifier que la propriété 'AllowOverride' soit à la valeur 'All' pour le chemin correspondant à votre application (dossier '/' si '/var/www' non présent) :
184 1 Etienne Pallier
<pre>
185 1 Etienne Pallier
<Directory />
186 1 Etienne Pallier
  Options FollowSymLinks
187 1 Etienne Pallier
  AllowOverride All
188 1 Etienne Pallier
  Order deny,allow
189 1 Etienne Pallier
  Deny from all
190 1 Etienne Pallier
  </Directory>
191 1 Etienne Pallier
</pre>
192 1 Etienne Pallier
193 7 Alexandre Cases
Sinon, vous pouvez ajouter ceci, uniquement pour Labinvent, les attributs seront à cette valeur uniquement pour le dossier labinvent et son contenu :
194 1 Etienne Pallier
<pre>
195 1 Etienne Pallier
<Directory /labinvent>
196 1 Etienne Pallier
  Options FollowSymLinks
197 1 Etienne Pallier
  AllowOverride All
198 1 Etienne Pallier
</Directory>
199 1 Etienne Pallier
</pre>
200 1 Etienne Pallier
201 1 Etienne Pallier
NB : si labinvent n'est pas dans le repertoire des sites webs, il faut mettre son chemin absolu a la place de /labinvent :
202 1 Etienne Pallier
> <Directory /chemin/abosolu/vers/labinvent>
203 1 Etienne Pallier
204 1 Etienne Pallier
* Activer le mode rewrite de Apache :
205 1 Etienne Pallier
> sudo a2enmod rewrite
206 1 Etienne Pallier
207 1 Etienne Pallier
* Redémarrer Apache 
208 1 Etienne Pallier
209 1 Etienne Pallier
* Tester l'accès web à l'application : http://localhost/labinvent.git/
210 1 Etienne Pallier
211 1 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
212 6 Alexandre Cases
213 6 Alexandre Cases
* Vérifier simplement (point vert) si votre base sql est bien relié à votre application, si les droits données au dossiers temporaires sont suffisant, et si toutes les extensions sont bien intallées.
214 7 Alexandre Cases
(La page affichera un message si l'URL-Rewriting ne fonctionne pas correctement)
215 6 Alexandre Cases
216 6 Alexandre Cases
* Dans le cas contraire, reporter vous à l'extension correspondant ci-dessous, pour l'installer ou la configurer :
217 6 Alexandre Cases
218 6 Alexandre Cases
* Extension PHP "mbstring" et librairie "zlib"
219 6 Alexandre Cases
La collection de librairies est normalement déja installée avec PHP en tant que dépendances, sinon faire :
220 6 Alexandre Cases
> sudo apt-get install libapache2-mod-php5
221 6 Alexandre Cases
=> Redémarrer votre serveur et vérifier que la ligne correspondant à l'extension soit passé au vert.
222 6 Alexandre Cases
223 6 Alexandre Cases
* Extension PHP "intl"
224 6 Alexandre Cases
Vérifier que cette extension est activée dans le php.ini:
225 6 Alexandre Cases
<pre>
226 6 Alexandre Cases
extension=intl.so
227 6 Alexandre Cases
</pre>
228 6 Alexandre Cases
229 6 Alexandre Cases
Vérifier qu'elle est bien installée :
230 6 Alexandre Cases
<pre>
231 6 Alexandre Cases
$ php -m| grep intl
232 6 Alexandre Cases
(ça devrait retourner "intl")
233 6 Alexandre Cases
</pre>
234 6 Alexandre Cases
235 6 Alexandre Cases
Sinon, l'installer
236 6 Alexandre Cases
> sudo apt-get install php5-intl
237 6 Alexandre Cases
238 6 Alexandre Cases
(Sur MacOS avec XAMPP: cf http://stackoverflow.com/questions/27886117/php-intl-installation-on-xampp)
239 6 Alexandre Cases
(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)
240 6 Alexandre Cases
<pre>
241 6 Alexandre Cases
cd /Applications/XAMPP/bin
242 6 Alexandre Cases
sudo ./pecl install intl
243 6 Alexandre Cases
</pre>
244 6 Alexandre Cases
(Vérifier qu'elle a bien été installée dans /Applications/XAMPP/xamppfiles/lib/php/extensions/no-debug-non-zts-20131226/)
245 6 Alexandre Cases
246 6 Alexandre Cases
=> Redémarrer votre serveur et vérifier que la ligne correspondant à l'extension soit passé au vert.
247 6 Alexandre Cases
248 6 Alexandre Cases
249 6 Alexandre Cases
* Librairie PHP "php-gd" 
250 6 Alexandre Cases
>  sudo apt-get install php5-gd
251 6 Alexandre Cases
=> Redémarrer votre serveur et vérifier que la ligne correspondant à l'extension soit passé au vert.
252 6 Alexandre Cases
Si ce n'est toujours pas le cas, aller dans le fichier /etc/php5/apache2/php.ini :
253 6 Alexandre Cases
Vérifier que la ligne suivante est présente et décommentée (absence de ";" devant la ligne) sinon il faut la rajouter : 
254 6 Alexandre Cases
<pre>
255 6 Alexandre Cases
extension=gd.so
256 6 Alexandre Cases
</pre>
257 6 Alexandre Cases
=> Redémarrer votre serveur et vérifier que la ligne correspondant à l'extension soit passé au vert.
258 6 Alexandre Cases
259 6 Alexandre Cases
260 6 Alexandre Cases
* Il est aussi conseillé d'avoir un "phpmyadmin" installé pour pouvoir gérer manuellement la base de données.
261 6 Alexandre Cases
> sudo apt-get php5-mcrypt
262 6 Alexandre Cases
> sudo apt-get install phpmyadmin
263 6 Alexandre Cases
> Pensez à activer l'extension mcrypt : sudo php5enmod mcrypt
264 6 Alexandre Cases
> Vous devez maintenant redémarrer Apache :
265 6 Alexandre Cases
> > sudo service apache2 restart
266 1 Etienne Pallier
(ou simplement le recharger: utiliser "reload" au lieu de "restart")
267 1 Etienne Pallier
268 1 Etienne Pallier
269 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 : 
270 1 Etienne Pallier
271 7 Alexandre Cases
<pre>
272 1 Etienne Pallier
Fichier ./.htaccess : 
273 7 Alexandre Cases
274 1 Etienne Pallier
<IfModule mod_rewrite.c>
275 1 Etienne Pallier
    RewriteEngine on
276 1 Etienne Pallier
    RewriteRule    ^$    webroot/    [L]
277 1 Etienne Pallier
    RewriteRule    (.*) webroot/$1    [L]
278 1 Etienne Pallier
</IfModule>
279 1 Etienne Pallier
</pre>
280 1 Etienne Pallier
281 1 Etienne Pallier
<pre>
282 1 Etienne Pallier
Fichier ./webroot/.htaccess : 
283 7 Alexandre Cases
284 1 Etienne Pallier
<IfModule mod_rewrite.c>
285 1 Etienne Pallier
    RewriteEngine On
286 1 Etienne Pallier
    RewriteCond %{REQUEST_FILENAME} !-f
287 1 Etienne Pallier
    RewriteRule ^ index.php [L]
288 1 Etienne Pallier
</IfModule>
289 1 Etienne Pallier
</pre>
290 1 Etienne Pallier
291 1 Etienne Pallier
292 1 Etienne Pallier
> Remarques :
293 1 Etienne Pallier
> > Dans CakePHP3 un serveur de développement est disponible, il faut se placer à la racine du projet faire la commande "bin/cake server".
294 1 Etienne Pallier
> > L'application devrait être accessible à l'adresse suivante par défaut : http://localhost:8765/