Chapitre 4 Installation de la documentation SEAS 3.0

Ce chapitre présente des renseignements sur la documentation fournie avec Solaris Easy Access Server 3.0, ainsi que des directives d'installation de la visionneuse de documentation AnswerBook2^TM.

• "Documentation de SEAS"

• "Installation du serveur AnswerBook2"

• "Installation du serveur AnswerBook2"

• "Installation des collections SEAS"

• "Inscription d'un serveur de documentation Answerbook2"

• "Utilisation du serveur AnswerBook2"

Consultez les sections "Conversión a Solstice DiskSuite 4.2" in Solaris Easy Access Server 3.0 Release Notes et "Documentation Errata" in Solaris Easy Access Server 3.0 Release Notes pour obtenir des renseignements de dernière minute sur la documentation de SEAS.

Documentation de SEAS

Toute la documentation de SEAS est incluse sur le CD de documentation SEAS, à l'exception des Notes de version, disponibles sous forme imprimée. La plupart des documents sont disponibles en format AnswerBook2, mais certains d'entre eux sont fournis dans d'autres formats, par exemple HTML, aide en ligne, fichiers de texte, PDF et PostScript. Vous pouvez installer la documentation au moyen de Solaris Web Start ou de la commande pkgadd.

Tableau 4-1 présente les livres et informations constituant la documentation de SEAS.

Installation du serveur AnswerBook2

Le logiciel AnswerBook2 est le système de documentation en ligne de Sun Microsystems. Son interface d'explorateur vous permet de visualiser et d'imprimer la documentation, et d'y effectuer des recherches.

Pour consulter la documentation SEAS en ligne, vous devez avoir accès à un serveur de documentation Answerbook2. Le serveur de documentation AnswerBook2 vous permet de visualiser la documentation Sun au moyen de votre explorateur favori. Il convertit la documentation en format compatible HTML 3.2, et l'envoie à un explorateur pour fins d'affichage ; il prend également en charge le format de documentation AnswerBook ^TM précédent. Le logiciel serveur de documentation AnswerBook2 est inclus sur le CD de documentation de SEAS ainsi que sur celui de Solaris 7.

Pour une consultation occasionnelle des documents SEAS, il n'est pas nécessaire d'installer le serveur de documentation AnswerBook2. Vous pouvez plutôt l'exécuter directement à partir du CD de documentation SEAS au moyen du script ab2cd. Pour obtenir des renseignements détaillés sur cette fonction, consultez le fichier Lisez-moi sur le CD de documentation SEAS. Pour ce faire, vous devez détenir un accès de superutilisateur au système auquel le CD est relié.

Toutefois, pour que les utilisateurs puissent accéder à la documentation des produits SEAS, il est nécessaire d'installer le logiciel serveur de documentation AnswerBook2. Après avoir installé le logiciel serveur SEAS, vous devez installer la documentation SEAS sur ce serveur. Pour obtenir des renseignements sur l'installation du logiciel serveur et de la documentation inclus sur le CD de documentation SEAS, consultez le fichier Lisez-moi de ce CD. Pour des renseignements généraux sur l'utilisation du produit AnswerBook2, consultez le module "Accès à la documentation en ligne" dans la bibliothèque d'installation de Solaris 7 (version pour plate-forme SPARC) ou la bibliothèque d'installation de Solaris 7 (version pour plate-forme Intel).

Si vous n'avez pas accès à un serveur de documentation AnswerBook2 ou ne souhaitez pas l'installer localement, vous pouvez consulter toute la documentation Solaris disponible sur le site Web http://docs.sun.com.

Comment exécuter le logiciel serveur Answerbook2 à partir du CD de documentation SEAS

Il est à remarquer que l'exécution du serveur de documentation directement sur le CD est lente. Cette approche n'est donc pas recommandée si vous prévoyez que d'autres utilisateurs souhaiteront accéder aux documents SEAS.

1. Connectez-vous en tant que superutilisateur.

2. Changez le répertoire, ou lancez le Gestionnaire de fichiers et accédez au répertoire contenant le script exécutable ab2_cd.

3. Exécutez la commande ab2_cd.

4. Accédez au serveur de documentation au moyen de l'URL suivant : http://hôte_local:8888

   où hôte_local est le nom de l'ordinateur où le CD est relié.

5. Pour quitter le logiciel serveur sur le CD, exécutez la commande ab2_cd stop.

Comment installer le serveur de documentation AnswerBook2

1. Insérez le CD de documentation SEAS dans le lecteur de CD-ROM.

