$Id: INSTALL_fr.txt,v 1.2 2002/10/20 19:37:11 mdruilhe Exp $ ====================================================================== Guide d'installation de w-agora 4.1 ====================================================================== PREREQUIS ========= Avant toute chose, nous vous conseillons de v�rifier que vous disposez de tous les �l�ments n�cessaires ą 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 v�rifier par vous męme ą l'aide du script ci-dessous. Copiez-collez les lignes suivantes dans votre editeur de texte et sauvegardez dans un fichier appel� info.php ou info.php3. "; phpinfo(); exit ?> PHP n'est pas install� ou n'est pas configur� pour cette extension de fichier Ensuite, transf�rer 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" activ�e, 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'acces si PHP est install� en Safe mode ou non. Vous trouverez �galement cette information dans le r�sultat du script cit� plus haut. II. Un accŁs ą une base de donn�es ---------------------------------- --> Si vous administrez vous męme votre serveur : 1. Vous devez avoir accŁs ą un de ces serveurs de base de donn�es : - mysql - postgres (6 ou 7) - Oracle 8 - Microsoft SQL server 7 ou 2000 2. Vous pouvez utiliser une base existante ou cr�er une base de donn�es sp�cifique: 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 comamnde: GRANT select, insert, update, create, alter, delete, drop ON database.* TO utilisateur@localhost IDENTIFIED BY 'motdepasse'; --> Si vous n'administrez pas vous męme le serveur, vous devez poss�der un accŁs ą une base de donn�es (cf. 1.). Dans ce cas votre h�bergeur doit vous fournir l'accŁs ą une base et vous communiquer tous les paramŁtres (nom de la base, identifiant, etc) vous permettant d'y acc�der. INSTALLATION ============ L'installation de w-agora d�pend l�gŁrement du type de serveur WEB et de base de donn�es. Instructions rapides d'installation =================================== 1. Extraire l'archive (tar/gunzip ou winzip) dans votre r�pertoire WEB 2. Positionnez les droits en lecture/ecriture sur les r�pertoires conf/ et forums/ 3. Ouvrez la page setup.php[3] dans votre navigateur et suivez les instructions. Instructions d�taill�es d'installation ====================================== I. COPIE SUR LE SERVEUR ----------------------- 1. Si vous disposez d'un accŁs shell sur votre serveur, vous pouvez t�l�charger le fichier archive (en mode binaire) et l'extraire directement dans un r�pertoire sur votre serveur. o Sous Linux, utilisez par exemple la commande suivante: (en supposant que le fichier compress� ą �t� t�l�charg� sous /tmp) $ cd /var/www/html/ $ tar -xzvf /tmp/w-agora-4.1.x.tar.gz Cette commande d�compactera l'ensemble dans le r�pertoire /var/www/html/w-agora o Sous windows, utilisez la commande winzip (ou autre). 2. Si vous ne poss�dez pas d'accŁs "shell" sur votre serveur, vous devez - d�compresser l'archive sur votre poste en local ą l'aide de la commande unzip ou tar (selon le fichier t�l�charg�) - Si vous avez t�l�charg� w-agora sur un poste sous Windows, il suffit d'extraire le fichier .zip ou.tar.gz ą l'aide de winzip dans un r�pertoire temporaire (ex: c:\temp ou c:\w-agora) - transf�rer par FTP l'ensemble des fichiers et r�pertoires dans un r�pertoire appropri� sur votre serveur (ex: html/w-agora). Veillez ą transf�rer TOUS les fichiers et r�pertoires et ą respecter la structure des r�pertoires. - Les fichiers .php, .php3, .inc et .txt et .htm doivent etre transf�r�s en mode ASCII, les fichiers gif et jpegs en mode binaire. Si vous n'ętes pas familier avec ces techniques, ce n'est pas trŁs grave, la plupart des logiciels de transfert FTP gŁrent tout cela trŁs bien ą votre place. II. VERIFIER LES PERMISSIONS SUR LES FICHIERS --------------------------------------------- w-agora est livr� au d�part 3 r�pertoires vides: "w-agora/conf" "w-agora/forums" "w-agora/forums/agora" En r�alit�, ces r�pertoires contiennet au d�part un fichier ".htaccess" utilis� par certains serveurs WEB (apache notamment) pour prot�ger ou modifier les propri�t�s d'un r�pertoire. w-agora utilise par la suite ces r�pertoires pour y stocker diff�rents fichiers (configurations, modŁles, piŁces jointes, ...) Si pour une raison quelconque, ces r�pertoires n'ont pas �t� cr��s dans l'�tape pr�c�dente (FTP) w-agora tente de les cr�er dans le processus d'installation. N�anmoins il est conseill� de les cr�er 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 r�pertoires : o Sous linux, utilisez la commande (en supposant que nobody est l'utilisateur pour le compte duquel le serveur WEB s'ex�cute) # 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 privilŁge "root" $ chmod -R a+w conf forums forums/agora o Si vous ne poss�dez pas un accŁs 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 plateforme 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 s�curis�) de PHP autorise l'accŁs en �criture uniquement aux r�pertoires appartenant au męme utilisateur que le propri�taire du script. Par exemple, si le script "cree_fichier.php" appartient ą l'utilisateur 'toto', ce script ne pourra cr�er des fichiers que dans les r�pertoires appartenant ą 'toto'. Par contre, tout fichier ou r�pertoire cr�� par un script PHP appartient ą celui qui ex�cute le script, ą savoir : le serveur HTTP. Par exemple si le script "cree_fichier.php" (appartenant ą l'utilisateur 'toto') cr�� le r�pertoire 'mon_repertoire', et que le serveur WEB s'�x�cute en tant qu'utilisateur 'nobody', alors 'mon_repertoire' aura comme propri�taire: 'nobody' Par cons�quent, en safe mode, ce męme script ne pourra pas cr�er un fichier dans le r�pertoire 'mon_repertoire' car 'mon_repertoire' et 'cree_fichier.php' n'ont pas le męme propri�taire. La solution consiste ą cr�er manuellement au pr�alable tous les r�pertoires. Les r�pertoires concern�s sont: - forums/agora Pour chaque site '' : - forums/ - forums//default Pour chaque forum '' dans '' - forums// - forums///notes Les permissions doivent ętre positionn�es ą "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 demand�s dans le formulaire d'installation: 1. ParamŁtres de la base de donn�es ----------------------------------- - Le type de base : actuellement sont support�s: mySQL, Oracle8, PosgreSQL et Microsoft SQL server. - Le nom de la base de donn�es (dans le cas d'Oracle il s'agit de l'identifiant (SID) ou de l'alias). Cette base doit exister au pr�alable (voir section I - prerequis). 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 acc�der ą la base de donn�es. Il s'agit de l'utilisateur au sens de la base de donn�es. Celui ci doit ętre pr�lablement cr��. - Eventuellement le nom et le mot de passe de l'administrateur de la base de donn�es, utilis� par w-Agora pour les t�ches d'administration (doit avoir droit de DELETE et CREATE). Si ces champs ne sont pas renseign�s, w-Agora utilise l'utilisateur d�fini ą la ligne pr�c�dente pour toutes les t�ches. - Eventuellement, les paramŁtres d'accŁs au serveur h�bergeant la base de donn�es : - son nom ou adresse IP (laisser vide si le serveur de base de donn�es se trouve sur la męme machine que le serveur WEB) - �ventuellement le port de connexion (laisser en blanc si le port n'est pas ą renseigner). Ce paramŁtre n'est g�n�ralement pas utilis� et n'a de sens que pour mysql et postgres. Si vous ne connaisssez pas les paramŁtres d'accŁs a votre base, contactez votre fournisseur d'accŁs, votre administrateur systŁme ou votre administrateur de base de donn�es. 2. ParamŁtres par d�faut pour les configuration de sites -------------------------------------------------------- Il s'agit des paramŁtres par d�faut qui seront utilis�s qu moement de la cr�ation des sites: - Le nom du r�pertoire dans lequel les fichiers relatifs aux diff�rents forums seront copi�s. Ce r�pertoire sera cr�� sous la racine de W-Agora si vous indiquez un nom relatif. Vous pouvez �galement pr�ciser un r�pertoire situ� endehors de l'arborescence du serveur WEB pour s�curiser l'accŁs ą vos donn�es. Si le nom par d�faut 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 d�faut, les recherches seront effectu�es directement par w-agora dans la base de donn�es 3. Donn�es utilisateur pour l'administrateur systŁme ---------------------------------------------------- w-agora enregistre au d�part un utilisateur ayant tous les droits (administrateur systŁme). Il s'agit de l'utilisateur "admin". Vous pourrez par la suite cr�er d'autres administrateurs ayant les męmes privilŁges. Par contre cet utilisateur ne pourra pas ętre supprim�. - Le nom de l'administrateur (celui qui appara�tra 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 (vou spouvez toutefois la chnager plus tard) - Le mot de passe de l'administrateur (deux fois pour confirmation). Les renseignements n�cessaires ą l'initialisation de W-Agora ont maintenant �t� fournis, vous pouvez cliquer sur " install ". W-Agora est install� ! Vous devez maintenant cr�er un ou plusieurs sites. Se reporter au paragraphe Cr�ation d'un site. IV. CREATION D'UN SITE : ------------------------ Un site est un ensemble de forums acc�d�s par un enesemeble d'utilisateurs. Chaque site peut ętre install� dans sa propre base de donn�es et peut ętre acc�d� par un ensemble d'utilisateurs diff�rents. La cr�ation d'un site est effect�e par le script: create_site.php. 1. Parametres g�n�raux ---------------------- Vous devez tout d'abord indiquer : - Le nom du site: Il s'agit du nom symbolique utilis� par w-agora pour acc�der au site. Il n'apparait que dans les URL, gardez si possible un nom aussi court que possible. - le titre : description brŁve du site - la description d�taill�e 2. ParamŁtres de la base de donn�es ----------------------------------- Chaque site pouvant utiliser sa propre base de donn�es, w-agora vous redemande ą nouveau les paramŁtres de la base de donn�es. Vous pouvez indiquer les męmes paramŁtres que pr�c�demment ou choisir une nouvelle base de donn�es (et męme un autre moteur de base de donn�es). Reportez vous au chapitre III - Installation 3. Configuration des forums --------------------------- - Le nom du r�pertoire dans lequel les fichiers relatifs aux diff�rents forums seront copi�s. Ce r�pertoire sera cr�� sous la racine de W-Agora si vous indiquez un nom relatif. Vous pouvez �galement pr�ciser un r�pertoire situ� en dehors de l'arborescence du serveur WEB pour s�curiser l'accŁs ą vos donn�es. w-agora cr�era par la suite dans ce r�pertoire un r�pertoire 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 d�faut, les recherches seront effectu�es directement dans la base de donn�es - Le theme par d�faut utilis� par les forums que vous cr�erez par la suite Une fois le site cr��, w-agora vous propose un menu vous permettant de cr�er un autre site, administrer (configurer) ce site ou bien : cr�er votre premier forum. V. CREATION D'UN FORUM : ------------------------ La cr�ation d'un forum est effctu�e 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 acc�der au forum. Il n'apparait que dans les URL, gardez si possible un nom aussi court que possible. - le titre : description brŁve du forum - la description d�taill�e de votre forum - Le thŁme utilis� pour ce forum: Vous pouvez s�l�ctionner le thŁme par d�faut choisi au moment de la cr�ation du site (�tape IV) ou bien choir un thŁme sp�cifique. Vous avez franchi toutes les �tapes n�cesaires ą 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 cr�er d'autres sites, cat�gories et forums, modifier l'aspect graphique de vos forums, g�rer vos utilisateurs, etc... Pour acc�der ą 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 derniŁres mises ą jour sur le site de w-agora http://www.w-agora.net o Pour tout problŁme 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'h�sitez pas ą nous contacter : [e-mail]