test

Installation et administration d'un serveur AnswerBook2

Chapitre 2 Installation du logiciel serveur AnswerBook2

Cette section décrit la procédure d'installation du logiciel serveur AnswerBook2.

Remarque :

Pour consulter la documentation en ligne en tant que client AnswerBook2, aucune installation n'est nécessaire ; vous devez connaître l'URL d'un serveur de documentation ou, si vous avez accès à Internet, vous pouvez consulter la documentation Sun à l'URL suivante : http://docs.sun.com/

Remarque :

Vous ne devez pas oublier que ce produit ne prévoit pas de contrôle d'accès au niveau client. Si une machine cliente peut accéder à l'URL de votre serveur de documentation, elle permet également à son utilisateur de visualiser les documents présents sur ce serveur.

Cette section contient les informations suivantes :

Important - Contraintes liées à l'environnement d'exploitation

Le serveur AnswerBook2 peut être exécuté dans les environnements d'exploitation Solaris 2.5.1, Solaris 2.6 et Solaris 7. Cepedant, la version spécifique de l'environnement d'exploitation impose certaines contraintes à votre installation dans les domaines suivants :

  1. Prise en charge des langues comportant des caractères de plusieurs octets, comme ceux qui sont utilisés par de nombreuses langues asiatiques - L'environnement d'exploitation Solaris utilise un utilitaire (iconv) qui convertit les caractère d'un jeu de codes à l'autre. Si vous utilisez l'environnement d'exploitation Solaris 2.5.1, vous devrez peut-être installer ou mettre à jour les modules suivants :

    • SUNWciu8 - Modules iconv du chinois simplifié pour UTF-8

    • SUNWhiu8 - Modules iconv du chinois traditionnel pour UTF-8

    • SUNWjiu8 - Modules iconv du japonais pour UTF-8

    • SUNWkiu8 - Modules iconv du coréen pour UTF-8

    • SUNWuiu8 - Modules génériques iconv pour UTF-8

  2. Prise en charge des services FNS (Federated Naming Services) - Si vous souhaitez inscrire votre serveur AnswerBook2 de façon à ce que les utilisateurs puissent y accéder «automatiquement», FNS doit être installé sur votre système. Cet utilitaire ne fait pas partie de l'environnement d'exploitation Solaris 2.5.1 de base. Vous devrez donc peut-être installer le module SUNWfns.

Liste de contrôle utile lors de la pré-installation

L'utilisation de cette liste simplifiera le processus d'installation.

Votre système est-il compatible avec le logiciel AnswerBook2 ?

Pour que votre système fonctionne en tant que serveur de documentation, il doit répondre à l'une des configurations système suivantes :

  • Système SPARCstation 2 (minimum, SPARCstation 5 recommandé) exécutant l'environnement d'exploitation Solaris 2.5.1, Solaris 2.6 ou Solaris 7 Edition de plate-forme SPARC

  • Système PC basé sur Intel exécutant l'environnement d'exploitation Solaris 2.5.1, Solaris 2.6 ou Solaris 7 Edition de plate-forme Intel

De plus, votre système serveur doit posséder un espace disponible d'environ 34 méga-octets pour le logiciel serveur et d'environ 600 méga-octets pour l'installation des collections de documents.

L'accès à un serveur de documentation (via un navigateur Web et une URL) ne nécessite aucune condition système spécifique. Cependant, vous devez exécuter un navigateur compatible HTML 3.2, tel que Netscape NavigatorTM, HotJavaTM ou Lynx.

Quels composants logiciels devez-vous installer ?

