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