Chapitre 1 Introduction

Ce chapitre présente le serveur de documentation AnswerBook2 ^TM. Il comprend les informations suivantes :

• "Vue d'ensemble des fonctions d'administration d'AnswerBook2"

• "Fonctions d'administration d'AnswerBook2"

• "Composants d'AnswerBook2"

• "Procédure d'installation"

• "Questions fréquemment posées"

Pour plus d'informations sur l'utilisation d'AnswerBook2 pour la consultation de la documentation en ligne, voir Affichage de la documentation en ligne á l'aide du système.

Vue d'ensemble des fonctions d'administration d'AnswerBook2

AnswerBook2 est le système de documentation en ligne de Sun. Il s'agit d'un système de type client-serveur dans lequel le client peut être n'importe quel navigateur Web compatible HTML 3.2 et le serveur, un serveur Web httpd. Vous pouvez installer les collections de documents d'AnswerBook2 sur un serveur de documentation centralisé ou sur un serveur local.

Fonctions d'administration d'AnswerBook2

Le logiciel AnswerBook2 offre les fonctions d'administration suivantes :

• Une architecture client-serveur permet de stocker les documents dans un seul emplacement (serveur) accessible depuis le bureau de l'utilisateur (client).

• Une interface reposant sur une ligne de commande (ab2admin) et une interface centrée sur un navigateur Web (page Administration d'AnswerBook2) permettent d'exécuter les fonctions d'administration du serveur.

• Vous pouvez l'exécuter comme un processus CGI sur plusieurs serveurs Web.

• Vous pouvez contrôler l'affichage des erreurs et les marquer d'un "BUG" rouge en activant ou en désactivant la fonction de débogage d'AnswerBook2.

• Vous pouvez consulter des fichiers de consignation pour l'accès au serveur et les erreurs.

Composants d'AnswerBook2

AnswerBook2 se compose des éléments suivants :

• Un serveur de documentation -- exécute les fonctions d'interrogation et fournit les documents au navigateur client. Il inclut des modèles qui offrent une présentation homogène pour la consultation et l'impression des documents ; il offre des interfaces d'administration reposant sur un navigateur Web et une ligne de commande pour exécuter des fonctions d'administration, de gestion de base de données et d'authentification des mots de passe. Pour plus d'informations sur l'installation d'un serveur de documentation, reportez-vous à la section "Installation du logiciel AnswerBook2". Pour plus d'informations sur l'administration d'un serveur de documentation, reportez-vous au Chapitre 3.

• Collections de documents -- il peut s'agir de nouveaux documents (SGML) ou d'anciens documents (Display PostScript^TM). Pour plus d'informations sur l'installation des collections de documents sur le serveur, reportez-vous à la section "Installation des collections de documents".

• Un navigateur Web client -- pour consulter la documentation, vous pouvez utiliser n'importe quel navigateur compatible HTML 3.2. Pour plus d'informations sur la consultation de la documentation, reportez-vous au manuel Affichage de la documentation en ligne á l'aide du système. Pour permettre aux utilisateurs d'accéder à votre serveur de documentation, vous devez enregistrer votre serveur avec FNS (Federated Naming Service) ou leur indiquer l'adresse URL de votre serveur. Pour obtenir des informations sur l'enregistrement FNS de votre serveur, reportez-vous à la section "Enregistrement du serveur de documentation".

Procédure d'installation

Le tableau suivant indique les étapes à suivre et les éléments à installer pour les fonctions spécifiques d'AnswerBook2.

Questions fréquemment posées

Cette section regroupe les questions fréquemment posées sur AnswerBook2 et fournit les réponses correspondantes.

En quoi consiste le AnswerBook2produit ?

La AnswerBook2 utilise un serveur de documentation normalisé permettant d'exploiter la documentation Sun en ligne sur le navigateur Web de votre choix. L'interface AnswerBook2 permet de parcourir et d'imprimer de nombreux documents et d'effectuer des recherches sur ces documents, y compris sur les documents au format AnswerBook1 et sur les pages man.

En quoi le produit AnswerBook2 diffère t-il d'AnswerBook ?

La version précédente d'AnswerBook (désormais appelée AnswerBook1) recourait au format Display PostScript pour afficher les versions électroniques de documents initialement conçus pour être imprimés. AnswerBook2 utilise un navigateur Web pour afficher des documents au format SGML, conçus pour une consultation en ligne, et des documents AnswerBook1.

La liste suivante identifie certaines différences clés entre les produits :

• Interface fondée sur un navigateur Web -- vous pouvez utiliser n'importe quel navigateur Web compatible HTML 3.2 sur n'importe quelle plate-forme pour consulter la documentation en ligne avec AnswerBook2.

• Souplesse de la source -- le serveur de documentation permet d'accéder aux documents au format AnswerBook1 (Display PostScript) ou aux documents au format AnswerBook2 (SGML).

• Support client-serveur -- AnswerBook2 vous permet d'installer le serveur et les collections de documents dans un emplacement central et de consulter les documents à partir d'autres systèmes. En outre, il comprend un mécanisme de "reprise" qui permet à l'administrateur de documents de définir plusieurs serveurs de documentation pour garantir le fonctionnement des liens entre les documents.

• Interplates-formes : pour cette version, le serveur de documentation AnswerBook2 doit s'exécuter sous Solaris 2.5.1 operating environment or compatible version (SPARC ou Intel). Cependant, les clients d'AnswerBook2 peuvent s'exécuter sur n'importe quelle plate-forme ; il est possible que les versions ultérieures permettent d'exploiter le serveur sur d'autres plates-formes.

• Comportement de recherche par défaut -- AnswerBook2 utilise l'opérateur AND dans son comportement de recherche par défaut au lieu de l'opérateur OR (comportement de recherche par défaut d'AnswerBook1).

Puis-je encore consulter les anciennes collections AnswerBook avec AnswerBook2 ?

Oui, sauf si vos anciens documents AnswerBook ont été créés avant la version Solaris 2.2. Pour ajouter des collections AnswerBook1 dans la base de données du serveur de documentation, l'administrateur de documents utilise la fonction "ajouter une collection" d'AnswerBook2 et sélectionne le répertoire contenant le fichier ab_cardcatalog d'AnswerBook1.

Les fonctions AnswerBook2 sont-elles disponibles pour les documents au format AnswerBook1 ?

Non. Pour une raison de cohérence, l'interface AnswerBook2 pour les documents AnswerBook1 est similaire à l'interface d'AnswerBook1. Les différences de fonctions entre les collections AnswerBook1 et AnswerBook2 sont expliquées ci-après :

• Vous ne pouvez pas détailler ni réduire la totalité de la table des matières d'un document AnswerBook1, vous devez procéder section par section.

• Les pages de sommaire AnswerBook1 ne comportent pas de sections Autres sujets. Pour naviguer d'une page à l'autre, utilisez Sujet suivant ou revenez à la Table des matières et sélectionnez une autre section.

• Les pages de sommaire AnswerBook1 affichent un chapitre à la fois. Il est impossible de définir des entités plus petites.

• Avec AnswerBook1, les icônes de résultats de recherche ne comportent pas d'informations détaillées : elles sont pleines ou vides.

• Dans un texte au format AnswerBook1, les termes cherchés ne sont pas mis en évidence.

• Avec AnswerBook1, les graphiques sont représentés par une icône. Lorsque vous cliquez sur cette icône, le fichier PostScript correspondant est ouvert.

• Les recherches Pages de manuel par mot clé couvrent uniquement les pages de manuel d'AnswerBook2 (SGML) sur le serveur, pas les pages de manuel d'AnswerBook1.

• Les pages man d'AnswerBook1 utilisent la même interface que les autres documents au format AnswerBook1 ; elles ne disposent pas d'une interface spéciale.