Capitolo 2 Installazione del server AnswerBook2

Questa sezione spiega la procedura da seguire per l'installazione del server AnswerBook2.

Per visualizzare la documentazione in linea da un client AnswerBook2 non è richiesta nessuna procedura di installazione particolare; è necessario conoscere l'URL del server di documenti o, se si dispone di un accesso a Internet, è possibile visualizzare la documentazione Sun all'URL: http://docs.sun.com/

Questo prodotto non dispone di alcun controllo degli accessi a livello dei client. Se un sistema client può accedere all'URL del server di documenti, esso potrà anche visualizzare i documenti presenti su quel server.

La sezione contiene le seguenti informazioni:

• "Importante -- Limitazioni dell'ambiente operativo"

• "Controlli pre-installazione"

• "Come ottenere il software AnswerBook2"

• "Installazione del software AnswerBook2"

• "Installazione delle collezioni di documenti "

• "Registrazione del server di documenti"

• "Esecuzione del server AnswerBook2 come processo CGI"

Importante -- Limitazioni dell'ambiente operativo

Il server AnswerBook2 può essere eseguito negli ambienti operativi Solaris 2.5.1, Solaris 2.6 e Solaris 7. Tuttavia, a seconda della versione utilizzata, la procedura di installazione potrà essere soggetta alle seguenti limitazioni:

1. Supporto delle lingue con caratteri multi-byte, come le lingue asiatiche -- L'ambiente operativo Solaris si serve di un'utility (iconv) per convertire i caratteri usati nei diversi set di codici. Se si utilizza la versione 2.5.1, può essere necessario installare o aggiornare questi package:

   • SUNWciu8 -- Moduli iconv per la conversione dal cinese semplificato in UTF-8

   • SUNWhiu8 -- Moduli iconv per la conversione dal cinese tradizionale in UTF-8

   • SUNWjiu8 -- Moduli iconv per la conversione dal giapponese in UTF-8

   • SUNWkiu8 -- Moduli iconv per la conversione dal coreano in UTF-8

   • SUNWuiu8 -- Moduli iconv generici per la conversione in UTF-8

2. Supporto dei servizi FNS (Federated Naming Services) -- Se si desidera registrare il server AnswerBook2 in modo che gli utenti possano accedervi "automaticamente", è necessario che sul sistema sia installato FNS. Questa utility non fa parte della configurazione base dell'ambiente operativo Solaris 2.5.1, perciò potrà essere necessario installare il package SUNWfns.

Controlli pre-installazione

Qui di seguito è elencata una serie di punti da controllare prima di iniziare il processo di installazione.

Il sistema è compatibile con il software di AnswerBook2?

Per poter utilizzare il sistema come server di documenti, la configurazione dovrà essere una delle seguenti:

• Sistema SPARCstation 2 (per la configurazione minima; si raccomanda un sistema SPARCstation 5) con l'ambiente operativo Solaris 2.5.1, Solaris 2.6 o Solaris 7 Edizione per piattaforma SPARC

• Personal computer Intel con l'ambiente operativo Solaris 2.5.1, Solaris 2.6 o Solaris 7 Edizione per piattaforma Intel

Inoltre, il sistema dovrà avere circa 34 Megabyte di spazio disponibile sul disco per il software server e circa 600 Megabyte per l'installazione delle collezioni di documenti.

Per accedere a un server di documenti (attraverso un Web browser e un URL) non vi sono requisiti di sistema specifici, ma si consiglia l'utilizzo di un browser compatibile con HTML 3.2, come Netscape Navigator^TM, HotJava^TM o Lynx.

Quali componenti software è necessario installare?

I componenti da installare dipendono dall'uso che verrà fatto del sistema.

• Per leggere la documentazione in linea: se all'interno dell'organizzazione è già installato un server AnswerBook2, è sufficiente lanciare un browser compatibile con HTML 3.2 e inserire l'URL del server (ad esempio http://imaserver:8888/). Per visualizzare la documentazione Sun pubblicata: usare l'URL: http://docs.sun.com/