2. Connectez-vous en tant que superutilisateur sur le serveur de documentation et accédez au répertoire contenant les progiciels d'installation.

3. À l'invite du système, lancez le Registre des produits en tapant :

   prodreg &

4. Cliquez sur Installer au bas de la fenêtre du registre des produits.

5. Repérez le programme d'installation d'AnswerBook2 et cliquez sur OK.

6. Suivez les directives apparaissant à l'écran.

Comment installer le serveur de documentation Answerbook2 avec pkgadd

1. Insérez le CD de documentation SEAS dans le lecteur de CD-ROM.

2. Connectez-vous en tant que superutilisateur sur le serveur de documentation et accédez au répertoire contenant les progiciels d'installation.

3. Tapez la commande :

   pkgadd nom_du_progiciel

   Pour installer les progiciels serveurs dans un répertoire autre que celui par défaut, utilisez la commande pkgadd -d . -a none. Ainsi, l'utilitaire pkgadd vous demande de préciser le répertoire où vous désirez installer le logiciel.

   SUNWab2r (0,02 méga-octet) est installé sur la partition racine et fournit les fichiers de configuration et de démarrage.

   SUNWab2s (0,21 méga-octet) fournit les fichiers partagés servant au traitement des documents.

   SUNWab2u (21,02 méga-octets) fournit les fichiers de traitement exécutables et dorsaux pour les fonctions de serveur et d'administration.

4. Au besoin, démarrez le serveur.

   L'installation des progiciels devrait démarrer le serveur sur le port par défaut 8888. S'il ne démarre pas, tapez la commande suivante pour le démarrer :

   # /usr/lib/ab2/bin/ab2admin -o start

Installation des collections SEAS

Pour que le serveur de documentation AnswerBook2 puisse fonctionner, vous devez installer les collections de documentation. Le Tableau 4-1 présente la liste des collections de documentation SEAS.

Employez l'utilitaire pkgadd pour installer les nouvelles collections de documents sur votre serveur. Si vous ajoutez les collections de documents SEAS à une base de données AnswerBook, utilisez la fonction Ajouter une collection à la liste ou la commande ad2admin -o add_coll pour ajouter les collections.

Si des collections sont déjà installées sur le serveur de documentation, vous pouvez employer la fonction Rechercher les collections locales ou la commande ab2admin -o scan afin de les ajouter automatiquement à la base de données de documentation du serveur. Cette procédure fonctionne uniquement avec des collections installées localement.

Pour desservir des collections de documentation situées sur un autre serveur de documentation, utilisez la fonction Ajouter une collection à la liste ou la commande ab2admin -o add_coll, et spécifiez le chemin d'accès complet du fichier ab_cardcatalog ou collinfo. Par exemple, si le serveur de documentation est ab2docserver et que vous voulez qu'il desserve les collections de documents DiskSuite 4.2 sur le système «bingo», vous pourriez taper la commande suivante :

ab2admin -o add_coll -d /net/bingo/opt/answerbooks/english/DiskSuite_4.2/SUNWdsab

Inscription d'un serveur de documentation Answerbook2

Si vous voulez que d'autres utilisateurs puissent trouver automatiquement votre serveur de documentation au moyen de FNS (Federated Naming Services), vous devez inscrire le serveur. Il sera alors inclus dans un groupe de serveurs pour un site, et les utilisateurs pourront choisir parmi divers serveurs de documentation.

Comment inscrire un serveur de documentation AnswerBook2

1. Tapez cette commande :

   # /usr/lib/ab2/bin/ab2regsvr url_du_serveur

   où url_du_serveur est l'URL complet permettant d'accéder à ce serveur.

   Par exemple : ab2docserver.eng.sun.com:8888

Pour de plus amples renseignements sur l'installation du logiciel serveur AnswerBook2, consultez la bibliothèque d'informations de Solaris 2.5 (version pour plate-forme SPARC).

Utilisation du serveur AnswerBook2

Si vous exécutez le système d'exploitation Solaris 2.6 ou Solaris 7, vous pouvez démarrer AnswerBook2 de l'une des façons suivantes :

• Dans le panneau frontal CDE, cliquez avec le bouton droit de la souris sur Programme, puis sélectionnez AnswerBook2.

• Dans le menu Ouvrir un programme Windows, choisissez AnswerBook2.

• Sur la ligne de commande UNIX, tapez answerbook2.

• Au moyen d'un explorateur Web, tapez le nom du serveur AnswerBook2 et le port, en employant la syntaxe suivante :

  http://serveur_de_documentation:port.

  Par exemple : http://ab2docserver:8888.