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 :
/usr/lib/ab2/bin/ab2admin -o start ;
/usr/lib/ab2/bin/ab2admin -o stop ;
/etc/init.d/ab2mgr start ;
/etc/init.d/ab2mgr stop ;
restart (à partir de la GUI d'administration).
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.
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" |
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.
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/.
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" |
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/.
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 .
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/).
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 |
Où port est le numéro du port sur lequel votre serveur de documentation s'exécute (8888 par défaut).
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 |
Où port est le numéro du port sur lequel votre serveur de documentation s'exécute (8888 par défaut).
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 |
Où port est le numéro du port sur lequel votre serveur de documentation s'exécute (8888 par défaut).
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 |
Où port est le numéro du port sur lequel votre serveur de documentation s'exécute (8888 par défaut).
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 |
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/).
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, 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 |
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 |
Où port est le numéro du port sur lequel votre serveur de documentation s'exécute (8888 par défaut).
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 |
Où port est le numéro du port sur lequel votre serveur de documentation s'exécute (8888 par défaut).
Editez le fichier /ul/netscape/suitespot/httpd-threads1/config/obj.conf et ajoutez l'entrée ligne suivante :
NameTrans fn="pfx2dir" from="/ab2" dir="/ul/netscape/suitespot/cgi-bin/nph-dweb/ab2" name="cgi" |
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 |
Où port est le numéro du port sur lequel votre serveur de documentation s'exécute (8888 par défaut).
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 |