Pour que vos utilisateurs puissent localiser votre serveur de documentation sans connaître son URL, vous pouvez enregistrer son nom avec le système FNS. Les utilisateurs peuvent toujours avoir accès à des serveurs de documentation non enregistrés s'ils connaissent leurs URL.
La méthode d'enregistrement de votre serveur dépend de deux paramètres :
Votre connaissance des commandes FNS.
Si vous connaissez bien les commandes FNS standard, par exemple fnbind, vous pouvez les utiliser pour enregistrer votre serveur. Cependant, pour simplifier la procédure d'enregistrement, vous pouvez utiliser la commande /usr/lib/ab2/bin/ab2regsvr, qui enregistrera votre serveur à votre place. Pour plus d'informations, reportez-vous aux sections "Enregistrement du serveur avec la commande ab2regsvr", et "Enregistrement du serveur à l'aide de commandes FNS standard".
Le service de noms utilisé.
NIS+ (Network Information Service Plus) est le principal service de noms utilisé pour les environnements d'exploitation Solaris 2.6 et ultérieurs. Si votre système utilise NIS+ et que vous disposez d'autorisations d'administration, vous pouvez enregistrer le serveur en étant connecté sur le système NIS+ maître ou sur le système NIS+ client.
NIS (Network Information Service) était le service de noms standard fourni dans les environnements SunOS 4.x (Solaris 1.x). Si votre système utilise NIS, connectez-vous en tant que superutilisateur sur le système NIS maître pour enregistrer le serveur de documentation.
AnswerBook2 fonctionne également avec un système de noms défini au niveau des systèmes de fichiers (files), dans lequel tous les noms doivent être entrés manuellement dans des fichiers de données. Ces fichiers sont stockés dans le répertoire /var/fn/. Dans ce cas, vous devez disposer d'un accès de superutilisateur au système pour pouvoir enregistrer le serveur. En outre, l'enregistrement s'applique uniquement sur la machine sur laquelle le serveur est enregistré. Les autres machines ne peuvent pas voir un serveur enregistré avec un mécanisme basé sur le système de fichiers.
Pour enregistrer votre serveur, utilisez la commande ab2regsvr. La commande ab2regsvr examine la configuration de votre système et définit l'espace de noms approprié à votre serveur.
Pour enregistrer votre serveur, tapez :
# /usr/lib/ab2/bin/ab2regsvr url_serveur |
Où url_serveur est l'URL complète permettant d'accéder à ce serveur (par exemple, http://imaserver.eng.sun.com:8888/).
La commande ab2regsvr accepte également quelques options qui peuvent s'avérer utiles :
Pour afficher une liste des URL des serveurs d'AnswerBook2 enregistrés :
# /usr/lib/ab2/bin/ab2regsvr -l |
Pour supprimer un serveur enregistré de la liste :
# /usr/lib/ab2/bin/ab2regsvr -d |
Pour modifier l'URL du serveur d'AnswerBook2 actuellement enregistré :
# /usr/lib/ab2/bin/ab2regsvr -r url_serveur |
Où url_serveur est la nouvelle URL permettant d'accéder à ce serveur (par exemple, http://aserver.eng.sun.com:8888/). L'URL existante est ainsi remplacée par l'URL spécifiée.
Pour plus d'informations sur la commande ab2regsvr, reportez-vous à la page de manuel ab2regsvr(1m).
Si vous voulez utiliser des commandes FNS pour enregistrer votre serveur et que vous avez déjà installé FNS sur votre site, utilisez la commande suivante pour enregistrer l'URL spécifiée en tant que serveur de documentation pour votre service (domaine) :
"# fnbind -r thisorgunit/server/answerbook2 onc_answerbook2 \ onc_addr_answerbook2 serveur_url" |
Où url_serveur est l'URL complète permettant d'accéder à ce serveur (par exemple, http://imaserver.eng.sun.com:8888/).
Pour savoir quels serveurs sont enregistrés, utilisez la commande suivante :
% fnlookup -v thisorgunit/service/answerbook2 |
Cette commande retourne une liste des serveurs enregistrés qui ressemble à la suivante :
Reference type: onc_answerbook2 Address type: onc_addr_answerbook2 length: 19 data: 0x68 0x74 0x74 0x70 0x3a 0x2f 0x2f 0x61 0x6e 0x73 http://ans 0x77 0x65 0x72 0x73 0x3a 0x38 0x38 0x38 0x38 wers:8888 |
Dans cet exemple, le serveur enregistré est http://answers:8888/.
Une réponse semblable à celle qui suit signifie qu'aucun serveur de documentation n'est enregistré avec FNS.
"Lookup of 'thisorgunit/service/answerbook2' failed: \"" ""Name Not Found: 'answerbook2'" |
Pour plus d'informations sur le système FNS, y compris son installation, reportez-vous à la documentation FNS.
Au lieu d'utiliser les services de noms qui viennent d'être décrits pour rechercher un serveur de documentation, l'utilisateur peut définir un serveur d'AnswerBook2 par défaut à l'aide de la variable d'environnement AB2_DEFAULTSERVER. Par exemple, il peut placer la ligne suivante dans le fichier .cshrc :
setenv AB2_DEFAULTSERVER http://imaserver.eng.sun.com:8888 |
Si l'utilisateur n'a pas défini de variable d'environnement, lorsqu'il lance AnswerBook2 à partir du bureau, le logiciel AnswerBook2 tente de déterminer si le système à partir duquel il a été lancé exécute un serveur de documentation. Le cas échéant, il s'ouvre en utilisant l'URL : http://localhost:port, où port vaut 8888 par défaut.
Si l'utilisateur n'a pas défini de variable d'environnement et que le système n'est pas un serveur de documentation, lorsqu'il lance AnswerBook2 à partir du bureau, le système exécute une commande fnlookup thisorgunit/service/answerbook2 pour rechercher les serveurs de documentation disponibles. Il en choisit alors un et lance le navigateur AnswerBook2 en utilisant ce nom de serveur comme URL.