ab2admin(1M) (Installazione e amministrazione di un server AnswerBook2)

Installazione e amministrazione di un server AnswerBook2

ab2admin(1M)

Nome

ab2admin- , interfaccia dalla riga di comando per l'amministrazione di AnswerBook2

SYNOPSIS

/usr/lib/ab2/bin/ab2admin

-h

comando

-o

comando

argomenti

DESCRIPTION

Il comando ab2admin è un'interfaccia disponibile dalla riga di comando per l'amministrazione delle collezioni e dei documenti AnswerBook2 su un determinato server AnswerBook2. Il comando permette di installare e rimuovere collezioni AnswerBook1 e AnswerBook2 su un server, di identificare le collezioni installate localmente, di aggiornare il database del server e di ottenere un elenco delle collezioni e dei libri disponibili.

Le funzioni di gestione del server di ab2admin permettono di: arrestare il server, avviare il server, riavviare il server, attivare o disattivare i file di log del server e ruotare i file di log. Il server può essere configurato in modo da risolvere i collegamenti che puntano a libri residenti su altri server AnswerBook2.

ab2admin può anche essere usato per controllare l'accesso al server mediante l'inserimento o l'eliminazione degli utenti desiderati dal gruppo degli utenti amministratori. Il controllo degli accessi può essere abilitato o disabilitato.

ab2admin può collegarsi a qualsiasi server AnswerBook2 (locale o remoto). Alcune funzioni (come stop, start e restart) possono essere utilizzate solo sul server AnswerBook2 locale. Se il server AnswerBook2 è protetto da una password, per eseguire le operazioni di amministrazione sarà necessario inserire l'ID utente e la password appropriata.

Per eseguire ab2admin in modo interattivo, digitare ab2admin dalla riga di comando e quindi inserire i comandi richiesti. ab2admin può anche essere eseguito interamente dalla riga di comando utilizzando l'opzione -o.

OPTIONS

Sono supportate le seguenti opzioni:

-h [comando]: Visualizza la guida e le informazioni specificate su un comando.
-o sottocomando [ argomenti]: Qui di seguito è riportato l'elenco dei sottocomandi supportati.

Sottocomandi

Sono supportati i seguenti sottocomandi dell'opzione -o:

access_off [ -m server ] [ -p porta_server]: Disabilita il file di log relativo agli accessi al server.
access_on [ -m server ] [ -p porta_server]: Abilita il file di log relativo agli accessi al server.
add_admin -u id_utente [ -m server ] [ -p porta_server]: Aggiunge un utente alla lista degli amministratori autorizzati del server.
add_coll -d percorso [ -m server ] [ -p porta_server ]: Aggiunge collezioni AnswerBook1 o AnswerBook2 al database del server AnswerBook2 specificato.
add_server -M server_alternativo -P porta_server_alternativo [ -m server ] [ -p porta_server ]: Aggiunge un server alternativo al server specificato.
auth_off [ -m server ] [ -p porta_server]: Disabilita la verifica per l'amministrazione del server.
auth_on [ -m server ] [ -p porta_server]: Abilita la verifica per l'amministrazione del server.
autostart_no [ -m server ] [ -p porta_server]: Disabilita il riavvio automatico del server AnswerBook2 al reboot del sistema.
autostart_yes [ -m server ] [ -p porta_server]: Abilita il riavvio automatico del server AnswerBook2 al reboot del sistema.
browser [ -m server ] [ -p porta_server]: Lancia un Web browser per l'accesso alle pagine di amministrazione di AnswerBook2.
change_password -u id_amministratore[ -m server ] [ -p porta_server]: Cambia la password dell'amministratore autorizzato.
del_admin -u id_utente[ -m server ] [ -p porta_server]: Elimina un utente dalla lista degli amministratori autorizzati del server.
del_coll -t titolo_collezione [ -m server ] [ -p porta_server ]: Rimuove collezioni AnswerBook1 o AnswerBook2 dal database del server specificato.
del_server -M server_alternativo -P porta_server_alternativo [ -m server ] [ -p porta_server]: Elimina un server alternativo dalla lista dei server noti al server specificato.
error_off [ -m server ] [ -p porta_server]: Disabilita il file di log relativo agli errori del server.
error_on [ -m server ] [ -p porta_server]: Abilita il file di log relativo agli errori del server.
help [ comando]: Presenta tutte le informazioni relative a un determinato comando o a tutti i comandi.
list [ -m server ] [ -p porta_server]: Elenca le collezioni AnswerBook1 e AnswerBook2 disponibili sul server specificato. L'elenco comprende i libri contenuti nelle collezioni.
list_server [ -m server ] [ -p porta_server]: Elenca tutti i server alternativi definiti per il server specificato.
menu: Presenta un elenco sintetico delle opzioni dei comandi.
modify_server_name -s nuovo_nome_server [ -m server ] [ -p porta_server ]: Modifica il nome del server.
modify_server_port -a nuova_porta_server [ -m server ] [ -p porta_server ]: Modifica il numero di porta del server.
restart: Riavvia il server AnswerBook2 locale. Richiede l'accesso come utente root.
rotate_access [ -m server ] [ -p porta_server ]: Salva e ripristina il file di log relativo agli accessi al server.
rotate_error [ -m server ] [ -p porta_server ]: Salva e ripristina il file di log relativo agli errori del server.
scan [ -m server ] [ -p porta_server ]: Identifica le collezioni installate localmente (AnswerBook1 o AnswerBook2) e aggiorna il database del server specificato.
start: Avvia il server AnswerBook2 locale. Richiede l'accesso come utente root.
start -D: Avvia il server AnswerBook2 locale in modalità debug. Richiede l'accesso come utente root.
stop: Arresta il server AnswerBook2 locale. Richiede l'accesso come utente root.
view_access [ -m server ] [ -p porta_server ]: Visualizza il contenuto del file di log relativo agli accessi al server.
view_config [ -m server ] [ -p porta_server ]: Visualizza le opzioni di configurazione del server.
view_error [ -m server ] [ -p porta_server ]: Visualizza il contenuto del file di log relativo agli errori del server.

