  $Id: INSTALL_fr.txt,v 1.4 2005/03/10 14:53:18 mdruilhe Exp $
 
  ======================================================================
                      
	Guide d'installation  de w-agora 4.2

  ======================================================================


                             PRE-REQUIS
                             ==========


Avant toute chose, nous vous conseillons de vrifier que vous disposez 
de tous les lments ncessaires  l'installation de w-agora.


I. PHP install et configur
----------------------------

  1. Assurez vous d'abord que PHP et correctement install et configur. Vous 
pouvez le vrifier par vous mme  l'aide du script ci-dessous.
  Copiez-collez les lignes suivantes dans votre diteur de texte et sauvegardez 
dans un fichier appel info.php ou info.php3.
  
<html>
<?echo "Ca marche !!<br>"; phpinfo(); exit ?>
<STRONG>PHP n'est pas install ou n'est pas configur pour cette extension de 
fichier </STRONG>
</html>

  Ensuite, transfrer cette page sur votre serveur et appelez l dans votre 
navigateur. Si PHP est correctement install, vous devriez obtenir une page 
affichant la configuration de PHP. Dans le cas contraire. Le message "PHP 
n'est pas install ou n'est pas configur pour cette extension de fichier" 
devrait s'afficher.

  2. Si PHP est install avec l'option "SAFE MODE"  active, veuillez consulter 
le paragraphe SAFE MODE  la fin de la section II. Si vous n'tes pas responsable 
de l'administration de votre serveur WEB, demandez  votre fournisseur d'accs si 
PHP est install en Safe mode ou non.

Vous trouverez galement cette information dans le rsultat du script cit plus 
haut.

II. Un accs  une base de donnes
----------------------------------

--> Si vous administrez vous mme votre serveur :

  1. Vous devez avoir accs  un de ces serveurs de base de donnes :
     - mysql
     - postgres (6 ou 7)
     - Oracle 8
     - Microsoft SQL server 7 ou 2000

  2. Vous pouvez utiliser une base existante ou crer une base de donnes 
spcifique: 
     Ex: avec mysql, vous pouvez utiliser la commande:

    mysqladmin -uuser -ppaswword create agora

    (Utilisez le nom que vous souhaitez, 'agora' est juste un exemple)
  
  3. Assurez-vous que cette base est accessible par un utilisateur ayant tous les 
droits sur les tables de cette base (select, insert, update, delete, create, 
alter et drop). Vous pouvez par exemple utiliser la commande:

    GRANT
      select, insert, update, create, alter, delete, drop
    ON 
      database.*
    TO 
      utilisateur@localhost
    IDENTIFIED BY
      'motdepasse';

--> Si vous n'administrez pas vous mme le serveur, vous devez possder un accs
 une base de donnes (cf. 1.). Dans ce cas votre hbergeur doit vous fournir 
l'accs  une base et vous communiquer tous les paramtres (nom de la base, 
identifiant, etc) vous permettant d'y accder.



                             INSTALLATION
                             ============


 L'installation de w-agora dpend lgrement du type de serveur WEB et de base 
de donnes.



                    Instructions rapides d'installation
                    ===================================

   1. Extraire l'archive (tar/gunzip ou winzip) dans votre rpertoire WEB

   2. Positionnez les droits en lecture/criture sur les rpertoires conf/ et 
forums/

   3. Ouvrez la page setup.php[3] dans votre navigateur et suivez les 
instructions.
   


                    Instructions dtailles d'installation
                    ======================================


I. COPIE SUR LE SERVEUR
-----------------------

  1. Si vous disposez d'un accs shell sur votre serveur, vous pouvez 
tlcharger le fichier archive (en mode binaire) et l'extraire directement 
dans un rpertoire sur votre serveur.
  
     o Sous Linux, utilisez par exemple la commande suivante:
       (en supposant que le fichier compress  t tlcharg sous /tmp)
          $ cd /var/www/html/
          $ tar -xzvf /tmp/w-agora-4.1.x.tar.gz

       Cette commande dcompactera l'ensemble dans le rpertoire 