• Per utilizzare il sistema come server di documenti, sarà necessario installare il software server e le collezioni di documenti. Sarà anche possibile installare il software server su un sistema e le collezioni di documenti su un altro. Vedere "Installazione del software AnswerBook2" e "Installazione delle collezioni di documenti ".

Dove si trova il software?

Il software del server AnswerBook2 è disponibile sul CD Solaris 7 Documentation, su altri CD Sun o direttamente dai siti Web Sun. La procedura da seguire per accedere ai package sarà perciò leggermente differente a seconda della fonte prescelta. Nella descrizione della procedura di installazione, directory-software indicherà i punti in cui occorrerà scegliere l'azione appropriata per la propria situazione.

Si sta già eseguendo un Web server su questo sistema?

Normalmente, il server di documenti AnswerBook2 viene eseguito come plug-in NSAPI sul server httpd incluso nel package SUNWab2u. Tuttavia, poiché il server AnswerBook2 è conforme ai protocolli Web standard, si può anche scegliere di eseguire il server di documenti come processo CGI (Common Gateway Interface) su un altro Web server già installato sul sistema (ad esempio, Netscape Server o Sun WebServer). Vedere "Esecuzione del server AnswerBook2 come processo CGI".

Si desidera rendere disponibile il server ad altri utenti nell'organizzazione?

Per permettere agli utenti di individuare il server di documenti senza conoscerne l'URL, è possibile registrare il nome del server con il sistema FNS. In ogni caso, gli utenti potranno sempre accedere ai server di documenti non registrati di cui conoscano l'URL. Vedere "Registrazione del server di documenti".

Come ottenere il software AnswerBook2

Il software AnswerBook2 è incluso nei CD di diversi prodotti Sun, come il CD Solaris 7 Documentation. Se si possiede il CD di un prodotto che contiene il software o si sono scaricati i package SUNWab2r, SUNWab2s e SUNWab2u da un sito Web Sun, passare a "Installazione del software AnswerBook2". Diversamente, prima di continuare sarà necessario procurarsi il software AnswerBook2.

Installazione del software AnswerBook2

Alcuni prodotti su CD che includono il software AnswerBook2 supportano un'utility di installazione grafica (Solaris Web Start). Per informazioni sull'uso di questa utility, vedere la documentazione fornita con il CD.

Per installare il server AnswerBook2

1. Eseguire il login come superutente nel server di documenti.

   È possibile eseguire il login come utente root dalla videata di login del desktop, oppure digitare su dalla riga di comando e inserire la password di root del sistema:

2. Inserire il CD nel lettore di CD-ROM o spostarsi nella directory del software.

   Se l'installazione viene eseguita da un CD, il sistema di gestione dei volumi dovrebbe attivare automaticamente il CD.

3. Se necessario, spostarsi nella directory che contiene i package del server di documenti.

   Inserire questo comando:

   # cd directory-software

   dove directory-software è diversa se l'installazione viene eseguita dal CD o se si sono scaricati i package da un sito Web. Ad esempio, la directory-software predefinita per il CD Solaris 7 Documentation è /cdrom/sol_7_doc/Solaris_2.7_Doc/sparc/Product/.

4. Lanciare l'utility di installazione e selezionare i package del software server.

   Ad esempio, per lanciare l'utility pkgadd usare il comando seguente:

   # pkgadd -d .

   Selezionare questi package:

   • SUNWab2r (0,03 Megabyte) -- Viene installato nella partizione root e contiene i file di configurazione e di avvio. Non installare questo package in una directory diversa da quella predefinita.

   • SUNWab2s (1,40 Megabyte) -- Contiene i file condivisi usati per l'elaborazione dei documenti. Non installare questo package in una directory diversa da quella predefinita.

   • SUNWab2u (30,00 Megabyte) -- Contiene i file eseguibili e i file di elaborazione per il server e le funzioni di amministrazione. Per installare questo package in una directory diversa da quella predefinita, usare la forma interattiva del comando pkgadd:

     # pkgadd -a none -d .

