Wiki

Version 59 (Etienne Pallier, 04/15/2016 05:59 pm)

1 1 Etienne Pallier
h1. INVENTIRAP WIKI
2 1 Etienne Pallier
3 16 Etienne Pallier
{{toc}}
4 13 Etienne Pallier
5 26 Etienne Pallier
6 35 Etienne Pallier
7 26 Etienne Pallier
8 36 Etienne Pallier
---
9 26 Etienne Pallier
10 54 Etienne Pallier
h2. TODOLIST
11 54 Etienne Pallier
12 55 Etienne Pallier
 * Mettre à jour fichier config (supprimer ce qui est BDD)
13 54 Etienne Pallier
14 55 Etienne Pallier
 * Doublon de la table documents et fichiers : laquelle garder (rename table ?)
15 54 Etienne Pallier
16 56 Etienne Pallier
 * Mieux gérer le debug=2 dans cakephp3 pour éviter pb de cache (update structure BDD)
17 56 Etienne Pallier
18 57 Etienne Pallier
 * Rendre Envoi de mail possible en local (et pas seulement sur serveur prod)
19 57 Etienne Pallier
20 58 Etienne Pallier
 * Update script sql de création de la BDD complète (bugué) et update script install.sh
21 58 Etienne Pallier
22 36 Etienne Pallier
h2. ROADMAP
23 1 Etienne Pallier
24 38 Etienne Pallier
Version en cours (1.3) : https://projects.irap.omp.eu/projects/inventirap/roadmap#version_1.3
25 37 Etienne Pallier
26 36 Etienne Pallier
Carte routière du projet : https://projects.irap.omp.eu/projects/inventirap/roadmap
27 36 Etienne Pallier
28 47 Etienne Pallier
Plan de travail: [[plan of work]]
29 47 Etienne Pallier
30 59 Etienne Pallier
Labinvent nouvelle version (en cours): [[labinvent nouvelle version]]
31 59 Etienne Pallier
32 39 Etienne Pallier
---
33 39 Etienne Pallier
34 44 Etienne Pallier
h2. RECUPERATION DU LOGICIEL
35 39 Etienne Pallier
36 39 Etienne Pallier
h3. Authenticate to https://gitlab.irap.omp.eu/epallier/labinvent
37 39 Etienne Pallier
38 39 Etienne Pallier
In order to get this software, you must first authenticate on the IRAP gitlab.
39 39 Etienne Pallier
40 39 Etienne Pallier
For this, just go to https://gitlab.irap.omp.eu/epallier/labinvent
41 39 Etienne Pallier
and either sign in with your LDAP account (if you are from IRAP),
42 41 Etienne Pallier
or register via the "Sign up" form (then, confirm your registration by answering an email sent by gitlab,
43 41 Etienne Pallier
and wait for the "SI" to authorize your registration)
44 39 Etienne Pallier
45 39 Etienne Pallier
h3. Browse the code (from gitlab)
46 39 Etienne Pallier
47 39 Etienne Pallier
https://gitlab.irap.omp.eu/epallier/labinvent/tree/master
48 39 Etienne Pallier
49 39 Etienne Pallier
h3. Download it (static version, not synchronized)
50 39 Etienne Pallier
51 39 Etienne Pallier
You can download the current version of the software.
52 39 Etienne Pallier
53 39 Etienne Pallier
Go to https://gitlab.irap.omp.eu/epallier/labinvent/tree/master
54 39 Etienne Pallier
55 39 Etienne Pallier
Click on "Download zip" on the up right hand corner.
56 39 Etienne Pallier
57 39 Etienne Pallier
Double-click on it to unzip it.
58 39 Etienne Pallier
59 39 Etienne Pallier
You should get a "labinvent.git" folder.
60 39 Etienne Pallier
61 39 Etienne Pallier
In this documentation, this software folder will be referenced as "labinvent".
62 39 Etienne Pallier
63 39 Etienne Pallier
(you can rename "labinvent.git" as "labinvent" if you want : "mv labinvent.git labinvent")
64 39 Etienne Pallier
65 39 Etienne Pallier
h3. Get it from GIT (dynamic version, synchronized)
66 39 Etienne Pallier
67 39 Etienne Pallier
(If you are using Windows, you must first get the git software, see below "Get git for Windows")
68 39 Etienne Pallier
69 39 Etienne Pallier
By getting the software from git, you will get a dynamically synchronized version,
70 39 Etienne Pallier
which means that you will be able to update your version as soon as a new version is available
71 39 Etienne Pallier
(with the command : "git pull").
72 39 Etienne Pallier
73 39 Etienne Pallier
* From Eclipse : See below, section "NOTES FOR ECLIPSE USERS"
74 39 Etienne Pallier
75 39 Etienne Pallier
* From the terminal
76 39 Etienne Pallier
77 39 Etienne Pallier
<pre>
78 39 Etienne Pallier
git clone https://gitlab.irap.omp.eu/epallier/labinvent.git labinvent
79 39 Etienne Pallier
</pre>
80 39 Etienne Pallier
81 39 Etienne Pallier
_(or also : git clone git@gitlab.irap.omp.eu:epallier/labinvent.git labinvent)_
82 39 Etienne Pallier
83 45 Etienne Pallier
If you ever get this error message... :
84 39 Etienne Pallier
<pre>
85 39 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.
86 39 Etienne Pallier
</pre>
87 39 Etienne Pallier
88 45 Etienne Pallier
...then, type this command (and then run again the "git clone" command):
89 39 Etienne Pallier
<pre>
90 39 Etienne Pallier
$ git config --global http.sslVerify false
91 39 Etienne Pallier
92 39 Etienne Pallier
Then check that your config is ok:
93 39 Etienne Pallier
94 39 Etienne Pallier
$ cat ~/.gitconfig 
95 39 Etienne Pallier
[user]
96 39 Etienne Pallier
	name = Etienne Pallier
97 39 Etienne Pallier
	email = epallier@irap.omp.eu
98 39 Etienne Pallier
[http]
99 39 Etienne Pallier
	sslVerify = false
100 39 Etienne Pallier
[push]
101 39 Etienne Pallier
	default = simple
102 39 Etienne Pallier
</pre>
103 39 Etienne Pallier
104 39 Etienne Pallier
105 39 Etienne Pallier
(Also, the first time you get the project, git will ask you for a login and password)
106 39 Etienne Pallier
107 39 Etienne Pallier
This creates a labinvent/ folder containing the project (with a .git/ subfolder for synchronization with the git repository)
108 39 Etienne Pallier
109 39 Etienne Pallier
110 39 Etienne Pallier
h4. (Windows only) : Get git for Windows
111 39 Etienne Pallier
112 39 Etienne Pallier
 * Download git at https://git-scm.com/download/win
113 39 Etienne Pallier
 * Run setup (keep default configurations)
114 39 Etienne Pallier
 * Once installed, open cmd