SINTASSI

quit: Esce dalla modalità interattiva.
q: Esce dalla modalità interattiva.
bye: Esce dalla modalità interattiva.
exit: Esce dalla modalità interattiva.
? [comando]: Visualizza la guida in modalità interattiva.
h [comando]: Visualizza la guida in modalità interattiva.

EXAMPLES

Esempio 1 Visualizzazione delle collezioni AnswerBook2 disponibili su un server

Per visualizzare l'elenco delle collezioni disponibili su un server di nome foo.com con numero di porta 8888:

esempio% ab2admin -o list -m foo.com -p 8888

Esempio 2 Visualizzazione delle collezioni in modalità interattiva

Per eseguire l'operazione sopra descritta usando ab2admin in modalità interattiva:

esempio% ab2admin >> list -m foo.com -p 8888

Esempio 3 Installazione di una collezione AnswerBook2

Per installare una collezione AnswerBook2 usando l'utility pkgadd:

esempio# pkgadd -d directory_package /SUNWabsdk

La struttura di directory della collezione verrà copiata nel sistema (automaticamente) sotto /opt/answerbooks/

Esempio 4 Installazione di una collezione AnswerBook2 non aggiornata nel database del server

Per installare una collezione AnswerBook2 che è stata installata nel sistema (con pkgadd) ma che non è stata aggiornata nel database del server:

esempio# ab2admin -o add_coll -d  /opt/answerbooks/english/solaris_2.6/SUNWabsdk

(Nota: -d percorso deve includere il file collinfo (per le collezioni AnswerBook2) o il file ab_cardcatalog (per le collezioni AnswerBook1).

Esempio 5 Analisi della definizione di una collezione AnswerBook1

Per analizzare la definizione di una collezione AnswerBook1:

esempio% cat /opt/SUNWans/ab_cardcatalog
:id=SUNWab_10_4: \
:version=: \
:title=Solaris XGL 3.1 AnswerBook: \
:tocpath=/net/elirium.Eng/export/answerbook/Solaris_2.4/SUNWAxg/toc: \
:pspath=/net/elirium.Eng/export/answerbook/Solaris_2.4/SUNWAxg/ps: \
:indexpath=/net/elirium.Eng/export/answerbook/Solaris_2.4/SUNWAxg/inde

Esempio 6 Analisi della definizione di una collezione AnswerBook2

Per analizzare la definizione di una collezione AnswerBook2:

esempio% cat/opt/answerbooks/english/solaris_2.6/SUNabsd/collinfo
dwCollections {
   coll.45.4 dwCollection
}
dwSetParam coll.45.4 {
   location /opt/answerbooks/english/solaris_2.6/SUNWabsdk
   title "Solaris 2.6 Software Developer AnswerBook Vol 1"
   type EbtCollection }

FILES

/var/log/ab2/catalog/local.socat: File di catalogo
/var/log/ab2/catalog/remote.socat: File di catalogo
/var/log/ab2/catalog/delegate.socat: File di catalogo
/var/log/ab2/catalog/libcat.socat: File di catalogo
/var/log/ab2/logs/access_8888.log: File di log predefinito per gli accessi
/var/log/ab2/logs/errors_8888.log: File di log predefinito per gli errori
/usr/lib/ab2/dweb/data/config/ab2_collections.template: Database delle collezioni AnswerBook2
/var/log/ab2/catalog/ab1_cardcatalog: Database delle collezioni AnswerBook1
/usr/lib/ab2/dweb/data/config/admin_passwd: File contenente le informazioni nomeutente:password

ATTRIBUTES

Vedere attributes(5) per la descrizione dei seguenti attributi:

TIPO ATTRIBUTO	VALORE ATTRIBUTO
Disponibile in	`SUNWab2u`