Project

General

Profile

InstallationFree » History » Version 1

eribar, 11/10/2009 11:26 PM

1 1 eribar
= Installation sur Free =
2
3
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''.
4
5
=== Paramètres Free ===
6
7
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.
8
9
Au départ, le mot de passe est identique pour l'accès :
10
 1. à l'adresse mail
11
 2. à la base de données par l'outil de gestion SQL (phpmyadmin)
12
 3. au site par l'outil de transfert FTP
13
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.
14
15
Après création de la "page perso" et activation de la base, les paramètres de connexion sont les suivants :
16
17
	* adresse mail		: ''!monsite.agenda21@free.fr''
18
	* site			: ''monsite.agenda21.free.fr''
19
	* serveur		: ''monsite.agenda21.sql.free.fr''
20
	* base de données	: ''monsite_agenda21''
21
	* mot de passe du site	: ''votre-mot-de-passe''
22
23
Le nom de la base de données correspond à ''monsite.agenda21'', mais dans lequel tous les points (.) sont remplacés par des underscores (_).
24
25
=== Préparatifs à l'installation de Linea21 - en local (sur votre ordinateur) ===
26
27
Après extraction de l'archive contenant linea21, on obtient un répertoire ''/linea21'' dans lequel plusieurs adaptations sont à réaliser.
28
29
 1. MODIFIER EVENTUELLEMENT L'ARBORESCENCE
30
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''.
31
32
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'' :
33
34
	* dans le fichier ''config/define_release.ini'', à la section [SERVER_SETTINGS]
35
	* dans les fichiers ''.htaccess'' et ''/public/.htaccess''
36
37
 2. OBLIGER LE SERVEUR FREE A UTILISER PHP V5
