test

Installera och administrera en AnswerBook2-server

Kapitel 2 Installera AnswerBook2-serverprogramvaran

Detta avsnitt beskriver installation av serverprogramvaran för AnswerBook2.

Obs!

För att kunna läsa onlinedokumentation som AnswerBook2-klient krävs ingen installation. Du behöver känna till URL:en för en dokumentationsserver, eller också, om du har tillgång till Internet, kan du läsa utgiven Sun-dokumentation som finns på URL:en http://docs.sun.com/

Obs!

För denna produkt finns ingen åtkomstkontroll på klientnivån. Om en klientdator kommer åt URL:en för en dokumentationsserver, så går det att läsa dokumenten på den servern.

Detta avsnitt innehåller följande information:

Viktigt - begränsningar i operativsystemet

AnswerBook2-servern kan köras med operativsystemet Solaris 2.5.1 (eller kompatibel version). Beroende på vilken version av operativsystem du väljer, kommer dock installationen att begränsas i följande avseenden:

  1. Stöd för språk med fler-bytestecken, gäller till exempel i många asiatiska länder - operativsystemet Solaris använder ett hjälpprogram (iconv) som konverterar tecken från en typ av kod till en annan. Om du använder operativsystemet Solaris 2.5.1, kan det hända att du måste installera eller uppdatera följande paket:

    • SUNWciu8 - iconv-moduler för UTF-8 för förenklad kinesiska

    • SUNWhiu8 - iconv-moduler för UTF-8 för traditionell kinesiska

    • SUNWjiu8 - iconv-moduler för UTF-8 för japanska

    • SUNWkiu8 - iconv-moduler för UTF-8 för koreanska

    • SUNWuiu8 - iconv-moduler (standard) för UTF-8

  2. Stöd för FNS (Federated Naming Services) - Om du vill registrera AnswerBook2-servern så att användarna får tillgång till den "automatiskt" måste du först installera FNS i systemet. Eftersom detta hjälpprogram inte är en del av kärnan i operativsystemet, kan du bli tvungen att installera SUNWfns-paketet.

Checklista före installation

Installationen blir enklare om du använder denna checklista.

Är ditt system kompatibelt med programvaran AnswerBook2?

För att ditt system ska kunna fungera som en dokumentationsserver, måste det överensstämma med någon av följande systemkonfigurationer:

  • SPARCstationTM 2 (minimum, SPARCstation 5 rekommenderas) med operativsystemet Solaris 2.5.1 för SPARC (eller kompatibel version)

  • Intel-baserad dator med operativsystemet Solaris 2.5.1 för Intel (eller kompatibel version)

Dessutom måste serversystemet ha ungefär 34 MB ledigt skivutrymme för serverprogramvaran och ungefär 600 MB ledigt skivutrymme för installation av dokumentsamlingar.

Om du vill komma åt en dokumentationsserver via en webbläsare och en URL behöver inga särskilda systemkrav uppfyllas. Du måste dock ha en webbläsare som kan hantera HTML 3.2, t ex Netscape NavigatorTM eller Lynx.

Vilka programvarukomponenter behöver du installera?

