Table des matières

Intro

L'article qui suit a été rédigé de manière à être compris par une grande partie du publique. Cependant, étant donné qu'il contient un bon nombre de commandes destinées à être exécutées sur des systèmes de type *nix, un minimum de connaissance est requis. Notamment les commandes “wget”, “nano”, “edit”… Doivent être connues et comprises, ainsi que les termes tels que “sources” ou encore “packages”…

Qu'est ce qu'UnrealIRCd ?

Histoire

Au départ utilisé pour servir sur le réseau DALnet, UnrealIRCd a commencé à être développé en mai 1999 à partir de DreamForge IRCd. Finalement il ne servira jamais sur ce réseau, qui optera pour l'IRCd Bahamut, un fork de Hybrid.

Cet IRCd est grandement utilisé parmi les réseaux de petite et de moyenne taille notamment francophone.

La dernière version au 20 Novembre 2008 est la 3.2.7. Elle est utilisée sur le réseau Virtual-Info.

– Wikipedia –

Particularités

Ce serveur fonctionne sur Linux, BSD, Mac OS X, Solaris, HP-UX et Windows (95/98/Millennium NT4/2000/XP/2003/Vista).

Il supporte des modules afin de compléter les fonctions de bases, à savoir :

– Wikipedia –

Comment installer UnrealIRCd ?

Comment télécharger les sources?

La manière la plus simple de télécharger la dernière version publique de UnrealIRCd sur un système *nix, est de taper la commande wget get.unrealircd.com sur votre shell. Cette commande téléchargera directement la dernière version des sources.

L'alternative à wget (pour ceux qui n'ont pas accès à cette commande) consiste à télécharger manuellement les sources (En .tar.gz) et de les uploader sur votre serveur.

Décompresser les sources

Là, ça reste simple:

  1. Placez vous dans le dossier contenant les sources
  2. Tapez la commande suivante: tar -zxvf Unreal3.2.7.tar.gz
  3. Placez vous dans le dossier Unreal3.2.7 qui vient juste d'être créée grâce à la commande ”tar
  4. Exécutez la commande pwd ce qui a pour effet de retourner le chemin complet vers le dossier dans lequel vous vous trouvez. Recopiez-le, nous en aurons besoin plus tard.

Configurer le package d'installation

La plupart du temps, avant d'installer une application sur un système de type *nix, il faut toujours configurer les sources. Cela leurs permet de s'adapter au système, de se préparer à l'installation, d'indiquer les disponibilités système, les versions des différents modules, les chemins d'installation… Le tout automatiquement.

