Installera och administrera en AnswerBook2-server

Kapitel 1 Introduktion

Det här kapitlet innehåller grundläggande information om AnswerBook2^TM-dokumentationsservern. Det innehåller följande information:

Information om hur du använder AnswerBook2 för att visa onlinedokumentation finns i Visa onlinedokumentation med AnswerBook2-systemet.

AnswerBook2 - administrationsöversikt

AnswerBook2 är onlinedokumentationssystemet för Sun. Det är ett klient-serverbaserat system, där klienten är en HTML 3.2-kompatibel webbläsare och servern är en httpd-baserad webbserver. Du kan installera AnswerBook2-dokumentsamlingar på en central dokumentationsserver eller på en lokal server.

AnswerBook2 - administrationsfunktioner

AnswerBook2 innehåller följande administrationsfunktioner:

Tack vare klient-serverarkitekturen kan dokumenten lagras på en enda plats (server) och kommas åt från användarens skrivbord (klient).
Du kan administrera dokumenthanteringen både i ett kommandoradsbaserat gränssnitt (ab2admin) och ett webbläsarbaserat gränssnitt (administrationssidan för AnswerBook2).
CGI-processer kan köras på flera olika webbservrar.
Du kan styra om fel ska visas grafiskt för användarna med ordet "BUG," i rött genom att aktivera eller inaktivera AnswerBook2-felsökningsfunktionen.
Loggfiler för serveråtkomst och fel ingår.

AnswerBook2 - ingående delar

AnswerBook2 består av följande delar:

En dokumentationsserver - Utför frågefunktioner och tillhandahåller dokument till klientwebbläsaren. Innehåller mallar med ett välbekant utseende vid visning och utskrift av dokument. Både webbläsar- och kommandoradsgränssnitt ingår för administration av databasfunktioner, lösenordsverifiering och andra administrativa funktioner. Information om hur du installerar en dokumentationsserver finns i "Installera programvaran för AnswerBook2 ". Information om hur du administrerar en dokumentationsserver finns i Kapitel 3.
Dokument - Kan vara både nya dokument (SGML) och gamla dokument (Display PostScript^TM). Information om hur du installerar dokumentationssamlingarna på servern finns i "Installera dokumentsamlingar".
En klientwebbläsare - Användarna kan visa dokumentationen i vilken HTML 3.2-kompatibel webbläsare som helst. Information om hur du visar dokumentation finns i Visa onlinedokumentation med AnswerBook2-systemet. För att användarna ska kunna ansluta till dokumentationsservern måste du antingen registrera servern i FNS (Federated Naming Service) eller informera användarna om serverns URL. Information om hur du registrerar servern i FNS finns i "Registrera dokumentationsservern".

Vad ska installeras?

Följande tabell visar vad du behöver göra eller installera för att kunna använda olika AnswerBook2-funktioner.

Tabell 1-1 Vad ska installeras, och när


Om du vill...	Gör så här...
Läsa onlinedokumentation med en klientläsare (på alla plattformar, med alla operativsystem).	Starta en HTML 3.2-kompatibel webbläsare och skriv in dokumentationsserverns URL (till exempel `http://imaserver:8888/`).
Aktivera systemet (datorn) så att det levererar dokumentation.	Installera programvaran för dokumentationsservern. Se Kapitel 2.
Lägga till dokumentation från produkt-CD-skivor, webbplatser eller andra källor, på din dokumentationsserver.	Dokumentationssamlingarna bör innehålla procedurer som lägger till dem i dokumentationsserverns databas efter installation. Om du har förinstallerat dokumentationssamlingar på dokumentationsservern, använder du funktionerna för att lägga till samlingar för att lägga till dokumentationssamlingarna i serverns databas. Se "Installera dokumentsamlingar".

Vanliga frågor

Det här avsnittet innehåller några vanliga frågor om AnswerBook2 och svaren på de frågorna.

Vad är AnswerBook2?

