Manuale utente Sun Remote System Control (RSC)

Capitolo 5 Uso della utility `rscadm`

La utility rscadm ed i relativi sottocomandi consentono l'amministrazione di RSC dall'host. Per poter utilizzare rscadm, è necessario eseguire il login al server come superutente (root). La maggior parte dei sottocomandi rscadm sono disponibili anche utilizzando la shell dei comandi di RSC, tuttavia l'uso di rscadm è preferibile per le operazioni seguenti:

Riconfigurazione di RSC quando non si conoscono le password dei profili

Ripristino di RSC quando non risponde

Backup dei dati di configurazione

Scaricamento del firmware RSC

Sincronizzazione della data e dell'ora di RSC con la data e l'ora del server.

La utility rscadm utilizza i sottocomandi seguenti.

Tabella 5-1 Sottocomandi della utility rscadm


Sottocomando	Descrizione
`help`	Visualizza un elenco dei comandi `rscadm` ed una breve descrizione di ognuno di essi
`date`	Visualizza o imposta l'ora e la data correnti
`set`	Imposta una variabile di configurazione
`show`	Visualizza una o più variabili di configurazione
`resetrsc`	Ripristina immediatamente RSC
`download`	Scarica il firmware nella PROM flash di RSC
`send_event`	Registra un evento; può inoltre inviare un messaggio di avviso
`modem_setup`	Cambia la configurazione del modem collegato alla porta seriale RSC
`useradd`	Aggiunge un profilo utente RSC
`userdel`	Elimina un profilo utente RSC
`usershow`	Mostra le caratteristiche di un profilo utente RSC
`userpassword`	Imposta o cambia la password di un utente
`userperm`	Imposta l'autorizzazione per un utente

Sottocomandi della utility `rscadm`

`help`

Questo sottocomando visualizza un breve messaggio della Guida, che riporta un elenco dei sottocomandi rscadm ed una breve descrizione di ognuno di essi.

`date [-s] date [[mmgg]HHMM|mmggHHMM[ss]aa]][.SS]`

Utilizzare il sottocomando date per visualizzare la data e l'ora correnti; utilizzare l'opzione -s per sincronizzare l'ora di RSC con l'ora del server. Fornire una data con il sottocomando per impostare la data e l'ora di RSC su valori diversi da quelli del server.

Per una descrizione delle parti componenti del formato della data, vedere "date [[mmgg]HHMM|mmggHHMM[ss]aa][.SS] ".

`set` `valore variabile`

Utilizzare il sottocomando set per impostare una variabile di configurazione RSC. Per una descrizione di queste variabili, vedere "Variabili di configurazione RSC".

È possibile utilizzare la stringa nulla ("") per impostare una variabile su null. Per impostare una variabile su una stringa che include spazi o caratteri speciali della shell di UNIX, racchiudere la stringa tra doppie virgolette. Ad esempio:

# rscadm set page_info2 ""
# rscadm set page_init1 "&F &E0"

`show [variabile]`

Utilizzare il sottocomando show per visualizzare il valore di una o più variabili di configurazione RSC. Se non si specifica una variabile, RSC visualizza tutte le variabili di configurazione. Per una descrizione di queste variabili, vedere "Variabili di configurazione RSC".

`resetrsc [-s]`

Questo sottocomando ripristina immediatamente RSC. Per terminare tutte le connessioni in modo 'pulito' prima del ripristino, utilizzare l'opzione -s. Se non viene fornito alcun argomento, questo sottocomando esegue un ripristino hardware ed interrompe tutte le connessioni.

`download [boot]file`

Questo sottocomando supporta lo scaricamento in RSC del nuovo firmware che si trova in file. Se si specifica boot, il contenuto di file sarà installato nella sezione boot della memoria non volatile di RSC. Se non si specifica boot, il contenuto di file sarà installato nella sezione firmware principale della memoria non volatile di RSC.

Al termine del trasferimento, RSC si ripristina automaticamente. Se l'interruttore a chiave dell'host è in posizione Bloccato, non è possibile aggiornare il firmware di RSC e viene visualizzato un messaggio di errore.

`send_event [-c]messaggio`

