Installazione e amministrazione di un server AnswerBook2

Capitolo 4 Soluzione dei problemi di AnswerBook2

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

Errori del server

La tabella seguente descrive i problemi che si possono incontrare nell'uso del server della documentazione in linea.

Tabella 4-1 Possibili problemi del server

Problema

Azione consigliata

Altre informazioni

Errore del proxy del browser

Aprire il file /usr/lib/ab2/dweb/data/config/dwhttpd.cfg e cambiare il nome dell'host in nomehost.dominio.

Ad esempio, invece della riga seguente:

set ServerHost imaserver ;#

Usare questa riga:

set ServerHost imaserver.eng.sun.com ;#

Quindi, riavviare il server di documenti.

Se il problema persiste, provare a disabilitare i proxy sul Web browser.

Errori del browser indicanti che il server di documenti non risponde

Se il server di documenti non risponde, riavviarlo.

Per informazioni su come arrestare e riavviare il server, vedere "Avvio e arresto del server di documenti".

Errore 404, File Not Found quando si cerca di accedere al server di documenti

È in esecuzione un processo server, ma il software server è stato rimosso. Reinstallare il software server.

Per informazioni sull'installazione del software, vedere "Installazione del software AnswerBook2".

Gli utenti segnalano che la pagina della libreria mostra solo la barra di navigazione ma nessuna collezione di documenti

Verificare che il file del modello delle collezioni (/usr/lib/ab2/dweb/data/config/ab2_collections.template) non contenga righe vuote o doppie.

Se la correzione del modello non risolve il problema, può essere necessario reinstallare le collezioni dei documenti o il software del server. Per informazioni sull'installazione del software, vedere "Installazione del software AnswerBook2".

Gli utenti segnalano che, in uno o più libri, alcune parti di testo sono evidenziate in rosso e compare la parola "BUG"

Il sorgente del libro contiene identificatori che AnswerBook2 non riconosce, e la variabile d'ambiente AB2_DEBUG è impostata su "1" sul server.

Per disabilitare la visualizzazione del problema, impostare la variabile AB2_DEBUG su "0", quindi arrestare e riavviare il server.

Per ottenere la correzione degli identificatori, contattare il fornitore del libro.

Non si riesce ad accedere alle funzioni di amministrazione sul server di documenti

Il server di documenti AnswerBook2 utilizza meccanismi di controllo degli accessi per identificare gli utenti che possono svolgere funzioni di amministrazione. Gli strumenti di amministrazione di AnswerBook2 permettono all'amministratore dei documenti del server di aggiungere ed eliminare altri utenti amministratori e di cambiare le loro password.

Per aggiungere o eliminare utenti amministratori del server, vedere "Controllo degli accessi di amministrazione". Per accedere a un altro server, contattare l'amministratore dei documenti di quel server.

Non è possibile eseguire comandi di amministrazione dalla pagina di amministrazione di AnswerBook2 (interfaccia browser)

Alcune funzioni non possono essere usate dalla GUI di amministrazione per ragioni di autorizzazioni. Provare a eseguire la stessa funzione dalla riga di comando con ab2admin.

Per informazioni sulle opzioni della riga di comando, vedere l'Appendice A.

La funzione "Individua le collezioni installate localmente" non presenta le collezioni di documenti che sono installate in un punto di attivazione locale

Verificare che la directory in cui sono state installate le collezioni sia accessibile in lettura.

È stata aggiunta una collezione AnswerBook1, ma gli utenti non riescono a visualizzarla nelle loro librerie

Questo problema indica un errore nei dati della collezione nel file ab_cardcatalog. Verificare che il contenuto di /var/log/ab2/catalog/ab1_cardcatalog sia corretto.

Quando si cerca di aggiungere una collezione dalla pagina di amministrazione di AnswerBook2, compare il messaggio Aggiunta della collezione fallita.

Verificare che il percorso del file collinfo o ab_cardcatalog della collezione sia corretto.

Il comando restart non ha riavviato il server di documenti o non ha prodotto i risultati previsti

