The Finger Server - french docs

Instructions d'installation et de configuration pour le The Finger Server

Introduction
Merci d'avoir pris le temps de télécharger The Finger Server. Les instructions qui suivent vont vous aider pas à pas avec l'installation complète du programme sur votre serveur. Une fois votre Finger Server installé, vous serez en mesure d'accéder la section Quick Help ( Aide Rapide ) du Panneau de Configuration pour de l'aide sur les fonctions du Panneau de Configuration.

À noter que le Quick Help ( Aide Rapide ) ne sera complètement fonctionnel qu'à partir de la version 1.0

Si vous trouvez des erreurs ou des inconsistances dans ce guide alors soyez assez aimable de me le faire savoir pour que je puisse les corriger.

Instructions d'installation

Les premières étapes

Si vous ne l'avez pas déjà fait, téléchargez une copie du The Finger Server et décompressez le dans un répertoire vide de votre ordinateur. Assurez-vous de garder les chemins dans l'archive intactes lors de l'extraction des fichiers. Winzip ( Windows95/98/NT ) et unzip ( Unix ) ne devraient pas avoir de problème à faire cela pour vous.
À l'intérieur du répertoire finger vous devriez maintenant avoir deux répertoires, l'un nommé cgi-bin et l'autre nommé htdocs. Le répertoire cgi-bin contient tous les scriptes et fichiers qui doivent être transférés dans un répertoire cgi-bin ou tout autre endroit sur le serveur web pouvant exécuter des scriptes CGI. Le répertoire htdocs contient tous les fichiers qui ne doivent pas être placés dans le répertoire cgi-bin. (La cause étant que certains serveur web ne servent pas du contenu html et image à partir du répertoire cgi-bin…)
Dans le répertoire cgi-bin, vous trouverez trois autres répertoires nommés admin, user et data. Ces trois répertoires contiennent respectivement les scriptes d'administration, les scriptes d'usager et les données d'usager.
Vous devrez éditer les trois principaux scriptes CGI et remplacer la toute première ligne de ceux-ci par le chemin vers perl de votre serveur. Les scriptes ont présentement #!/usr/bin/perl sur la première ligne.

Les trois scriptes à éditer sont :

/cgi-bin/finger.cgi
/cgi-bin/admin/admin.cgi
/cgi-bin/user/user.cgi

Si vous n'êtes pas certain du chemin vers perl de votre serveur alors vous pouvez telneter à votre serveur et placer la commande whereis perl ou bien demander à votre administrateur de système.
Note : /usr/bin/perl est le chemin habituel vers perl sur les systèmes unix alors il ne sera probablement pas nécessaire de d'effectuer ces modifications.

NOTE : Si vous transférez ces fichiers sur une machine Unix et que vous aviez édité ces trois fichiers, soit certain de les avoir sauvegardé dans le format texte unix ( LF à la place de CR/LF ). Si vous ne faites pas cela, les scriptes ne fonctionnerons pas! Les utilisateurs de Windows95/98/NT peuvent trouver un excellent éditeur de texte qui sauvegarde les fichiers texte unix comme il faut à http://www.textpad.com/.

Le transfert de vos fichiers

Avant de transférer les fichiers sur votre serveur vous allez devoir créer deux répertoires. Un pour les scriptes CGI et un autre pour les fichiers html. Créez un répertoire nommé finger à l 'intérieur de votre répertoire cgi-bin et un répertoire nommé finger où vous gardez vos fichiers html. Vous pouvez utiliser le nom de répertoire que vous voulez, finger est uniquement un exemple.
Transférez tous les fichiers et les répertoires à l 'intérieur du répertoire cgi-bin sur votre ordinateur dans le répertoire /cgi-bin/finger sur votre serveur.
Transférez tous les fichiers du répertoire htdocs sur votre ordinateur dans le répertoire html /finger sur votre serveur.
À l'intérieur du répertoire cgi-bin/finger sur votre serveur web, créez deux répertoire supplémentaires.
L'un doit être nommé plans et l'autre news.
Si votre serveur web est un serveur Unix alors vous devrez définir les permissions de vos répertoires, scriptes et autres fichiers dans le répertoire cgi-bin. À partir de la ligne de commande Unix ou d'une session telnet vous pouvez exécuter la commande chmod pour faire cela. ( pour de l'information sur la commande chmod, tapez man chmod ) En plus de ça, la plupart des clients FTP pour Windows95/98/NT vous permettent de changer la permission des fichiers et répertoires sur un serveur à distance.

Tous les fichiers *.cgi, *.pl et *.pm dans tous les répertoires doivent avoir la permission 0755
Exception : /admin/adminpass.cgi où la permission doit être 0777

Tous les fichiers *.cfg doivent avoir la permission 0777
Les fichiers d'usager se trouvant dans le répertoire /cgi-bin/finger/data doivent avoir la permission 0777.
Tous les répertoires, incluant le répertoire principal /cgi-bin/finger doivent avoir la permission 0777.
Tous les autres fichiers qui n'ont pas été nommé doivent avoir la permission 0777.