Utilizzare questo sottocomando per registrare un evento nel log eventi di RSC. Inserire l'opzione -c per inviare anche un messaggio di avviso che RSC inoltra in base alla configurazione degli avvisi. Il messaggio è una stringa ASCII di massimo 80 caratteri. Per utilizzare una stringa che include spazi o caratteri speciali della shell di UNIX, racchiudere la stringa tra doppie virgolette.

Per l'esempio di uno script Perl che utilizza questo sottocomando per inviare un avviso, vedere l'Appendice C.

`modem_setup`

Utilizzare questo sottocomando per cambiare la configurazione del modem collegato alla porta seriale RSC. Se il modem è collegato correttamente, è possibile inserire i comandi AT standard e vedere le risposte del modem. Per uscire dal sottocomando, inserire il carattere di escape (~) seguito da un punto all'inizio di una riga. Esempio:

# rscadm modem_setup
AT <enter>
OK
~.
#

La sequenza di escape per rscadm modem_setup è sempre ~. La console RSC presenta un carattere di escape configurabile, ma il carattere di escape per rscadm modem_setup non è modificabile.

Sottocomandi per l'amministrazione dei profili utente

Per amministrare i profili utente dall'host utilizzando rscadm, eseguire il login all'host come superutente ed utilizzare la utility rscadm con i sottocomandi seguenti:

useradd (vedere "useradd nome_utente")

userdel (vedere "userdel nome_utente ")

usershow (vedere "usershow [nome_utente] ")

userpassword (vedere "userpassword nome_utente ")

userperm (vedere "userperm nome_utente [c][u][a][r] ")

Messaggi di errore della utility `rscadm`

In questa sezione vengono fornite ulteriori spiegazioni sui messaggi di errore ricevuti dalla utility rscadm. Gli ultimi 12 sono messaggi di errore di sintassi.

Le password non corrispondono, riprovare

Durante l'esecuzione del sottocomando userpassword, la password è stata inserita due volte. Se le password specificate non sono uguali, viene richiesto di inserirle nuovamente.

Questo programma DEVE essere eseguito come root

Il programma deve essere eseguito come superutente.

rscadm: comando sconosciuto

È stato utilizzato un sottocomando rscadm non valido.

rscadm: errore durante lo scaricamento del file

Si è verificato un errore interno durante l'esecuzione del sottocomando download.

rscadm: ERRORE INTERNO nella data impostata

Errore interno del software rscadm.

rscadm: ERRORE INTERNO, overflow nel callback

Si è verificato un errore interno durante l'esecuzione del sottocomando download.

rscadm: ERRORE, le password non corrispondono

Durante l'esecuzione del sottocomando userpassword, la password è stata inserita due volte. Se le password specificate non sono uguali, viene richiesto di inserirle nuovamente. Se ancora una volta non corrispondono, il sottocomando non viene eseguito.

rscadm: ERRORE, impossibile configurare la coda messaggi

Si è verificato un errore interno durante l'esecuzione del sottocomando download.

rscadm: ERRORE, inizializzazione callback non riuscita

Si è verificato un errore interno durante l'esecuzione del sottocomando download.

rscadm: formato nome utente non corretto

Sono stati inseriti caratteri non validi in un nome utente.

rscadm: formato password non corretto

È stata specificata una password non valida. Una password valida contiene da 6 a 8 caratteri, presenta almeno due caratteri alfabetici ed almeno un carattere numerico o speciale.

rscadm: hardware RSC non rilevato o trovato file di lock. È possibile eseguire solo un'istanza di rscadm alla volta

Come dichiarato.

rscadm: il file non è un record s valido

Durante l'esecuzione del sottocomando download, il file da scaricare non era un file record s valido.

rscadm: il firmware RSC non risponde

Il firmware principale di RSC non risponde. Potrebbe essere in corso il boot di RSC, il firmware principale potrebbe essere danneggiato, oppure si è verificato un problema all'hardware di RSC.

rscadm: il messaggio relativo all'evento non può essere più lungo di 80 caratteri

Il messaggio per il sottocomando send_event non può essere più lungo di 80 caratteri.

rscadm: il nome utente non esiste

Il nome utente specificato non è associato ad alcun profilo utente RSC sul server.

rscadm: il nome utente non inizia con una lettera o non contiene una lettera minuscola

Durante il tentativo di aggiunta di un profilo utente RSC è stato utilizzato un formato nome utente non valido.