115 39 Etienne Pallier
<pre>
116 39 Etienne Pallier
$ git config --global http.sslVerify false
117 39 Etienne Pallier
</pre>
118 39 Etienne Pallier
119 39 Etienne Pallier
You can now use your git from the cmd or the graphic client !
120 36 Etienne Pallier
121 36 Etienne Pallier
---
122 36 Etienne Pallier
123 36 Etienne Pallier
h2. INSTALLATION DU LOGICIEL (HOWTO)
124 18 Etienne Pallier
125 18 Etienne Pallier
126 12 Etienne Pallier
(Pour les developpeurs avec Eclipse, voir aussi le document install/manual_install/INSTALLATION_MANUELLE_mode_expert.txt)
127 12 Etienne Pallier
(Une fois l'installation terminee, les developpeurs devraient aussi lire le document docs/HOWTO.txt) 
128 12 Etienne Pallier
129 19 Etienne Pallier
LabInvent est un logiciel multi-plateformes (Linux, Mac OS X, Windows), il nécessite les services suivants :
130 12 Etienne Pallier
- serveur web (Apache)
131 12 Etienne Pallier
- serveur de base de données (Mysql)
132 12 Etienne Pallier
- interpréteur Php 5.3+ (minimum)
133 12 Etienne Pallier
134 12 Etienne Pallier
Il est aussi conseillé d'avoir un "phpmyadmin" installé pour pouvoir gérer manuellement la base de données
135 12 Etienne Pallier
136 12 Etienne Pallier
Il a été testé avec les configurations suivantes :
137 12 Etienne Pallier
- OS : CentOS 6.2 et 6.6, Mac OS 10.7, Windows 7
138 12 Etienne Pallier
- PHP : 5.3, 5.4, et 5.6
139 12 Etienne Pallier
- Mysql : 5.1, 5.6
140 12 Etienne Pallier
- Apache : 2.2.14, 2.2.15, et 2.4.10
141 12 Etienne Pallier
142 12 Etienne Pallier
Le projet occupe un espace d'environ 190 Mo (environ 370 Mo si versionné avec svn).
143 12 Etienne Pallier
144 12 Etienne Pallier
ATTENTION, pré-requis : 
145 12 Etienne Pallier
1) Apache rewrite activé 
146 12 Etienne Pallier
Le module rewrite d'apache doit etre chargé et actif. 
147 12 Etienne Pallier
Pour verifier le chargement, phpinfo affiche la liste des modules d'apache pris en compte. 
148 12 Etienne Pallier
2) Le projet necessite la librairie gd (utilisee par php), sans quoi vous aurez une erreur (fatale) 
149 12 Etienne Pallier
lors de la visualisation de la fiche d'un materiel (qui contient l'image d'un QRCode). 
150 12 Etienne Pallier
(Pour info, c'est la librairie phpqrcode, dans cakephp/app/Vendor, qui génère le QRCode et donc utilise gd, par exemple pour appeler des fonctions telles que ImageCreate...)
151 1 Etienne Pallier
Il faut donc vérifier que gd et php-gd sont installés :
152 31 Etienne Pallier
- gd => on l'installe avec "yum install gd" sur CentOS
153 12 Etienne Pallier
- php-gd doit etre installé avec la bonne version, c'est à dire celle du php que vous utilisez 
154 31 Etienne Pallier
(par exemple, si php 5.4, installer php-gd version 5.4) => on l'installe avec "yum install php-gd" sur CentOS 
155 12 Etienne Pallier
(Pour info, la librairie phpqrcode necessite aussi la librairie zlib qui offre les fonctions gzcompress, gzuncompress, etc.)
156 12 Etienne Pallier
157 21 Etienne Pallier
158 1 Etienne Pallier
-----------------
159 1 Etienne Pallier
160 23 Etienne Pallier
h3. INSTALLATION
161 21 Etienne Pallier
162 21 Etienne Pallier
-----------------
163 12 Etienne Pallier
164 12 Etienne Pallier
Pour une MISE A JOUR du logiciel, aller directement à la fin de ce document, a la section MISE A JOUR (UPGRADE)
165 12 Etienne Pallier
166 52 Etienne Pallier
A/ PRELIMINAIRES
167 52 Etienne Pallier
168 12 Etienne Pallier
Il y a deux façons de l'installer :
169 12 Etienne Pallier
- Pour une installation manuelle (mode expert) allez dans le sous-repertoire manual_install et lisez le document INSTALLATION_MANUELLE_mode_expert.txt
170 12 Etienne Pallier
- Sinon (méthode conseillée), si vous voulez une installation complètement assistée (avec questions/réponses), poursuivez la lecture de ce document.
171 12 Etienne Pallier
(NB : l'ancien script d'installation fourni à l'origine par Upsilon s'appelle install-upsillon.sh, il n'est plus a jour)
172 12 Etienne Pallier
173 12 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.
174 12 Etienne Pallier
175 12 Etienne Pallier
Pour cela, suivez les instructions ci-dessous.
176 12 Etienne Pallier
177 12 Etienne Pallier
Si ce n'est pas déjà fait, récuperer l'archive labinvent.tgz
178 12 Etienne Pallier
179 12 Etienne Pallier
Placer cette archive à l'endroit voulu, 2 possibilités :
180 28 Etienne Pallier
- (1) soit vous placez cette archive directement dans le repertoire des sites webs du serveur web (par exemple /var/www/html/)
181 28 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
182 12 Etienne Pallier
183 12 Etienne Pallier
Dézipper l'archive :
184 30 Etienne Pallier
	tar xvfz labinvent.tgz
185 1 Etienne Pallier
	=> cela crée un dossier labinvent_1-3-xxx/
186 52 Etienne Pallier
187 52 Etienne Pallier
188 52 Etienne Pallier
B/ INSTALLATION
189 52 Etienne Pallier
190 12 Etienne Pallier
Aller dans le repertoire d'installation :
191 12 Etienne Pallier
	cd labinvent/install/
192 12 Etienne Pallier
193 12 Etienne Pallier
Exécuter le script d'installation :
194 12 Etienne Pallier
	./installation.sh
195 12 Etienne Pallier
(vous pouvez le faire en tant qu'administrateur "root", mais ça n'est pas nécessaire, le script fera quelques petits "sudo" seulement quand nécessaire).
196 12 Etienne Pallier
(Conseil : à la plupart des questions, laissez les réponses par défaut)
197 12 Etienne Pallier
(Comme expliqué au début, faites une installation en mode "sans LDAP")
198 12 Etienne Pallier
199 12 Etienne Pallier
200 12 Etienne Pallier
Autoriser les fichiers .htaccess sur le site :
201 12 Etienne Pallier
(cf http://book.cakephp.org/2.0/fr/installation/url-rewriting.html)
202 12 Etienne Pallier
Dans le fichier httpd.conf de Apache, si vous avez deja quelquechose comme ceci, cela suffit :
203 12 Etienne Pallier
<Directory />
204 12 Etienne Pallier
    Options FollowSymLinks
205 12 Etienne Pallier
    AllowOverride All
206 12 Etienne Pallier
#    Order deny,allow
207 12 Etienne Pallier
#    Deny from all
208 12 Etienne Pallier
</Directory>
209 12 Etienne Pallier
Sinon, vous pouvez ajouter ceci, uniquement pour Labinvent :
210 12 Etienne Pallier
<Directory /labinvent>
211 12 Etienne Pallier
    Options FollowSymLinks
212 12 Etienne Pallier
    AllowOverride All
213 12 Etienne Pallier
</Directory>
214 12 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 :
215 12 Etienne Pallier
<Directory /chemin/abosolu/vers/labinvent>
216 12 Etienne Pallier
217 1 Etienne Pallier
218 1 Etienne Pallier
Tester l'accès web à l'application :
219 1 Etienne Pallier
- (1) Si vous avez placé le logiciel directement dans le repertoire des sites webs du serveur web :
220 31 Etienne Pallier
	=> tester l'url http://localhost/labinvent/cakephp
221 12 Etienne Pallier
- (2) Si vous avez placé le logiciel dans un autre repertoire, par exemple /home/votre_nom/ :
222 12 Etienne Pallier
	Faites un lien nommé "labinvent" dans le repertoire des sites webs du serveur web (par exemple /var/www/html/), qui pointe vers le repertoire "cakephp" du logiciel :
223 31 Etienne Pallier
	=> cd /var/www/html/
224 31 Etienne Pallier
	=> ln -s /home/votre_nom/labinvent/cakephp/ labinvent
225 31 Etienne Pallier
	=> puis, tester l'url http://localhost/labinvent/
226 12 Etienne Pallier
	(Si vous ne voulez ou ne pouvez pas utiliser un lien, vous pouvez plutôt créer un Virtual Host, voir tout à la fin de ce doc, la section "VIRTUAL HOST") 
227 12 Etienne Pallier
228 12 Etienne Pallier
Tester le bon fonctionnement de l'application :
229 12 Etienne Pallier
- Connectez-vous au logiciel (normalement, vous etes le super administrateur) avec votre login (ldap), SANS MOT DE PASSE (grâce au mode "SANS ldap")
230 12 Etienne Pallier
- Vous etes maintenant sur la page d'accueil générale ; vous devez voir votre nom s'afficher :
231 12 Etienne Pallier
"Vous êtes connecté en tant que <vos nom et prénom> et avec le niveau d'authentification Super Administrateur"
232 12 Etienne Pallier
- Cliquez un peu partout pour voir si tout s'affiche bien sans erreur (par exemple, "Liste des matériels" doit afficher 0 matériel...)
233 12 Etienne Pallier
- Cliquez sur Outils, puis "Gérer les utilisateurs privilégiés" : vous devriez voir un seul utilisateur dans la liste, le "super administrateur" (a priori vous)
234 12 Etienne Pallier
- Déconnectez-vous du logiciel 
235 12 Etienne Pallier
236 12 Etienne Pallier
Voila, felicitations, votre installation fonctionne !
237 12 Etienne Pallier
238 12 Etienne Pallier
Pensez à personnaliser les 2 fichiers logos suivants dans cakephp/app/webroot/img/ :
239 12 Etienne Pallier
	- logo_entity.jpg : le logo du laboratoire
240 22 Etienne Pallier
	- logo_software.jpg : le logo du logiciel
241 1 Etienne Pallier
242 1 Etienne Pallier
-----------------
243 23 Etienne Pallier
244 1 Etienne Pallier
h3. PASSAGE EN MODE "AVEC LDAP" (facultatif) :
245 22 Etienne Pallier
246 22 Etienne Pallier
-----------------
247 12 Etienne Pallier
248 12 Etienne Pallier
Maintenant, si vous le désirez, vous pouvez ajouter la connexion au LDAP :
249 12 Etienne Pallier
- soit en refaisant une nouvelle installation complète, qui incluera cette fois-ci une connexion au LDAP, 
250 12 Etienne Pallier
	mais il faudra répondre à nouveau à toutes les questions
251 12 Etienne Pallier
- soit (méthode conseillée) directement à la main dans votre fichier de configuration comme ceci :
252 12 Etienne Pallier
	Editer votre fichier de configuration cakephp/app/Config/labinvent.php, chercher la section ci-dessous, 
253 12 Etienne Pallier
	et remplacer chacune des valeurs par celles concernant votre LDAP.
254 12 Etienne Pallier
	Attention, il faut bien mettre USE_LDAP à la valeur TRUE :
255 12 Etienne Pallier
	 
256 12 Etienne Pallier
	'USE_LDAP' => TRUE,
257 12 Etienne Pallier
	'ldap' => array (
258 12 Etienne Pallier
		'host'		 			=> 'ldap-servername-or-ip',
259 12 Etienne Pallier
		'port'					=> '389',
260 12 Etienne Pallier
		'authenticationType'	=> 'cn',
261 12 Etienne Pallier
		'baseDn'				=> 'ou=users,dc=irap,dc=omp,dc=eu',
262 12 Etienne Pallier
		'filter'				=> '(cn=*)'
263 12 Etienne Pallier
	),
264 12 Etienne Pallier
265 12 Etienne Pallier
Pour tester que votre connexion LDAP fonctionne bien,
266 12 Etienne Pallier
connectez-vous au logiciel d'inventaire avec votre login ldap, et cette fois-ci AVEC votre mot de passe LDAP 
267 12 Etienne Pallier
(normalement, vous ne devriez plus pouvoir vous connecter sans mot de passe)
268 12 Etienne Pallier
Voila, vous devriez maintenant etre connecte sur le logiciel avec votre login ldap et avec le profil "super administrateur" 
269 12 Etienne Pallier
270 1 Etienne Pallier
La base de donnees est actuellement vide. Vous pouvez donc commencer à alimenter le logiciel avec quelques données.
271 12 Etienne Pallier
Pour cela, poursuivez votre lecture.
272 12 Etienne Pallier
273 12 Etienne Pallier
-----------------
274 12 Etienne Pallier
275 12 Etienne Pallier
h3. PARAMETRAGE DU LOGICIEL (PERSONNALISATION)
276 1 Etienne Pallier
277 1 Etienne Pallier
-----------------
278 1 Etienne Pallier
279 26 Etienne Pallier
Vous devez maintenant personnaliser le logiciel à partir des données concernant votre entité (laboratoire).
280 26 Etienne Pallier
Pour cela, éditer le fichier de configuration cakephp/app/Config/labinvent.php et adapter la valeur des paramètres
281 12 Etienne Pallier
contenus dans le tableau "localisation".
282 26 Etienne Pallier
283 26 Etienne Pallier
		'localisation' => array(
284 26 Etienne Pallier
				
285 26 Etienne Pallier
			// Nom de l'entité (laboratoire) :			
286 12 Etienne Pallier
			//'labName' => "IRAP",
287 1 Etienne Pallier
			'labName' => "LABONAME",
288 26 Etienne Pallier
			
289 26 Etienne Pallier
			...
290 26 Etienne Pallier
		
291 22 Etienne Pallier
		), // $localisation
292 1 Etienne Pallier
293 23 Etienne Pallier
294 22 Etienne Pallier
-----------------
295 22 Etienne Pallier
296 22 Etienne Pallier
h3. ALIMENTATION DE LA BASE DE DONNEES
297 12 Etienne Pallier
298 12 Etienne Pallier
-----------------
299 12 Etienne Pallier
300 12 Etienne Pallier
En ce qui concerne le rôle quotidien des personnes de l'administration sur ce logiciel, voir le document Inventirap_AdministrationUser_Manual.docx dans le dossier docs/
301 12 Etienne Pallier
En ce qui concerne les possibilites offertes à tout utilisateur (non privilegie) de ce logiciel, voir le document Inventirap_User_Manual.docx dans le dossier docs/
302 12 Etienne Pallier
303 12 Etienne Pallier
Ici, nous allons plutot expliquer comment commencer a alimenter la base de donnees du logiciel (a priori vide) avec un minimum de donnees 
304 12 Etienne Pallier
afin de rendre possible la saisie de l'inventaire materiel. En effet, pour pouvoir saisir des materiels dans l'inventaire, 
305 12 Etienne Pallier
il vous faut au prealable :
306 12 Etienne Pallier
307 12 Etienne Pallier
1) definir quelques utilisateurs PRIVILEGIES (comme vous, mais avec des profils moins forts comme "administrateur", "responsable"...)
308 12 Etienne Pallier
qui seront habilites a faire cette saisie (notamment le personnel administratif) ; attention,
309 1 Etienne Pallier
tout utilisateur (du LDAP) non privilegie peut entrer un nouveau materiel dans l'inventaire, mais seul le personnel administratif 
310 12 Etienne Pallier
pourra ensuite faire la saisie des informations administratives et valider la fiche materiel...
311 12 Etienne Pallier
312 1 Etienne Pallier
2) definir quelques domaines et categories (et éventuellement des sous-categories si vous en avez besoin), qui permettront de classer le materiel
313 12 Etienne Pallier
314 12 Etienne Pallier
3) (FACULTATIF) definir des groupes metiers (auquels on pourra associer les utilisateurs mais aussi les materiels) et groupes thematiques (associés aux materiels)
315 12 Etienne Pallier
316 31 Etienne Pallier
=> Pour ces 3 premiers points, lire le document Inventirap_AdministrationUser_Manual.docx (dans le dossier docs/) au chapitre 2 "Les outils"
317 1 Etienne Pallier
318 1 Etienne Pallier
On pourra ensuite enfin commencer la saisie des materiels
319 1 Etienne Pallier
320 31 Etienne Pallier
=> Sur ce point, lire le document Inventirap_User_Manual.docx (dans le dossier docs/) au chapitre 3, en particulier 3.2 "Saisie de materiel"
321 22 Etienne Pallier
322 12 Etienne Pallier
323 23 Etienne Pallier
324 22 Etienne Pallier
-----------------
325 22 Etienne Pallier
326 1 Etienne Pallier
h3. LOGS (facultatif)
327 1 Etienne Pallier
328 1 Etienne Pallier
-----------------
329 1 Etienne Pallier
330 12 Etienne Pallier
Un fichier de log est créé et alimenté par l'application.
331 22 Etienne Pallier
Il s'agit de cakephp/app/tmp/logs/labinvent.log
332 12 Etienne Pallier
333 23 Etienne Pallier
334 22 Etienne Pallier
-----------------
335 22 Etienne Pallier
336 22 Etienne Pallier
h3. INSTALLATION DES ETIQUETEUSES (facultatif)
337 12 Etienne Pallier
338 12 Etienne Pallier
-----------------
339 12 Etienne Pallier
340 12 Etienne Pallier
Si vous désirez imprimer des étiquettes (ruban) à coller sur les materiels inventoriés,
341 12 Etienne Pallier
il vous faut installer une ou plusieurs étiqueteuses (au moins une) sur les postes clients.
342 12 Etienne Pallier
343 12 Etienne Pallier
Voici la procédure à suivre pour installer une étiqueteuse sur un poste client :
344 12 Etienne Pallier
345 12 Etienne Pallier
1) Acheter la bonne imprimante (!) 
346 12 Etienne Pallier
L'imprimante configurée est une "DYMO LabelManager PnP USB"
347 12 Etienne Pallier
Pour avoir plus d'informations sur cette étiqueteuse, aller sur la page Outils puis cliquer sur "Voir les étiqueteuses installées"
348 12 Etienne Pallier
349 12 Etienne Pallier
2) Installer cette imprimante sur le poste client
350 12 Etienne Pallier
Attention, il faut bien faire l'installation dans cette ordre sinon ça ne marche pas :
351 12 Etienne Pallier
a) Mettre la batterie dans l'imprimante
352 12 Etienne Pallier
b) Connecter l'imprimante sur un port USB du poste client, l'imprimante s'installe normalement toute seule,
353 12 Etienne Pallier
et représente un nouvel espace disque sur le bureau (sur Windows, elle occupe une lettre de lecteur disque monté, style "G:")
354 12 Etienne Pallier
C'est normal car ce disque contient un mini logiciel qui permet d'utiliser très simplement cette imprimante.
355 12 Etienne Pallier
Mais ce n'est pas ce logiciel que nous allons utiliser, donc surtout ne l'installez pas. 
356 12 Etienne Pallier
357 12 Etienne Pallier
3) Télécharger et installer le logiciel DLS (Dymo Label Software) associé à cette imprimante
358 12 Etienne Pallier
Pour cela aller dans la section "LOGICIEL DLS (DYMO LABEL SOFTWARE) A INSTALLER", et cliquer sur le lien "Téléchargement logiciel"
359 12 Etienne Pallier
Selon que c'est un poste Mac ou Windows, cliquer sur le bon lien "DOWNLOAD"
360 12 Etienne Pallier
Installer ce logiciel
361 12 Etienne Pallier
362 12 Etienne Pallier
4) Imprimer une étiquette 
363 12 Etienne Pallier
Allumer l'imprimante (si ce n'est déjà fait)
364 12 Etienne Pallier
Depuis ce poste client, aller sur le logiciel Labinvent (via un navigateur comme Firefox par exemple),
365 12 Etienne Pallier
cliquez sur "Liste des matériels", cliquez sur un matériel quelconque, et cliquez sur le bouton "Impr. ruban"
366 12 Etienne Pallier
Les 5 étapes suivantes ne sont à faire qu'une seule fois pour toutes : 
367 12 Etienne Pallier
- Une boîte de dialogue s'ouvre pour vous demander quel logiciel il faut ouvrir.
368 12 Etienne Pallier
- Cliquez sur le bouton "Choisir..." (à droite du texte "Ouvrir avec")
369 1 Etienne Pallier
- Choisir l'application DLS (Dymo Label Software)
370 1 Etienne Pallier
- Cocher l'option "Toujours effectuer cette opération avec ce type de fichier"
371 1 Etienne Pallier
- Cliquer sur OK
372 12 Etienne Pallier
Le logiciel DLS s'ouvre avec l'étiquette prête à être imprimée.
373 12 Etienne Pallier
Cliquer sur le bouton "Imprimer"
374 12 Etienne Pallier
375 22 Etienne Pallier
376 12 Etienne Pallier
377 23 Etienne Pallier
378 12 Etienne Pallier
-----------------
379 22 Etienne Pallier
380 22 Etienne Pallier
h3. AUTORISATIONS (ACL) : REGLAGE DES DROITS ASSOCIES A CHAQUE PROFIL
381 12 Etienne Pallier
382 12 Etienne Pallier
-----------------
383 12 Etienne Pallier
384 12 Etienne Pallier
TODO: expliquer comment ajouter, modifer, ou supprimer un profil 
385 12 Etienne Pallier
386 12 Etienne Pallier
Cette application définit 5 profils de pouvoir croissant :
387 12 Etienne Pallier
- USER : le profil par défaut de tout utilisateur)
388 12 Etienne Pallier
- RESPONSABLE : le responsable d'un ou plusieurs matériels 
389 12 Etienne Pallier
- ADMIN : le service administratif (gestion)
390 12 Etienne Pallier
- ADMINPLUS : le responsable administratif
391 12 Etienne Pallier
- SUPERADMIN (ce profil correspond au super administrateur, il a TOUS les droits)
392 12 Etienne Pallier
393 12 Etienne Pallier
Les droits associés à chaque profil sont décrits dans le document docs/userguide/ACL.pdf, principalement dans le tableau II-B.
394 12 Etienne Pallier
395 12 Etienne Pallier
L'ensemble de tous ces droits est contrôllé (presque) entièrement par un seul tableau nommé $easyACL
396 12 Etienne Pallier
397 12 Etienne Pallier
Il vous suffit donc de jouer sur le contenu de ce tableau pour modifier les droits.
398 12 Etienne Pallier
399 12 Etienne Pallier
On peut définir ces droits à deux niveaux : 
400 12 Etienne Pallier
- Les droits PAR DEFAUT sont définis dans la classe mère de tous les controleurs, nommée app/Controller/AppController
401 12 Etienne Pallier
- Les droits spécifiques à un modèle (Matériel, Suivi, Emprunt) sont définis dans le controleur respectif (MaterielsController, SuivisController, EmpruntController...)
402 12 Etienne Pallier
403 12 Etienne Pallier
1) Les droits PAR DEFAUT sont définis dans la classe mère de tous les controleurs, nommée app/Controller/AppController
404 12 Etienne Pallier
405 12 Etienne Pallier
Vous y trouverez un tableau $easyACL avec un contenu semblable à celui-ci :
406 12 Etienne Pallier
407 12 Etienne Pallier
	protected $easyACL = array(
408 12 Etienne Pallier
	
409 12 Etienne Pallier
			'ALL' => array (
410 12 Etienne Pallier
				// CRUD actions :
411 12 Etienne Pallier
				'index' => 'Y', // Read all
412 12 Etienne Pallier
				'view' => 'Y', // Read one
413 12 Etienne Pallier
				'add' => 'Y', // Create
414 12 Etienne Pallier
				'edit' => 'N', // Update
415 12 Etienne Pallier
				//'delete' => 'N', // Delete
416 12 Etienne Pallier
			),
417 12 Etienne Pallier
	
418 12 Etienne Pallier
			'USER' => array (
419 12 Etienne Pallier
				// CRUD actions :
420 12 Etienne Pallier
				'index' => 'Y', // read all
421 12 Etienne Pallier
				'view' => 'Y', // read one
422 12 Etienne Pallier
				//'add' => 'Y', // create
423 12 Etienne Pallier
				'edit' => 'N', // update
424 12 Etienne Pallier
				'delete' => 'N',
425 12 Etienne Pallier
			),
426 12 Etienne Pallier
427 12 Etienne Pallier
			'RESPONSABLE' => array (
428 12 Etienne Pallier
				// CRUD actions :
429 12 Etienne Pallier
				'index' => 'Y', // read all
430 12 Etienne Pallier
				'view' => 'Y', // read one
431 12 Etienne Pallier
				'add' => 'Y', // create
432 12 Etienne Pallier
				'edit' => 'N', // update
433 12 Etienne Pallier
				'delete' => 'Y',
434 12 Etienne Pallier
			),
435 12 Etienne Pallier
			
436 12 Etienne Pallier
			...
437 12 Etienne Pallier
438 12 Etienne Pallier
	}