Les composants que vous devez installer dépendent de ce que vous souhaitez réaliser.

  • Pour consulter la documentation en ligne, si un serveur AnswerBook2 est déjà installé quelque part dans votre entreprise, il suffit de lancer un navigateur compatible HTML 3.2 et d'entrer l'URL du serveur (telle que http://imaserver:8888/). Pour consulter la documentation Sun, utilisez l'URL : http://docs.sun.com/

  • Pour que votre système "fournisse" de la documentation, installez le logiciel du serveur de documentation et les collections de documents sur votre système. Vous pouvez également choisir d'installer le logiciel serveur sur un système et les collections de documents sur un autre. Reportez-vous aux sections "Installation du logiciel AnswerBook2" et "Installation des collections de documents".

Où est le logiciel ?

Le logiciel serveur AnswerBook2 est disponible à divers endroits, comme le CD de documentation de Solaris 7, d'autres CD Sun ou directement à partir des sites Web Sun. C'est pourquoi les étapes à suivre pour accéder aux modules différeront légèrement en fonction de votre situation spécifique. Au cours de la procédure d'installation, l'emplacement du logiciel fait référence aux endroits que vous devrez utiliser compte tenu de votre situation.

Un serveur Web fonctionne t-il déjà sur ce système ?

Par défaut, le serveur de documentation AnswerBook2 s'exécute comme un plug-in NSAPI au-dessus du serveur httpd inclus dans le module SUNWab2u. Comme le serveur AnswerBook2 se conforme aux protocoles Web standard, vous pouvez choisir d'exécuter le serveur de documentation comme un processus CGI (Common Gateway Interface) au-dessus d'un autre serveur déjà installé sur votre système (par exemple, Netscape Server ou Sun Web Server). Reportez-vous à la section "Exécution d'un serveur AnswerBook2 comme un processus CGI".

Obtention du logiciel AnswerBook2

Le logiciel AnswerBook2 est inclus sur plusieurs CD, comme le CD de documentation Solaris 7. Si vous possédez un CD qui contient le logiciel ou que vous avez téléchargé les modules SUNWab2r, SUNWab2s et SUNWab2u à partir d'un site Web Sun, consultez "Installation du logiciel AnswerBook2". Autrement, vous devrez vous procurer le logiciel AnswerBook2 avant de poursuivre.

Installation du logiciel AnswerBook2

Remarque :

Certains CD comprenant le logiciel AnswerBook2 prennent en charge un utilitaire d'installation par pointer-cliquer (Solaris Web Start). Pour plus d'informations sur l'utilisation de cet utilitaire, consultez la documentation accompagnant le CD.

Installation du logiciel serveur AnswerBook2

  1. Connectez-vous en tant que super-utilisateur sur la machine serveur de documentation.

    Vous pouvez vous connecter en tant que root dans l'écran de connexion du bureau, ou entrer su à la ligne de commande, puis taper le mot de passe du système root.

  2. Insérez le CD dans le lecteur de CD-ROM ou placez-vous dans le répertoire du logiciel.

    Si vous effectuez l'installation à partir d'un CD, le Gestionnaire de volumes le monte automatiquement.

  3. Indiquez le répertoire des modules du serveur de documentation, si cela est nécessaire.

    Entrez la commande suivante :


    # cd emplacement du logiciel

    où l'emplacement du logiciel dépend du type d'installation, à partir d'un CD ou à partir d'un site Web. Par exemple, la valeur par défaut de l'emplacement du logiciel du CD de documentation Solaris 7 est /cdrom/sol_7_doc/Solaris_2.7_Doc/sparc/Product/.

  4. Lancez l'utilitaire d'installation et sélectionnez les modules de logiciel serveur.

    Par exemple, pour lancer l'utilitaire pkgadd, utilisez la commande suivante :


    # pkgadd -d .

    Sélectionnez les modules de logiciel serveur suivants :

    • SUNWab2r (0,03 mégaoctet) - s'installe dans la partition root et fournit les fichiers de configuration et de démarrage. N'installez pas ce module dans un emplacement autre que celui par défaut.

    • SUNWab2s (1,4 mégaoctet) - fournit des fichiers partagés permettant le traitement des documents. N'installez pas ce module dans un emplacement autre que celui par défaut.

    • SUNWab2u (30 mégaoctets) - fournit des fichiers de traitement exécutables et de sauvegarde pour les fonctions de serveur et d'administration. Pour installer ce module dans un emplacement autre que celui par défaut, utilisez la commande interactive pkgadd :


      # pkgadd -a none -d .

  5. Répondez aux invites du superutilisateur.

    Lorsqu'un message similaire au suivant apparaît :


    This package contains scripts which will be executed with super-user

permission during the process of installing this package.



Do you want to continue with the installation [y,n,?]

    Répondez y.

  6. Démarrez le serveur, le cas échéant.

    Après avoir terminé le processus d'installation du SUNWab2u, un script tente de démarrer le serveur sur le port par défaut 8888. Pour vous assurer que le serveur a démarré, utilisez l'une des méthodes suivantes :

    • Démarrez un navigateur Web compatible HTML 3.2 et entrez l'URL suivante : http://localhost:8888/

      Une page "Bibliothèque d'AnswerBook2" doit s'afficher avec au moins une collection de documents (les ressources d'aide d'AnswerBook2), en fonction des collections qui sont installées.

    • Identifiez le processus de serveur à l'aide de la commande suivante : 


      # ps -eaf | grep dwhttpd

    Si tel n'est pas le cas, démarrez le serveur à l'aide de la commande suivante :


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

  7. Une fois le processus d'installation terminé, votre serveur démarre à l'aide des informations de configuration par défaut.

    Pour plus d'informations sur la modification de la configuration de votre serveur, lisez ce qui suit :

    • Pour modifier des paramètres de configuration de serveur standard, comme le numéro de port, utilisez l'interface de ligne de commande ab2admin ou la page Administration d'AnswerBook2. Reportez-vous à l'Annexe A ou au Chapitre 3.

    • Pour exécuter le serveur AnswerBook2 sur un serveur httpd existant, comme Sun WebServer ou Netscape Server, vous devez installer le logiciel serveur de documentation standard, puis modifier plusieurs fichiers de configuration et créer des liens pour exécuter le serveur de documentation comme un processus CGI. Reportez-vous la section "Exécution d'un serveur AnswerBook2 comme un processus CGI".

  8. Installez les collections de documents.

    Si des collections de documents sont installées sur votre serveur, le processus d'installation les recherche et les ajoute à la base de données du serveur. Vous pouvez installer des collections à partir de CD ou effectuer une mise à jour de la base de données du serveur pour identifier les collections de documents existantes installées sur d'autres systèmes. Reportez-vous la section "Installation des collections de documents".

Installation des collections de documents

Remarque :

Certains CD comprenant le logiciel AnswerBook2 prennent en charge un utilitaire d'installation par pointer-cliquer (Solaris Web Start). Pour plus d'informations sur l'utilisation de cet utilitaire, consultez la documentation accompagnant le CD.

Votre serveur de documentation ne peut pas remplir son rôle si aucune collection de documents n'est installée.

Installation des collections de documents

  1. Connectez-vous en tant que super-utilisateur sur la machine serveur de documentation.

    Vous pouvez vous connecter en tant que root dans l'écran de connexion du bureau, ou entrer su à la ligne de commande, puis taper le mot de passe du système root.

  2. Insérez le CD dans le lecteur de CD-ROM ou placez-vous dans le répertoire du logiciel.

    Si vous effectuez l'installation à partir d'un CD, le Gestionnaire de volumes le monte automatiquement.

  3. Placez-vous dans le répertoire des modules de collections de documents.

    Vous pouvez installer des collections de documents à partir de l'emplacement du logiciel ou à partir d'autres emplacements, tels que des collections de documents existantes ou des collections provenant d'autres CD.

    Entrez la commande suivante :


    # cd emplacement du logiciel

    où emplacement du logiciel dépend du type d'installation à partir d'un CD ou à partir d'un site Web. Par exemple, la valeur par défaut de l'emplacement du logiciel du CD de documentation Solaris 7 est /cdrom/sol_7_doc/Solaris_2.7_Doc/common/Product/.

  4. Lancez l'utilitaire d'installation et sélectionnez les modules de logiciel serveur suivants :

    Par exemple, pour lancer l'utilitaire pkgadd :


    # pkgadd -d .

    Pour obtenir la liste des collections disponibles sur le CD, consultez le fichier README figurant sur ce CD.

  5. Décidez si vous souhaitez installer tous les fichiers de documents associés localement (installation lourde) ou uniquement les fichiers essentiels (installation minimale) pour chaque module de collection de documents.

    Une installation lourde copie tous les fichiers sur votre système serveur et peut utiliser un espace disque important. Cependant, ce dernier choix permet des performances plus rapides du serveur.

  6. Les modules de collections de documents AnswerBook2 incluent un script de post-installation qui ajoute des collections dans la base de données du serveur et relance le serveur.

    Le cas échéant ou si vous installez les modules de collections AnswerBook1, vous devez utiliser la fonction Ajouter une collection à la liste de la page Administration d'AnswerBook2 ou la commande ab2admin -o add_coll pour ajouter ces collections dans la base de données du serveur.

    Si des collections de documents sont déjà installées sur votre serveur, vous pouvez utiliser la fonction Scanner les collections installées localement de la page Administration d'AnswerBook2 ou la commande ab2admin -o scan pour que les modules soient automatiquement localisés et ajoutés dans la base de données du serveur de documentation. Cette fonction ne s'applique qu'aux modules installés localement.

    Pour servir les collections de documents situées sur un autre système, utilisez la fonction Ajouter une collection à la liste ou la commande ab2admin -o add_coll et indiquez le chemin complet du fichier ab_cardcatalog ou collinfo. Par exemple, si le serveur de documentation est imaserver et si vous souhaitez qu'il serve des collections installées sur le système elsewhere, vous pouvez utiliser la commande suivante : 


    imaserver# ab2admin -o add_coll -d /net/elsewhere/books/SUNWdtad/collinfo

Exécution d'un serveur AnswerBook2 comme un processus CGI

Par défaut, le serveur de documentation AnswerBook2 s'exécute comme un plug-in NSAPI au-dessus du serveur httpd inclus dans le module SUNWab2u. Comme le serveur AnswerBook2 se conforme aux protocoles Web standard, vous pouvez choisir d'exécuter le serveur de documentation comme un processus CGI (Common Gateway Interface) au-dessus d'un autre serveur déjà sur votre système (par exemple, Netscape Server ou Sun Web Server).

N'oubliez pas que les fonctions suivantes ne fonctionnent pas si vous changez le serveur Web AnswerBook2 par défaut :

Vous devrez utiliser les fonctions de démarrage et d'arrêt de votre serveur.

Utilisation d'un serveur CGI

Dans la mesure où les détails spécifiques varient d'un serveur Web à un autre, cette procédure décrit les étapes générales que vous devez suivre pour utiliser un serveur Web CGI à la place du serveur par défaut (plug-in NSAPI). Vous trouverez ci-après des exemples spécifiques pour Sun Web Server et Netscape Server.

  1. Désactivez le démarrage automatique du serveur AnswerBook2 lors de la réinitialisation du système.

    Utilisez la page Modifier la configuration du serveur de la page Administration d'AnswerBook2 ou la commande suivante :


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

  2. Arrêtez le serveur AnswerBook2 s'il est en cours d'exécution.

    Utilisez l'une des commandes suivantes :


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

# /etc/init.d/ab2mgr stop

  3. Editez le fichier de configuration de votre serveur Web et affichez les icônes disponibles.

    La documentation de votre serveur Web contient des explications spécifiques telles que l'emplacement du fichier de configuration. L'entrée /icons/ doit pointer vers /usr/lib/ab2/data/docs/icons/.

    Si /icons/ est déjà utilisé, liez tous les fichiers figurant dans /usr/lib/ab2/data/docs/icons/ au répertoire /icons/ existant.

  4. Liez les documents d'aide d'AnswerBook2 au répertoire racine contenant la documentation.

    Accédez au répertoire racine de votre serveur Web et créez un lien vers /usr/lib/ab2/data/docs/.

  5. Assurez-vous que les fichiers cgi d'AnswerBook2 sont disponibles sur le serveur.

    Accédez au répertoire cgi-bin de votre serveur Web et créez des liens vers :


    /usr/lib/ab2/bin/ab2bin/admin

/usr/lib/ab2/bin/ab2bin/nph-dweb

/usr/lib/ab2/bin/ab2bin/gettransbitmap

/usr/lib/ab2/bin/ab2bin/getepsf

/usr/lib/ab2/bin/ab2bin/getframe

/usr/lib/ab2/bin/ab2bin/ab2srwrap

  6. Editez le fichier de configuration de votre serveur et configurez /ab2/ de manière à appeler les scripts cgi d'AnswerBook2.

    La documentation de votre serveur Web contient des explications spécifiques, par exemple quant à l'emplacement du fichier de configuration. Vous devez remplacer l'entrée /ab2/ par /usr/lib/ab2/bin/ab2bin/nph-dweb/ab2/.

  7. Editez le fichier de configuration de l'administration d'AnswerBook2.

    Vous devez éditer le fichier /usr/lib/ab2/bin/ab2bin/nph-dweb et modifier les entrées pour servertype, errorlog et accesslog.

Utilisation du serveur Sun Web Server à l'aide de CGI

Par défaut, le fichier de configuration du Sun Web Server est /etc/http/httpd.conf, les fichiers résidant dans /var/http/demo/. Si vous n'avez pas installé SUNWab2u à l'emplacement par défaut (/usr/), tous les chemins qui commencent par /usr/lib/ab2/ doivent correspondre à l'emplacement d'installation des fichiers (par exemple, /usr2/lib/ab2/).

  1. Désactivez le démarrage automatique du serveur AnswerBook2 et éteignez le serveur.

    Utilisez les commandes suivantes :


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

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

  2. Editez le fichier /etc/http/httpd.conf et insérez la ligne suivante dans la section server du fichier :


    map /icons /usr/lib/ab2/data/docs/icons

    Une fois cette modification effectuée, utilisez la commande suivante pour redémarrer le serveur SWS :


    # /etc/init.d/httpd start

    Pour vérifier vos modifications, entrez l'URL suivante dans votre navigateur Web pour afficher une icône d'aide :


    http://localhost:port/icons/ab2_help.gif

    où port est le numéro du port sur lequel s'exécute votre serveur de documentation, le port par défaut étant 8888.

  3. Accédez au répertoire /var/http/demo/public/ et insérez-y le lien suivant :


    # ln -s /usr/lib/ab2/data/docs/Help Help

    Pour vérifier vos modifications, entrez l'URL suivante dans votre navigateur Web pour afficher une icône d'aide :


    http://localhost:port/Help/C/Help/books/Help/figures/ab2_help.gif

    où port est le numéro du port sur lequel s'exécute votre serveur de documentation, le port par défaut étant 8888.

  4. Accédez au répertoire /var/http/demo/cgi-bin/ et créez les liens suivants :


    # ln -s /usr/lib/ab2/bin/ab2bin/admin

# ln -s /usr/lib/ab2/bin/ab2bin/nph-dweb

# ln -s /usr/lib/ab2/bin/ab2bin/gettransbitmap

# ln -s /usr/lib/ab2/bin/ab2bin/getepsf

# ln -s /usr/lib/ab2/bin/ab2bin/getframe

# ln -s /usr/lib/ab2/bin/ab2bin/ab2srwrap

    Pour vérifier vos modifications, entrez l'URL suivante dans votre navigateur Web pour afficher la page de bibliothèque d'AnswerBook2 :


    http://localhost:port/cgi-bin/nph-dweb/ab2

    où port est le numéro du port sur lequel s'exécute votre serveur de documentation, le port par défaut étant 8888.

  5. Editez le fichier /etc/http/httpd.conf et ajoutez l'entrée suivante dans la section "host" du fichier :


    map /ab2 /var/http/demo/cgi-bin/nph-dweb/ab2 cgi

    Redémarrez le serveur SWS à l'aide de la commande suivante :


    # /etc/init.d/httpd start

    Pour vérifier vos modifications, entrez l'URL suivante dans votre navigateur Web pour afficher la page de bibliothèque d'AnswerBook2 :


    http://localhost:port/ab2

    où port est le numéro du port sur lequel s'exécute votre serveur de documentation, le port par défaut étant 8888.

  6. Editez le fichier /usr/lib/ab2/bin/ab2bin/nph-dweb et modifiez les entrées suivantes :


    setenv servertype sws

setenv errorlog

setenv accesslog /var/http/logs/http.elf.1
Utilisation d'un serveur Netscape Server à l'aide de CGI

Pour cet exemple, le fichier de configuration du serveur Netscape Server est /ul/netscape/suitespot/httpd-threads1/config/obj.conf, les fichiers résidant dans /ul/netscape/suitespot/docs/. Si vous n'avez pas installé SUNWab2u à l'emplacement par défaut (/usr/), tous les chemins qui commencent par /usr/lib/ab2/ doivent correspondre à l'emplacement d'installation des fichiers (par exemple, /usr2/lib/ab2/).

  1. Désactivez le démarrage automatique du serveur AnswerBook2 et éteignez le serveur.

    Utilisez les commandes suivantes :


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

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

  2. Editez le fichier /ul/netscape/suitespot/httpd-threads1/config/obj.conf et ajoutez la ligne suivante :


    NameTrans fn="pfx2dir" from="/icons" dir="/usr/lib/ab2/data/docs/icons"

    Pour vérifier vos modifications, redémarrez le serveur Netscape. Puis, entrez l'URL suivante dans votre navigateur Web pour afficher une icône d'aide :


    http://localhost:port/icons/ab2_help.gif

    où port est le numéro du port sur lequel s'exécute votre serveur de documentation, le port par défaut étant 8888.

  3. Accédez au répertoire /ul/netscape/suitespot/docs/ et insérez le lien suivant :


    # ln -s /usr/lib/ab2/data/docs/Help Help

    Pour vérifier vos modifications, entrez l'URL suivante dans votre navigateur Web pour afficher une icône d'aide :


    http://localhost:port/Help/C/Help/books/Help/figures/ab2_help.gif

    où port est le numéro du port sur lequel s'exécute votre serveur de documentation, le port par défaut étant 8888.

  4. Accédez au répertoire /ul/netscape/suitespot/cgi-bin/ et créez les liens suivants :


    # ln -s /usr/lib/ab2/bin/ab2bin/admin

# ln -s /usr/lib/ab2/bin/ab2bin/nph-dweb

# ln -s /usr/lib/ab2/bin/ab2bin/gettransbitmap

# ln -s /usr/lib/ab2/bin/ab2bin/getepsf

# ln -s /usr/lib/ab2/bin/ab2bin/getframe

# ln -s /usr/lib/ab2/bin/ab2bin/ab2srwrap

    Pour vérifier vos modifications, entrez l'URL suivante dans votre navigateur Web pour afficher la page de bibliothèque d'AnswerBook2 :


    http://localhost:port/cgi-bin/nph-dweb/ab2

    où port est le numéro du port sur lequel s'exécute votre serveur de documentation, le port par défaut étant 8888.

  5. Editez le fichier /ul/netscape/suitespot/httpd-threads1/config/obj.conf et ajoutez l'entrée suivante :


    NameTrans fn="pfx2dir" from="/ab2" 

dir="/ul/netscape/suitespot/cgi-bin/nph-dweb/ab2" name="cgi"

    Pour vérifier vos modifications, redémarrez le serveur Netscape et entrez l'URL suivante dans votre navigateur Web pour afficher la page de bibliothèque d'AnswerBook2 :


    http://localhost:port/ab2

    où port est le numéro du port sur lequel s'exécute votre serveur de documentation, le port par défaut étant 8888.

  6. Editez le fichier /usr/lib/ab2/bin/ab2bin/nph-dweb et modifiez les entrées suivantes :


    setenv servertype netscape

setenv errorlog /ul/netscape/suitespot/httpd-threads1/logs/errors

setenv accesslog /ul/netscape/suitespot/httpd-threads1/logs/access