AnswerBook2 använder en standardbaserad dokumentationsserver för att visa Suns onlinedokumentation i din webbläsare. Med hjälp av gränssnittet i AnswerBook2 kan du bläddra, söka efter och skriva ut en mängd information, inklusive AnswerBook1-samlingar och direkthjälpen (man).

På vilket sätt skiljer sig AnswerBook2 från AnswerBook?

Föregående version av AnswerBook (AnswerBook1) använde Display PostScript^TM för att visa elektroniska versioner av dokument som främst var utvecklade som pappersdokument. AnswerBook2 använder en webbläsare för att visa onlinedokumentation som är utvecklad för att visas elektroniskt med hjälp av SGML och för att visa befintliga AnswerBook1-dokument.

Följande lista visar de huvudsakliga skillnaderna mellan produkterna:

Webbläsargränssnitt - Du kan använda en valfri HTML 3.2-kompatibel webbläsare på vilken plattform som helst för att visa onlinedokumentationen med AnswerBook2.
Flexibla källor - Dokumentationsservern kan visa både AnswerBook1-dokument (Display PostScript) och AnswerBook2-dokument (SGML).
Klient-serverstöd - Med AnswerBook2 kan du installera server- och dokumentsamlingarna på en central plats och sedan komma åt dokumenten från andra system. Dessutom finns en "fail-over"-mekanism som gör att dokumentadministratören kan definiera flera dokumentationsservrar så att länkar mellan dokument alltid fungerar.
Plattformsoberoende - I den här versionen måste AnswerBook2-dokumentservern köras i operativmiljön Solaris 2.5.1, Solaris 2.6 eller Solaris 7 (SPARC eller Intel). Dock kan AnswerBook2-klienter köras på vilken plattform som helst, och framtida versioner kan komma att erbjuda serverfunktionalitet för flera plattformar.
Standardsökfunktioner - AnswerBook2 använder logiskt AND som standard vid sökning i stället för OR (standardsökfunktionalitet för AnswerBook1).

Kan jag fortfarande visa mina gamla AnswerBook-samlingar med AnswerBook2?

Ja, om inte dina gamla AnswerBook-dokument är äldre än operativmiljön Solaris 2.2. Om du vill lägga till AnswerBook1-samlingar i dokumentationsserverns databas använder du AnswerBook2-funktionen "lägg till samling" och pekar på katalogen som innehåller AnswerBook1-filen ab_cardcatalog.

Innehåller AnswerBook2 samma funktioner för AnswerBook1- och AnswerBook2-dokument?

Nej. För enhetlighetens skull är gränssnittet i AnswerBook2 för AnswerBook1-dokument snarlikt gränssnittet i AnswerBook1. Här följer en kortfattad lista över funktionsskillnader mellan AnswerBook1- och AnswerBook2-samlingar:

Du kan inte visa eller dölja alla nivåer i en AnswerBook1-innehållsförteckning, bara visa eller dölja ett visst avsnitt i innehållsförteckningen.
AnswerBook1-innehållssidor innehåller inte Andra avsnitt. Om du vill navigera från en sida till en annan, kan du använda länken Nästa avsnitt eller återgå till innehållsförteckningen och markera ett annat avsnitt i boken.
AnswerBook1-innehållssidor visar hela kapitlet på en gång, inte mindre avsnitt.
Ikonerna för sökresultatet visar bara grovt sannolikheten för en matchning i AnswerBook1-information. Ikonerna är oftast antingen helt fyllda eller helt tomma.
Söktermer markeras inte i AnswerBook1-text.
Utskriftsfunktionen stöder bara utskrift av ett kapitel i taget för en AnswerBook1-bok. AnswerBook1-grafik visas inte direkt utan representeras av en ikon som öppnar en PostScript-visning av grafiken när du klickar på den.
I en sökning av typen Direkthjälp efter nyckelord ingår bara AnswerBook2-direkthjälpen (SGML-baserade sidor) på servern, inte AnswerBook1-hjälpen.
För AnswerBook1-hjälpen används samma gränssnitt som för alla andra AnswerBook1-dokument. Det finns inget särskilt direkthjälpsgränssnitt.