Ce document a pour but d'aider les respbats au câblage des adhérents.

Même si le câblage n'est pas une tâche insurmontable, il nous arrive à tous d'avoir quelques trous de mémoire. C'est pourquoi cette page présente un certain nombre d'infos et de liens utiles permettant aux respbats de se dépatouiller sans déranger nos chères nounous affairées...:))

1. Généralités

Zamok

Notre serveur préféré auquel il faut se connecter par l'intermédiaire d'un Client SSH. Toutes les infos à ce sujet sont disponibles à la page de documentation SSH.

Commandes Unix

Vous trouverez une liste des commandes Unix ainsi que de nombreuses explications sur cette page de documentation sur les commandes Unix. Si vous ne les connaissez pas du tout, jetez un coup d'oeil à :

man
logout
passwd
cd
mkdir
rm
more
w
talk
write

qui sont souvent très utiles.
N'oubliez pas que les majuscules et les minuscules ne sont pas équivalentes. Il est aussi bon de savoir que la touche Tab permet la complétion des commandes.

Commandes spécifiques au cablage

Sur Zamok vous disposez de toute une série de petits utilitaires facilitant la vie :

whos <chaîne de caractères>

recherche la chaîne de caractères en question dans les fichiers de configuration. Si vous taper whos sans chaîne de caractères vous obtiendrez un descriptif des options vous permettant d'affiner votre recherche (login, hostname ou n°MAC)

mkaccount

crée une entrée machine ainsi que le compte utilisateur correspondant.

Attention :

Si la personne à câbler ne souhaite pas utiliser de mail login@crans.org, il faut remplir le champ login avec l'adresse mail qu'elle souhaite utiliser. De plus, le login doit être le nom patronymique de l'adhérent (voire une déclinaison du nom en cas d'homonymes) et en aucun cas un surnom ; il peut contenir jusqu'à 10 caractères et doit être uniquement constitué de lettres de l'alphabet. Si vous souhaitez créer un login plus long, sachez que c'est possible, mais il vous faudra voir au préalable avec une nounou.

Le nom de machine "hostname" peut être constitué : des 26 lettres de l'alphabet, du tiret simple "-" ou de chiffres mais n'utilisez en aucun cas d'autres caractères tels que les espaces ou les accents...vous risquez d'avoir affaire à un Nico pas content :))

mknewlogin <login> Prénom.Nom

crée un compte pour l'utilisateur Prenom Nom avec "login" pour login. (Veillez à bien respecter la syntaxe Prénom.Nom et les majuscules)

Attention :

Cette création de compte est inutile si la personne ne souhaite pas de compte login@crans.org.

chgpass <login>

change le mot de passe de l'utilisateur "login".

chgaccount <id>

modifie les informations sur un utilisateur. "id" peut correspondre à n'importe quel champ du fichier de configuration, il suffit de préciser ce champ à la demande du script.

lanceMake

commande à effectuer apres toute modification afin que celle-ci soit prise en compte. Toutefois, seules les modifications portant sur l'IP ou le nom de la machine nécessitent de lancer obligatoirement cette commande.

rmlogin <login>

Cette commande permet de supprimer un compte du serveur. Elle ne doit évidemment être lancée que si la personne ne désire plus conserver son compte. Les données personnelles du home de l'utilisateur ainsi que sa boîte mail sont sauvegardées, il est donc possible d'y réaccéder en cas de problème.

2. Les fichiers de configuration

Ces fichiers contiennent les informations sur les adhérents de l'association et sont donc relativement importants. Ils se trouvent dans le répertoire /CRANS/confs. Ce sont :

bata.cf
batb.cf
batc.cf
batm.cf
batf.cf
batg.cf
batj.cf
blacklist.cf

Les premiers contiennent les informations de configurations par bâtiment comme leurs noms l'indiquent et le dernier la liste des adhérents déconnectés (temporairement ou non, pour upload excessif par exemple).

Format

Une ligne d'un fichier de configuration est commentée si elle contient en premier caractère le symbole "#".

Les lignes ont la structure suivante :

0xXXX:nom de machine:adresse mac:Prenom.Nom:chambre:prise:etat de la connexion:annee scolaire:

login ou mail exterieur:promo:login du respbat:date:tel:commentaire

Explications :

0xXXX

correspond a l'IP de la machine au format hexadecimal. (à convertir en base 256 pour avoir l'IP : 138.231.136.xxx)

adresse mac

Attention :

Il faut bien l'adresse MAC et non le "PPP Adapter" pour les machines Windows... en gros, si on vous refile une adresse en 4445...... vous pouvez parier que la personne qui vous l'a donnée s'est plantée...

état de la connection

c'est un chiffre : 0 si tout est OK, 1 s'il manque la jarretière, 2 s'il manque le câble dans la chambre, 4 s'il y a un problème sur la machine de l'utilisateur et 8 s'il y a un problème "mystérieux externe à la machine.