38
39
Cf. [http://dev.linea21.com/wiki/InstallationSysteme InstallationSysteme]
40
41
Modifier le fichier ''.htaccess'', en ajoutant ''php1'' au début du fichier, pour obtenir :
42
43
{{{
44
	php 1
45
	## Error management - Default location
46
	ErrorDocument 404  /linea21/public/error.php
47
	## Error management - Virtual Host configuration
48
	#ErrorDocument 404  /public/error.php
49
}}}
50
51
Ce fichier ''.htaccess'' sera obligatoirement présent à la racine du site.
52
53
 3. PARAMETRER LES DONNEES DE CONNEXION
54
55
  * Modifier le fichier ''/linea21/config/define_db.ini'', en renseignant la section [DATABASE] comme suit :
56
   * DB_HOST 		= ''monsite.agenda21.sql.free.fr''
57
   * DB_USER 		= ''monsite.agenda21''
58
   * DB_PASS 		= ''votre_mot_de_passe''
59
   * DB_NAME 		= ''monsite_agenda21''
60
   * DB_ADMINMAIL 		= ''-1''
61
62
  * Modifier le fichier ''/linea21/config/define_release.ini'', en renseignant la section [SERVER_SETTINGS] comme suit :
63
   * SITE_CITY_NAME 	= ''Ma_Communauté_Agenda21''
64
   * SITE_CITY_URL 	= ''!http://monsite.agenda21.free.fr/public/''
65
   * SITE_ROOT_URL 	= ''!http://monsite.agenda21.free.fr''
66
   * SITE_CITY_MAIL 	= ''!monsite.agenda21@free.fr''
67
   * SITE_PATH 		= ''path/to/your/application/''
68
69
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.
70
71
 4. PREPARER LE SCRIPT D'INSTALLATION DES TABLES SQL
72
73
Cf. [http://dev.linea21.com/wiki/InstallationDistante InstallationDistante]
74
75
Dans le script ''/linea21/scripts_sql/BuildDB.mysql.sql'', remplacer les 4 premières lignes par les instructions suivantes :
76
{{{
77
	# BUILD Linea21 DB script - UTF-8 format
78
	# CREATE DATABASE IF NOT EXISTS `linea` DEFAULT CHARACTER SET utf8 COLLATE utf8_bin;
79
	USE `monsite_agenda21`;
80
	#
81
}}}
82
83
Les "`" qui encadrent le nom de la base ne sont vraiment obligatoires que si votre nom de base comporte des espaces vides, ce qui n'est pas le cas chez Free.
84
85
 5. CREER UN SCRIPT POUR CONNAITRE LE ''CHEMIN'' DE VOTRE SITE CHEZ FREE
86
Créer à la racine du répertoire ''/linea21'' un fichier ''path.php'' (c'est un exemple) qui contiendra uniquement le code suivant :
87
{{{
88
	<?php
89
	echo realpath("path.php");
90
	?>
91
}}}
92
93
=== Alimentation de la base de données Mysql "monsite_agenda21" ===
94
95
 1. se connecter à l'interface de gestion de la base de données (phpmyadmin), chez Free, à l'adresse : [http://sql.free.fr/phpMyAdmin/]
96
97
 2. une boîte de dialogne demande les identifiant et mot de passe de connexion : ''monsite.agenda21'' et ''votre-mot-de-passe''
98
99
 3. pour créer les tables dans l'interface de ''phpmyadmin'' :
100
  * cliquer sur '''Importer'''
101
  * sélectionner le script ''/linea21/scripts_sql/BuildDB.mysql.sql''
102
  * cliquer sur '''Exécuter''' : toutes les tables sont alors générées dans votre base.
103
  * cliquer à nouveau sur '''Importer'''
104
  * sélectionner le script ''/linea21/scripts_sql/input.mysql.fr.sql''
105
  * 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é)
106
107
=== Installation de linea21 sur "monsite.agenda21" par FTP ===
108
109
Avec Free, le programme de transfert FTP recommandé est ''!FileZilla''.
110
111
 1. Paramétrer dans !FileZilla une connexion à votre site avec les paramètres suivants :
112
	* hôte = ''monsite.agenda21.free.fr''
113
	* port = ''21''
114
	* type d'authentification = ''normale''
115
	* identifiant = ''monsite.agenda21''
116
	* mot de passe = ''votre-mot-de-passe''
117
118
 2. Installer linea21 sur le site Free
119
	* se connecter à votre site et créer un répertoire '''sessions''' à sa racine
120
	* télécharger tous les répertoires et fichiers de linea21 de votre ordinateur vers votre site
121
	* 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'').
122
123
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'').
124
125
=== Première connexion à l'interface d'administration et paramétrage initial ===
126
127
 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''.
128
129
 2. les informations dans ''Base de données (define_db)'' et ''Configuration système (define_release)'' doivent être identiques à vos saisies en local
130
131
 3. de plus, comme indiqué dans le fichier ''readme.fr.txt'', il faut paramétrer dans ''Configuration système (define_release)'' :
132
133
	* dans la section [SERVER_SETTINGS], le ''SITE_PATH'' (le chemin de votre site chez Free)
134
		* pour connaître ce chemin, dans votre navigateur, aller à l'adresse ''monsite.agenda21.free.fr/path.php''
135
		* La page affiche alors le ''path/to/your/application/'' (ex : ''/mnt/xxx/free.fr/f/z/monsite.agenda21/path.php'')
136
		* saisissez ce chemin (sans le "path.php", soit ''/mnt/xxx/free.fr/f/z/monsite.agenda21/'')
137
138
	* dans la section [MAIL_INFORMATIONS], l'ensemble des champs comme suit :
139
		* MAIL_FROM             = votre_adresse_d'envoi_de_mail         (ex : !monsite.agenda21@free.fr)
140
		* MAIL_FROMNAME		= votre_nom_d'adresse_d'envoi		(ex : Administrateur monsite.agenda21)
141
		* MAIL_REPLY		= votre_adresse_où_répondre		(ex : administrateur SOAVE.DD)
142
		* MAIL_REPLYNAME	= votre_nom_d'adresse_de_réponse	(ex : Administrateur monsite.agenda21)
143
		* MAIL_YELLOWPAGES	= 1
144
	
145
	* dans la section [MAIL_SETTINGS], l'ensemble des champs comme indiqué dans [wiki:"Configuration des mails"].
146
147
'''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.''' [[BR]][[BR]]
148
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.
149
150
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.
151
152
----
153
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/].