In alcuni casi, il comando restart non funziona correttamente. Usare i comandi stop e start.

Per maggiori informazioni, vedere "Avvio e arresto del server di documenti".

Le collezioni di documenti sembrano danneggiate e devono essere reinstallate

Usare la funzione ab2admin -o del_coll o il comando "Elimina collezione dall'elenco" nella pagina di amministrazione di AnswerBook2 per eliminare queste collezioni dal database del server di documenti.

Quindi, usare pkgrm per rimuoverle dal server prima di installare i nuovi package.

Per maggiori informazioni sull'eliminazione delle collezioni, vedere "Eliminazione di collezioni AnswerBook2". Per maggiori informazioni sull'aggiunta delle collezioni, vedere "Aggiunta di collezioni".

Messaggi di errore di AnswerBook2

Questa sezione contiene i messaggi di errore di AnswerBook2 e spiega come procedere.

Cannot find local AnswerBook2 server to administer.

Cosa significa: Si è provato ad usare lo script answerbook2_admin o a lanciare la pagina di amministrazione di AnswerBook2 dal pannello principale del CDE, ma l'operazione non è riuscita perché sul sistema non è presente nessun server di documenti.

Come procedere: Spostarsi sul sistema in cui si trova il server di documenti e usare la stessa procedura, oppure inserire l'URL del server di documenti che si desidera amministrare dal browser.

No AnswerBook2 documentation server was found.

Cosa significa: Si è provato ad 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.

Come procedere: Per identificare un server di documenti predefinito, il client usa l'approccio seguente:

Se la variabile d'ambiente AB2_DEFAULTSERVER è definita, il visualizzatore di AnswerBook2 viene lanciato usando l'URL definito da questa variabile. Ad esempio, è possibile che il file .cshrc contenga la riga seguente:
setenv AB2_DEFAULTSERVER http://imaserver.eng.sun.com:8888/
Se il sistema da cui è stata avviata la funzione AnswerBook2 è un server di documenti, il visualizzatore AnswerBook2 cerca di accedere all'URL: http://localhost:8888
Se vi è un server AnswerBook2 registrato con FNS (Federated Naming Service), il visualizzatore AnswerBook2 utilizza l'URL del server registrato.

Software del server AnswerBook2 non trovato nel percorso %s.

Cosa significa: Si è cercato di lanciare lo script ab2cd, ma l'operazione non è riuscita perché il percorso specificato non è valido.

Come procedere: Eseguire il comando dalla directory in cui si trova lo script ab2cd o specificare il percorso completo per lo script ab2cd.

Architettura non supportata: %s.

Cosa significa: Si è cercato di eseguire lo script ab2cd da un sistema non supportato.

Come procedere: Il software del server di documenti richiede l'ambiente operativo Solaris 2.5.1, Solaris 2.6 o Solaris 7 eseguito su un sistema SPARC o Intel.

ab2cd non supporta la versione locale %s.

Cosa significa: Si è cercato di eseguire lo script ab2cd da un sistema configurato con una versione locale non supportata o con un sistema di codifica non supportato.

Come procedere: Il software del server di documenti supporta le seguenti versioni locali e i seguenti tipi di codifica: C, en_*, es, es_*, fr, fr_*, it, it_*, sv, sv_*, de, de_*, ja, japanese, ja_JP.PCK, ko, zh, zh_TW, zh_TW.BIG5 e *[Uu][Tt][Ff]-8*.

Autenticazione fallita, riprovare.

Cosa significa: Un utente amministratore ha digitato erroneamente la password di amministrazione.

Come procedere: Reinserire la password. Se l'errore si ripresenta, verificare che si stia cercando di amministrare il server per cui si possiede una password valida.

Mancano una o più opzioni obbligatorie.

Cosa significa: È stato eseguito un comando ab2cd, ma non sono state specificate le opzioni corrette.

Come procedere: Verificare di avere inserito correttamente il comando e le opzioni. Per maggiori informazioni sulle opzioni, vedere la pagina man ab2cd.