439 12 Etienne Pallier
440 12 Etienne Pallier
Le sous-tableau 'ALL' contient les DROITS PAR DEFAUT pour TOUS les profils (ALL), 
441 12 Etienne Pallier
pour TOUS les modèles, et pour les actions qu'il définit (ici, les actions CRUD, Create Read Update Delete).
442 12 Etienne Pallier
Par exemple, avec l'entrée 'delete' => 'N', par défaut aucun profil n'a le droit de supprimer quelque modèle (matériel, suivi, emprunt, ...) que ce soit,
443 12 Etienne Pallier
même les nouveaux modèles qui pourraient être ajoutés dans le futur.
444 12 Etienne Pallier
Attention, ce système est "permissif" dans le sens ou par défaut tout est autorisé.
445 12 Etienne Pallier
Si vous voulez interdire une action, il faut le dire explicitement, sinon elle est autorisée par défaut.
446 12 Etienne Pallier
En général, cela simplifie les choses.
447 12 Etienne Pallier
Donc, par exemple, si on commente l'action 'delete', elle est alors autorisée.
448 12 Etienne Pallier
C'est comme si elle était définie avec 'delete' => 'Y'
449 12 Etienne Pallier
 
450 12 Etienne Pallier
Si un profil spécifique doit avoir un droit sur une action, qui est différent du droit PAR DEFAUT défini dans 'ALL',
451 12 Etienne Pallier
alors il faut ajouter un sous-tableau pour ce profil, portant le nom de ce profil (en majuscule).
452 12 Etienne Pallier
453 12 Etienne Pallier
Ainsi, le sous-tableau 'USER' contient les droits spécifiques pour le profil USER, 
454 12 Etienne Pallier
pour TOUS les modèles, et pour les actions qu'il définit. 
455 12 Etienne Pallier
Par exemple, avec l'entrée 'delete' => 'N', par défaut un USER n'a pas le droit de supprimer quelque modèle (matériel, suivi, emprunt, ...) que ce soit.
456 12 Etienne Pallier
Si une action n'est pas définie (par exemple 'add'), alors c'est l'autorisation définie dans 'ALL' qui fait foi.
457 12 Etienne Pallier
458 12 Etienne Pallier
Le sous-tableau 'ADMIN' contient les droits par défaut pour le profil ADMIN, 
459 12 Etienne Pallier
pour TOUS les modèles, et pour les actions qu'il définit. 
460 12 Etienne Pallier
Par exemple, avec l'entrée 'delete' => 'Y', par défaut un ADMIN a le droit de supprimer TOUS les modèles (matériel, suivi, emprunt, ...),
461 12 Etienne Pallier
y-compris les nouveaux modèles qui pourraient être ajoutés dans le futur.
462 12 Etienne Pallier
463 12 Etienne Pallier
Et ainsi de suite pour les autres profils ADMIN, ADMINPLUS, et SUPERADMIN.
464 12 Etienne Pallier
S'ils ne sont pas définis, alors ils héritent des autorisations par défaut définies dans 'ALL'. 
465 12 Etienne Pallier
466 12 Etienne Pallier
467 12 Etienne Pallier
2) Les droits spécifiques à un modèle (Matériel, Suivi, Emprunt) sont définis dans le controleur respectif (MaterielsController, SuivisController, EmpruntController...)
468 12 Etienne Pallier
469 12 Etienne Pallier
Si, pour un modèle donné, on veut définir des droits différents de ceux définis globalement dans app/Controller/AppController,
470 12 Etienne Pallier
il faut le faire dans le controleur correspondant au modèle.
471 12 Etienne Pallier
Par exemple, si on veut des droits particuliers pour les matériels, il faut les définirs dans app/Controller/MaterielsController
472 12 Etienne Pallier
Cependant, afin de garder la plupart des droits définis globalement dans AppController, 
473 12 Etienne Pallier
et de redéfinir SEULEMENT CERTAINS droits spécifiques pour certains profils ou certaines actions,
474 12 Etienne Pallier
on définira les nouveaux droits un peu différemment de ce qui a été fait dans AppController.
475 12 Etienne Pallier
(TODO: je n'ai pas réussi avec Php 5.3 à gérer un héritage au niveau du tableau $easyACL entre celui de AppController et celui des sous-classes,
476 12 Etienne Pallier
car celui défini dans une sous-classe écrase complètement celui de la classe mère AppController ; peut-être qu'avec Php 5.6 il y aurait une solution plus éléguante).
477 12 Etienne Pallier
En effet, plutôt que de définir à nouveau un tableau $easyACL qui écraserait celui défini dans AppController,
478 12 Etienne Pallier
on hérite du $easyACL de AppController, et on en écrase seulement certaines entrées.
479 12 Etienne Pallier
On définit ces nouvelles entrées dans la méthode beforeFilter() du controleur.
480 12 Etienne Pallier
Voir par exemple les entrées définies dans la méthode beforeFilter() du controleur MaterielsController. 
481 12 Etienne Pallier
482 12 Etienne Pallier
Par exemple, une entrée comme celle-ci :
483 12 Etienne Pallier
	$this->easyACL['ALL']['view'] = 'N';
484 12 Etienne Pallier
remplacerait l'entrée par défaut de AppController
485 12 Etienne Pallier
	'ALL' => array (
486 12 Etienne Pallier
		...
487 12 Etienne Pallier
		'view' => 'Y',
488 12 Etienne Pallier
		...
489 12 Etienne Pallier
	);
490 12 Etienne Pallier
491 12 Etienne Pallier
Une entrée (un peu plus complexe) comme celle-ci :
492 12 Etienne Pallier
	$this->easyACL['ALL']['delete'] = 'status == CREATED';
493 12 Etienne Pallier
remplacerait l'entrée par défaut de AppController
494 12 Etienne Pallier
	'ALL' => array (
495 12 Etienne Pallier
		...
496 12 Etienne Pallier
		'delete' => 'Y',
497 12 Etienne Pallier
		...
498 12 Etienne Pallier
	);
499 12 Etienne Pallier
et signifierait que la suppression d'un matériel n'est possible (par défaut) que si le statut du matériel est "CREATED" (il vient d'être créé, mais il n'est pas encore validé). 
500 12 Etienne Pallier
501 12 Etienne Pallier
Enfin, une entrée (encore plus complexe) comme celle-ci :
502 12 Etienne Pallier
	$this->easyACL['USER']['edit'] = '&& nom_createur == CURRENT_USER_NAME';
503 12 Etienne Pallier
remplacerait l'entrée par défaut de AppController pour le profile USER
504 12 Etienne Pallier
	'USER' => array (
505 12 Etienne Pallier
		...
506 1 Etienne Pallier
		'edit' => 'Y',
507 1 Etienne Pallier
		...
508 1 Etienne Pallier
	);
509 1 Etienne Pallier
et ajouterait (grâce au '&&') une contrainte supplémentaire pour la modification d'un matériel (pour les USER),
510 12 Etienne Pallier
qui est que le matériel doit avoir été créé par l'utilisateur qui en fait la modification
511 12 Etienne Pallier
512 12 Etienne Pallier
... etc.
513 12 Etienne Pallier
514 12 Etienne Pallier
A vous de jouer maintenant, vous savez comment "tuner" votre application, au niveau des droits de chaque profil et sur chaque action.
515 22 Etienne Pallier
516 12 Etienne Pallier
517 23 Etienne Pallier
518 12 Etienne Pallier
-----------------
519 22 Etienne Pallier
520 22 Etienne Pallier
h3. VIRTUAL HOST (facultatif)
521 12 Etienne Pallier
522 12 Etienne Pallier
-----------------
523 12 Etienne Pallier
524 12 Etienne Pallier
But : Créer un virtual host pour pouvoir acceder au logiciel avec cette simple url "http://localhost:8081" par exemple.
525 12 Etienne Pallier
526 12 Etienne Pallier
Pour cela :
527 12 Etienne Pallier
528 12 Etienne Pallier
- Ajouter a la fin du fichier de conf apache /etc/httpd.conf (ou /etc/httpd/conf/httpd.conf, ou encore XAMPP/xamppfiles/etc/httpd.conf) la ligne :
529 12 Etienne Pallier
	Include etc/extra/labinvent.conf
530 12 Etienne Pallier
	(ou conf.d/labinvent.conf)
531 12 Etienne Pallier
532 12 Etienne Pallier
- Editer ce fichier etc/extra/labinvent.conf et y mettre ceci :
533 12 Etienne Pallier
#####################
534 12 Etienne Pallier
Listen 8081
535 12 Etienne Pallier
NameVirtualHost *:8081
536 12 Etienne Pallier
<VirtualHost *:8081>
537 12 Etienne Pallier
        ServerAdmin VOTRE_ADRESSE_MAIL
538 12 Etienne Pallier
        DocumentRoot "/Applications/XAMPP/xamppfiles/htdocs/labinvent/cakephp/app/webroot"
539 12 Etienne Pallier
        ErrorLog logs/labinvent.error_log
540 12 Etienne Pallier
        CustomLog logs/labinvent.access_log combined
541 1 Etienne Pallier
</VirtualHost>
542 1 Etienne Pallier
#####################
543 1 Etienne Pallier
544 1 Etienne Pallier
- Remplacer VOTRE_ADRESSE_MAIL par votre adresse email
545 12 Etienne Pallier
- Modifier la ligne DocumentRoot avec le chemmin absolu vers votre installation de l'application (jusqu'au dossier webroot inclus)
546 12 Etienne Pallier
547 1 Etienne Pallier
Redemarrez maintenant votre serveur web Apache
548 12 Etienne Pallier
549 12 Etienne Pallier
Voila ! Vous devriez maintenant pouvoir vous connecter a l'application avec l'url http://localhost:8081
550 12 Etienne Pallier
551 12 Etienne Pallier
552 12 Etienne Pallier
553 12 Etienne Pallier
NB: Une fois l'installation terminee, les developpeurs devraient aussi lire le document docs/HOWTO.txt 
554 22 Etienne Pallier
555 1 Etienne Pallier
556 22 Etienne Pallier
557 23 Etienne Pallier
-----------------
558 22 Etienne Pallier
559 22 Etienne Pallier
h3. MISE A JOUR (UPGRADE) en 5 petites etapes
560 12 Etienne Pallier
561 12 Etienne Pallier
-----------------
562 12 Etienne Pallier
563 1 Etienne Pallier
Nous expliquons ici comment mettre à jour votre logiciel,
564 12 Etienne Pallier
en installant une nouvelle version,
565 12 Etienne Pallier
qui doit remplacer la version actuelle (déjà installée et utilisée avec des données).
566 1 Etienne Pallier
Le but est de mettre a jour le logiciel tout en conservant la connexion a la base de données actuelle et son contenu.
567 12 Etienne Pallier
568 12 Etienne Pallier
1) Desactiver la version actuelle
569 1 Etienne Pallier
Aller dans le repertoire parent de l’application actuelle
570 12 Etienne Pallier
Le repertoire de l’application actuelle devrait avoir un nom du style labinvent/
571 12 Etienne Pallier
C’est sur ce nom que doit pointer l’URL du navigateur (ex: http://labinvent/cakephp)
572 12 Etienne Pallier
Renommer ce repertoire en "labinvent_OLD" :
573 12 Etienne Pallier
	mv labinvent labinvent_OLD
574 12 Etienne Pallier
575 12 Etienne Pallier
2) Activer la nouvelle version
576 12 Etienne Pallier
Extraire la nouvelle version à côté de l’actuelle :
577 12 Etienne Pallier
	tar xvfz labinvent_X-Y-ZZZ.tgz (par exemple : tar xvfz labinvent_1-3-460.tgz)
