test

Installation et administration d'un serveur AnswerBook2

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 WebServer).

Remarque :

Modifier le comportement du serveur à ce niveau requiert une très bonne connaissance du Web. Vous ne devez donc pas vous lancer dans cette tâche si vous ne connaissez pas parfaitement la configuration et les besoins spécifiques de votre serveur Web.

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
Remarque :

Compte tenu de la rapidité de l'évolution des technologies du Web, ce document ne peut décrire toutes les configurations de serveurs Web possibles. La procédure générale suivante doit donc être considérée comme un guide des opérations à réaliser. Vous devez parfaitement connaître la configuration et les besoins spécifiques de votre navigateur Web avant de commencer cette procédure.

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).

  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. Désactivez le contrôle d'accès administratif pour le serveur de documentation par défaut

    Utilisez la commande suivante : 


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

  3. 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

  4. 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, par exemple quant à l'emplacement du fichier de configuration. L'entrée /icons/ doit être modifiée pour 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.

    Une fois cette modification effectuée, redémarrez votre serveur.

    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.

  5. 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/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/AB2ADMIN/figures/ab2_help.gif

    où port est le numéro du port sur lequel s'exécute votre serveur de documentation.

  6. 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

    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.

  7. 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/.

    Pour vérifier vos modifications, redémarrez votre serveur 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.

  8. Pour que les utilisateurs puissent accéder au serveur de documentation sans spécifier /ab2 à la fin de l'URL, éditez le fichier de configuration de votre serveur et associez / à /ab2/.

    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 / par /ab2/ et ajouter un indicateur remote à l'association.

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


    http://localhost:port

    où port est le numéro du port sur lequel s'exécute votre serveur de documentation.

  9. 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.


    setenv servertype type_serveur
setenv errorlog chemin_complet_journal_erreurs
setenv accesslog chemin_complet_journal_acces

    où :

    • type_serveur identifie le serveur que vous exécutez, par exemple sws.

    • chemin_complet_journal_erreurs est le chemin d'accès du journal des erreurs de votre serveur Web.

    • chemin_complet_journal_accès est le chemin d'accès du journal des accès de votre serveur Web.

  10. Configurez le contrôle d'accès de l'interface d'administration AnswerBook2.

    Pour contrôler les utilisateurs autorisés à exécuter des fonctions administratives sur le serveur de documentation, utilisez les mécanismes de contrôle d'accès appropriés de votre serveur http de façon à limiter l'accès à l'URL suivante : /ab2/@Ab2Admin