Bibliothèque d'installation de Solaris 7 (Edition pour plate-forme SPARC)

Exécution du serveur d'AnswerBook2 en tant que processus CGI

Par défaut, le serveur de documentation AnswerBook2 s'exécute en tant qu'extension NSAPI au-dessus du serveur httpd fourni avec le module SUNWab2u. Le serveur d'AnswerBook2 étant conforme aux protocoles Web standard, vous pouvez exécuter le serveur de documentation en tant que processus CGI (Common Gateway Interface) au-dessus d'un autre serveur Web déjà installé sur votre système (par exemple, Netscape Server ou Sun Web Server).

Notez cependant que les fonctions suivantes seront inopérantes si vous n'utilisez pas le serveur Web d'AnswerBook2 par défaut :

Vous devrez utiliser les fonctions de lancement et d'arrêt de votre serveur à la place de ces commandes.

Pour utiliser un serveur basé CGI

Les serveurs Web pouvant présenter de légères différences, cette procédure décrit les étapes générales que vous devez suivre pour utiliser un serveur Web basé CGI au lieu du serveur par défaut (extension NSAPI). Vous trouverez ci-dessous des exemples spécifiques aux serveurs Sun Web Server et Netscape Server.

  1. Arrêtez le serveur d'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
    
  2. Modifiez le fichier de configuration de votre serveur Web de façon que les icônes soient disponibles.

    Vous devriez trouver plus d'informations dans la documentation de votre serveur Web, par exemple l'emplacement du fichier de configuration. L'entrée /icons/ doit pointer sur /usr/lib/ab2/data/docs/icons/.

    Si l'entrée /icons/ est déjà utilisée, liez tous les fichiers de /usr/lib/ab2/data/docs/icons/ au répertoire /icons/ existant.

  3. Liez les documents de l'aide d'AnswerBook2 au répertoire racine actuel de la documentation.

    Placez-vous dans le répertoire racine de la documentation de votre serveur Web et créez un lien symbolique vers /usr/lib/ab2/data/docs/.

  4. Rendez les fichiers cgi-bin d'AnswerBook2 accessibles à votre serveur.

    Placez-vous dans le répertoire cgi-bin de votre serveur Web et créez des liens symboliques vers :


    /usr/lib/ab2/bin/cgi/admin
    
    /usr/lib/ab2/bin/cgi/nph-dweb
    
    /usr/lib/ab2/bin/cgi/gettransbitmap
    
    /usr/lib/ab2/bin/cgi/getepsf
    
    /usr/lib/ab2/bin/cgi/getframe
    
    /usr/lib/ab2/bin/cgi/ab2srwrap
  5. Modifiez le fichier de configuration de votre serveur Web de façon que /ab2/ appelle les répertoires cgi d'AnswerBook2.

    Vous devriez trouver plus d'informations dans la documentation de votre serveur Web, par exemple l'emplacement du fichier de configuration. Vous devrez définir l'entrée /ab2/ à /usr/lib/ab2/bin/cgi/nph-dweb/ab2/.

  6. Modifiez le fichier de configuration de l'administration d'AnswerBook2.

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

Exécution d'un serveur d'AnswerBook2 en tant que processus CGI sur Sun WebServer

Par défaut, le fichier de configuration de Sun Web Server est /etc/http/httpd.conf et ses fichiers sont stockés dans /var/http/demo/. Si vous n'avez pas installé dans l'emplacement par défaut (/usr/), tous les chemins commençant par /usr/lib/ab2/ doivent être remplacés par des chemins commençant par le chemin où les fichiers sont installés (par exemple, /usr2/lib/ab2/).

  1. Editez le fichier /etc/http/httpd.conf et placez la ligne suivante dans sa section server :


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

    Ensuite, utilisez la commande suivante pour relancer le serveur SWS :


    # /etc/init.d/httpd start
    

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


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

    port est le numéro du port sur lequel votre serveur de documentation s'exécute (8888 par défaut).

  2. Placez-vous dans le répertoire /var/http/demo/public/ et créez le lien symbolique suivant :


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

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


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

    port est le numéro du port sur lequel votre serveur de documentation s'exécute (8888 par défaut).

  3. Placez-vous dans le répertoire /var/http/demo/cgi-bin/ et créez les liens symboliques suivants :


    # ln -s /usr/lib/ab2/bin/cgi/admin
    
    # ln -s /usr/lib/ab2/bin/cgi/nph-dweb
    
    # ln -s /usr/lib/ab2/bin/cgi/gettransbitmap
    
    # ln -s /usr/lib/ab2/bin/cgi/getepsf
    
    # ln -s /usr/lib/ab2/bin/cgi/getframe
    
    # ln -s /usr/lib/ab2/bin/cgi/ab2srwrap

    Entrez l'URL suivante dans votre navigateur Web pour afficher la page de bibliothèques d'AnswerBook2 et vérifier vos modifications :


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

    port est le numéro du port sur lequel votre serveur de documentation s'exécute (8888 par défaut).

  4. Editez le fichier /etc/http/httpd.conf et ajoutez la ligne suivante dans sa section host :


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

    Relancez le serveur SWS en utilisant la commande suivante :


    # /etc/init.d/httpd start
    

    Entrez l'URL suivante dans votre navigateur Web pour afficher la page de bibliothèques d'AnswerBook2 et vérifier vos modifications :


    http://localhost:port/ab2
    

    port est le numéro du port sur lequel votre serveur de documentation s'exécute (8888 par défaut).

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


    setenv servertype sws
    
    setenv errorlog
    
    setenv accesslog /var/http/logs/http.elf.1
Exécution d'un serveur d'AnswerBook2 en tant que processus CGI sur Netscape Server

Dans cet exemple, le fichier de configuration de Netscape Server est /ul/netscape/suitespot/httpd-threads1/config/obj.conf et ses fichiers résident dans /ul/netscape/suitespot/docs/. Si vous n'avez pas installé dans l'emplacement par défaut (/usr/), tous les chemins commençant par /usr/lib/ab2/ doivent être remplacés par des chemins commençant par le chemin où les fichiers sont installés (par exemple, /usr2/lib/ab2/).

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


    NameTrans fn="pfx2dir" from="/ab2" 
    
    dir="/ul/netscape/suitespot/cgi-bin/nph-dweb/ab2" name="cgi"

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


    http://localhost:port/icons/ab2_help.gif
    
  2. Placez-vous dans le répertoire /ul/netscape/suitespot/docs/ et créez le lien symbolique suivant :


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

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


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

    port est le numéro du port sur lequel votre serveur de documentation s'exécute (8888 par défaut).

  3. Placez-vous dans le répertoire /ul/netscape/suitespot/cgi-bin/ et créez les liens symboliques suivants :


    # ln -s /usr/lib/ab2/bin/cgi/admin
     
    # ln -s /usr/lib/ab2/bin/cgi/nph-dweb
     
    # ln -s /usr/lib/ab2/bin/cgi/gettransbitmap
     
    # ln -s /usr/lib/ab2/bin/cgi/getepsf
     
    # ln -s /usr/lib/ab2/bin/cgi/getframe
     
    # ln -s /usr/lib/ab2/bin/cgi/ab2srwrap
    

    Entrez l'URL suivante dans votre navigateur Web pour afficher la page de bibliothèques d'AnswerBook2 et vérifier vos modifications :


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

    port est le numéro du port sur lequel votre serveur de documentation s'exécute (8888 par défaut).

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


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

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


    http://localhost:port/ab2
    

    port est le numéro du port sur lequel votre serveur de documentation s'exécute (8888 par défaut).

  5. Editez le fichier /usr/lib/ab2/bin/cgi/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