test

Installera och administrera en AnswerBook2-server

Köra AnswerBook2-servern som en CGI-process

Som standard körs AnswerBook2-dokumentationsservern som en NSAPI-plug-in-modul ovanpå den httpd-server som ingår i paketet SUNWab2u. AnswerBook2-servern är kompatibel med standardwebbprotokoll, och du kan därför välja att köra dokumentationsservern som en CGI-process (Common Gateway Interface) ovanpå en annan webbserver som redan finns i systemet (t ex en Netscape-server eller en Sun-webbserver).

Tänk på att följande funktioner inte kan användas om du byter från AnswerBook2-standardwebbservern:

Du måste använda serverns start- och stoppfunktioner i stället.

Så här byter du till en CGI-baserad server

Det finns flera olika slags webbservrar, men här får du bara allmänna anvisningar för hur du gör om du vill använda en CGI-baserad webbserver i stället för standardservern (NSAPI-plug-in). Nedan finns särskilda exempel för Sun Web Server och Netscape Server.

  1. Se till att funktionen för att starta AnswerBook2-servern automatiskt vid omstart är avstängd.

    Använd antingen sidan Ändra serverkonfiguration på administrationssidan för AnswerBook2 eller följande kommando:


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

  2. Stäng av AnswerBook2-servern om den körs.

    Använd ett av följande kommandon:


    # /usr/lib/ab2/bin/ab2admin -o stop
# /etc/init.d/ab2mgr stop

  3. Redigera webbserverns konfigurationsfil och visa ikoner.

    I dokumentationen till webbservern beskrivs detaljerna, t ex var du hittar konfigurationsfilen. Posten /icons/ ska peka på /usr/lib/ab2/data/docs/icons/.

    Om /icons/ redan används länkar du alla filer i /usr/lib/ab2/data/docs/icons/ till den befintliga /icons/-katalogen.

  4. Länka AnswerBook2-hjälpdokument till den aktuella dokumentationsroten.

    Gå till webbserverns dokumentationsrotkatalog och skapa en symbolisk (mjuk) länk till /usr/lib/ab2/data/docs/.

  5. Gör cgi-filerna för AnswerBook2 tillgängliga på servern.

    Gå till webbserverns cgi-bin-katalog och skapa symboliska länkar till följande:


    /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. Redigera serverns konfigurationsfil och avbilda /ab2/ så att AnswerBook2-cgi anropas.

    I dokumentationen till webbservern beskrivs detaljerna, t ex var du hittar konfigurationsfilen. Du måste ändra posten för /ab2/ till /usr/lib/ab2/bin/ab2bin/nph-dweb/ab2/.

  7. Redigera konfigurationsfilen för AnswerBook2-administration.

    Du måste redigera filen /usr/lib/ab2/bin/ab2bin/nph-dweb och ändra posterna för servertype, errorlog och accesslog.

Så här byter du till Sun Web Server med CGI

Som standard är konfigurationsfilen för Sun Web Server /etc/http/httpd.conf, och filerna finns i /var/http/demo/. Om du inte har installerat SUNWab2u på standardplatsen (/usr/), ska alla sökvägar som börjar med /usr/lib/ab2/ ändras till den sökväg som du har installerat filerna på (t ex /usr2/lib/ab2/).

  1. Stäng av den automatiska starten av AnswerBook2-servern och stäng av servern.

    Använd följande kommandon:


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

  2. Redigera filen /etc/http/httpd.conf och lägg till följande rad i server-delen i filen:


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

    När du har gjort de här ändringarna startar du om SWS-servern med följande kommando:


    # /etc/init.d/httpd start

    Kontrollera ändringarna genom att skriva följande URL i webbläsaren, så att en hjälpikon visas :


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

    Där port är portnumret som dokumentationsservern körs på (som standard 8888).

  3. Gå till katalogen /var/http/demo/public/ och lägg till följande symboliska länk:


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

    Kontrollera ändringarna genom att skriva följande URL i webbläsaren, så att en hjälpikon visas :


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

    Där port är portnumret som dokumentationsservern körs på (som standard 8888).

  4. Gå till katalogen /var/http/demo/cgi-bin/ och skapa följande symboliska länkar:


    # 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

    Kontrollera ändringarna genom att skriva följande URL i webbläsaren, så att AnswerBook2-bibliotekssidorna visas:


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

    Där port är portnumret som dokumentationsservern körs på (som standard 8888).

  5. Redigera filen /etc/http/httpd.conf och lägg till följande post i filens värddel:


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

    Starta om SWS-servern med följande kommando:


    # /etc/init.d/httpd start

    Kontrollera ändringarna genom att skriva följande URL i webbläsaren, så att AnswerBook2-bibliotekssidorna visas:


    http://localhost:port/ab2

    Där port är portnumret som dokumentationsservern körs på (som standard 8888).

  6. Redigera filen /usr/lib/ab2/bin/ab2bin/nph-dweb och ändra följande poster:


    setenv servertype sws
setenv errorlog
setenv accesslog /var/http/logs/http.elf.1
Så här byter du till Netscape Server med CGI

Som standard är konfigurationsfilen för Netscape Server /ul/netscape/suitespot/httpd-threads1/config/obj.conf, och filerna finns i /ul/netscape/suitespot/docs/. Om du inte har installerat SUNWab2u på standardplatsen (/usr/), ska alla sökvägar som börjar med /usr/lib/ab2/ ändras till den sökväg som du har installerat filerna på (t ex /usr2/lib/ab2/).

  1. Stäng av den automatiska starten av AnswerBook2-servern och stäng av servern.

    Använd följande kommandon:


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

  2. Redigera filen /ul/netscape/suitespot/httpd-threads1/config/obj.conf och lägg till den här raden:


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

    Kontrollera dina ändringar genom att starta om Netscape Server. Skriv sedan följande URL i webbläsaren, så att en hjälpikon visas :


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

    Där port är portnumret för dokumentationsservern, som standard är det 8888.

  3. Gå till katalogen /ul/netscape/suitespot/docs/ och lägg till följande mjuka länk:


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

    Kontrollera ändringarna genom att skriva följande URL i webbläsaren, så att en hjälpikon visas :


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

    Där port är portnumret som dokumentationsservern körs på (som standard 8888).

  4. Gå till katalogen /ul/netscape/suitespot/cgi-bin/ och skapa följande mjuka länkar:


    # 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

    Kontrollera ändringarna genom att skriva följande URL i webbläsaren, så att AnswerBook2-bibliotekssidorna visas:


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

    Där port är portnumret som dokumentationsservern körs på (som standard 8888).

  5. Redigera filen /ul/netscape/suitespot/httpd-threads1/config/obj.conf och lägg till den här posten:


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

    Kontrollera ändringarna genom att starta om Netscape-servern och skriva följande URL i webbläsaren, så att AnswerBook2-bibliotekssidorna visas:


    http://localhost:port/ab2

    Där port är portnumret som dokumentationsservern körs på (som standard 8888).

  6. Redigera filen /usr/lib/ab2/bin/cgi/nph-dweb och ändra följande poster:


    setenv servertype netscape
setenv errorlog /ul/netscape/suitespot/httpd-threads1/logs/errors
setenv accesslog /ul/netscape/suitespot/httpd-threads1/logs/access