Edition

En théorie, l'usage des scripts étant vivement conseillé, vous n'aurez pas à éditer les fichiers de configuration. Cependant, en cas de besoin, il est possible de les éditer grâce à la commande :

edit <nom de fichier>

Cette commande lance par defaut l'éditeur "vi". Il est déconseillé d'éditer autrement les fichiers, car de cette façon, vous créez un lock sur le fichier qui va empêcher que deux utilisateurs modifient le même fichier en même temps et donc que certaines modifications soient perdues. "vi" est assez difficile à utiliser au début, c'est pourquoi vous trouverez ici un petit manuel rapide de "vi".

Si vous souhaitez utiliser un autre éditeur (nano ou jed par exemple) tout en créant un lock, vous pouvez toujours le faire en tapant :

	env EDITOR=<editeur> edit <lefichier>

Ceci dit, contrairement à Vince, moi j'aime bien "vi" :))

3. Câblage

La prise

La mise en place de la prise dans le local n'a rien de fondamentalement difficile, il suffit de brancher à l'aide d'un câble la prise de la chambre à une prise d'un hub/switch (evitez l'uplink, ça fait mauvais effet...) et de vérifier que la petite lumière verte du hub/switch s'allume lorsque la machine de l'adhérent est branchée et allumée. Malheureusement concernant les bâtiments A et B, notre ami le CROUS nous a reservé une petite surprise et les numéros des chambres ne correspondent pas aux numéros des prises... Heureusement, vous n'êtes pas les premiers à vous pencher sur ce problème relativement pénible et vous trouverez les correspondances "n° de Chambre" <=> "n° de prise" dans le fichier de configuration du bâtiment en question. Si vous ne trouvez pas la correspondance dans le fichier de configuration, regardez si un numéro n'est pas indiqué au feutre dans la chambre de l'adhérent sur sa prise ou essayez d'utiliser les trois derniers chiffres du numéro indiqué sur la petite plaque France Telecom dans la chambre.

Chez l'adhérent

En théorie, en tant que câbleur, vous n'avez pas à vous déplacer ; puisqu'a priori, l'adhérent sait lire, il aura donc consulté la page des réglages sur vos bons conseils... En fait pour vous si la lumière verte du hub/switch correspondant à la prise est allumée, et si vous avez tout bien répondu aux questions du script, c'est que le problème vient de la machine de l'adhérent. Ceci dit, rien ne vous empêche de l'aider un peu, la page des réglages étant là pour vous aider... (Si vous avez affaire à une adhérente, soyez sympa, envoyez-là chez Sandor, il cherche une voisine...)

4. En cas de problème

Au secours, chez vous ca marche mais ça marche plus chez un adhérent de votre bâtiment ! Vous avez alors l'adhérent en question sur le point de défoncer votre porte pour vous prouver son désespoir... On ne panique pas, voici la démarche à suivre après avoir demandé à l'adhérent d'allumer sa machine :

1. On identifie l'adhérent et on vérifie que l'entrée machine existe bien grâce à la commande whos sur zamok. Si elle n'y est pas, on la remet, on exécute lanceMake et il y a des chances que ça marche... Sinon, on continue :

2. On vérifie que l'adhérent ne se trouve pas dans le fichier blacklist, car si c'est le cas, c'est normal que ça ne fonctionne pas... rien n'empêche de lui faire un petit topo sur le réseau, l'assoce et l'upload... en lui expliquant que ce qu'il fait n'est pas très sympa. S'il n'est pas dans le fichier :

3. On regarde si la machine de l'adhérent "répond" par le réseau grâce à la commande ping. Si elle répond, c'est que la machine de l'adhérent est mal réglée...(cf. la fameuse page des réglages) Sinon, on continue :

4. On attrape la clé du local et on descend le visiter afin de regarder si la petite lumière verte correspondant à la prise de l'adhérent sur le hub/switch est allumée. Si elle l'est, alors c'est que le problème vient de la machine de l'adhérent (et oui, encore...), on retourne donc à la fameuse page des réglages et on n'oublie pas de vérifier que l'adhérent ne nous à pas fait la mauvaise blague d'installer un firewall mal réglé (genre cette horreur de Z***A**** que l'on voit si souvent)... Après tout ça, ça devrait marcher (rien n'empêche de refaire tous les réglagles de zéro si on veut être sûr, ça peut parfois permettre de gagner du temps)... Mais si la lumière verte est éteinte, c'est moins drôle, cela signifie que le hub et la machine de l'adhérents ne sont pas reliés, il s'agit donc d'un problème matériel, on continue :

5. On regarde : si le câble est bien dans la prise au niveau de la carte réseau de l'adhérent, si les petites lumières de celle-ci sont bien vertes et si elle fonctionne, et si la prise est bien enfoncée dans le mur... et en général, on trouve le problème.

Voilà, bon courage.

top

documents

home

dernière modif le 10.03.03 par Nico