578 31 Etienne Pallier
=> cela doit créer un dossier labinvent_X-Y-ZZZ/ (par exemple : labinvent_1-3-460/)
579 12 Etienne Pallier
(à coté du dossier labinvent_OLD/)
580 12 Etienne Pallier
Renommer ce repertoire en "labinvent" :
581 12 Etienne Pallier
	mv labinvent_X-Y-ZZZ.tgz labinvent (par exemple : mv labinvent_1-3-460 labinvent)
582 12 Etienne Pallier
583 12 Etienne Pallier
3) Aller dans le dossier d’installation de la NOUVELLE version
584 12 Etienne Pallier
cd labinvent/install/
585 12 Etienne Pallier
586 12 Etienne Pallier
4) Executer le script installation.sh
587 26 Etienne Pallier
./installation.sh
588 1 Etienne Pallier
ATTENTION : Répondre "Non" à la question "Voulez-vous creer la base de donnees ?"
589 1 Etienne Pallier
590 1 Etienne Pallier
5) Récupérer la configuration de l’application actuelle dans la nouvelle
591 1 Etienne Pallier
- Configuration Base de données : 
592 12 Etienne Pallier
Copier le fichier labinvent_OLD/cakephp/app/Config/database.php de l’application actuelle dans la nouvelle, c’est à dire dans labinvent/cakephp/app/Config/
593 1 Etienne Pallier
- Configuration Générale : 
594 1 Etienne Pallier
Adapter le nouveau fichier labinvent/cakephp/app/Config/labinvent.php à partir de ce que vous avez dans le même fichier de l’application actuelle,
595 1 Etienne Pallier
c'est à dire dans labinvent_OLD/cakephp/app/Config/labinvent.php
596 12 Etienne Pallier
(la commande « diff » peut aider à voir ce qui a changé)
597 31 Etienne Pallier
598 46 Etienne Pallier
h2. TEST
599 31 Etienne Pallier
600 46 Etienne Pallier
---
601 46 Etienne Pallier
602 46 Etienne Pallier
603 46 Etienne Pallier
h2. RUN
604 46 Etienne Pallier
605 46 Etienne Pallier
---
606 31 Etienne Pallier
607 48 Etienne Pallier
h2. INSTALLATION DEPUIS ECLIPSE (SEULEMENT POUR LES DEV)
608 48 Etienne Pallier
609 48 Etienne Pallier
1) Préparation d'Eclipse
610 48 Etienne Pallier
611 48 Etienne Pallier
Download Eclipse pour Php (plugin PDT déjà inclus) : 
612 48 Etienne Pallier
http://www.eclipse.org/downloads
613 48 Etienne Pallier
(sinon, éventuellement http://www.eclipse.org/downloads/index-developer.php)
614 48 Etienne Pallier
(on peut aussi télécharger un eclipse standard, et lui ajouter ensuite le plugin PDT)
615 48 Etienne Pallier
Choisir "Eclipse for PHP Developpers"
616 48 Etienne Pallier
Fin 2014, j'ai téléchargé la version Luna 4.4.1 SR1
617 48 Etienne Pallier
Workspace proposé par défaut : /Users/pallier/Documents/workspace
618 48 Etienne Pallier
(==> remplacé par /Users/pallier/projects/Eclipse/eclipse_luna_php_workspace)
619 48 Etienne Pallier
620 48 Etienne Pallier
Cliquer sur "Workbench"
621 48 Etienne Pallier
622 48 Etienne Pallier
Se placer dans la perspective PHP
623 48 Etienne Pallier
624 48 Etienne Pallier
Installer un client svn avec le plugin subversive : 
625 48 Etienne Pallier
Help/Eclipse Marketplace, chercher "subversive"
626 48 Etienne Pallier
Installer Subversive (pour moi, c'était version 2.0.1)
627 48 Etienne Pallier
Restart Eclipse
628 48 Etienne Pallier
629 48 Etienne Pallier
File/Import/From svn
630 48 Etienne Pallier
==> demande à installer un connecteur svn
631 48 Etienne Pallier
J'ai choisi le plus récent, soit "svn kit 1.8.7" (compatible avec svn 1.7 et 1.8)
632 48 Etienne Pallier
(il contient Subversive svn connectors 4.1.2)
633 48 Etienne Pallier
634 48 Etienne Pallier
Restart Eclipse
635 48 Etienne Pallier
636 48 Etienne Pallier
2) Recupération du projet 
637 48 Etienne Pallier
638 48 Etienne Pallier
File/Import/From svn (2ème fois)
639 48 Etienne Pallier
URL : https://usvn-inventirap.irap.omp.eu/repo/inventirap/trunk
640 48 Etienne Pallier
(répondre Non à la proposition de normaliser l'arborescence)
641 48 Etienne Pallier
donner un nom, par exemple : labinvent2015
642 48 Etienne Pallier
Utiliser emplacement : 
643 48 Etienne Pallier
- par défaut (directement dans le dossier d'Eclipse, c'est plus simple)
644 48 Etienne Pallier
ou bien
645 48 Etienne Pallier
- /Applications/XAMPP/xamppfiles/htdocs (si on veut que le projet s'execute directement dans le dossier web apache htdocs, mais ca n'est pas obligatoire...)
646 48 Etienne Pallier
647 48 Etienne Pallier
S'assurer que le projet est bien reconnu comme un projet PHP (il doit y avoir un petit "P" sur le dossier racine du projet)
648 48 Etienne Pallier
Si ça n'est pas le cas, vérifier que le fichier .project (à la racine) contient bien
649 48 Etienne Pallier
	<natures>
650 48 Etienne Pallier
		<nature>org.eclipse.php.core.PHPNature</nature>
651 48 Etienne Pallier
	</natures>
652 48 Etienne Pallier
NB : Le fichier .project est normalement versionné et donc le projet labinvent devrait être reconnu automatiquement comme projet PHP
653 48 Etienne Pallier
654 48 Etienne Pallier
S'assurer que les fichiers de vue de cakephp (*.ctp) sont bien reconnus comme des fichiers PHP.
655 48 Etienne Pallier
Pour tester cela, ouvrir le fichier de vue cakephp/app/View/Categories/get_all.ctp
656 48 Etienne Pallier
Si ce fichier s'ouvre comme un simple fichier texte, c'est qu'il n'est pas reconnu par Eclipse comme un fichier Php. 
657 48 Etienne Pallier
Il faut donc associer l'editeur Php a l'extension de fichier "*.ctp" :
658 48 Etienne Pallier
- Preferences/General/Content types
659 48 Etienne Pallier
- Dans la liste "Content types", ouvrir la section "Text", selectionner PHP
660 48 Etienne Pallier
- Ajouter l'extension "*.ctp"
661 48 Etienne Pallier
662 48 Etienne Pallier
Vérifier la version de php utilisée (il serait préférable d'utiliser la meme version que celle du serveur officiel, début 2015 c'est toujours php 5.3) :
663 48 Etienne Pallier
- Clic-droit sur le projet, Propriétés
664 48 Etienne Pallier
- PHP
665 48 Etienne Pallier
- Interpreter
666 48 Etienne Pallier
- Enable project specific settings, PHP Version : "PHP 5.3"
667 48 Etienne Pallier
668 48 Etienne Pallier
S'assurer que le texte est bien encodé en UTF-8 par défaut :
669 48 Etienne Pallier
clic-droit sur le dossier racine du projet (dans PHP Explorer), Properties, Resource : dans la zone "Text file encoding" cocher "Other" et sélectionner UTF-8
670 48 Etienne Pallier
(
671 48 Etienne Pallier
Il faudrait commiter ça mais je ne sais pas trop si c'est risqué ou pas.
672 48 Etienne Pallier
Les fichiers concernés sont :
673 48 Etienne Pallier
- .project (déjà versionné) : car il commence par la ligne "<?xml version="1.0" encoding="UTF-8"?>"
674 48 Etienne Pallier
- mais c'est surtout celui-ci qui compte (actuellement ignoré de svn) : .settings/org.eclipse.core.resources.prefs : car sa 2eme ligne est "encoding/<project>=UTF-8"
675 48 Etienne Pallier
)
676 48 Etienne Pallier
677 48 Etienne Pallier
Les éléments suivants sont normalement DEJA ignorés par svn (svn:ignore), à vérifier :
678 48 Etienne Pallier
- .settings/
679 48 Etienne Pallier
- cakephp/app/tmp/ : tout sauf 
680 48 Etienne Pallier
	- documents/
681 48 Etienne Pallier
- cakephp/app/Config/ :
682 48 Etienne Pallier
	- database.php
683 48 Etienne Pallier
	- labinvent.php
684 48 Etienne Pallier
685 48 Etienne Pallier
686 48 Etienne Pallier
687 48 Etienne Pallier
688 48 Etienne Pallier
*********************************************************
689 48 Etienne Pallier
REMARQUES INTERRESSANTES (MAIS VOUS POUVEZ LES IGNORER)
690 48 Etienne Pallier
691 48 Etienne Pallier
// DEBUT DES REMARQUES
692 48 Etienne Pallier
693 48 Etienne Pallier
A la racine du projet, j'ai plusieurs éléments cachés de configuration Eclipse :
694 48 Etienne Pallier
695 48 Etienne Pallier
1) fichier .buildpath 
696 48 Etienne Pallier
Il est versionné puisque "svn status .buildpath" (depuis la console) ne donne rien
697 48 Etienne Pallier
Il contient :
698 48 Etienne Pallier
699 48 Etienne Pallier
<?xml version="1.0" encoding="UTF-8"?>
700 48 Etienne Pallier
<buildpath>
701 48 Etienne Pallier
        <buildpathentry kind="con" path="org.eclipse.php.core.LANGUAGE"/>
702 48 Etienne Pallier
        <buildpathentry kind="lib" path="docs/mockup/mockup_html.zip"/>
703 48 Etienne Pallier
        <buildpathentry kind="src" path="cakephp"/>
704 48 Etienne Pallier
</buildpath>
705 48 Etienne Pallier
706 48 Etienne Pallier
2) fichier .project
707 48 Etienne Pallier
Il est déjà versionné
708 48 Etienne Pallier
Il contient :
709 48 Etienne Pallier
<?xml version="1.0" encoding="UTF-8"?>
710 48 Etienne Pallier
<projectDescription>
711 48 Etienne Pallier
        <name>invirap</name>
