anope

- supernets anope source code & configuration
git clone git://git.acid.vegas/anope.git
INSTALL.fr (6911B)
      1 Instructions d'installation d'Anope
      2 -----------------------------------
      3 
      4 1) Installation d'Anope
      5 2) Mettre à jour Anope
      6 3) Configuration de l'IRCd
      7 4) Mettre en route Anope
      8 5) Mettre en place un crontab
      9 
     10 Note : Vous devrez également lire les fichiers README et FAQ !
     11 
     12 1) Installation d'Anope
     13 
     14     NOTE IMPORTANTE : il est déconseillé d'utiliser (et même d'installer)
     15                       Anope en tant que root. Utilisez un utilisateur non
     16                       privilégié. Celui que vous utilisez pour l'IRCd ou
     17 		              un utilisateur dédié suffira.
     18 
     19     La première chose que vous devez faire est d'obtenir le package Anope
     20     (si ce n'est déjà fait). Vous pouvez le trouver ici :
     21 
     22         https://www.anope.org/
     23 
     24     Anope nécessite cmake pour être compilé. Vous pouvez vérifier si CMake
     25     est déjà installé sur votre système avec la commande :
     26 
     27         cmake --version
     28 
     29     Si CMake est installé, vous aurez une ligne qui dit quelque chose comme
     30     "cmake version 2.8.12.2". Si la version est inférieure à 2.4 ou si vous
     31     obtenez une erreur disant que la commande n'a pas été trouvée, vous ne
     32     pourrez pas utiliser CMake à moins de l'installer vous-même dans votre
     33     répertoire home. CMake peut être téléchargé ici :
     34 
     35         https://cmake.org/download/
     36 
     37     Ensuite, décompressez le package dans votre répertoire home, et allez
     38     dans le répértoire qui vient d'être créé.
     39 
     40     Si il y a des modules facultatifs que vous voulez activer comme m_mysql,
     41     exécuter le script 'extras' pour les activer. Si vous ne savez pas, vous
     42     pouvez les activer plus tard.
     43 
     44     Maintenant, tapez ./Config pour lancer le script de configuration. Il
     45     va vous poser quelques questions, et déterminer comment compiler Anope
     46     sur votre système. Si vous ne savez pas comment répondre à une question,
     47     utilisez la valeur par défaut.
     48 
     49     Allez dans le dossier build (cd build) et tapez make et make install.
     50     Ceci va installer tous les fichiers nécessaires dans les dossiers que
     51     vous avez indiqués avec le script Config et régler les permissions des
     52     fichiers. Vous devez vous assurer que le répertoire data n'est pas 
     53     accessible par les autres utilisateurs, car des utilisateurs
     54     malveillants pourraient causer des problèmes sur votre réseau, si les
     55     mots de passe ne sont pas chiffrés, ou lire les mémos de tous les
     56     utilisateurs.
     57 
     58     Allez maintenant dans le répertoire conf (par défaut, ~/services/conf).
     59     Copiez l'exemple de fichier de configuration (example.conf) en
     60     services.conf et ouvrez ce dernier avec votre éditeur de texte favori.
     61     Il contient toutes les directives de configuration qu'Anope va utiliser
     62     en démarrant. Lisez attentivement les instructions contenues dans le
     63     fichier. L'utilisation des valeurs par défaut n'est pas toujours
     64     recommandée, et Anope ne fonctionnera probablement pas !
     65 
     66     Si vous avez besoin d'aide, vous pouvez aller sur le site
     67     https://forum.anope.org/ ou le canal #anope sur irc.anope.org.
     68     Fournissez *l'essemble* des erreurs qui apparaîssent, en plus de
     69     toutes informations utiles, comme les versions de votre OS, du
     70     compilateur utilisé et de la librairie C++. Lisez le fichier README
     71     pour plus d'informations.
     72 
     73 2) Mettre à jour Anope
     74 
     75     Pour mettre à jour Anope, suivez simplement les instructions
     76     d'installation décrites dans la section 1. Prenez garde cependant :
     77 
     78         * IMPORTANT : Sauvegardez vos anciennes bases de données !
     79         * Si vous mettez à jour vers une nouvelle version majeure,
     80           recommencez *toujours* toute votre configuration à partir du
     81           fichier example.conf.
     82 
     83 3) Configuration de l'IRCd
     84 
     85     Les Services agissent comme un serveur IRC avec des pseudo-clients.
     86     Pour les relier à votre réseau, vous aurez besoin de configurer votre
     87     IRCd pour permettre aux services de se connecter.
     88 
     89     La configuration dépend de l'IRCd utilisé, mais vous aurez probablement
     90     besoin d'un bloc link (aussi appelé connect block, ou C:line) et un
     91     U:line (aussi appelé shared block). Assurez-vous que l'IRCd écoute
     92     sur le port donné dans le bloc link.
     93 
     94     Des exemples de configurations de bloc link peuvent être trouvés dans
     95     le fichier example.conf pour certains des IRCd les plus populaires.
     96 
     97     Souvenez-vous de /rehash votre IRCd pour appliquer les changements.
     98 
     99     Vous pouvez également essayer notre créateur de bloc link interactif
    100     situé ici :
    101 
    102         https://www.anope.org/ilm.php
    103 
    104 4) Mettre en route Anope
    105 
    106     Allez dans le répertoire où les fichiers binaires ont été installés
    107     (par défaut, ~/services/bin). Tapez ./services pour lancer Anope.
    108 
    109     S'il y a des erreurs de syntaxe dans le fichier de configuration, elles
    110     seront affichées à l'écran. Corrigez-les jusqu'à ce qu'il n'y en ait
    111     plus. Un démarrage réussi ne générera pas de message.
    112 
    113     Donnez aux services au moins une minute pour se connecter à votre
    114     réseau, car certains IRCds sur certains systèmes peuvent être très
    115     lents pour le processus de liaison. Si rien ne se passe après environ
    116     une minute, il y a probablement un problème de configuration. Essayez
    117     de lancer Anope en mode debug avec ./services -debug -nofork pour voir
    118     toutes les erreurs rencontrées et essayez de les corriger.
    119 
    120     Si vous avez besoin d'aide pour résoudre des erreurs, n'hésitez pas à
    121     vous abonner à la liste de diffusion Anope et d'y poser vos question.
    122     Voir le fichier README pour plus de détails.
    123 
    124 5) Mettre en place un crontab
    125 
    126     Une entrée crontab vous permettra de vérifier périodiquement si Anope
    127     est toujours en cours d'exécution et de le redémarrer s'il n'est pas.
    128 
    129     D'abord renommez le script example.chk qui est dans les dossiers
    130     d'Anope (par défaut, ~/services/conf) en services.chk et modifiez-le.
    131     Vous aurez besoin de modifier la partie CONFIGURATION du fichier.
    132     Assurez-vous ensuite que le fichier est marqué comme exécutable en
    133     tapant chmod +x services.chk et essayez de lancer le script pour voir
    134     si cela fonctionne (Anope ne doit pas être en marche lorsque vous
    135     testez cela ;))
    136 
    137     Lorsque c'est fait, vous devrez ajouter l'entrée crontab. Entrez
    138     crontab -e. Cela va ouvrir l'éditeur de texte par défaut avec le
    139     fichier crontab. Entrez la ligne suivante (avec le chemin correct) :
    140 
    141         */5 * * * * /home/ircd/services/conf/services.chk > /dev/null 2>&1
    142 
    143     Le */5 au début signifie "vérifier toutes les 5 minutes". Vous pouvez
    144     remplacer le 5 par un autre numéro si vous voulez (mais moins de 60).
    145     Consultez les pages de manuel de votre système pour plus de détails sur
    146     la  syntaxe du fichier crontab. Les pages de manuel intéressantes sont
    147     crontab(5), crontab(1) et cron(8).
    148 
    149     Sauvegardez, quittez, et c'est installé !