Visualizzazione della documentazione in linea con AnswerBook2

Capitolo 7 Soluzione dei problemi di AnswerBook2

Questa sezione spiega come risolvere alcuni problemi relativi ad AnswerBook2. I problemi vengono suddivisi nel modo seguente:

Errori funzionali

Questa sezione descrive i problemi che si possono incontrare nella visualizzazione della documentazione in linea.

Tabella 7-1 Possibili problemi funzionali


Problema	Azione consigliata	Altre informazioni
Errore del proxy del browser	Contattare l'amministratore dei documenti per verificare che il server a cui si cerca di accedere sia configurato correttamente.	Se il problema persiste, provare a disabilitare i proxy sul Web browser.
Messaggio di errore all'avvio di AnswerBook2 dal Pannello principale del CDE	Se non si dispone di un browser compatibile con HTML 3.2, installarne uno e riprovare. Se il browser si avvia ma non riesce a trovare un server di documenti, è necessario trovare un URL valido per il server di documenti e usare le normali funzioni del browser per accedervi. L'URL per un server di documenti ha tipicamente la forma `http://nome_server:8888/` (ad esempio `http://imaserver:8888/`).	Se non si dispone di un server di documenti locale ma si dispone di un accesso a Internet, è possibile visualizzare la documentazione Sun disponibile all'indirizzo http://docs.sun.com
Problemi nell'uso della funzione di stampa di AnswerBook2	Configurare il tipo MIME `application/postscript` nel browser per eseguire la stampa su un file o direttamente su una stampante.	Per maggiori informazioni sulla funzione di stampa di AnswerBook2, vedere il Capitolo 6.
Caratteri non riconoscibili nella pagina della Libreria	Cambiare l'impostazione della lingua o la codifica della lingua nel browser.	Per maggiori informazioni sulla scelta della lingua, vedere "Scelta della lingua" e "Scelta del tipo di codifica".
La pagina della Libreria non presenta una collezione di documenti esistente	Controllare la definizione della Libreria personale per verificare che includa la collezione "mancante".	Per informazioni sulla definizione della Libreria personale, vedere "Definizione di una libreria personale".
Messaggi di eccezione dello script TCL quando si cerca di visualizzare un libro	Se viene visualizzato un messaggio di eccezione di uno script TCL, significa che esiste un problema nel libro che si cerca di visualizzare.	Contattare il fornitore del libro e richiederne una versione corretta.
Errori del browser indicanti che il server di documenti non risponde	Attendere alcuni minuti e riprovare ad accedere al server. Questo errore indica solitamente che il server non è attivo o è occupato.	Se il problema persiste, contattare l'amministratore del server di documenti.
Non si riesce ad accedere alle funzioni necessarie per definire la libreria personale o la lingua	Il browser non supporta i cookies, o questo supporto è stato disabilitato.	Contattare il servizio di assistenza per il browser.
La libreria o la lingua selezionate non vengono attivate	Il browser non supporta i persistent cookies o non si sta visualizzando la libreria per la quale sono state impostate le preferenze.	Verificare che la libreria visualizzata sia quella corretta. Se il problema persiste, contattare il servizio di assistenza per il browser.
La pagina della libreria (`http://server:8888/ab2/`) contiene la barra di navigazione ma non presenta nessuna collezione di documenti	Fare clic sul pulsante appropriato del Web browser per ricaricare la pagina, nel caso in cui la pagina non fosse stata caricata correttamente o il caricamento non fosse terminato. Per caricare la pagina dal server anziché dalla cache del Web browser, premere il tasto `Shift` insieme al pulsante.	Se il problema persiste, contattare l'amministratore del server di documenti.
Parti del testo appaiono in rosso con la scritta "BUG"	Il documento sorgente contiene informazioni di identificazione non riconosciute.	Contattare l'amministratore del server di documenti.
Non si riesce ad accedere alle funzioni di amministrazione sul server di documenti	L'accesso a queste funzioni è riservato ai soli utenti autorizzati.	Per ottenere l'accesso a queste funzioni, contattare l'amministratore del server di documenti.

Messaggi di errore

Questa sezione descrive i messaggi di errore di AnswerBook2 e le possibili soluzioni.

No AnswerBook2 documentation server was found.

Si è cercato di usare lo script answerbook2 o a lanciare il visualizzatore client dal Pannello principale del CDE, ma l'operazione non è riuscita perché sul sistema non vi è nessun server di documenti predefinito.

Per cercare un server di documenti predefinito, il client utilizza l'approccio seguente:

Se la variabile d'ambiente AB2_DEFAULTSERVER è definita, il programma di visualizzazione di AnswerBook2 si avvia usando l'URL definito da questa variabile. Ad esempio, il file .cshrc potrebbe contenere la riga seguente:
setenv AB2_DEFAULTSERVER http://imaserver.eng.sun.com:8888/
Se il sistema da cui è stato avviato AnswerBook2 è un server di documenti, il programma di visualizzazione di AnswerBook2 si avvia usando l'URL: localhost:porta, dove porta ha il valore predefinito 8888.
Se il server AnswerBook2 è stato registrato con FNS (Federated Naming Service), il programma di visualizzazione di AnswerBook2 utilizza l'URL del server registrato.

Cannot find local AnswerBook2 server to administer.

Si è cercato di usare lo script answerbook2_admin o di avviare la pagina di amministrazione dal Pannello principale del CDE, ma l'operazione non è riuscita perché sul sistema non è presente un server di documenti.

Per amministrare il server AnswerBook2, procedere in uno di questi modi:

Eseguire il login nel sistema in cui è installato il server di documenti e riprovare.
Inserire nel browser l'URL del server di documenti da amministrare.