RT installation name
Les commandes précédées de "$" signifient que vous devez exécuter la commande en tant qu'utilisateur général - et non en tant qu'utilisateur root.
Les commandes précédées de "#" signifient que vous devez travailler en tant qu'utilisateur root.
Les commandes comportant des lignes de commande plus spécifiques (par exemple "RTR-GW>" ou "mysql>") signifient que vous exécutez des commandes sur des équipements à distance, ou dans un autre programme.
Si une ligne de commande se termine par "", ceci signifie que la commande se poursuit sur la ligne suivante et que vous devez la traiter comme une seule ligne.
Ouvrez une session sur votre PC ou ouvrez une fenêtre de terminal en tant qu'utilisateur sysadm.
Installez les paquets nécessaires pour la RT. mysql-server devrait en principe déjà être être installé, mais nous allons l'installer au cas où. Ceci ne causera pas de problème.
Copiez les lignes "apt-get install" ci-dessous, en entier, y compris le caractère \ (sauf le $ initial), et collez les dans votre session de terminal sur votre machine virtuelle:
$ sudo apt-get install rt4-apache2 rt4-clients rt4-db-mysql \
request-tracker4 libapache2-mod-fastcgi libfcgi-perl muttRépondez "Oui" au message vous invitant à installer les paquets.
Plusieurs fenêtres vont maintenant s'afficher successivement. Lisez les instructions suivantes pour savoir comment procéder :
Name for this Request Tracker (RT) instance:
Supprimez ce qui est affiché, et remplaer par "netmgmt", puis choisissez <Ok> puis ENTREE pour continuer.
RT installation name
Handle RT_SiteConfig.pm permissions?
Configure database for request-tracker4 with dbconfig-common?
DB configuration
Password of the database's administrative user:
Saisir le mot de passe de MySQL root (ou admin). Ceci a été configurée plus tôt dans l'atelier - au moment de Cacti. Si vous ne savez pas de quoi il s'agit, demandez à votre instructeur.
DB admin password
MySQL application password for request-tracker4:
Choisissez le mot de passe que vous voulez. Ceci sera utilisé par Request Tracker pour la connexion à MySQL. Vous n'avez pas besoin de vous souvenir de ce mot de passe. Choisissez quelque chose qui ne peut pas être deviné facilement (c'est à dire autre chose que rt, requesttracker, 1234, etc.)
DB application password
Password confirmation:
Entrez de nouveau le même mot de passe.
DB application password
Initial root password for RT system:
Initial root password
Vous verrez un bon nombre de lignes défiler sur l'écran pendant que l'installation de Request Tracker se termine. C'est un gros paquetage.
A ce stade vous avez installé Request Tracker version 4. Pour accéder à la RT via le serveur web Apache, vous devez effectuer une petite modification.
$ cd /etc/apache2/conf.d
$ sudo ln -s /etc/request-tracker4/apache2-fastcgi.conf .
$ sudo a2enmod fastcgi
$ sudo service apache2 restartLa dernière étape peut prendre 30 secondes - soyez patient!
RT devrait maintenant fonctionner sur votre machine.
Se loger en tant que l'utilisateur RT root
Si vous ouvrez le lien http://pcN.ws.nsrc.org/rt/ vous verrez l'écran d'accueil de RT:
Login screen
Entrez les informations suivantes pour vous connecter en tant que root sur RT:
Username: root
Password: [CHOISI À L'INSTALLATION]
Configuration de RT : Création d'un utilisateur
Maintenant que vous êtes loggé sur RT, nous allons créer un nouvel utilisateur pour le reste de ces travaux pratiques.
En haut de l'écran de configuration choisir Tool => Configuration => Users, puis sur Create dans le lien du menu.
Create User
La boîte de dialogue suivante s'affiche à l'écran. Remplissez les champs, et vérifiez que la case "Let this user be granted rights" (accorder des droits à cet utilisateur) est cochée. Pour l'email, utiliser sysadm@pcX.ws.nsrc.org (X = votre PC)
User creation form
Utilisez pour sysadm le même mot de passe que celui que vous utilisez en classe. Veillez à bien cocher la case "Let this user be granted rights" (accorder des droits à cet utilisateur). Faites ensuite défiler la page vers le bas et cliquez sur le bouton Create (créer) en bas à droite. Vous devriez voir ceci :
User created
Configuration de RT : Création d'un groupe
Create group
Create group form
Vous devriez obtenir le résultat suivant (page suivante) :
Group created
Group members
Add member
Member added
Configuration de RT : Création d'une nouvelle file d'attente
Create queue
Queue Name: net
Description: Problèmes de Réseau
Subject Tag: RT: NET
Reply Address: net@pcX.ws.nsrc.org
Comment Address: net-comment@pcX.ws.nsrc.org
Queue create form
Note: Remplacer pcX avec le numéro de votre machine.
Vous devriez voir ceci:
Queue created
Configuration de RT : Attribution de droits à notre groupe sur la file d'attente
Dans le menu en haut, sélectionner: Tools => Configuration => Queue => Select
Vous devriez voir:
Enabled Queues
Group rights
La page suivante devrait ressembler à ceci:
Group rights overview
Remarquez les trois catégories:
General rights, Rights for Staff, Rights for Administrators
Nous voulons donner des droits à Everyone (toutes les personnes qui ne sont pas encore connues de RT - mais seulement le strict minimum).
Ceux-si sont sous la catégorie General Rights, et sont les suivants:
(CreateTicket)(ReplyToTicket)(SeeQueue)(ShowTicket)Donc commencer par sélectionner ces 4 privilèges en cochant les 4 cases dans votre navigateur.
Remarquez que Everyone à gauche est déjà sélectionné.
Modify group rights
Maintenant, cliquez sur Save Changes (en bas à droite) pour vous assurer que les changements ont été sauvegardés.
Saved rights
Toujours sur la même page, nous allons maintenant donner des permissions (tous) au groupe netmgmt...
Pour faire ceci, commencer par taper le nom du group dans le champ ADD GROUP en bas à gauche:
Add rights to group
Maintenant, cochez toutes les cases dans les catégories General Rights, Rights for Staff, Rights for Administrators.
All rights selected
Une fois que c'est fait, appuyer sur le bouton Save Changes en bas à droite de la page.
N'oubliez pas de sauvegarder les permissions de groupes Modify Group Rights après avoir sélectionné les nouvelles permissions. Une fois que vous avez cliqué sur Modify Group Rights, vous verrez:
Rights granted
Configuration de RT : Connexion en tant que sysadm
Fermez la session RT (menu en haut, choisir l'élément Logged in as root => Logout)
Logging out
Now log back in as the sysadm user you have created: Maintenant re-connectez vous en tant que sysadm (l'utilisateur que vous avez créé).
Logging in as sysadm
Vous devriez voir la chose suivante:
Main page view for sysadm
A ce stade, RT a été correctement configuré pour sa mise en route. Nous devons maintenant configurer correctement la messagerie pour communiquer avec notre nouvelle file d'attente "net" dans RT.
Configuration de RT : Messagerie
RT utilisera l'agent MTA (agent de transfert de messagerie) de votre choix. Dans notre cas, nous utilisons Postfix configuré pour opérer comme un MTA de "site Internet" – c.-à-d. pour acheminer le courrier localement et à distance à l'aide du protocole SMTP.
Modifiez le fichier /etc/aliases
$ sudo editor /etc/aliasesAjouter les deux lignes suivantes à la fin du fichier (par copier-coller !) :
net-comment: "|/usr/bin/rt-mailgate --queue net --action comment --url http://localhost/rt/"
net: "|/usr/bin/rt-mailgate --queue net --action correspond --url http://localhost/rt/"Enregistrez le fichier et quittez. Certains éditeurs risquent de couper les lignes ci-dessus et en faire plusieurs lignes. Assurez-vous de n'avoir que deux lignes dans /etc/aliases après avoir copié le texte ci-dessus.
Maintenant lancez la commande
$ sudo newaliasesConfiguration de RT: Création d'un e-mail et de tickets
Vous allez créer un e-mail et l'envoyer à la file d'attente "net" de RT. Effectuez cette opération en tant qu'utilisateur sysadm (pas en tant que root !) :
Si vous êtes logué en tant que root :
# su - sysadm
$ echo "Probleme avec mon routeur" | mail -s "Probleme de routeur" net@pcX.ws.nsrc.orgN'oubliez pas de remplacer pcX avec le nom de votre serveur.
Vérifiez maintenant que vous avez reçu un mail :
$ muttVous devriez voir un e-mail de Request Tracker accusant réception de la création de votre ticket.
Le mail devrait ressembler à ceci:
Date: Fri, 9 Nov 2012 00:29:27 +0000
From: Network Problems via RT <net@pcX.ws.nsrc.org>
To: sysadm@pcX.ws.nsrc.org
Subject: [Request Tracker: NET #1] AutoReply: Probleme de routeur
Greetings,
This message has been automatically generated in response to the
creation of a trouble ticket regarding:
"Probleme de routeur",
a summary of which appears below.
There is no need to reply to this message right now. Your ticket has been
assigned an ID of [Request Tracker: NET #1].
Please include the string:
[Request Tracker: NET #1]
in the subject line of all future correspondence about this issue. To do so,
you may reply to this message.
Thank you,
net@pcX.ws.nsrc.orgDans le cas contraire, procédez comme indiqué puis envoyez à nouveau l'e-mail :
$ sudo touch /var/mail/sysadm
$ sudo chown sysadm:mail /var/mail/sysadmConfiguration de RT : Visualisation, réponse, résolution et réouverture de tickets dans Request Tracker
Revenez dans votre navigateur web à l'endroit où vous avez ouvert une session RT en tant qu'utilisateur sysadm, puis cliquez sur Home dans le menu (en haut à gauche).
Vous devriez voir une vue mise à jour du ticket actuel:
Main page - ticket overview
Maintenant, cliquez sur le sujet du ticket.
Vous verrez un tas d'informations concernant le ticket. Faites défiler la page jusqu'au bas
Vous pouvez ici répondre Reply au ticket :
Display ticket
Saisissez une réponse ; changez le Status du ticket sur Resolved (résolu) - en haut à droite, il y a un menu pour ceci, puis cliquez sur Update Ticket (en bas à droite, "mise à jour du ticket").
Replying to ticket
Vous devriez obtenir ceci :
Reply sent
Le ticket est actuellement "résolu", mais vous pouvez à tout moment le rouvrir via l'interface web de RT ou le ticket sera rouvert si son créateur initial (dans ce cas sysadm) répond à l'e-mail que vous venez d'envoyer.
Consultez l'historique en bas de la page pour constater que le ticket est actuellement fermé :
View history
Si vous retournez à votre session terminal en tant qu'utilisateur sysadm et avez tapé :
$ muttet répondu à l'e-mail généré par Request Tracker, alors le statut de votre ticket va changer. Vous pouvez le voir en rechargeant la page web RT du ticket et en consultant l'historique au bas de la page.
Utilisation de mutt pour répondre à un mail
To: System Admin via RT <net@localhost> - Appuyer sur ENTREE pour continuer.Inclure le message dans la réponse? ([yes]/no): appuyer sur ENTREE pour inclure le message auquel vous répondezvi. Compozes votre réponse. Nous vous suggérons de répondre au-dessous du message original.:wq in vi).y pour envoyer le message.q pour quitter mutt à ce stade.
Ticket history showing reply
Vous avez maintenant une instance RT fonctionnant avec intégration d'e-mails. Ceci n'est pas une installation très réaliste, puisque vous communiquez avec vous-même! Mais il se trouve que les autres utilisateurs de la classe peuvnt vous envoyer des mail:
Assure-vous qu'ils ont configuré leur logiciel de mail (sudo apt-get install postfix, puis accepter les valeurs proposées).
Demandez aux utilisateurs de vous envoyer un mail, par exemple:
echo "Ou est mon chat ?" | mail -s "Chat perdu" net@pcX.ws.nsrc.orgUn peu plus tard nous allons étendre l'utilisation de RT en l'intégrant à d'autres logiciels de surveillance réseau avec la fonction rt-mailgate que nous avons déjà configurée dans le fichier /etc/aliases.
Il nous manque une fonctionnalité importante: ce n'est pas pratique de devoir se connecter à RT chaque fois que des tickets ont été créés. Il serait bien plus praitque si on recevait un mail chaque fois qu'un incident à été créé, non ?
Logout as sysadm
Log in as root
Maintenant, pour recevoir un mail chaque fois qu'une requête est soumise à RT, on va modifier les paramètres de la file (Queue) net:
Select queue
Depuis la page Queue (file), choisir net comme file en cliquant sur son nom, et vous pourrez alors choisir l'option Watchers (Observateurs) dans le menu en haut:
Queue watchers
Vous devriez voir ceci:
Modify queue watchers
Sous New watchers, tapez le nom du groupe netmgmt dans le champ <
New watchers
Et cliquez sur Go!
RT va chercher tous les groupes qui correspondent à netmgmt. Bien sur il n'y en a qu'un pour le moment, que nous avons créé plus tôt.
RT le trouve et affiche ceci:
Matched groups
Remarquez que nous avons sélectionné AdminCc dans le menu Groups à côté de netmgmt. Faites ceci et cliquez sur Save Changes en bas à droite.
Le résultat devrait ressembler à ceci:
Watchers modified
Qu'est-ce que cela signifie ? Et bien, demandez à un autre utilisateur de la classe de vous envoyer un mail, comment avant, mais cette fois-ci, vous devriez recevoir un mail de RT avec la reqûete de l'utilisateur. Lancez mutt en tant que sysadm.
Un peu plus tard nous étendrons l'utilisation de RT en l'intégrant avec des outils de supervision Réseau, à l'aide de la fonction de rt-mailgate que nous avons déjà configuré dans le fichier /etc/aliases.
Retrouver un ticket fermé.
Après qu'un ticket a été résolu ou fermé, vous pouvez remarquer qu'il disparaît de votre file d'attente. En fait, retrouver un ticket fermé nécessite quelques étapes. Cliquez tout d'abord sur Tickets => New Search dans le menu en haut dans RT:
Search tickets
Vous devriez voire quelque chose d'équivalent à:
Ticket search form
Si vous souhaitez rechercher des éléments dans une file d'attente et qu'il y a déjà des éléments dans la case "Current search" (recherche en cours)", alors vous devez d'abord effacer les éléments dans "Current search". Ensuite, dans la boîte "Add Criteria" (ajouter des critères), sélectionnez la file d'attente "net" dans le menu déroulant "Queue" (voir ci-dessous) :
Adding search terms
Cliquez sur "Add these terms" (ajouter ces termes) ou "Add these terms and Search" (ajouter ces termes et chercher) - Si vous choisissez uniquement "Add these terms", vous devez cliquer en bas de page sur "Update format and Search" (mettre à jour le format et chercher) - RT conservera les termes de la recherche jusqu'à ce vous les supprimiez.
Execute search
Les résultats de votre recherche ressembleront à ceci et vous permettront d'afficher les tickets qui ont été fermés, résolus, etc. :
Search results