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


Obs!

Det krävs "expertkunskaper" för att ändra serverns funktionalitet på den här nivån. Du bör inte försöka att utföra den här uppgiften om du inte redan har stor kunskap om hur webbservern är konfigurerad och hur den fungerar.


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

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

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

Obs!

Eftersom webbservertekniken utvecklas så snabbt finns inte alla webbserverkonfigurationer med här. Det här är riktlinjer för hur du ska gå tillväga. Du bör ha goda kunskaper om webbläsarens konfiguration och funktioner innan du utför den här proceduren.


Här beskrivs de steg som du måste följa om du vill använda en CGI-baserad webbserver i stället för standardservern (plugin-programmet NSAPI).

  1. Inaktivera automatisk start av AnswerBook2-servern när systemet startas om.

    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 administrativ behörighetskontroll för standarddokumentationsservern.

    Använd följande kommando:


    # /usr/lib/ab2/bin/ab2admin -o access_off
    
  3. 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
    
  4. Redigera webbserverns konfigurationsfil och visa ikoner.

    I dokumentationen till din webbserver bör det finnas information om 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.

    När du har gjort de här ändringarna startar du om servern.

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

  5. 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/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/AB2ADMIN/figures/ab2_help.gif
    

    där port är portnumret som dokumentationsservern körs på.

  6. Se till att cgi-filerna för AnswerBook2 är tillgängliga för servern.

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


    /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

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

  7. Redigera konfigurationsfilen för servern och avbilda /ab2/ om du vill kalla AnswerBook2 cgi.

    I dokumentationen till din webbserver bör det finnas information om var du hittar konfigurationsfilen. Du måste ändra posten för /ab2/ till /usr/lib/ab2/bin/ab2bin/nph-dweb/ab2/.

    Kontrollera ändringarna genom att starta om 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å.

  8. Om du vill att användarna ska komma åt dokumentationsservern utan att de måste ange /ab2 i slutet av adressen redigerar du serverns konfigurationsfil och avbildar / till /ab2/.

    I dokumentationen till din webbserver bör det finnas information om var du hittar konfigurationsfilen. Du måste ändra posten för / till /ab2/ och lägga till en remote-flagga i mappningen.

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


    http://localhost:port
    

    där port är portnumret som dokumentationsservern körs på.

  9. Redigera konfigurationsfilen för administration av AnswerBook2.

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


    setenv servertype servertyp
    setenv errorlog fullständig_sökväg_till_felloggen
    setenv accesslog fullständig_sökväg_till_åtkomstloggen
    

    där:

    • servertyp anger den server du kör, t ex sws.

    • fullständig_sökväg_till_felloggen är sökvägen till webbserverns fellogg.

    • fullständig_sökväg_till_åtkomstloggen är sökvägen till webbserverns åtkomstlogg.

  10. Ange behörighet till gränssnittet för administrationsgränssnittet för AnswerBook2.

    Med hjälp av http-serverns mekanismer för åtkomstkontroll kan du bestämma vem som ska kunna utföra administrativa funktioner på dokumentationsservern genom att begränsa åtkomsten till följande adress: /ab2/@Ab2Admin