Installazione e amministrazione di un server AnswerBook2

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