diff --git a/docs/INSTALL.fr b/docs/INSTALL.fr index 489a3882c..8baa108e8 100644 --- a/docs/INSTALL.fr +++ b/docs/INSTALL.fr @@ -1,209 +1,158 @@ -Installation et instructions d'anope +Instructions d'installation d'Anope ------------------------------------ -1) Instalation d'anope -2) Mise à jour d'anope -3) Configuration de l'ircd -4) Mise en route de anope -5) Mise en place d'un fichier crontab +1) Installation d'Anope +2) Mettre à jour Anope +3) Configuration de l'IRCd +4) Mettre en route Anope +5) Mettre en place un crontab -Note: Vous devrez également lire les fichiers README et FAQ ! +Note : Vous devrez également lire les fichiers README et FAQ ! -1) Installation de anope +1) Installation d'Anope - Note importante: il n'est pas recommandé d'utiliser (et même d'installer) - Anope en tant que root. - Utilisez un utilisateur non privilégié, + NOTE IMPORTANTE : il n'est pas recommandé d'utiliser (et même d'installer) + Anope en tant que root. Utilisez un utilisateur non + privilégié. Celui que vous utilisez pour l'IRCd ou un + utilisateur dédié suffira. + La première chose que vous devez faire est d'obtenir le package Anope (si ce + n'est déjà fait). Vous pouvez le trouver ici : -La première chose que vous devez faire est d'obtenir le package Anope (si ce n'est déjà fait). + http://www.anope.org/ -Vous pouvez le trouver ici http://www.anope.org/ + Anope peut être installé de deux façons. La méthode recommandée est + d'utiliser CMake. Vous pouvez vérifier si CMake est déjà installé + sur votre système en utilisant la commande : + cmake --version + Si CMake est installé, vous aurez une ligne qui dit quelque chose similaire + à "cmake version 2.6 cmake-patch 1". Si la version est inférieure à 2.4 ou + si vous obtenez une erreur disant que la commande n'a pas été trouvée, + vous ne serez pas en mesure d'utiliser CMake, sauf si vous l'installez + vous-même dans votre répertoire home. CMake peut être téléchargé ici : -Anope peut être installer de deux façons. + http://www.cmake.org/cmake/resources/software.html - 1. La méthode recommandée est d'utiliser CMake. - Vous pouvez vérifier si CMake est déjà installé sur votre système en utilisant la + Si vous n'arrivez pas à l'installer (soit en raison du manque d'espace + ou de restrictions par votre fournisseur d'hébergement), vous pouvez encore + utiliser le script de configuration fourni. Cette option n'est pas + recommandée et finira par être retirée, mais est fournie pour la + compatibilité de ceux à qui il manque CMake. - commande: cmake --version ( sur votre vps ou dedier etre loggué en root ) + Ensuite, décompressez le package dans votre répertoire home, et allez dans + le répértoire qui vient d'être créé. + Maintenant, tapez ./Config pour lancer le script de configuration. Il va + vous poser quelques questions, et compiler Anope sur votre système. Si vous + ne savez pas répondre à une question, utilisez la valeur par défaut. La + question d'utiliser CMake ou configure dépend de la décision que vous avez + prise précedemment. Si vous avez CMake et que vous souhaitez l'utiliser, + répondez avec cmake, sinon répondez avec configure. - Si c'est installé, vous aurez une ligne qui dit quelque chose qui ressemble à + Vous pouvez maintenant taper make pour compiler Anope. S'il y'a des erreurs + dans le Makefile, *essayez d'utiliser* gmake à la place. Si cela ne + fonctionne toujours pas, vous (ou votre administrateur système) devriez + installer GNU make. + Vous pouvez le trouver ici : ftp://prep.ai.mit.edu/pub/gnu/. - «version 2.6 cmake-patch 1". + Maintenant, tapez make install (ou gmake install ; voir ci-dessus). Cela + permet d'installer tous les fichiers nécessaires dans les chemins que vous + avez spécifié au script configure, et de régler les permissions des fichiers. + Vous devez vous assurer que le répertoire data n'est pas accessible par les + autres utilisateurs, des utilisateurs malveillants pourraient causer des + problèmes sur votre réseau, si les mots de passe ne sont pas chiffrés, + ou lire les mémos de tout utilisateur. - Si la version est inférieure à 2,4 ou si vous obtenez une erreur disant que la commande n'a pas été trouvé, - vous ne serez pas en mesure d'utiliser CMake, + Si vous voyez des erreurs lors de ce processus, merci de nous envoyer un + e-mail avec la sortie d'erreur *complète* et n'oubliez pas de mentionner + les versions de votre système, compilateur et bibliothèque C++. - sauf si vous installez vous-même dans votre répertoire home. CMake - vous pouvez le téléchargé ici > http://www.cmake.org/cmake/resources/software.html + Allez maintenant dans le répertoire de données (par défaut, ~/services/data). + Copiez l'exemple de fichier de configuration (example.conf) en services.conf + et ouvrez ce dernier avec votre éditeur de texte favori. Il contient toute + les directives de configuration. Anope va l'utiliser au démarrage. + Lisez attentivement les instructions contenues dans le fichier. + L'utilisation des valeurs par défaut n'est pas recommendé et Anope ne + fonctionnera probablement pas. + Si vous avez besoin d'aide, abonnez-vous à la liste de diffusion Anope + et envoyez-y vos e-mails pour obtenir de l'aide de la part des autres + utilisateurs. Voir le fichier README pour plus d'informations. - Si vous n'arrivez pas à installer (soit en raison du manque d'espace - ou de restrictions par votre fournisseur d'hébergement), - vous pouvez encore utiliser le script de configuration fournis. - Cette option n'est pas recommandée et finira par être retiré, mais il est fourni pour la compatibilité de ces - manque de CMake. +2) Mettre à jour Anope + Pour mettre à jour Anope, suivez simplement les instructions d'installation + décrites dans la section 1. Il y a cependant une ligne de conduite + spécifique : + * IMPORTANT : Sauvegardez vos anciennes bases de données ! + * Si vous mettez à jour vers une nouvelle version majeure, toujours + redémarrer avec un fichier de configuration neuf depuis example.conf. - Ensuite, décompressez le package dans votre répertoire home, et allez dans le répértoire - qui viens d'être crée. +3) Configuration de l'IRCd - Maintenant, tapez ./Config pour lancer le script de configuration. Il va vous poser - quelques questions, et compiler Anope sur votre système. + Les Services agissent comme un serveur IRC avec des pseudo-clients. + Pour les relier à votre réseau, vous aurez besoin de configurer votre IRCd + pour permettre aux services de linker. - Si vous ne savez pas repondre à une question, utilisez la valeur par défaut. + La configuration varie selon les IRCd, mais vous aurez probablement besoin + d'un block link (aussi appelé connect block, ou C line), un U line (aussi + appelé shared block) et assurez-vous que l'IRCd écoute sur le port donné + dans le block link. + Des exemples de configurations de link peuvent être trouvés dans le fichier + example.conf pour certains des IRCd les plus populaires. - Vous pouvez maintenant taper make pour compiler Anope. S'il ya des erreurs dans la - Makefile, * essayez d'utiliser * gmake au lieu. Si cela ne fonctionne toujours pas, vous (ou - votre fournisseur ) doit installer GNU make. Vous pouvez - le Trouvez sur ftp://prep.ai.mit.edu/pub/gnu/. + Souvenez-vous de /rehash votre IRCd pour appliquer les changements. - Maintenant, tapez make install (ou gmake install; voir ci-dessus). Cela permet d'installer - tous les fichiers nécessaires dans les chemins que vous avez spécifié dans la configuration - script, et les permissions du fichier de configuration. Vous devez vous assurer que les données - répertoire ne sont pas accessible par d'autres utilisateurs, que des utilisateurs malveillants peuvent - causer des problèmes sur votre réseau, si les mots de passe ne sont pas cryptés, ou de lire - les mémos de tout utilisateur. - - Si vous voyez des erreurs lors de ce processus, s'il vous plaît nous envoyer un mail avec le * complet * - sortie d'erreur, et n'oubliez pas de mentionner votre OS, compilateur et bibliothèque C + + - versions. - - Maintenant, allez dans le répertoire de données (par défaut, cd ~/services/data). ouvrer exemple.conf - avec votre éditeur de texte favori. Il contient toute la configuration - directives. Anope va l'utiliser au démarrage. Lisez attentivement les instructions contenues dans - le fichier. l'utilisation des valeurs par defauld n'est pas recomment et anope ne risque pas de fonctionner - - - Si vous avez besoin d'aide, vous devez vous abonner à la mailing list et par courrier Anope - pour se faire aider par d'autres utilisateurs. Voir le fichier README pour plus de - informations. - -2) Mise à jour Anope - - Si vous avez un fichier .Diff et que vous voulez patcher les ancienne sources Anope avec, - effectuer les opérations suivantes: - - * Copiez le fichier .Diff dans le répertoire racine des sources Anope. - * Type de patch-p1 /dev/nul 2> & 1 + */5 * * * * /home/ircd/services/data/services.chk > /dev/null 2>&1 - Le * / 5 au commencement signifie "vérifier toutes les 5 minutes". Vous pouvez remplacer - le 5 avec un autre numéro si vous voulez (mais moins de 60). Consulter - pages de manuel de votre système pour plus de détails sur la syntaxe de la crontab - fichier. Intéressant pages de manuel sont crontab (5), crontab (1) et cron (8). + Le */5 au début signifie "vérifier toutes les 5 minutes". Vous pouvez + remplacer le 5 par un autre numéro si vous voulez (mais moins de 60). + Consultez pages de manuel de votre système pour plus de détails sur la + syntaxe du fichier crontab. Les pages de manuel intéressantes sont + crontab(5), crontab(1) et cron(8). - Sauvegarder et quitter, et il est installé. \ No newline at end of file + Sauvegardez, quittez et c'est installé.