test

Installationsbibliotek för Solaris 7 (SPARC-version)

Installera programvara för en dokumentationsserver

I det här avsnittet förklaras vad som krävs för att serverprogramvaran AnswerBook2 ska kunna installeras samt vilka beslut som måste tas före installationen.

Det här avsnittet vänder sig bara till den person som administrerar ett AnswerBook2-serversystem. Användare som bara läser onlinedokumentationen behöver inte läsa det här avsnittet. Det krävs ingen speciell installation för att bli en AnswerBook2-klient.

Obs!

Observera att det inte finns någon åtkomstkontroll på klientnivå för den här produkten. Om en klientdator har tillgång till dokumentserverns URL, kan dokumenten på servern läsas.

Det här avsnittet innehåller följande information:

Detaljerad information om hur man administrerar en dokumentserver finns i onlinehjälpen som är tillgänglig i AnswerBook2-gränssnittet när du har installerat programvaran för dokumentservern.

Innan du installerar serverprogramvaran

Innan du startar installationen bör du kontrollera att systemet klarar kraven som finns i listan i "Maskin- och programvarukrav" och bestämma var du vill installera programmet, enligt förklaringen i "Installationsalternativ".

Maskin- och programvarukrav

Innan du startar installationsprocessen kontrollerar du att systemen där du tänker installera programvaran för AnswerBook2-servern uppfyller maskin- och programvarukraven enligt Tabell 8-2 och Tabell 8-3.

Tabell 8-2 Maskin- och programvarukrav

Komponent 

Krav 

Systemmaskinvara för dokumentationsservrar 

SPARCstationTM 2-dator eller bättre (SPARCstation 5-dator rekommenderas)

Intel-baserad persondator 

Operativmiljö 

Solaris 7 (för SPARC eller x86) 

Administrativt gränssnitt och AnswerBook2-klient visningsprogram 

Valfri HTML 3.2-kompatibel läsare, t ex Netscape Navigator, HotJava eller Lynx 

Tabell 8-3 Diskutrymmeskrav

Sökväg till katalog 

Beskrivning 

Utrymme 

/usr/lib/ab2/

Innehåller körbara filer, serverbearbetande filer, biblioteksfiler, grafikfiler och dokumentkällfiler för produktgränssnittet. 

26,0 MB 

/var/log/ab2/

Innehåller katalogfiler och loggfiler, om loggningsfunktioner är aktiverade. 

5,0 MB (rekommenderas - ökar när servern används) 

/etc/init.d/ab2mgr

Serverstartfil 

0,01 MB 

Du bör dessutom reservera en viss mängd diskutrymme för själva bokfilerna (600 MB rekommenderas). Den exakta mängden utrymme som krävs beror på de specifika samlingarna. En lista över uppsättningarna på dokumentations-CD för Solaris 7 finns i filen README på CD:n.

Installationsalternativ

Innan du installerar AnswerBook2-serverprogramvara, bör du gå igenom de olika installationsalternativen:

Så här installerar du AnswerBook2-serverprogramvaran