712 48 Etienne Pallier
        <comment></comment>
713 48 Etienne Pallier
        <projects>
714 48 Etienne Pallier
        </projects>
715 48 Etienne Pallier
        <buildSpec>
716 48 Etienne Pallier
                <buildCommand>
717 48 Etienne Pallier
                        <name>org.eclipse.wst.common.project.facet.core.builder</name>
718 48 Etienne Pallier
                        <arguments>
719 48 Etienne Pallier
                        </arguments>
720 48 Etienne Pallier
                </buildCommand>
721 48 Etienne Pallier
                <buildCommand>
722 48 Etienne Pallier
                        <name>org.eclipse.wst.validation.validationbuilder</name>
723 48 Etienne Pallier
                        <arguments>
724 48 Etienne Pallier
                        </arguments>
725 48 Etienne Pallier
                </buildCommand>
726 48 Etienne Pallier
                <buildCommand>
727 48 Etienne Pallier
                        <name>org.eclipse.dltk.core.scriptbuilder</name>
728 48 Etienne Pallier
                        <arguments>
729 48 Etienne Pallier
                        </arguments>
730 48 Etienne Pallier
                </buildCommand>
731 48 Etienne Pallier
        </buildSpec>
732 48 Etienne Pallier
        <natures>
733 48 Etienne Pallier
                <nature>org.eclipse.php.core.PHPNature</nature>
