diff --git a/exercice_exemple.tex b/exercice_exemple.tex index ed399f0..d2b83ce 100644 --- a/exercice_exemple.tex +++ b/exercice_exemple.tex @@ -24,6 +24,7 @@ \usepackage{titlesec} \usepackage{fancyhdr} \usepackage{lastpage} +\usepackage{minted} \setlength{\hoffset}{-18pt} \setlength{\oddsidemargin}{0pt} % Marge gauche sur pages impaires @@ -37,31 +38,10 @@ \setlength{\headsep}{10pt} % Entre le haut de page et le texte \setlength{\footskip}{27pt} % Bas de page + séparation \setlength{\textheight}{708pt} % Hauteur de la zone de texte (25cm) - -\definecolor{gray}{rgb}{0.4,0.4,0.4} -\definecolor{darkblue}{rgb}{0.0,0.0,0.6} -\definecolor{cyan}{rgb}{0.0,0.6,0.6} - -\lstset{ - basicstyle=\ttfamily, - columns=fullflexible, - showstringspaces=false, - commentstyle=\color{gray}\upshape -} - -\lstdefinelanguage{XML} -{ - morestring=[b]", - morestring=[s]{>}{<}, - morecomment=[s]{}, - stringstyle=\color{black}, - identifierstyle=\color{darkblue}, - keywordstyle=\color{cyan}, - morekeywords={xmlns,version,type}% list your attributes here -} +\definecolor{bg}{rgb}{0.9,0.9,0.9} % TITRE DU DOCUMENT ! -\title{Corrigé des exercices : création d'un dictionnaire EOLE} +\title{Corrigé des exercices : intégration de ircd-irc2 dans EOLE} %\date{} @@ -92,7 +72,7 @@ Créé un fichier en suivant les conventions suivantes : Créer le fichier 00\_ircd.xml avec la structure de base suivante : -\begin{lstlisting}[language=XML] +\begin{minted}[bgcolor=bg]{xml} @@ -109,23 +89,23 @@ Créer le fichier 00\_ircd.xml avec la structure de base suivante : -\end{lstlisting} +\end{minted} \chapter{Installation du paquet et gestion du service} Le logiciel doit s'installer à l'instanciation du serveur et le service doit être géré par EOLE : -\begin{lstlisting} +\begin{minted}{xml} -\end{lstlisting} -\begin{lstlisting}[language=XML] +\end{minted} +\begin{minted}[bgcolor=bg]{xml} ircd-irc2 ircd-irc2 -\end{lstlisting} -\begin{lstlisting} +\end{minted} +\begin{minted}{xml} @@ -138,23 +118,23 @@ Le logiciel doit s'installer à l'instanciation du serveur et le service doit ê -\end{lstlisting} +\end{minted} \chapter{Ouverture du firewall et tcpwrapper} -\begin{lstlisting} +\begin{minted}{xml} ircd-irc2 ircd-irc2 -\end{lstlisting} -\begin{lstlisting}[language=XML] +\end{minted} +\begin{minted}[bgcolor=bg]{xml} ircd_port -\end{lstlisting} -\begin{lstlisting} +\end{minted} +\begin{minted}{xml} @@ -167,13 +147,13 @@ Le logiciel doit s'installer à l'instanciation du serveur et le service doit ê -\end{lstlisting} +\end{minted} \chapter{Activation/désactivation du service} Ajouter une variable pour activer/désactiver le service : -\begin{lstlisting} +\begin{minted}{xml} @@ -186,15 +166,16 @@ Ajouter une variable pour activer/désactiver le service : -\end{lstlisting} -\begin{lstlisting}[language=XML] +\end{minted} +\begin{minted}[bgcolor=bg]{xml} - + oui -\end{lstlisting} -\begin{lstlisting} +\end{minted} +\begin{minted}{xml} @@ -204,13 +185,13 @@ Ajouter une variable pour activer/désactiver le service : -\end{lstlisting} +\end{minted} \chapter{Ajout du template} Le fichier de configuration du service doit être "templatiser" par EOLE : -\begin{lstlisting} +\begin{minted}{xml} @@ -220,16 +201,17 @@ Le fichier de configuration du service doit être "templatiser" par EOLE : ircd_port -\end{lstlisting} -\begin{lstlisting}[language=XML] +\end{minted} +\begin{minted}[bgcolor=bg]{xml} -\end{lstlisting} -\begin{lstlisting} +\end{minted} +\begin{minted}{xml} - + oui @@ -242,13 +224,13 @@ Le fichier de configuration du service doit être "templatiser" par EOLE : -\end{lstlisting} +\end{minted} \chapter{Ajout des variables} Dans le template nous allons utiliser des variables définis dans le dictionnaire. Nous allons ajouter les variable pour configurer les M line et les K line : -\begin{lstlisting} +\begin{minted}{xml} @@ -263,34 +245,32 @@ Dans le template nous allons utiliser des variables définis dans le dictionnair - - oui - - -\end{lstlisting} -\begin{lstlisting}[language=XML] - - + oui +\end{minted} +\begin{minted}[bgcolor=bg]{xml} - + description="Nom de domaine utilisé pour accéder au serveur IRC"/> + + mode='expert'> 6667 + description="Hote banni sur le serveur IRC" multi="True" + mandatory="True"/> + description="Motif du bannissement du serveur IRC"> Vous êtes banni, contacter votre administrateur -\end{lstlisting} -\begin{lstlisting} +\end{minted} +\begin{minted}{xml} @@ -300,90 +280,88 @@ Dans le template nous allons utiliser des variables définis dans le dictionnair -\end{lstlisting} +\end{minted} \chapter{Désactivation des éléments} Si "activer\_ircd" est à "non" le service ne devrait plus être démarré, la famille ne doit plus être accessible et le fichier de configuration ne doit plus être généré : -\begin{lstlisting} +\begin{minted}{xml} ircd-irc2 -\end{lstlisting} -\begin{lstlisting}[language=XML] +\end{minted} +\begin{minted}[bgcolor=bg]{xml} ircd-irc2 -\end{lstlisting} -\begin{lstlisting} +\end{minted} +\begin{minted}{xml} ircd_port -\end{lstlisting} -\begin{lstlisting}[language=XML] +\end{minted} +\begin{minted}[bgcolor=bg]{xml} -\end{lstlisting} -\begin{lstlisting} +\end{minted} +\begin{minted}{xml} - - oui - - - - + oui - + description="Nom de domaine utilisé pour accéder au serveur IRC"/> + + mode='expert'> 6667 + description="Hote banni sur le serveur IRC" multi="True" + mandatory="True"/> + description="Motif du bannissement du serveur IRC"> Vous êtes banni, contacter votre administrateur -\end{lstlisting} -\begin{lstlisting}[language=XML] +\end{minted} +\begin{minted}[bgcolor=bg]{xml} non ircd ircd ircd -\end{lstlisting} -\begin{lstlisting} +\end{minted} +\begin{minted}{xml} -\end{lstlisting} +\end{minted} -\chapter{Test} +\chapter{Test du dictionnaire} Lancer gen\_config.Dans l'onglet service tester si l'onglet "Ircd" disparait bien si "Activer le serveur IRC" est à "non" et réapparait si la valeur est à "oui". Renseigner la valeur de la variable "Nom de domaine utilisé pour accéder au serveur IRC" à "localhost.localdomaine". -\chapter{Aide} +\chapter{Ajout d'aide à la variable d'activation} Ajouter de l'aide sur la variable activer\_ircd : -\begin{lstlisting} +\begin{minted}{xml} @@ -398,22 +376,25 @@ Ajouter de l'aide sur la variable activer\_ircd : - + oui - + description="Nom de domaine utilisé pour accéder au serveur IRC"/> + + mode='expert'> 6667 + description="Hote banni sur le serveur IRC" multi="True" + mandatory="True"/> + description="Motif du bannissement du serveur IRC"> Vous êtes banni, contacter votre administrateur @@ -430,14 +411,120 @@ Ajouter de l'aide sur la variable activer\_ircd : -\end{lstlisting} -\begin{lstlisting}[language=XML] +\end{minted} +\begin{minted}[bgcolor=bg]{xml} Cette variable permet d'activer un serveur IRC -\end{lstlisting} -\begin{lstlisting} +\end{minted} +\begin{minted}{xml} -\end{lstlisting} +\end{minted} + +\chapter{Création du template} + +Si le variable pour activer le serveur est maintenant bien présente, le service n'est toujours pas fonctionnel. +En effet, il faut configurer l'application avec les informations fournis par l'utilisateur. + +Pour cela, nous allons créé le template /usr/share/eole/creole/distrib/ircd.conf : + +\begin{otherlanguage}{english} +\begin{minted}{cpp} +# This is ircd's config-file. Look at +# /usr/share/doc/ircd-irc2/ircd.conf.example.gz and +# and /usr/share/doc/ircd-irc2/INSTALL.* for more detailled information +# and instructions + +# A-Line +A:Default:Default file:Welcome::ExampleNet + +# Y-Lines +Y:1:90::100:512000:5.5:100.100 +Y:2:90::300:512000:5.5:250.250 + +# I-Line +I:*:::0:1 +I:127.0.0.1/32:::0:1 + +# P-Line +P::::6667: +\end{minted} +\end{otherlanguage} + +\chapter{Configuration général du service} + +L'utilisateur a renseigner un domaine, un label et un port pour IRCD. Il faut maintenant en tenir compte : +\begin{otherlanguage}{english} +\begin{minted}{cpp} +# This is ircd's config-file. Look at +# /usr/share/doc/ircd-irc2/ircd.conf.example.gz and +# and /usr/share/doc/ircd-irc2/INSTALL.* for more detailled information +# and instructions +\end{minted} +\begin{minted}[bgcolor=bg]{cpp} +# M-Line +M:%%ircd_domaine::%%ircd_libelle:%%ircd_port:000A +\end{minted} +\begin{minted}{cpp} +# A-Line +A:Default:Default file:Welcome::ExampleNet + +# Y-Lines +Y:1:90::100:512000:5.5:100.100 +Y:2:90::300:512000:5.5:250.250 + +# I-Line +I:*:::0:1 +I:127.0.0.1/32:::0:1 + +# P-Line +P::::6667: +\end{minted} +\end{otherlanguage} + + +\chapter{Ajout des bannissements} + +L'administrateur a la possibilité d'ajouté plusieurs lignes de bannissement. Il est donc nécessaire de récupérer les informations avec une boucle : + +\begin{otherlanguage}{english} +\begin{minted}{cpp} +# This is ircd's config-file. Look at +# /usr/share/doc/ircd-irc2/ircd.conf.example.gz and +# and /usr/share/doc/ircd-irc2/INSTALL.* for more detailled information +# and instructions +# M-Line +M:%%ircd_domaine::%%ircd_libelle:%%ircd_port:000A +%for %%hostname in %%ircd_banned_hostname +\end{minted} +\begin{minted}[bgcolor=bg]{cpp} +# K-Line +K:%%hostname:%%hostname.ircd_banned_comment:*:0: +%end for +\end{minted} +\begin{minted}{cpp} +# A-Line +A:Default:Default file:Welcome::ExampleNet + +# Y-Lines +Y:1:90::100:512000:5.5:100.100 +Y:2:90::300:512000:5.5:250.250 + +# I-Line +I:*:::0:1 +I:127.0.0.1/32:::0:1 + +# P-Line +P::::6667: +\end{minted} +\end{otherlanguage} + +\chapter{Configuration et démarrage le service} + +Il est maintenant possible de vérifier le fonctionnement du service. + +Le service doit être démarré après le reconfigure si on active IRCD. + +Le service doit être arrêté après le reconfigure si on désactive IRCD. \end{document}