guide d`installation - W
Transcription
guide d`installation - W
Gestionnaire de forums et de publication sur Internet GUIDE D’INSTALLATION version 4.1.5 1 PREREQUIS 1.1 PHP INSTALLE ET CONFIGURE 1.1.1 PHP est-il correctement installé et configuré? 1.1.2 L’option SAFE MODE 1.2 UN ACCES A UNE BASE DE DONNEES 2 INSTALLATION DE W-AGORA 2.1 2.2 2.3 EXTRACTION DE L’ARCHIVE, COPIE SUR LE SERVEUR POSITIONNEMENT DES DROITS SUR LES FICHIERS INSTALLATION DE W-AGORA : LA PAGE SETUP.PHP 4 4 4 4 5 7 7 8 9 3 CREATION D’UN SITE 11 4 CREATION D’UN FORUM 13 1 Prérequis A vant toute chose, nous vous conseillons de vérifier que vous disposez de tous les éléments nécessaires à l'installation de W-Agora. Ensuite nous expliquerons comment installer l’application sur votre serveur. 1.1PHP installé et configuré Ce chapître vise à vérifier la configuration PHP de votre serveur, à répondre à la question : PHP est-il prêt à héberger W-Agora ? 1.1.1 PHP est-il 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. <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, 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. 1.1.2 L’option SAFE MODE Si PHP est installé avec l'option "SAFE MODE" activée, veuillez consulter les indications ci-dessous. Note : 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. 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. 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. 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: o o o o 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 positionnées à "777" ou 707 Vous trouverez également cette information dans le résultat du script cité plus haut. 1.2Un accès à une base de données Vérifions ici si vous avez un accés à une base de données et si il est configuré correctement : o o Si vous administrez vous même votre serveur : 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 Vous pouvez utiliser une base existante ou en créer une spécifique: Exemple: avec mysql, vous pouvez utiliser la commande: mysqladmin -uuser -ppaswword create agora (Utilisez le nom que vous souhaitez, 'agora' est juste un exemple) o 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). Exemple : Vous pouvez 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 même le serveur, vous devez posséder un accès à une base de données (cf. plus haut). 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. 2 Installation de W-Agora L 'installation de w-agora dépend légèrement du type de serveur WEB et de base de données. Voici les grandes étapes de la procédure d’installation de W-Agora, elles devraient être réalisées sans difficulté. Si vous rencontrez des difficultés, reférez-vous à la description détaillée des instructions d’installation dans les paragraphes suivants. Extraire l'archive (tar/gunzip ou winzip) dans votre répertoire WEB Positionnez les droits en lecture/ecriture sur les répertoires conf/ et forums/ Ouvrez la page setup.php[3] dans votre navigateur et suivez les instructions. 2.1Extraction de l’archive, copie sur le serveur 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. Exemple : Sous Linux, utilisez 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 Sous windows, utilisez la commande winzip (ou autre). 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é) Note : 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). Note : 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. 2.2Positionnement des droits sur les fichiers W-Agora est livré au départ avec 3 répertoires vides: "w-agora/conf" "w-agora/forums" "w-agora/forums/agora" Note : En réalité, ces répertoires contiennent 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 : 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 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 Sur une plateforme Windows/IIS positionnez les permissions en lecture/écriture Note : !!! Si vous utilisez PHP en Safe Mode, Reférez-vous au paragraphe 1.1.2 !!! 2.3Installation de W-Agora : la page setup.php Dans votre navigateur, ouvrez la page setup.php3 (or setup.php) afin d'installer et configurer le programme. Figure 1: Setup.php Remplissez les champs demandés dans le formulaire d'installation: Renseignements concernant la base de données o o o o o o Choisissez le type de la base de données (actuellement sont supportés mySQL, mSQL 2.0, Oracle8, PosgreSQL, Microsoft SQL server 7, Microsoft Access) 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 (cf paragraphe 1.2). Le nom proposé est agora, mais vous pouvez indiquer le nom que vous souhaitez. Les nom et mot de passe de l’utilisateur employé par w-Agora pour se connecter à la base, il s’agit de l’utilisateur au sens de la base de données, celui-ci doit être préalablement créé (cf paragraphe 1.2) Les nom et mot de passe de l’administrateur de la base (si celui-ci est différent de celui employé par w-Agora) 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 Le nom ou adresse IP du serveur hebergeant la base de données (laisser vide si le serveur de base de données se trouve sur la même machine que le serveur WEB) 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. Renseignements concernant la configuration par défaut des sites o 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 o 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 Note : !!! Si vous utilisez PHP en Safe Mode, Reférez-vous au paragraphe 1.1.2 !!! Renseignements concernant l’administrateur w-Agora (admin) 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. Note : Par contre cet utilisateur ne pourra pas être supprimé. o o o 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 (vous pouvez toutefois la changer 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 pouvez maintenant créer un site et dans ce site, un forum. 3 Création d’un site A près avoir installé W-Agora, vous êtes en possession d’un outil d’échange d’informations vierge de toute information! La première chose à faire alors est de créer un site. Dans ce site vous créerez des forums dans lesquels les utilisateurs viendront déposer de l’information. Figure 2: Création d'un site Renseignements concernant le site : • • • Le nom interne du site (nom symbolique dont W-Agora se sert pour l’identification du site). Le titre du site (description brève). Une description plus détaillée du site. Renseignements concernant la base de données Chaque site pouvant utiliser sa propre base de données, w-agora vous demande à nouveau les paramètres de la base de données. Note : 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 paragraphe 2.3 pour plus de détails concernant les paramètres de la base de données. Renseignements concernant la configuration des forums • Le nom du répertoire dans lequel les fichiers relatifs aux différents forums seront copiés. Note : 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. !!! Si vous utilisez PHP en Safe Mode, Reférez-vous au paragraphe 1.1.2 !!! • • 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 modèle sur lequel vous voulez construire le site. Ce modèle servira de modèle à la liste des forums ainsi que de modèle par défaut du site. 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. 4 Création d’un forum V ous n’avez plus qu’à créer un forum, pour cela vous devez fournir divers renseignements comme vous l’avez fait pour la création du site : Figure 3 : Création d'un forum • • • • • • • • • Le nom interne du forum (nom symbolique dont W-Agora se sert pour identification du forum). Le titre du forum (description brève). Une description plus détaillée du forum. Le modèle sur lequel vous voulez construire le forum. « Default » désigne le modèle que vous avez choisi comme modèle par défaut du site lors de la création du site. La catégorie a laquelle appartiendra le forum. Un numéro d’ordre qui servira à ordonner les forums dans la liste d’affichage. Le mode d’accès au forum (public, à enregistrement, restreint ou privé). Si vous voulez que le forum soit modéré ou non. Choisissez le modérateur principal du forum (il est, par la suite, possible de rajouter des modérateurs aux forums). Note : !!! Si vous utilisez PHP en Safe Mode, Reférez-vous au paragraphe 1.1.2 !!! Cliquez sur « créer ce forum » lorsque la page est correctement remplie pour créer le forum. Vous avez franchi toutes les étapes nécesaires à l'utilisation de votre premier forum ! A O archive Oracle · 5 extraire · 7 P B base de données accés et configuration · 5 D PHP configuration · 4 postgres · 5 S droits lecture/écriture · 7 M Microsoft SQL server · 5 Mysql · 5 SAFE MODE · 4 setup · 7, 9 site création · 11