5. Rispondere alle richieste del sistema.

   Quando compare un messaggio simile al seguente:

   Questo package contiene script che verranno eseguiti con autorizzazioni di superutente durante il processo di installazione. Procedere con l'installazione [y,n,?]

   Rispondere y.

6. Avviare il server.

   Al termine del processo di installazione di SUNWab2u, uno script cercherà di avviare il server sulla porta predefinita 8888. Per verificare che il server si sia avviato, usare uno dei metodi seguenti:

   • Avviare un Web browser compatibile con HTML 3.2 e digitare il seguente URL: http://localhost:8888/

     Dovrebbe comparire una pagina "Libreria di AnswerBook2" con almeno una collezione di documenti (la collezione della Guida di AnswerBook2).

   • Cercare il processo server con il comando:

     # ps -eaf | grep dwhttpd

   Se il server non si è avviato, usare il seguente comando:

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

7. Al termine del processo di installazione, il server si avvierà usando la configurazione predefinita.

   Per informazioni su come modificare la configurazione del server:

   • Per cambiare i parametri di configurazione standard del server, come il numero di porta, usare l'interfaccia dalla riga di comando di ab2admin o la pagina di amministrazione di AnswerBook2. Vedere l'Appendice A o il Capitolo 3.

   • Per eseguire il server AnswerBook2 su un server httpd preesistente, come Sun WebServer o Netscape Server, è necessario installare il server di documenti standard, quindi modificare diversi file di configurazione e creare una serie di collegamenti per eseguire il server di documenti come processo CGI. Vedere "Esecuzione del server AnswerBook2 come processo CGI".

8. Installare le collezioni di documenti.

   Se sul server sono installate una o più collezioni di documenti, il processo di installazione le aggiunge al database del server. È anche possibile installare le collezioni dal CD di un prodotto o aggiornare il database del server in modo da identificare le collezioni già installate su altri sistemi. Vedere "Installazione delle collezioni di documenti ".

9. (Opzionale) Registrare il server.

   Per fare in modo che gli altri utenti possano localizzare automaticamente il server di documenti tramite i Federated Naming Services (FNS), è necessario registrare il server usando il comando seguente:

   # /usr/lib/ab2/bin/ab2regsvr url_server

   dove url_server è l'URL completo per accedere al server (ad esempio: http://imaserver.eng.sun.com:8888/). Per maggiori informazioni, vedere "Registrazione del server di documenti".

Installazione delle collezioni di documenti

Alcuni prodotti su CD che includono il software AnswerBook2 supportano un'utility di installazione grafica (Solaris Web Start). Per informazioni sull'uso di questa utility, vedere la documentazione fornita insieme al CD.

Il server di documenti può operare solo se sono installati uno o più documenti.

Per installare le collezioni di documenti

1. Eseguire il login come superutente nel server di documenti.

   È possibile eseguire il login come utente root dalla videata di login del desktop, oppure digitare su dalla riga di comando ed inserire la password di root del sistema:

2. Inserire il CD nel lettore di CD-ROM o spostarsi nella directory del software.

   Se l'installazione viene eseguita da un CD, il sistema di gestione dei volumi dovrebbe attivare automaticamente il CD.

3. Spostarsi nella directory che contiene i package delle collezioni di documenti.

   Le collezioni possono essere installate dalla directory-software o da altre posizioni, ad esempio da collezioni di documenti preesistenti o da collezioni contenute in altri CD.

   Digitare questo comando:

   # cd directory-software

   dove directory-software è diversa se l'installazione viene eseguita dal CD o se si sono scaricati i package da un sito Web. Ad esempio, la directory-software predefinita per il CD Solaris 7 Documentation è /cdrom/sol_7_doc/Solaris_2.7_Doc/common/Product/.