Du kan installera dokumentationsserverprogramvaran genom att peka och klicka i Solaris Web StartTM-verktyget eller med hjälp av standardinstallationsverktyg, t ex pkgadd .

  1. Sätt in dokumentations-CD för Solaris 7 i din CD-ROM-enhet.

    Volymhanteraren monterar CD-skivan automatiskt.

  2. Om du vill installera produkterna med verktyget Solaris Web Start dubbelklickar du på ikonen installer, följer anvisningarna i Web Start och går till Steg 6.

    I Web Start-verktyget finns det förvalda paketgrupper som du kan installera. Fortsätt genom att följa anvisningarna i Web Start.

  3. Om du vill använda något av verktygen pkgadd eller swmtool måste du logga in som superanvändare på dokumentationsservern.

    Skriv t ex följande på kommandoraden:


    % su -

  4. Byt katalog till den som innehåller dokumentationsserverpaketen.

    Du kan t ex skriva följande kommando för att komma till den katalog som innehåller serverprogrampaketen för en SPARC-server:


    # cd cdrom/Solaris_2.7_Doc/sparc/Product/

    Där cdrom är monteringspunkten för CD-ROM-enheten. Som standard används: /cdrom/sol_2_7_doc

  5. Starta installationsverktyget och välj serverprogramvarupaketen.

    Du kan t ex starta verktyget pkgadd med följande kommando:


    # pkgadd -d .

    Välj serverprogramvarupaketen:

    • SUNWab2r (0,25 MB) - Installeras i rotpartitionen och innehåller konfigurations- och startfiler.

    • SUNWab2s (1,0 MB) - Innehåller delade filer för dokumentbearbetning.

    • SUNWab2u (26,0 MB) - Innehåller körbara filer och back-end-bearbetningsfiler för server- och administrationsfunktioner.

  6. Starta servern om det behövs.

    När paketen installeras bör servern starta på standardporten 8888. Om den inte startas använder du följande kommando för att starta den:


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

  7. Installera bokuppsättningar.

    Dokumentationsservern fungerar inte om inga dokument är installerade på den. Du kan installera uppsättningar från dokumentations-CD för Solaris 7 eller från andra platser, t ex befintliga dokumentuppsättningar eller uppsättningar på andra CD-skivor. Mer information om hur du installerar dokumentuppsättningar finns i "Så här installerar du dokumentuppsättningar på servern".

  8. (Valfritt) Byt konfigurationsfiler och skapa länkar för att köra dokumentationsservern som en CGI-process på en befintlig httpd-server.

    Om du redan kör en httpd-server på systemet kan du köra dokumentationsservern som en CGI-process på servern. Du måste installera standardprogramvaran för dokumentationsservern och sedan byta ut flera konfigurationsfiler och skapa länkar för att köra dokumentationsservern som en CGI-process. Mer information finns i "Köra AnswerBook2-servern som en CGI-process".

  9. (Valfritt) Registrera en server.

    Om du vill att andra användare automatiskt ska hitta din dokumentserver via FNS (Federated Naming Services) måste du registrera servern. Du registrerar servern med följande kommando:


    # /usr/lib/ab2/bin/ab2regsvr server_url

    Där server_url är en fullständig URL-adress till den här servern (till exempel: http://imaserver.eng.sun.com:8888/). Mer information finns i "Registrera servern".

Så här installerar du dokumentuppsättningar på servern

Dokumentationsservern fungerar inte om inga dokument är installerade på den. Du kan installera uppsättningar från dokumentations-CD för Solaris 7 eller från andra platser, t ex befintliga dokumentuppsättningar eller uppsättningar på andra CD-skivor.

Du kan installera dokumentuppsättningspaketen från dokumentations-CD för Solaris 7 genom att peka och klicka i verktyget Solaris Web Start eller med hjälp av standardinstallationsverktyg, t ex pkgadd. Så här installerar du dokumentuppsättningar:

  1. Sätt in dokumentations-CD för Solaris 7 i din CD-ROM-enhet.

    Volymhanteraren monterar CD-skivan automatiskt.

  2. Om du vill installera produkterna med verktyget Solaris Web Start dubbelklickar du på ikonen installer, följer anvisningarna i Web Start och går till Steg 6.

    I Web Start-verktyget finns det förvalda paketgrupper som du kan installera. Fortsätt genom att följa anvisningarna i Web Start.

  3. Om du vill använda något av verktygen pkgadd eller swmtool måste du logga in som superanvändare på dokumentationsservern.

    Skriv t ex följande på kommandoraden:


    % su -

  4. Byt katalog till den som innehåller dokumentuppsättningspaketen.

    Till exempel:


    # cd cdrom/Solaris_2.7_Doc/common/Product/

    Där cdrom är monteringspunkten för CD-ROM-enheten. Som standard används /cdrom/sol_2_7_doc.

  5. Starta installationsverktyget och välj de dokumentationsuppsättningspaket som du vill installera.

    Så här startar du t ex verktyget pkgadd:


    # pkgadd -d .

    En detaljerad lista över uppsättningarna på dokumentations-CD för Solaris 7 finns i filen README på CD:n.

  6. I dokumentuppsättningspaketen på dokumentations-CD för Solaris 7 ingår en kommandofil som används efter installationen för att lägga till uppsättningarna i serverdatabasen och starta om servern.

    Om du installerar uppsättningspaket från någon annan plats än dokumentations-CD för Solaris 7 bör du antingen använda funktionen Lägg till samling i lista i det administrativa gränssnittet eller kommandot ab2admin -o add_coll för att lägga till de här uppsättningarna i dokumentationsserverns databas.

    Om uppsättningspaket redan är installerade i systemet kan du använda funktionen Sök efter lokalt installerade samlingar i administrationsgränssnittet eller kommandot ab2admin -o scan för att automatiskt leta reda på dem och lägga till dem i dokumentationsserverns databas. Den här funktionen fungerar bara för lokalt installerade paket.

    Om du vill tilllhandahålla dokumentuppsättningar som finns i ett annat system använder du funktionen Lägg till samling i lista eller kommandot ab2admin -o add_coll och anger den fullständiga sökvägen till filen ab_cardcatalog eller collinfo. Om dokumentationsservern t ex är imaserver och du vill att den ska tillhandahålla dokumentuppsättningar som finns på systemet annat_system, kan du använda följande kommando: 


    # /usr/lib/ab2/bin/ab2admin -o add_coll -d /net/elsewhere/books/SUNWdtad/collinfo

Registrera servern

Om du vill ge användarna möjlighet att hitta dokumentationsservern utan att känna till URL:en kan du registrera serverns namn i FNS-systemet. Användare kan fortfarande komma åt oregistrerade dokumentationsservrar om de känner till URL:en.

Hur du registrerar servern beror på två faktorer:

Registrera servern med kommandot ab2regsvr

Du registrerar servern med kommandot ab2regsvr. Kommandot ab2regsvr läser systemets konfiguration och anger lämplig namnrymd för servern.

Du registrerar servern genom att skriva:


# /usr/lib/ab2/bin/ab2regsvr server_url

Där server_url är en fullständig URL-adress till den här servern (till exempel: http://imaserver.eng.sun.com:8888/).

Kommandot ab2regsvr har också några andra alternativ som kan vara användbara:

Mer information om kommandot ab2regsvr finns i direkthjälpsavsnittet (man page) ab2regsvr(1m).

Registrera servern med FNS-standardkommandon

Om du vill registrera servern med FNS-kommandon och FNS redan är installerat på din arbetsplats, registrerar du den angivna URL:en som dokumentationsserver för ditt företag (domän) med hjälp av följande kommando: 


# fnbind -r thisorgunit/server/answerbook2 onc_answerbook2 \
onc_addr_answerbook2 server_url

Där server_url är en fullständig URL-adress till den här servern (till exempel: http://imaserver.eng.sun.com:8888/).

Om du vill veta vilka servrar som är registrerade använder du följande kommando: 


% fnlookup -v thisorgunit/service/answerbook2

Det här ger en lista över registrerade servrar som ser ut ungefär så här:


Reference type: onc_answerbook2
Address type: onc_addr_answerbook2
  length: 19
  data: 0x68 0x74 0x74 0x70 0x3a 0x2f 0x2f 0x61 0x6e 0x73  http://ans
        0x77 0x65 0x72 0x73 0x3a 0x38 0x38 0x38 0x38       wers:8888

I det här exemplet är den registrerade servern http://answers:8888/.

Om du får ett svar som liknar det följande finns inga dokumentationsservrar registrerade i FNS.


Lookup of 'thisorgunit/service/answerbook2' failed: \
Name Not Found: 'answerbook2'

Mer information om FNS, t ex hur du installerar det, finns i FNS-dokumentationen.

Namntjänster och AnswerBook2-användare

I stället för att använda de beskrivna namntjänsterna för att hitta en dokumentserver kan användaren definiera en standard-AnswerBook2-server med hjälp av omgivningsvariabeln AB2_DEFAULTSERVER. Filen .cshrc kan t ex innehålla följande rad:


setenv AB2_DEFAULTSERVER http://imaserver.eng.sun.com:8888

Om användaren inte har definierat en omgivningsvariabel och startar AnswerBook2 från skrivbordssystemet letar programmet efter en dokumentationsserver i det system som det startades på. Om detta är fallet startas programmet med följande URL: http://localhost:port, där port som standard har värdet 8888.

När användaren startar AnswerBook2 från skrivbordssystemet utför systemet kommandot fnlookup thisorgunit/service/answerbook2 för att ta reda på vilka dokumentservrar som är tillgängliga, om användaren inte har definierat en omgivningsvariabel. Därefter väljer systemet en server och startar AnswerBook2-läsaren med servernamnet som URL.

Så här kör du en dokumentationsserver från dokumentations-CD för Solaris 7

  1. Sätt in dokumentations-CD för Solaris 7 i din CD-ROM-enhet.

  2. Kontrollera att du är inloggad som superanvändare. 


    % su -

  3. Byt katalog till (eller öppna och gå till) översta nivån på CD:n.

    Det bör se ut så här: 


    /cdrom/sol_2_7_doc/

    Den här katalogen innehåller en katalog, en README-fil, verktyget installer och kommandofilen ab2cd. Med hjälp av kommandofilen ab2cd kan du köra dokumentationsservern direkt från CD:n.

  4. Skriv följande kommando:


    # ./ab2cd

  5. Öppna dokumentationsservern med följande URL: 


    http://server:8888/

    Där server är namnet på den dator som CD-skivan är kopplad till.

    Observera att en dokumentationsserver som körs från CD:n alltid körs på port 8888.

  6. (Valfritt) Om det redan finns dokumentuppsättningar installerade på servern och du vill att programvaran för den CD-drivna servern ska kunna identifiera uppsättningarna använder du följande kommando: 


    # ab2cd -s

    När du använder den här formen av kommandot kan den CD-drivna serverprogramvaran leta efter andra uppsättningar som är installerade på systemet och lägga till dem i databasen.

  7. Om du vill att servern inte längre ska köras från CD:n skriver du: 


    # /cdrom/sol_2_7_doc/ab2cd stop
Varning! Varning!

En dokumentationsserver som körs direkt från CD:n är oftast ganska långsam. Du bör därför inte använda den här metoden om flera användare ska använda dokumentationsservern.

Viktigt att tänka på när du kör AnswerBook2-servern från CD:n

Tänk på följande när du kör servern från CD:n.

Viktigt att tänka på när du kör två servrar

Om du vill köra två AnswerBook2-servrar (en i systemet och en från CD), bör du tänka på följande:

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