Libreria di installazione di Solaris 7 (Edizione per piattaforma SPARC)

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 Web Server).

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
comandi di riavvio dalla GUI di amministrazione

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 Web Server e a Netscape Server.

Arrestare il server AnswerBook2, se necessario.

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-bin di AnswerBook2.

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

/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

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/cgi/nph-dweb/ab2/.

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

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

Per eseguire un server AnswerBook2 come processo CGI su Sun WebServer

Il file di configurazione predefinito di Sun Web Server è /etc/http/httpd.conf, e i file si trovano in /var/http/demo/. Se 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/).

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

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/cgi/nph-dweb e modificare le voci seguenti:
setenv servertype sws setenv errorlog setenv accesslog /var/http/logs/http.elf.1

Per eseguire un server AnswerBook2 come processo CGI su Netscape Server

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

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

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

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