4. Lanciare l'utility di installazione e selezionare i package delle collezioni di documenti da installare.

   Ad esempio, per lanciare l'utility pkgadd:

   # pkgadd -d .

   Per un elenco dettagliato delle collezioni di documenti incluse in un determinato CD, vedere il file README incluso in quel CD.

5. Per ogni package delle collezioni di documenti, decidere se installare localmente tutti i file dei documenti associati (installazione heavy) o solo i file essenziali (installazione nil).

   L'installazione "heavy" copia tutti i file sul server e può occupare molto spazio sul disco, ma offre prestazioni migliori.

6. I package delle collezioni di documenti AnswerBook2 includono uno script di post-installazione che aggiunge le collezioni al database del server e lo riavvia.

   Se questo non accade, o se occorre installare i package di una collezione AnswerBook1, è necessario usare la funzione Aggiungi collezione all'elenco della pagina di amministrazione di AnswerBook2 o il comando ab2admin -o add_coll per aggiungere le collezioni al database del server di documenti.

   Se vi sono collezioni di documenti già installate sul sistema, è possibile usare la funzione Individua le collezioni installate localmente della pagina di amministrazione di AnswerBook2 o il comando ab2admin -o scan per individuarle e aggiungerle al database del server di documenti. Questa funzione può essere usata solo per i package installati localmente.

   Per rendere disponibili le collezioni di documenti situate su un altro sistema, usare la funzione Aggiungi collezione all'elenco o il comando ab2admin -o add_coll e specificare il percorso completo dei file ab_cardcatalog o collinfo. Ad esempio, per fare in modo che il server di documenti imaserver possa accedere anche alle collezioni di documenti situate sul sistema altrove, il comando da usare sarà il seguente:

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

Registrazione del server di documenti

Per offrire agli utenti la possibilità di individuare il server di documenti senza conoscerne l'URL, è possibile registrare il nome del server con il sistema FNS. Gli utenti potranno comunque accedere anche ai server di documenti non registrati conoscendone l'URL.

La modalità di registrazione del server dipende da due fattori:

• La conoscenza dei comandi FNS

  Se si conosce l'uso dei comandi FNS standard, come fnbind, è possibile registrare il server usando questi comandi. Per semplificare il processo, il comando /usr/lib/ab2/bin/ab2regsvr può eseguire la registrazione del server automaticamente. Per maggiori informazioni, vedere "Registrazione del server con il comando ab2regsvr" e "Registrazione del server con i comandi FNS standard".

• I servizi di denominazione in uso

  NIS+ (Network Information Service Plus) è il servizio di denominazione primario usato in Solaris 2.6 e negli ambienti operativi compatibili. Se il sistema utilizza NIS+ e si dispone dei privilegi di amministrazione, è possibile registrare il server accedendo al master NIS+ o a un client NIS+.

  NIS (Network Information Service) era il servizio di denominazione standard degli ambienti SunOS^TM 4.x (Solaris 1.x). Se il sistema utilizza il sistema NIS, per registrare il server di documenti è necessario eseguire il login come utente root nel sistema master NIS.

  Il prodotto AnswerBook2 può operare anche con un sistema di denominazione basato sui file system (file) in cui tutti i nomi vengono inseriti manualmente in appositi file di dati. Questi file vengono memorizzati nella directory /var/fn/. In questo caso, la registrazione del server è possibile solo accedendo al sistema come root e sarà valida solo per il sistema in cui viene eseguita. Gli altri sistemi non potranno vedere i server registrati con questo meccanismo.

Registrazione del server con il comando ab2regsvr

Per registrare il server, usare il comando ab2regsvr. Questo comando esamina la configurazione del sistema e predispone lo spazio di denominazione appropriato per il server.

Per registrare il server, usare il comando seguente:

# /usr/lib/ab2/bin/ab2regsvr url_server

dove url_server è l'URL completo da utilizzare per accedere al server (ad esempio: http://imaserver.eng.sun.com:8888/).

