Installazione e amministrazione di un server AnswerBook2

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.

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

Arrestare il server AnswerBook2.

Usare uno dei comandi seguenti:

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

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.

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

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

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

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

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

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.

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.

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.

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.

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

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

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.

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.

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.

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.

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