NOTE SUR LA SÉCURITÉ : Les instructions données plus haut définissent plusieurs fichiers et répertoires sur votre serveur web comme read ( lecture ), write ( écriture ) et execute ( exécution ). Cela veut dire que n'importe qui ayant un accès ssh ou telnet à votre serveur peut modifier les fichiers à l'intérieur de votre répertoire finger. Il est nécessaire d'utiliser ces permissions de cette façon car par défaut le serveur web roule avec les permissions les plus basses possible et n'a généralement pas d'accès écriture sur les pages web ou scriptes CGIde l'usager.

Ceci dit, le Finger Server garde les informations de configuration et les informations de plan dans votre répertoire cgi-bin et doit avoir un accès d'écriture sur des endroits spécifiques. Si vous savez que votre serveur web à un accès écriture sur vos fichiers de Finger Server comme un usager ou groupe ( user or group ) alors vous pouvez fermer le bit d'écriture pour world ( le monde ) en plaçant la commande suivante :

Chmod -R o-w *

Assurez-vous d'être à l'intérieur du répertoire cgi-bin/finger avant d'exécuter cette commande!
Il est capital de définir les permissions correctement sur votre serveur. Si votre Finger Server ne fonctionne pas à partir de la section suivante alors c'est fort probablement un problème relié aux permissions de fichier...sérieusement.

Configuration du System Setup

Maintenant que nous avons transferé les fichiers et répertoires, nous devons configurer le Finger Server à partir du Panneau de Configuration. Pour cela, avec votre fureteur, accédez au fichier admin.cgi dans le répertoire /cgi-bin/finger/admin.

Par exemple, si vous avez installé le Finger Server dans /cgi-bin/finger, vous devez pointer votre fureteur à http://www.votredomaine.com/cgi-bin/finger/admin/admin.cgi
Si tout à été installé correctement alors vous allez être demandé à entrer votre nom d'usager et mot de passe. Le nom d'usager par défaut est admin et le mot de passe par défaut est 51channels. Une fois le système accédé, vous devez directement aller à la section System Setup pour configurer votre système afin que le reste du Panneau de Configuration fonctionne correctement.
Chacune des options dans le System Setup a une explication placée en dessous. Lisez-les attentivement et remplissez les valeurs appropriées. Si vous êtes incertain de quelque chose comme le chemin du serveur vers vos fichiers cgi-bin ou html alors contactez votre administrateur de système. Vous pouvez aussi utiliser l'option ViewEnvironment dans le Panneau de Configuration pour voir quelques informations utiles sur votre serveur web comme le chemin vers cgi-bin, etc.
Après avoir configuré votre System Setup, toutes les fonctions du Panneau de Configuration devraient fonctionner correctement. Si elles ne fonctionnent pas, retournez en arrière et confirmez que vous avez entré la bonne information et que toutes vos permissions de fichier sont appropriées.

Configuration du Look and Feel

Par la suite, configurez le Look and Feel de votre serveur. Ici, vous pouvez personnaliser le nom du serveur, la couleur, les catégories et autres informations par rapport à votre serveur.
Chaque option dans la section Look and Feel a une explication placée en dessous. Lisez-les attentivement et remplissez les valeurs appropriées. Dans la plupart des cas, les valeurs par défaut devraient suffire et si vous doutez de quelque chose, vous pouvez laisser les valeurs par défaut. Vous pourrez toujours les changer par la suite.
La section Homepage " Latest Plan List " Setup de Look and Feel va être expliquée plus bas.

Changer le mot de passe par défaut

Maintenant que le System Setup et le Look and Feel ont été configuré, vous allez devoir changer le mot de passe par défaut. Le Finger Server démarre avec le même nom d'usager et mot de passe administrateur. Si vous ne changez pas le mot de passe n'importe qui pourra accéder au scripte d'administration de votre Finger Server et effectuer des changements ou pire, sans que vous le sachiez.
À partir du menu d'administration principal, sélectionnez Change Password.
Entrez votre nouveau nom d'usager et mot de passe que vous voulez utiliser.
Après avoir modifié le mot de passe, vous allez devoir vous reconnecter à votre Finger Server en utilisant le lien fournit.

Administration d'usager ( User Administration )

Par la suite, vous allez probablement vouloir ajouter des usagers. Sélectionnez User Administration dans le Panneau de Configuration. Pour ajouter, modifier ou effacer un usager, sélectionnez l'action appropriée. Les usagers fraîchement ajoutés seront en mesure d'utiliser le système immédiatement et de commencer à mettre à jour leurs plans.

Accès usager ( User access )

Les usagers peuvent se connecter et mettre à jour leurs plans à partir du User Control Panel ( Panneau de Configuration Usager ). Ils accèdent à cela de la même manière que vous accédez le Panneau de Configuration principal.
Pour se connecter, les usagers doivent accéder avec leur fureteur au fichier user.cgi qui se trouve dans le répertoire /cgi-bin/finger/user
Par exemple, si vous avez installé le Finger Server dans /cgi-bin/finger, le fureteur doit pointer vers http://www.votredomaine.com/cgi-bin/finger/user/user.cgi.

Terminé

C'est tout. Si vous avez besoin d'aide avec les autres sections du Panneau de Configuration, référez-vous à la section Quick Help ( Aide Rapide ) dans le Panneau de Configuration.

Traduction française par Kornel Kiss - French translation by Kornel Kiss
1999