Il comando ab2regsvr consente di eseguire anche altre funzioni utili:

• Visualizzare l'elenco degli URL dei server AnswerBook2 registrati:

  # /usr/lib/ab2/bin/ab2regsvr -l

• Rimuovere un server registrato dall'elenco:

  # /usr/lib/ab2/bin/ab2regsvr -d

• Cambiare l'URL del server AnswerBook2 attualmente registrato:

  # /usr/lib/ab2/bin/ab2regsvr -r url_server

  dove url_server è il nuovo URL da utilizzare per accedere al server (ad esempio: http://aserver.eng.sun.com:8888/). L'URL specificato sostituirà gli altri URL preesistenti.

Per maggiori informazioni sul comando ab2regsvr, vedere l'Appendice B.

Registrazione del server con i comandi FNS standard

Se si desidera registrare il server usando i comandi FNS e il sistema FNS è già installato, usare il comando seguente per registrare l'URL specificato come server di documenti per la propria organizzazione (dominio):

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

dove url_server è l'URL completo da utilizzare per accedere al server (ad esempio: http://imaserver.eng.sun.com:8888/).

Per determinare quali server siano attualmente registrati, usare il comando seguente:

% fnlookup -v thisorgunit/service/answerbook2

Verrà restituito un elenco dei server registrati simile al seguente:

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

In questo esempio, il server registrato è http://answers:8888/.

Se si riceve una risposta simile alla seguente, significa che non vi sono server di documenti registrati con FNS:

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

Per maggiori informazioni su FNS, incluse le procedure di installazione, vedere la documentazione di FNS.

Servizi di denominazione e utenti di AnswerBook2

Nell'ambiente operativo Solaris 2.6 o Solaris 7, è possibile definire un server AnswerBook2 predefinito usando la variabile d'ambiente AB2_DEFAULTSERVER. Ad esempio, è possibile inserire la riga seguente nel file .cshrc:

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

Se la variabile d'ambiente non viene definita, il prodotto AnswerBook2 cerca di determinare, quando viene avviato, se il sistema da cui è stato lanciato stia eseguendo un server di documenti. In caso affermativo, esso si avvia usando l'URL: http://localhost:porta, dove porta ha il valore predefinito 8888.

Se non è stata definita una variabile d'ambiente e il sistema corrente non è un server di documenti, avviando AnswerBook2 il sistema esegue il comando fnlookup thisorgunit/service/answerbook2 per determinare i server di documenti disponibili, quindi ne sceglie uno e lancia il browser AnswerBook2 usando il nome di quel server nell'URL.

Esecuzione del server AnswerBook2 come processo CGI

Normalmente, il server di documenti AnswerBook2 viene eseguito come plug-in NSAPI sul server httpd incluso nel package SUNWab2u. Poiché il server AnswerBook2 è conforme ai protocolli Web standard, si può scegliere di eseguire il server di documenti come processo CGI (Common Gateway Interface) su un altro Web server già presente sul sistema (ad esempio, Netscape Server o Sun WebServer).

Si noti che le funzioni seguenti possono operare solo con il Web server predefinito di AnswerBook2:

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

• /usr/lib/ab2/bin/ab2admin -o stop

• /etc/init.d/ab2mgr start

• /etc/init.d/ab2mgr stop

• restart dalla pagina di amministrazione di AnswerBook2

• Funzioni di avvio automatico

Al loro posto occorrerà utilizzare le funzioni di avvio e di arresto del server in uso.

Utilizzo di un server CGI

Poiché ogni Web server ha alcune caratteristiche peculiari, questa procedura descrive le operazioni generali da eseguire per usare un Web server di tipo CGI al posto di quello predefinito (plug-in NSAPI). Gli esempi riportati qui sotto si riferiscono a Sun WebServer e a Netscape Server.

1. Disabilitare il riavvio automatico del server AnswerBook2 al riavvio del sistema.

   Usare la pagina di modifica della configurazione del server della pagina di amministrazione di AnswerBook2 o digitare il comando seguente:

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

2. Arrestare il server AnswerBook2.

   Usare uno dei comandi seguenti:

   # /usr/lib/ab2/bin/ab2admin -o stop # /etc/init.d/ab2mgr stop

3. Modificare il file di configurazione del Web server e rendere le icone disponibili.

   La documentazione del Web server dovrebbe spiegare i particolari della procedura, ad esempio dove trovare il file di configurazione. La voce /icons/ dovrebbe puntare a /usr/lib/ab2/data/docs/icons/.

   Se /icons/ è già in uso, collegare tutti i file presenti in /usr/lib/ab2/data/docs/icons/ alla directory /icons/ esistente.

4. Collegare i documenti di guida di AnswerBook2 alla directory radice della documentazione corrente.

   Spostarsi nella directory radice della documentazione del Web server e creare un collegamento simbolico a /usr/lib/ab2/data/docs/.

5. Rendere disponibili al server i file cgi di AnswerBook2.

   Spostarsi nella directory cgi-bin del Web server e creare collegamenti simbolici ai file seguenti:

   /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 /usr/lib/ab2/bin/ab2bin/ab2srwrap

6. Aprire con un editor il file di configurazione del server e mappare /ab2/ in modo che chiami il cgi di AnswerBook2.

   La documentazione del Web server dovrebbe spiegare i particolari della procedura, ad esempio dove trovare il file di configurazione. È necessario cambiare la voce relativa a /ab2/ in /usr/lib/ab2/bin/ab2bin/nph-dweb/ab2/.

7. Modificare il file di configurazione per l'amministrazione di AnswerBook2.

   Aprire con un editor il file /usr/lib/ab2/bin/ab2bin/nph-dweb e modificare le voci relative a servertype, errorlog e accesslog.

Uso di Sun Web Server con CGI

Il file di configurazione predefinito di Sun Web Server è /etc/http/httpd.conf, e i file si trovano in /var/http/demo/. Se SUNWab2u non è stato installato nella directory predefinita (/usr/), tutti i percorsi che iniziano con /usr/lib/ab2/ dovranno riflettere il percorso in cui sono stati installati i file (ad esempio, /usr2/lib/ab2/).

1. Disabilitare il riavvio automatico del server AnswerBook2 e arrestare il server.

   Usare i comandi seguenti:

   # /usr/lib/ab2/bin/ab2admin -o autostart_no # /usr/lib/ab2/bin/ab2admin -o stop

2. Aprire con un editor il file /etc/http/httpd.conf e inserire la riga seguente nella sezione server:

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

   Una volta effettuata questa modifica, usare il comando seguente per riavviare il server SWS:

   # /etc/init.d/httpd start

   Per verificare le modifiche effettuate, inserire l'URL seguente nel Web browser per visualizzare l'icona della Guida :

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

   dove porta è il numero della porta utilizzata dal server di documenti, il cui valore predefinito è 8888.

3. Spostarsi nella directory /var/http/demo/public/ e creare il seguente collegamento simbolico:

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

   Per verificare le modifiche, inserire il seguente URL nel Web browser per visualizzare un'icona della Guida :

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

   dove porta è il numero della porta utilizzata dal server di documenti, il cui valore predefinito è 8888.

4. Spostarsi nella directory /var/http/demo/cgi-bin/ e creare i seguenti collegamenti simbolici:

   # ln -s /usr/lib/ab2/bin/ab2bin/admin # ln -s /usr/lib/ab2/bin/ab2bin/nph-dweb # ln -s /usr/lib/ab2/bin/ab2bin/gettransbitmap # ln -s /usr/lib/ab2/bin/ab2bin/getepsf # ln -s /usr/lib/ab2/bin/ab2bin/getframe # ln -s /usr/lib/ab2/bin/ab2bin/ab2srwrap

   Per verificare le modifiche, inserire il seguente URL nel Web browser per visualizzare la pagina della libreria di AnswerBook2:

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

   dove porta è il numero della porta utilizzata dal server di documenti, il cui valore predefinito è 8888.

5. Aprire con un editor il file /etc/http/httpd.conf e aggiungere la voce seguente alla sezione host:

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

   Riavviare il server SWS con il comando seguente:

   # /etc/init.d/httpd start

   Per verificare le modifiche, inserire il seguente URL nel Web browser per visualizzare la pagina della libreria di AnswerBook2:

   http://localhost:porta/ab2

   dove porta è il numero della porta utilizzata dal server di documenti, il cui valore predefinito è 8888.

6. Aprire con un editor il file /usr/lib/ab2/bin/ab2bin/nph-dweb e modificare le voci seguenti:

   setenv servertype sws setenv errorlog setenv accesslog /var/http/logs/http.elf.1

Uso di Netscape Server con CGI

In questo esempio, il file di configurazione di Netscape Server è /ul/netscape/suitespot/httpd-threads1/config/obj.conf e i file si trovano in /ul/netscape/suitespot/docs/. Se SUNWab2u non è stato installato nella directory predefinita (/usr/), tutti i percorsi che iniziano con /usr/lib/ab2/ dovranno riflettere il percorso in cui sono stati installati i file (ad esempio, /usr2/lib/ab2/).

1. Disabilitare il riavvio automatico del server AnswerBook2 e arrestare il server.

   Usare i comandi seguenti:

   # /usr/lib/ab2/bin/ab2admin -o autostart_no # /usr/lib/ab2/bin/ab2admin -o stop

2. Aprire con un editor il file /ul/netscape/suitespot/httpd-threads1/config/obj.conf e aggiungere la riga seguente:

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

   Per verificare le modifiche, riavviare Netscape Server. Quindi, inserire il seguente URL nel Web browser per visualizzare l'icona della Guida:

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

   dove porta è il numero della porta utilizzata dal server di documenti, il cui valore predefinito è 8888.

3. Spostarsi nella directory /ul/netscape/suitespot/docs/ e creare il seguente collegamento simbolico:

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

   Per verificare le modifiche, inserire il seguente URL nel Web browser per visualizzare l'icona della Guida :

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

   dove porta è il numero della porta utilizzata dal server di documenti, il cui valore predefinito è 8888.

4. Spostarsi nella directory /ul/netscape/suitespot/cgi-bin/ e creare i seguenti collegamenti simbolici:

   # ln -s /usr/lib/ab2/bin/ab2bin/admin # ln -s /usr/lib/ab2/bin/ab2bin/nph-dweb # ln -s /usr/lib/ab2/bin/ab2bin/gettransbitmap # ln -s /usr/lib/ab2/bin/ab2bin/getepsf # ln -s /usr/lib/ab2/bin/ab2bin/getframe # ln -s /usr/lib/ab2/bin/ab2bin/ab2srwrap

   Per verificare le modifiche, inserire il seguente URL nel Web browser per visualizzare la pagina della libreria di AnswerBook2:

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

   dove porta è il numero della porta utilizzata dal server di documenti, il cui valore predefinito è 8888.

5. Aprire con un editor il file /ul/netscape/suitespot/httpd-threads1/config/obj.conf e aggiungere la voce seguente:

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

   Per verificare le modifiche, riavviare Netscape Server e inserire il seguente URL nel Web browser per visualizzare la pagina della libreria di AnswerBook2:

   http://localhost:porta/ab2

   dove porta è il numero della porta utilizzata dal server di documenti, il cui valore predefinito è 8888.

6. Aprire con un editor il file /usr/lib/ab2/bin/ab2bin/nph-dweb e modificare le voci seguenti:

   setenv servertype netscape setenv errorlog /ul/netscape/suitespot/httpd-threads1/logs/errors setenv accesslog /ul/netscape/suitespot/httpd-threads1/logs/access