rscadm: impossibile aggiungere l'utente

RSC ha rilevato un errore interno durante il tentativo di aggiunta di un profilo utente. La SEEPROM di RSC potrebbe essere difettosa.

rscadm: impossibile aprire il file

Durante l'esecuzione del sottocomando download, non è stato possibile aprire il file specificato nella riga di comando.

rscadm: impossibile cambiare la password

RSC ha rilevato un errore interno durante il tentativo di modifica di una password utente. La SEEPROM di RSC potrebbe essere difettosa.

rscadm: impossibile cambiare le autorizzazioni

RSC ha rilevato un errore interno durante il tentativo di modifica delle autorizzazioni utente. La SEEPROM di RSC potrebbe essere difettosa.

rscadm: impossibile connettersi al modem

Durante l'esecuzione del sottocomando modem_setup, RSC non è riuscito a collegarsi al modem RSC. Verificare che il modem sia collegato. Il modem potrebbe essere correntemente utilizzato dal sottosistema di invio messaggi a cercapersone, oppure RSC è collegato ad un altro modem.

rscadm: impossibile creare thread

Durante l'esecuzione del sottocomando modem_setup, una chiamata di creazione thread non è riuscita.

rscadm: impossibile disconnettersi dal modem

Durante l'esecuzione del sottocomando modem_setup, RSC ha rifiutato di scollegarsi dal modem.

rscadm: impossibile eliminare l'utente

RSC ha rilevato un errore interno durante il tentativo di eliminazione di un profilo utente. La SEEPROM di RSC potrebbe essere difettosa.

rscadm: impossibile impostare la data su RSC

RSC ha rilevato un errore interno durante il tentativo di impostazione della data.

rscadm: impossibile inviare avviso

Durante l'esecuzione del sottocomando send_event, il firmware di RSC non è riuscito ad inviare l'evento.

rscadm: impossibile inviare dati a RSC

RSC non ha confermato i dati inviati. Verificare che RSC sia in funzione.

rscadm: impossibile inviare i dati del modem a RSC

RSC non ha confermato i dati inviati. Verificare che RSC sia in funzione.

rscadm: impossibile leggere la data da RSC

Si è verificato un errore indefinito nel firmware di RSC durante il tentativo di lettura della data da RSC.

rscadm: impossibile ottenere le informazioni sull'utente

RSC ha rilevato un errore interno durante il tentativo di accesso alle informazioni utente nel corso di un sottocomando usershow. La SEEPROM di RSC potrebbe essere difettosa.

rscadm: impossibile ripristinare l'hardware RSC

Durante l'esecuzione del sottocomando resetrsc, il tentativo di ripristino dell'hardware RSC non è riuscito.

rscadm: la lunghezza massima del nome utente è - 8

Il nome utente specificato contiene più di 8 caratteri; la lunghezza massima per i nomi utente è otto caratteri.

rscadm: riga comando troppo lunga

Verificare che la riga di comando non sia eccessivamente lunga.

rscadm: RSC ha restituito dati superflui

Questo errore si verifica in varie situazioni; come dichiarato.

rscadm: RSC ha restituito un errore fatale

Durante l'esecuzione del sottocomando download, RSC ha restituito un errore non documentato.

rscadm: RSC ha restituito un errore sconosciuto

Durante l'esecuzione del sottocomando download, RSC ha restituito uno stato non documentato (né esito positivo, né negativo).

rscadm: RSC ha restituito una risposta errata

RSC ha restituito una risposta non valida durante un sottocomando user*. Questo errore viene considerato errore interno in RSC o rscadm.

rscadm: RSC non è in grado di liberare memoria

Questo messaggio può verificarsi in varie situazioni. La utility rscadm non è stata in grado di cancellare il messaggio ricevuto dal firmware di RSC.

rscadm: RSC non ha risposto durante lo scaricamento

Durante l'esecuzione del sottocomando download, RSC non è passato correttamente in modalità boot.

rscadm: RSC non ha risposto durante l'inizializzazione del processo di boot

Si è verificato un errore interno durante l'esecuzione del sottocomando download.

rscadm: RSC non risponde alle richieste

Non è stata inviata la risposta attesa da RSC. Verificare che RSC sia in funzione.

rscadm: scaricamento non riuscito, RSC ha rilevato un errore di ambito