Pour configurer le package d'installation de Unreal, rien de plus simple, tapez la commande: ./Config Puis suivez les indications:

  1. Do you want to enable the server anti-spoof protection? ⇒ Je vous conseille de mettre ”Yes
  2. What directory are all the server configuration files in? ⇒ Pour une bonne organisation, mettez le chemin vers les sources, le chemin que vous avez recopiez juste après avoir décompressé les sources (Ex: /home/Unreal3.2.7).
  3. What is the path to the ircd binary including the name of the binary? ⇒ Si ce n'est pas déjà fait, et toujours pour une bonne organisation, remettez la même adresse que pour la question précédente, puis ajoutez ”/src/ircd” à la fin (Ex: /home/Unreal3.2.7/src/ircd)
  4. Would you like to compile as a hub or as a leaf? Type Hub to select hub and Leaf to select leaf. ⇒ Là… Faut faire gaffe, un Hub est un serveur sur lequel tout les autres serveurs se connecteront. Un leaf n'accepte qu'UNE SEULE connexion… Celle d'un HUB. Mettez de préférence ”Hub
  5. What is the hostname of the server running your IRCd? ⇒ Là… C'est votre choix, le host du serveur sur lequel tourne votre ircd. Si vous ne savez pas, remettez l'adresse vers votre serveur IRC, de type ”irc.exemple.com” ou autre si vous êtes sur un serveur mutualisé.
  6. What should the default permissions for your configuration files be? (Set this to 0 to disable) It is strongly recommended that you use 0600 to prevent unwanted reading of the file ⇒ Les réglages par défaut sont sur 0600, il n'est pas conseillé de changer ce paramètre. Passez à la prochaine question.
  7. Do you want to support SSL (Secure Sockets Layer) connections? ⇒ Si vous en avez la possibilité avec votre shell, il est préférable d'accepter et de proposer des connexions sécurisées. Si vous avez les librairies nécessaires, mettez ”Yes”.
  8. Si vous avez mis ”Yes” à la question précédente: If you know the path to OpenSSL on your system, enter it here. If not leave this blank ⇒ Comme indiqué… Laissez vide si vous ne savez pas quoi mettre.
  9. Do you want to enable IPv6 support? ⇒ Si vous voulez activer le support de l'IPv6, mettez ”Yes”.
  10. Do you want to enable ziplinks support? ⇒ Si vous voulez activer la compression des données, mettez ”Yes” Si vous avez mis ”Yes” à la question précédente: If you know the path to zlib on your system, enter it here. If not leave this blank ⇒ Comme indiqué… Laissez vide si vous ne savez pas quoi mettre.
  11. Do you want to enable remote includes? ⇒ Si vous projetez d'utiliser des fichiers de configurations distants (Utiles pour les réseaux IRC), mettez ”Yes” Si vous avez mis ”Yes” à la question précédente: Specify the directory you installed libcurl to ⇒ Cette fois… Vous devez indiquer le dossier d'installation de LibCurl
  12. Do you want to enable prefixes for chanadmin and chanowner? This will give +a the & prefix and ~ for +q (just like +o is @) Supported by the major clients (mIRC, xchat, epic, eggdrop, Klient, PJIRC, irssi, CGI:IRC, etc.) This feature should be enabled/disabled network-wide. ⇒ Nous avons choisi Unreal pour cette fonctionnalité justement. Mettez ”Yes”.

Pour toutes questions suivantes, laissez les options par défaut et appuyez directement sur ”Entrée” à chaque fois.

Compiler les sources

Une fois l'étape de la configuration terminer, il vous faut 'compiler' les sources. Sans entrer dans les détails, c'est la transcription du langage de programmation utilisé par les concepteurs du programme en langage binaire (0 et 1) qui est le seul langage compris par l'ordinateur. Il vous suffit de taper make.

Configurer votre serveur

Maintenant que votre serveur est correctement installer sur votre système, il faut le configurer. C'est cette étape qui vous permettra de choisir le nom de votre serveur, ou bien de créer des accès administrateurs …etc. Tout se passe dans le fichier unrealircd.conf.

[ A compléter ]

Compiler les modules

Si vous voulez ajouter des modules pendant/après l'installation et le démarrage de votre serveur IRC, c'est très simple:

  1. Mettez tout les fichiers “*.c” dans le dossier ”Unreal3.2.7/src/modules”.
  2. Revenez dans le dossier racine de Unreal (Unreal3.2.7/)
  3. Tapez la commande: “make custommodule MODULEFILE=modulename” (En remplaçant “modulename” par le nom du module sans “.c”. Par exemple, pour le module “m_jumpserver”, son fichier s'appelle “m_jumserver.c” et la commande à taper sera: make custommodule MODULEFILE=m_jumpserver.
  4. Ensuite, il suffit d'ajouter la ligne de config qui permettra de lancer le module au démarrage dans le fichier unrealircd.conf: loadmodule “src/modules/modulename.so”; (En remplaçant modulename évidemment…
  5. Demandez a votre IRCd de relire le fichier de config, vu que vous êtes déjà dans le shell et dans le dossier racine de UnrealIRCd, tapez: ./unreal rehash et votre IRCd relira la config, et lancera le(s) nouveau(x) modules.

Site officiel

http://www.unrealircd.com

Documentations

Doc en français: http://www.unrealircd.com/files/docs/unreal32docs.fr.html

Rien ne vaut la version originale: http://www.unrealircd.com/files/docs/unreal32docs.html