Vilka komponenter du måste installera beror på vad du vill kunna göra.

  • Om du vill kunna läsa onlinedokumentation, när en AnswerBook2-server redan finns installerad någonstans i din organisation, behöver du bara starta en HTML 3.2-kompatibel webbläsare och skicka URL:en till servern (till exempel, http://imaserver:8888/). Om du vill läsa utgiven Sun-dokumentation, ange URL:en: http://docs.sun.com/

  • Om du vill att systemet ska kunna hantera dokumentation installerar du programvaran för dokumentationsservern och dokumentsamlingarna på systemet. Du kan också installera serverprogramvaran på ett system och dokumentsamlingarna på ett annat. Se "Installera programvaran för AnswerBook2 " och "Installera dokumentsamlingar".

Var finns programvaran?

Programvaran för AnswerBook2-servern finns tillgänglig på olika platser, till exempel på dokumentations-CD:n för Solaris 7, andra Sun-CD-skivor eller direkt från Suns webbplatser. Detta innebär att exakt vilka steg du behöver ta för att komma åt paketen kan variera något, beroende på din situation. Under hela installationen kommer programkatalog att indikera på vilka ställen du kan hitta sådant som passar i din situation.

Kör du redan en webbserver i systemet?

Som standard körs AnswerBook2-dokumentationsservern som en NSAPI-plug-in-modul ovanpå den httpd-server som ingår i paketet SUNWab2u. Eftersom AnswerBook2-servern arbetar med standardwebbprotokoll, kan du välja att köra dokumentationsservern som en CGI-process (Common Gateway Interface) ovanpå någon annan webbserver, som redan finns i systemet (till exempel Netscape Server eller Sun WebServerTM). Se "Köra AnswerBook2-servern som en CGI-process".

Vill du att andra användare inom din organisation ska kunna hitta servern?

För att andra användare ska kunna hitta dokumentationsservern utan att känna till dess URL, kan du registrera servernamnet med FNS-systemet. Användarna kan fortfarande komma åt oregistrerade dokumentationsservrar om de anger rätt URL:er. Se "Registrera dokumentationsservern".

Få tag på programvara för AnswerBook2

Programvaran för AnswerBook2 finns med på många av Suns produkt-CD-skivor, till exempel på dokumentations-CD:n för Solaris 7. Om du har en produkt-CD som innehåller programvaran, eller om du har hämtat programpaketen SUNWab2r, SUNWab2s och SUNWab2u från en av Suns webbplatser, läs då "Installera programvaran för AnswerBook2 ". I annat fall måste du skaffa dig programvaran för AnswerBook2 innan du fortsätter.

Installera programvaran för AnswerBook2

Obs!

Vissa produkt-CD-skivor som innehåller programvaran för AnswerBook2 stödjer ett verktyg för peka-och-klicka-installation (Solaris Web Start). För information om hur du använder det verktyget, se den dokumentation som levereras tillsammans med CD:n.

Så här installerar du AnswerBook2-serverprogramvaran

  1. Logga in som superanvändare på dokumentationsservern.

    Logga in som root i inloggningsfönstret eller skriv su på kommandoraden och ange sedan root-lösenord:

  2. Sätt in CD:n i CD-ROM-enheten, eller välj den plats där programmet finns.

    Om du installerar från en CD monteras CD:n automatiskt av Volymhanteraren.

  3. Välj den katalog där dokumentationsserverpaketen finns.

    Skriv följande kommando:


    # cd programkatalog

    där programkatalog avgörs av om du installerar från en CD eller om du har fått paketen via en webbplats. Till exempel är programkatalogen för dokumentations-CD:n för Solaris 7 som standard /cdrom/sol_7_doc/Solaris_2.7_Doc/sparc/Product/.

  4. Starta installationsverktyget och välj vilka dokumentationsserverpaket du vill installera.

    Så här startar du t ex verktyget pkgadd 


    # pkgadd -d .

    Välj de här serverprogrampaketen:

    • SUNWab2r (0,03 MB) - Installeras på rotpartitionen och innehåller konfigurationsfiler och startfiler. Installera inte det här paketet någon annanstans än där programmet föreslår.

    • SUNWab2s (1,40 MB) - Innehåller delade filer för dokumentbearbetning. Installera inte det här paketet någon annanstans än där programmet föreslår.

    • SUNWab2u (30,00 MB) - Innehåller körbara filer och back-end-bearbetningsfiler för server- och administrationsfunktioner. Om du vill installera det här paketet på någon annan plats än vad som föreslås av programmet använder du den interaktiva varianten av kommandot pkgadd:


      # pkgadd -a none -d .

  5. Besvara de prompter som visas.

    När du ser ett meddelande i stil med följande:


    This package contains scripts which will be executed with super-user
permission during the process of installing this package.

Do you want to continue with the installation [y,n,?]

    Svara med y.

  6. Starta servern om det behövs.

    När installationen av SUNWab2u är klar startas servern med hjälp av ett skript på standardporten 8888 om det är möjligt. Om du vill verifiera att servern har startats kan du använda någon av följande metoder:

    • Starta en HTML 3.2-kompatibel webbläsare och skriv följande URL-adress: http://localhost:8888/

      En bibliotekssida med minst en dokumentsamling (hjälpsamlingen för AnswerBook2) bör visas. Hur många dokumentationssamlingar som visas beror på hur många som är installerade.

    • Leta efter serverprocessen med hjälp av följande kommando: 


      # ps -eaf | grep dwhttpd

    Om servern inte har startats använder du följande kommando för att starta den:


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

  7. När installationsprocessen är klar startas servern med standardkonfigurationen.

    Mer information om hur du ändrar serverns konfiguration finns i följande avsnitt:

    • Om du vill ändra serverkonfigurationens standardparametrar, till exempel portnummer, använder du antingen kommandoradsgränssnittet i ab2admin eller administrationssidan för AnswerBook2. Se Bilaga A eller Kapitel 3.

    • Om du vill köra AnswerBook2-servern på en befintlig httpd-server, till exempel en Sun WebServer eller en Netscape Server, måste du installera dokumentationsserverns standardprogram. Sedan måste du ändra flera konfigurationsfiler och skapa länkar för att köra dokumentationsservern som en CGI-process. Se "Köra AnswerBook2-servern som en CGI-process".

  8. Installera dokumentationssamlingar.

    Om det finns några dokumentationssamlingar installerade på servern hittas de under installationsprocessen och läggs till i serverdatabasen. Du kan installera samlingar från produkt-CD-skivor eller uppdatera serverdatabasen för att känna igen befintliga dokumentationssamlingar som är installerade på andra system. Se "Installera dokumentsamlingar".

  9. (Valfritt) Registrera en server.

    Om du vill att andra användare automatiskt ska hitta din dokumentationsserver 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 den fullständiga URL-adressen för att komma till den här servern (t ex http://imaserver.eng.sun.com:8888/). Mer information finns i "Registrera dokumentationsservern".

Installera dokumentsamlingar

Obs!

Vissa produkt-CD-skivor som innehåller programvaran för AnswerBook2 stödjer ett verktyg för peka-och-klicka-installation (Solaris Web Start). För information om hur du använder det verktyget, se den dokumentation som levereras tillsammans med CD:n.

Dokumentationsservern fungerar inte om inga dokument är installerade på den.

Så här installerar du dokumentsamlingar:

  1. Logga in som superanvändare på dokumentationsservern.

    Logga in som root i inloggningsfönstret eller skriv su på kommandoraden och ange sedan root-lösenord:

  2. Sätt in CD:n i CD-ROM-enheten, eller välj den plats där programmet finns.

    Om du installerar från en CD monteras CD:n automatiskt av Volymhanteraren.

  3. Välj den katalog där dokumentsamlingspaketen finns.

    Du kan installera samlingarna från programkatalog eller från andra platser, t ex befintliga dokumentsamlingar eller samlingar som följer med andra CD-skivor.

    Skriv följande kommando:


    # cd programkatalog

    där programkatalog avgörs av om du installerar från en CD eller om du har fått paketen via en webbplats. Till exempel är programkatalogen för dokumentations-CD:n för Solaris 7 som standard /cdrom/sol_7_doc/Solaris_2.7_Doc/common/Product/.

  4. Starta installationsverktyget och välj vilka dokumentsamlingspaket du vill installera.

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


    # pkgadd -d .

    En detaljerad lista över de dokumentsamlingar som finns på en viss CD finns i filen README på CD:n.

  5. I dokumentsamlingspaketen på AnswerBook2 finns ett skript som lägger till samlingarna i dokumentationsserverdatabasen efter installationen och startar om servern.

    Om servern inte startas om eller om du installerar samlingspaket för AnswerBook1 bör du antingen använda funktionen "Lägg till samling i lista" i AnswerBook2 eller kommandot ab2admin -o add_coll för att lägga till de här samlingarna i dokumentationsserverns databas.

    Om dokumentsamlingar redan har installerats i systemet kan du söka efter dem och lägga till dem i dokumentationsserverdatabasen med funktionen "Sök efter installerade samlingar" eller kommandot ab2admin -o scan på administrationssidorna för AnswerBook2. Den här funktionen fungerar bara för lokalt installerade paket.

    Om du vill arbeta med dokumentsamlingar som finns i ett annat system använder du funktionen Lägg till samling i lista eller kommandot ab2admin -o add_coll och anger fullständig sökväg till filen ab_cardcatalog eller collinfo. Om dokumentationsservern t ex är imaserver och du vill att den ska hantera dokumentsamlingar som finns på systemet ett_annat_system, kan du använda följande kommando: 


    imaserver# ab2admin -o add_coll -d /net/elsewhere/books/SUNWdtad/collinfo

Registrera dokumentationsservern

För att andra användare ska kunna hitta dokumentationsservern utan att känna till dess URL, kan du registrera servernamnet med FNS-systemet. Användare kan fortfarande komma åt oregistrerade dokumentationsservrar om de vet vilken URL som ska anges.

Hur du ska registrera servern beror på två faktorer:

Registrera servern med hjälp av kommandot ab2regsvr

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

Du registrerar servern med följande kommando:


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

där server_url är den fullständiga URL-adressen för att komma till den här servern (t ex http://imaserver.eng.sun.com:8888/).

Med kommandot ab2regsvr får du tillgång till några andra användbara alternativ:

Mer information om kommandot ab2regsvr finns i Bilaga B.

Registrera servern med hjälp av standardkommandon för FNS

Om du vill använda FNS-kommandon för att registrera servern och redan har en FNS installerad, använder du följande kommando för att registrera den angivna URL:en som en dokumentationsserver för ditt företag (din domän): 


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

där server_url är den fullständiga URL-adressen för att komma till den här servern (t ex 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

En lista över registrerade servrar visas som ser ut ungefär så här:


Referenstyp: onc_answerbook2
Adresstyp: onc_addr_answerbook2
  längd: 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.


Det gick inte att hitta 'thisorgunit/service/answerbook2': \: \
Namnet hittades inte: 'answerbook2'

Mer information om FNS och hur du installerar det finns i FNS-dokumentationen.

Namntjänster och AnswerBook2-användare

I operativsystemet Solaris 2.6 eller Solaris 7 kan användaren ange en standard-AnswerBook2-server med hjälp av miljövariabeln AB2_DEFAULTSERVER>. Till exempel kan användaren ha följande rad i .cshrc -filen:


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

Om användaren inte har definierat någon miljövariabel, när han startar AnswerBook2-produkten från skrivbordet, så kontrollerar programmet om systemet från vilket det startades kör en dokumentationsserver. Om så är fallet startar det med följande URL: http://localhost:port, där port som standard är 8888.

Om användaren inte har definierat någon miljövariabel och det aktuella systemet inte är en dokumentationsserver utför systemet kommandot fnlookup thisorgunit/service/answerbook2 när användaren startar AnswerBook2 från skrivbordet. Detta för att ta reda på vilka dokumentationservrar som finns tillgängliga. Programmet väljer sedan en av dessa servrar och startar AnswerBook2-läsaren, med serverns namn som URL.

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