734 48 Etienne Pallier
                <nature>org.eclipse.wst.common.project.facet.core.nature</nature>
735 48 Etienne Pallier
        </natures>
736 48 Etienne Pallier
</projectDescription>
737 48 Etienne Pallier
738 48 Etienne Pallier
3) dossier .settings/ (exclus de svn)
739 48 Etienne Pallier
Il contient 3 fichiers :
740 48 Etienne Pallier
741 48 Etienne Pallier
- org.eclipse.core.resources.prefs : bizarrement, il ne contient que quelques références seulement :
742 48 Etienne Pallier
eclipse.preferences.version=1
743 48 Etienne Pallier
encoding//cakephp/app/Controller/MaterielsController.php=UTF-8
744 48 Etienne Pallier
encoding//cakephp/app/View/Elements/menu_view.ctp=UTF-8
745 48 Etienne Pallier
encoding//cakephp/app/View/Layouts/default.ctp=UTF-8
746 48 Etienne Pallier
encoding//cakephp/app/View/Materiels/index.ctp=UTF-8
747 48 Etienne Pallier
encoding//cakephp/app/View/Materiels/scaffold.view.ctp=UTF-8
748 48 Etienne Pallier
encoding//database/Upd_TableConstraints.sql=UTF-8
749 48 Etienne Pallier
encoding//database/update/README.txt=UTF-8
750 48 Etienne Pallier
encoding//docs/HOWTO.txt=UTF-8
751 48 Etienne Pallier
encoding//install/HOWTO.txt=UTF-8
752 48 Etienne Pallier
encoding/<project>=UTF-8
753 48 Etienne Pallier
754 48 Etienne Pallier
- org.eclipse.php.core.prefs
755 48 Etienne Pallier
eclipse.preferences.version=1
756 48 Etienne Pallier
include_path=0;/invirap\u00051;/invirap/docs/mockup/mockup_html.zip
757 48 Etienne Pallier
758 48 Etienne Pallier
- org.eclipse.wst.common.project.facet.core.xml : sans doute inutile ? (lié à "Faceted Project Validation Builder" dans Properties/Builders)
759 48 Etienne Pallier
<?xml version="1.0" encoding="UTF-8"?>
760 48 Etienne Pallier
<faceted-project>
761 48 Etienne Pallier
  <fixed facet="php.core.component"/>