/var/www/html/w-agora

     o Sous windows, utilisez la commande winzip (ou autre).

  2. Si vous ne possdez pas d'accs "shell" sur votre serveur, vous devez 
     - dcompresser l'archive sur votre poste en local  l'aide de la commande 
unzip ou tar (selon le fichier tlcharg)
     - Si vous avez tlcharg w-agora sur un poste sous Windows, il suffit 
d'extraire le fichier .zip ou.tar.gz  l'aide de winzip dans un rpertoire 
temporaire (ex: c:\temp ou c:\w-agora)
     - transfrer par FTP l'ensemble des fichiers et rpertoires dans un 
rpertoire appropri sur votre serveur (ex: html/w-agora). Veillez  
transfrer TOUS les fichiers et rpertoires et  respecter la structure des 
rpertoires.
     - Les fichiers .php, .php3, .inc et .txt et .htm doivent tre transfrs en 
mode ASCII, les fichiers gif et jpeg en mode binaire. Si vous n'tes pas 
familier avec ces techniques, ce n'est pas trs grave, la plupart des 
logiciels de transfert FTP grent tout cela trs bien  votre place.


II. VERIFIER LES PERMISSIONS SUR LES FICHIERS
---------------------------------------------
  
  w-agora est livr au dpart 3 rpertoires vides:

      "w-agora/conf"
      "w-agora/forums"
      "w-agora/forums/agora"
 
 En ralit, ces rpertoires contiennent au dpart un fichier ".htaccess" utilis 
par certains serveurs WEB (apache notamment) pour protger ou modifier les 
proprits d'un rpertoire.

 w-agora utilise par la suite ces rpertoires pour y stocker diffrents fichiers 
(configurations, modles, pices jointes, ...) 
 Si pour une raison quelconque, ces rpertoires n'ont pas t crs dans l'tape 
prcdente (FTP) w-agora tente de les crer dans le processus d'installation. 
Nanmoins il est conseill de les crer manuellement (cas du safe mode 
notamment). Pour cela vous pouvez utiliser votre client FTP (ou ssh/telnet).

 Vous devez vous assurer que le serveur WEB (utilisateur nobody, httpd ou autre) 
