Project

General

Profile

InstallationFree » History » Version 7

Simon, 05/02/2012 02:13 PM

1 6 Simon
{{>toc}}
2 1 eribar
3 5 Simon
h1. Installation sur Free
4 1 eribar
5
6 5 Simon
Ce tutoriel explique les étapes d'installation de Linea21 (version 1.3) sur un site distant, dans une "page perso" (un site personnel) de Free, avec utilisation d'une base Mysql. Pour l'exemple, votre site sera dénommé _monsite.agenda21_.
7
8
9 7 Simon
h2. Paramètres Free
10 5 Simon
11
12 1 eribar
Chez Free, on crée d'abord une adresse mail, puis une "page perso" (un site) liée à cette adresse. Enfin on active - ou non - une base de donnée mysql ou postgresql (dans notre exemple Mysql), pour contenir les données du site. Pour utiliser Linea21, une base de donnée est obligatoire.
13
14
Au départ, le mot de passe est identique pour l'accès :
15
 1. à l'adresse mail
16
 2. à la base de données par l'outil de gestion SQL (phpmyadmin)
17
 3. au site par l'outil de transfert FTP
18
Par la suite, on peut modifier ce mot de passe pour chacun de ces accès et en avoir donc 3 différents. On suppose ici que le mot de passe reste identique pour les 3 accès.
19
20
Après création de la "page perso" et activation de la base, les paramètres de connexion sont les suivants :
21
22 5 Simon
	* adresse mail		: _!monsite.agenda21@free.fr_
23
	* site			: _monsite.agenda21.free.fr_
24
	* serveur		: _monsite.agenda21.sql.free.fr_
25
	* base de données	: _monsite_agenda21_
26
	* mot de passe du site	: _votre-mot-de-passe_
27 1 eribar
28 5 Simon
Le nom de la base de données correspond à _monsite.agenda21_, mais dans lequel tous les points (.) sont remplacés par des underscores (_).
29 1 eribar
30
31 7 Simon
h2. Préparatifs à l'installation de Linea21 - en local (sur votre ordinateur)
32 1 eribar
33 5 Simon
34
Après extraction de l'archive contenant linea21, on obtient un répertoire _/linea21_ dans lequel plusieurs adaptations sont à réaliser.
35
36 1 eribar
 1. MODIFIER EVENTUELLEMENT L'ARBORESCENCE
