test

Installationsbibliotek för Solaris 7 (SPARC-version)

Köra AnswerBook2-servern som en CGI-process

Som standard körs AnswerBook2-dokumentationsservern som en NSAPI-tilläggsmodul över httpd-servern som ingår i SUNWab2u-paketet. AnswerBook2-servern är kompatibel med standardwebbprotokollen, och du kan därför välja att köra dokumentationsservern som en CGI-process (Common Gateway Interface) över en annan webbserver som redan finns i systemet (t ex Netscape Server eller Sun Web Server).

Tänk på att följande funktioner inte kan användas om du använder en annan webbserver ä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

Vissa detaljer skiljer sig åt mellan olika webbservrar, och i de här anvisningarna beskrivs därför de allmänna steg som du måste följa om du vill använda en CGI-baserad webbserver i stället för standardservern (NSAPI-tilläggsmodul). Nedan följer exempel på Sun Web Server och Netscape Server.

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

  2. Redigera webbserverns konfigurationsfil och gör ikonerna tillgängliga.

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

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

  3. Skapa länkar för AnswerBook2-hjälpdokumenten till den aktuella rotkatalogen för dokumentationen.

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

  4. Gör AnswerBook2-cgi-bin-filerna tillgängliga för servern.

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


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

    I dokumentationen till webbservern hittar du detaljerade anvisningar, t ex om var konfigurationsfilen finns. Du måste ändra posten för /ab2/ till /usr/lib/ab2/bin/cgi/nph-dweb/ab2/.

  6. Redigera AnswerBook2-administrationskonfigurationsfilen.

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

Så här kör du en AnswerBook2-server som en CGI-process på Sun WebServer

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 i standardkatalogen (/usr/), ska alla sökvägar som börjar med /usr/lib/ab2/ vara sökvägen till den katalog där du har installerat filerna (t ex /usr2/lib/ab2/).

  1. Redigera filen /etc/http/httpd.conf och infoga följande rad i filens server-avsnitt:


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

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


    # /etc/init.d/httpd start

    Om du vill kontrollera dina ändringar anger du följande URL-adress i din webbläsare, så visas en hjälpikon:


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

    Där port är portnummret där din dokumentserver körs. Standardnummer är 8888.

  2. Gå till katalogen /var/http/demo/public/ och infoga följande mjuka länk:


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

    Om du vill kontrollera dina ändringar anger du följande URL-adress i din webbläsare, så visas en hjälpikon:


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

    Där port är portnummret där din dokumentserver körs. Standardnummer är 8888.

  3. Gå till katalogen /var/http/demo/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

    Om du vill kontrollera dina ändringar anger du följande URL-adress i din webbläsare, så visas bibliotekssidan för AnswerBook2:


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

    Där port är portnummret där din dokumentserver körs. Standardnummer är 8888.

  4. Redigera filen /etc/http/httpd.conf och infoga följande post i filens värdavsnitt:


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

    Starta om SWS-servern med följande kommando:


    # /etc/init.d/httpd start

    Om du vill kontrollera dina ändringar anger du följande URL-adress i din webbläsare, så visas bibliotekssidan för AnswerBook2:


    http://localhost:port/ab2

    Där port är portnummret där din dokumentserver körs. Standardnummer är 8888.

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


    setenv servertype sws
setenv errorlog
setenv accesslog /var/http/logs/http.elf.1
Så här kör du en AnswerBook2-server som en CGI-process på Netscape Server

I det här exemplet ä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 i standardkatalogen (/usr/), ska alla sökvägar som börjar med /usr/lib/ab2/ vara sökvägen till den katalog där du har installerat filerna (t ex /usr2/lib/ab2/).

  1. Redigera filen /ul/netscape/suitespot/httpd-threads1/config/obj.conf och lägg till följande rad:


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

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


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

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


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

    Om du vill kontrollera dina ändringar anger du följande URL-adress i din webbläsare, så visas en hjälpikon:


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

    Där port är portnummret där din dokumentserver körs. Standardnummer är 8888.

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

    Om du vill kontrollera dina ändringar anger du följande URL-adress i din webbläsare, så visas bibliotekssidan för AnswerBook2:


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

    Där port är portnummret där din dokumentserver körs. Standardnummer är 8888.

  4. Redigera filen /ul/netscape/suitespot/httpd-threads1/config/obj.conf och lägg till följande post:


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

    Om du vill kontrollera dina ändringar startar du om Netscape-servern och skriver följande URL i webbläsaren så visas bibliotekssidan för AnswerBook2:


    http://localhost:port/ab2

    Där port är portnummret där din dokumentserver körs. Standardnummer är 8888.

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