762 48 Etienne Pallier
  <fixed facet="php.component"/>
763 48 Etienne Pallier
  <installed facet="php.core.component" version="1"/>
764 48 Etienne Pallier
  <installed facet="php.component" version="5.4"/>
765 48 Etienne Pallier
</faceted-project>
766 48 Etienne Pallier
767 48 Etienne Pallier
// FIN DES REMARQUES
768 48 Etienne Pallier
*********************************************************
769 48 Etienne Pallier
770 48 Etienne Pallier
771 48 Etienne Pallier
II - Configuration du projet LABINVENT
772 48 Etienne Pallier
**************************************************
773 48 Etienne Pallier
774 53 Etienne Pallier
Aller maintenant dans la section INSTALLATION ci-dessue, à partir du point "B/ Installation"
775 48 Etienne Pallier
776 48 Etienne Pallier
777 48 Etienne Pallier
778 48 Etienne Pallier
---
779 23 Etienne Pallier
780 23 Etienne Pallier
h2. Comment accéder au site redmine depuis l'extérieur ?
781 1 Etienne Pallier
782 1 Etienne Pallier
-----------------
783 1 Etienne Pallier
784 1 Etienne Pallier
785 1 Etienne Pallier
1) Créer un tunnel (entre le port local 9443 et le port distant 443 du serveur web irap, via la passerelle)
786 1 Etienne Pallier
787 1 Etienne Pallier
ssh -L 9443:projects.irap.omp.eu:443 MONLOGINDULABO@PASSERELLE.irap.omp.eu
788 2 Etienne Pallier
789 3 Etienne Pallier
(Pour les personnes qui utilisent Windows, vous pouvez faire la même chose avec le logiciel Putty, en vous inspirant de ce qui est décrit au point 4) a) de cet article http://planetoweb.cesr.fr/twiki/bin/view/Main/HowtoInformatique#Se_connecter_un_serveur_linux_en) 
790 24 Etienne Pallier
791 24 Etienne Pallier
2) Pointer son navigateur sur https://localhost:9443
792 5 Etienne Pallier
793 24 Etienne Pallier
-----------------
794 24 Etienne Pallier
795 5 Etienne Pallier
h2. Dépôt SVN
796 10 Etienne Pallier
797 5 Etienne Pallier
-----------------
798 25 Etienne Pallier
799 25 Etienne Pallier
https://usvn-inventirap.irap.omp.eu/repo/inventirap/trunk/
800 5 Etienne Pallier
801 25 Etienne Pallier
-----------------
802 25 Etienne Pallier
803 1 Etienne Pallier
h2. Mailing list
804 1 Etienne Pallier
805 1 Etienne Pallier
-----------------
806 1 Etienne Pallier
807 1 Etienne Pallier
usvn-repo_inventirap AT irap.omp.eu
808 1 Etienne Pallier
809 1 Etienne Pallier
(https://listes.irap.omp.eu/wws/info/usvn-repo_inventirap)