37 5 Simon
Par défaut, Linea21 est paramétré pour s'installer dans le répertoire intermédiaire _monsite.agenda21/linea21/_. L'URL d'accès publique sera donc _!http://monsite.agenda21/linea21/public_.
38 1 eribar
39 5 Simon
Si on préfère installer Linea21 directement à la racine du site (et donc avoir une adresse publique du type _!http://monsite.agenda21/public_), il faut supprimer les références _/linea21_ :
40 1 eribar
41 5 Simon
	* dans le fichier _config/define_release.ini_, à la section [SERVER_SETTINGS]
42
	* dans les fichiers _.htaccess_ et _/public/.htaccess_
43 1 eribar
44
 2. OBLIGER LE SERVEUR FREE A UTILISER PHP V5
45
46 5 Simon
Cf. "InstallationSysteme":http://dev.linea21.com/wiki/InstallationSysteme
47 1 eribar
48 5 Simon
Modifier le fichier _.htaccess_, en ajoutant _php1_ au début du fichier, pour obtenir :
49 1 eribar
50 5 Simon
<pre>
51 1 eribar
	php 1
52
	## Error management - Default location
53
	ErrorDocument 404  /linea21/public/error.php
54
	## Error management - Virtual Host configuration
55
	#ErrorDocument 404  /public/error.php
56 5 Simon
</pre>
57 1 eribar
58 5 Simon
Ce fichier _.htaccess_ sera obligatoirement présent à la racine du site.
59 1 eribar
60
 3. PARAMETRER LES DONNEES DE CONNEXION
61
62 5 Simon
** Modifier le fichier _/linea21/config/define_db.ini_, en renseignant la section [DATABASE] comme suit :
63
*** DB_HOST 		= _monsite.agenda21.sql.free.fr_
64
*** DB_USER 		= _monsite.agenda21_
65
*** DB_PASS 		= _votre_mot_de_passe_
66
*** DB_NAME 		= _monsite_agenda21_
67
*** DB_ADMINMAIL 		= _-1_
68 1 eribar
69 5 Simon
** Modifier le fichier _/linea21/config/define_release.ini_, en renseignant la section [SERVER_SETTINGS] comme suit :
70
*** SITE_CITY_NAME 	= _Ma_Communauté_Agenda21_
71
*** SITE_CITY_URL 	= _!http://monsite.agenda21.free.fr/public/_
72
*** SITE_ROOT_URL 	= _!http://monsite.agenda21.free.fr_
73
*** SITE_CITY_MAIL 	= _!monsite.agenda21@free.fr_
74
*** SITE_PATH 		= _path/to/your/application/_
75 1 eribar
76 5 Simon
Ici l'arborescence choisie n'est pas celle par défaut, elle ne comporte pas le répertoire intermédiaire _/linea21_. Le _path/to/your/application/_ sera renseigné ultérieurement, dans l'interface d'aministration du site.
77 1 eribar
78 5 Simon
 4. CREER UN SCRIPT POUR CONNAITRE LE _CHEMIN_ DE VOTRE SITE CHEZ FREE
79
Créer à la racine du répertoire _/linea21_ un fichier _path.php_ (c'est un exemple) qui contiendra uniquement le code suivant :
80
<pre>
81 1 eribar
	<?php
82
	echo dirname(realpath("path.php"));
83
	?>
84 5 Simon
</pre>
85 1 eribar
86
87 7 Simon
h2. Alimentation de la base de données Mysql "monsite_agenda21"
88 1 eribar
89
90 5 Simon
 1. se connecter à l'interface de gestion de la base de données (phpmyadmin), chez Free, à l'adresse : "2. une boîte de dialogne demande les identifiant et mot de passe de connexion : _monsite.agenda21_ et _votre-mot-de-passe_
91 1 eribar
92 5 Simon
 3. pour créer les tables dans l'interface de _phpmyadmin_ :
93
** cliquer sur *Importer*
94
** sélectionner le script _/linea21/scripts_sql/BuildDB.mysql.sql_
95
** cliquer sur *Exécuter* : toutes les tables sont alors générées dans votre base.
96
** cliquer à nouveau sur *Importer*
97
** sélectionner le script _/linea21/scripts_sql/input.mysql.fr.sql_
98
** cliquer sur *Exécuter* : toutes les tables nécessaires au démarrage sont alimentées (ex : _lusers_ avec l'utilisateur _admin_ et son mot de passe crypté)
99 1 eribar
100
101 7 Simon
h2. Installation de linea21 sur "monsite.agenda21" par FTP
102 1 eribar
103 5 Simon
104
Avec Free, le programme de transfert FTP recommandé est _!FileZilla_.
105
106
 1. Paramétrer dans FileZilla une connexion à votre site avec les paramètres suivants :
107
	* hôte = _monsite.agenda21.free.fr_
108
	* port = _21_
109
	* type d'authentification = _normale_
110
	* identifiant = _monsite.agenda21_
111
	* mot de passe = _votre-mot-de-passe_
112
113 1 eribar
 2. Installer linea21 sur le site Free
114 5 Simon
	* se connecter à votre site et créer un répertoire *sessions* à sa racine
115 1 eribar
	* télécharger tous les répertoires et fichiers de linea21 de votre ordinateur vers votre site
116 5 Simon
	* vérifier la présence à la racine du site des fichiers _.htaccess_, _info.php_ et _path.php_ (ils le seront si on n'utilise pas l'installation avec le répertoire intermédiaire _/linea21_).
117 1 eribar
118 5 Simon
Désormais tout est prêt pour accéder aux interfaces d'administration (_!http://monsite.agenda21.free.fr/admin_) et publique (_!http://monsite.agenda21.free.fr/public_).
119 2 Simon
120 1 eribar
121 7 Simon
h2. Première connexion à l'interface d'administration et paramétrage initial
122 1 eribar
123
124 5 Simon
 1. accéder à l'interface d'administration avec l'identifiant _admin_ et le mot de passe par défaut _linea_, puis cliquer sur _configurer > système_.
125 1 eribar
126 5 Simon
 2. les informations dans _Base de données (define_db)_ et _Configuration système (define_release)_ doivent être identiques à vos saisies en local
127 1 eribar
128 5 Simon
 3. de plus, comme indiqué dans le fichier _readme.fr.txt_, il faut paramétrer dans _Configuration système (define_release)_ :
129
130
	* dans la section [SERVER_SETTINGS":http://sql.free.fr/phpMyAdmin/], le _SITE_PATH_ (le chemin de votre site chez Free)
131
		* pour connaître ce chemin, dans votre navigateur, aller à l'adresse _monsite.agenda21.free.fr/path.php_
132
		* La page affiche alors le _path/to/your/application/_ (ex : _/mnt/xxx/free.fr/f/z/monsite.agenda21/_)
133
		* saisissez ce chemin (soit _/mnt/xxx/free.fr/f/z/monsite.agenda21/_)
134
135 1 eribar
	* dans la section [MAIL_INFORMATIONS], l'ensemble des champs comme suit :
136
		* MAIL_FROM             = votre_adresse_d'envoi_de_mail         (ex : !monsite.agenda21@free.fr)
137
		* MAIL_FROMNAME		= votre_nom_d'adresse_d'envoi		(ex : Administrateur monsite.agenda21)
138
		* MAIL_REPLY		= votre_adresse_où_répondre		(ex : administrateur SOAVE.DD)
139
		* MAIL_REPLYNAME	= votre_nom_d'adresse_de_réponse	(ex : Administrateur monsite.agenda21)
140
		* MAIL_YELLOWPAGES	= 1
141
	
142 5 Simon
	* dans la section [MAIL_SETTINGS], l'ensemble des champs comme indiqué dans ""Configuration des mails"":http://dev.linea21.com/wiki/Configuration%20des%20mails#Surunh%C3%A9bergementFree.fr.
143 1 eribar
144 5 Simon
*Ces modifications dans [MAIL_SETTINGS] sont IMPERATIVES afin de pouvoir recevoir les mails de changement de mot de passe. Sans cela, le message consécutif à toute modification de l'adresse mail (qui génère automatiquement un nouveau mot de passe) ou demande de nouveau mot de passe d'un utilisateur, ne lui parviendrait pas et serait perdue. L'utilisateur ne pourrait plus se connecter.* 
145
146
147 1 eribar
Ceci est particulièrement important au démarrage, lors de la modification de l'adresse mail de l'administrateur par défaut (admin) et/ou lors de la création de nouveaux administrateurs. S'ils ne reçoivent pas le message avec leur nouveau mot de passe, ils ne peuvent plus se connecter par l'interface d'admnistration. La seule solution de contournement consiste à aller modifier leur mot de passe directement dans la base SQL avec phpmyadmin, ce qui n'est ni rapide ni pratique.
148
149
On peut vérifier le bon paramétrage des champs [MAIL_SETTINGS] en créant un utilisateur simple, puis en attendant la réception du message avec son mot de passe sur l'adresse mail de l'utilisateur. Si cela fonctionne, on peut alors créer/modifier les administrateurs.
150
151
----
152
Voilà, votre site est prêt à l'emploi sur Free ! Pour améliorer ce tutoriel, ou pour toute anomalie d'installation, n'hésitez pas à vous adresser au forum : [http://www.linea21.com/forum/].