est autoris  crire dans ces rpertoires :

  o  Sous linux, utilisez la commande (en supposant que nobody est l'utilisateur 
pour le compte duquel le serveur WEB s'excute)
     # chown -R nobody ./w-agora
         ou
     # chgrp -R nobody w-agora; chmod -R g+w w-agora"
         ou encore (si vous n'avez pas le privilge "root"
     $ chmod -R a+w conf forums forums/agora
   
  o Si vous ne possdez pas un accs shell, utilisez la commande FTP::

     $ ftp ftp.votresiteftp.com
     ftp> cd w-agora
     ftp> mkdir conf
     ftp> quote site chmod 707 conf
     ftp> mkdir forums
     ftp> quote site chmod 707 forums
     ftp> cd forums
     ftp> mkdir agora
     ftp> quote site chmod 707 agora

  o Sur une plate-forme Windows/IIS positionnez les permissions en 
lecture/criture

  o !!! Attention: Si vous utilisez PHP en Safe Mode, Veuillez consulter les 
instructions suivantes.!!!


SAFE MODE 
---------

Le "SAFE MODE" (mode scuris) de PHP autorise l'accs en criture uniquement 
aux rpertoires appartenant au mme utilisateur que le propritaire du script.

Par exemple, si le script "cree_fichier.php" appartient  l'utilisateur 'toto', 
ce script ne pourra crer des fichiers que dans les rpertoires appartenant  
'toto'.

Par contre, tout fichier ou rpertoire cr par un script PHP appartient  celui 
qui excute le script,  savoir : le serveur HTTP. Par exemple si le script 
"cree_fichier.php" (appartenant  l'utilisateur 'toto') cr le rpertoire 
'mon_repertoire', et que le serveur WEB s'excute en tant qu'utilisateur 
'nobody', alors 'mon_repertoire' aura comme propritaire: 'nobody'

Par consquent, en safe mode, ce mme script ne pourra pas crer un fichier dans 
le rpertoire 'mon_repertoire' car 'mon_repertoire' et 'cree_fichier.php' n'ont 
pas le mme propritaire.

La solution consiste  crer manuellement au pralable tous les rpertoires. Les 
rpertoires concerns sont:

  - forums/agora
    
    Pour chaque site '<sitename>' :
    - forums/<sitename>
    - forums/<sitename>/default

    Pour chaque forum '<forumname>' dans '<sitename>'
    - forums/<sitename>/<forumname>
    - forums/<sitename>/<forumname>/notes

Les permissions doivent tre positionnes  "777" ou 707


III. INSTALLATION
-----------------

Dans votre navigateur, ouvrez la page setup.php3 (or setup.php) afin d'installer 
et configurer le programme.

    http://localhost/w-agora/setup.php3
or
    http://www.My_Domain.net/w-agora/setup.php

Remplissez les champs demands dans le formulaire d'installation:


  1. Paramtres de la base de donnes 
  -----------------------------------  
  - Le type de base : actuellement sont supports: mySQL, Oracle8, PostgreSQL et 
Microsoft SQL server.

  - Le nom de la base de donnes (dans le cas d'Oracle il s'agit de 
l'identifiant (SID) ou de l'alias). Cette base doit exister au pralable (voir 
section I - pr-requis). Le nom propos est agora, mais vous pouvez indiquer le 
nom que vous souhaitez. 

  - Le nom et le mot de passe de l'utilisateur utilis par W-Agora pour accder 
 la base de donnes. Il s'agit de l'utilisateur au sens de la base de 
donnes. Celui ci doit tre pralablement cr.

  - Eventuellement le nom et le mot de passe de l'administrateur de la base de 
donnes, utilis par w-Agora pour les tches d'administration (doit avoir 
droit de DELETE et CREATE). Si ces champs ne sont pas renseigns, w-Agora 
utilise l'utilisateur dfini  la ligne prcdente pour toutes les tches.
  
  - Eventuellement, les paramtres d'accs au serveur hbergeant la base de 
donnes : 
	- son nom ou adresse IP (laisser vide si le serveur de base de donnes 
se trouve sur la mme machine que le serveur WEB)
	- ventuellement le port de connexion (laisser en blanc si le port n'est 
pas  renseigner). Ce paramtre n'est gnralement pas utilis et n'a de 
sens que pour mysql et postgres.

  Si vous ne connaissez pas les paramtres d'accs a votre base, contactez 
votre fournisseur d'accs, votre administrateur systme ou votre 
administrateur de base de donnes.

2. Paramtres par dfaut pour les configuration de sites
--------------------------------------------------------

Il s'agit des paramtres par dfaut qui seront utiliss au moment de la 
cration des sites:

  - Le nom du rpertoire dans lequel les fichiers relatifs aux diffrents forums 
seront copis. Ce rpertoire sera cr sous la racine de W-Agora si vous 
indiquez un nom relatif. Vous pouvez galement prciser un rpertoire situ 
endehors de l'arborescence du serveur WEB pour scuriser l'accs  vos 
donnes.  
  Si le nom par dfaut vous convient, passez directement a la suite. 

  -->  Attention: veuillez consulter le paragraphe SAFE MODE  la fin de la 
section II.

  
  - Le moteur de recherche que vous souhaitez utiliser, si celui-ci est install 
et support par w-agora. Par dfaut, les recherches seront effectues 
directement par w-agora dans la base de donnes


3. Donnes utilisateur pour l'administrateur systme
----------------------------------------------------
  w-agora enregistre au dpart un utilisateur ayant tous les droits 
(administrateur systme). Il s'agit de l'utilisateur "admin". Vous pourrez par 
la suite crer d'autres administrateurs ayant les mmes privilges. Par contre 
cet utilisateur ne pourra pas tre supprim.

  - Le nom de l'administrateur (celui qui apparatra dans toute correspondance). 
Attention: Il s'agit du nom et non de l'identifiant. L'identifiant de 
l'administrateur principal est "admin".

  - L'adresse e-mail de l'administrateur. Indiquez une adresse valide (vous
pourrez toutefois la changer plus tard)
  
  - Le mot de passe de l'administrateur (deux fois pour confirmation).


Les renseignements ncessaires  l'initialisation de W-Agora ont maintenant t 
fournis, vous pouvez cliquer sur " install ". W-Agora est install ! Vous devez 
maintenant crer un ou plusieurs sites. Se reporter au paragraphe Cration d'un 
site.


IV. CREATION D'UN SITE :
------------------------

  Un site est un ensemble de forums accds par un ensemble d'utilisateurs.
  Chaque site peut tre install dans sa propre base de donnes et peut tre 
accd par un ensemble d'utilisateurs diffrents. La cration d'un site est 
effectue par le script: create_site.php.

  1. Paramtres gnraux
  ----------------------
  
  Vous devez tout d'abord indiquer :
   - Le nom du site: Il s'agit du nom symbolique utilis par w-agora pour 
accder au site. Il n'apparat que dans les URL, gardez si possible un nom 
aussi court que possible.
   - le titre : description brve du site
   - la description dtaille

  2. Paramtres de la base de donnes 
  -----------------------------------  
  Chaque site pouvant utiliser sa propre base de donnes, w-agora vous redemande 
 nouveau les paramtres de la base de donnes. Vous pouvez indiquer les mmes 
paramtres que prcdemment ou choisir une nouvelle base de donnes (et mme 
un autre moteur de base de donnes). Reportez vous au chapitre III - 
Installation 

  3. Configuration des forums
  ---------------------------
 
   - Le nom du rpertoire dans lequel les fichiers relatifs aux diffrents 
forums seront copis. Ce rpertoire sera cr sous la racine de W-Agora si 
vous indiquez un nom relatif. Vous pouvez galement prciser un rpertoire 
situ en dehors de l'arborescence du serveur WEB pour scuriser l'accs  vos 
donnes.  w-agora crera par la suite dans ce rpertoire un rpertoire pour 
chaque forum.
-->  Attention: veuillez consulter le paragraphe SAFE MODE  la fin de la 
section II.
  
  - Le moteur de recherche que vous souhaitez utiliser, si celui-ci est install 
et support par w-agora. Par dfaut, les recherches seront effectues 
directement dans la base de donnes

  - Le thme par dfaut utilis par les forums que vous crerez par la suite

	
  Une fois le site cr, w-agora vous propose un menu vous permettant de crer 
un autre site, administrer (configurer) ce site ou bien : crer votre premier 
forum.


V. CREATION D'UN FORUM :
------------------------

  La cration d'un forum est effectue par le script: 
  http://localhost/w-agora/create_forum.php3?site=nomdusite

  Suivez les instructions sur cette page.

  Vous pouvez/devez configurer notamment: :

   - Le nom du forum: Il s'agit du nom symbolique utilis par w-agora pour 
accder au forum. Il n'apparat que dans les URL, gardez si possible un nom 
aussi court que possible.
   
   - le titre : description brve du forum

   - la description dtaille de votre forum

   - Le thme utilis pour ce forum: Vous pouvez slectionner le thme par 
dfaut choisi au moment de la cration du site (tape IV) ou bien choir un 
thme spcifique.


   Vous avez franchi toutes les tapes ncessaires  l'utilisation de votre 
premier forum.


VI. UTILISEZ VOTRE FORUM
------------------------
  
  A ce stade, vous pouvez maintenant poster votre premier message dans le forum

  Vous pourrez par la suite crer d'autres sites, catgories et forums, modifier 
l'aspect graphique de vos forums, grer vos utilisateurs, etc...

  Pour accder  l'interface d'administration, utiliser le script admin.php, 
c'est  dire, ouvrez par exemple la page 
http://votre_site.com/w-agora/admin.php



  Merci d'utiliser w-agora. 
  
  o  Vous trouverez les dernires mises  jour sur le site de w-agora
  http://www.w-agora.net

  o Pour tout problme d'installation vous pouvez consulter le forum:
  http://www.w-agora.net/current/index.php?bn=support_install

  o Nous fournissons galement des services d'installation et de personnalisation. 
  N'hsitez pas  nous contacter : services@w-agora.net
