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 |
Questo sottocomando visualizza un breve messaggio della Guida, che riporta un elenco dei sottocomandi rscadm ed una breve descrizione di ognuno di essi.
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] ".
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"
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".
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.
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.
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.
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.
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] ")
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
Durante l'esecuzione del sottocomando download, RSC ha rilevato un problema all'hardware durante il tentativo di programmazione della EEPROM di RSC.
rscadm: scaricamento non riuscito, RSC ha rilevato un errore di cancellazione
Durante l'esecuzione del sottocomando download, RSC ha rilevato un problema all'hardware durante il tentativo di programmazione della EEPROM di RSC.
rscadm: scaricamento non riuscito, RSC ha rilevato un errore di verifica
Durante l'esecuzione del sottocomando download, RSC ha rilevato un problema all'hardware durante il tentativo di programmazione della EEPROM di RSC.
rscadm: scaricamento non riuscito, RSC ha rilevato un errore int_wp
Durante l'esecuzione del sottocomando download, RSC ha rilevato un problema all'hardware durante il tentativo di programmazione della EEPROM di RSC.
rscadm: scaricamento non riuscito, RSC ha rilevato un errore vpp
Durante l'esecuzione del sottocomando download, RSC ha rilevato un problema all'hardware durante il tentativo di programmazione della EEPROM di RSC.
rscadm: scaricamento non riuscito, RSC ha rilevato un errore wp
Durante l'esecuzione del sottocomando download, RSC ha rilevato un problema all'hardware durante il tentativo di programmazione della EEPROM di RSC.
rscadm: scaricamento respinto, interruttore a chiave in posizione Bloccato?
Non è possibile eseguire il sottocomando download quando l'interruttore a chiave del server è in posizione Bloccato.
rscadm: tutti gli slot utente sono pieni
Questo errore si verifica se si tenta di aggiungere un profilo utente quando sono già stati configurati quattro profili utente per RSC; RSC supporta un massimo di quattro profili utente. Per aggiungere un nuovo profilo, è necessario eliminare un profilo utente esistente.
rscadm: utente già esistente
L'utente che si sta tentando di aggiungere possiede già un profilo RSC su questo server.
rscadm: variabile non valida
Durante l'esecuzione del sottocomando set, è stata specificata una variabile non valida. Per i valori corretti, vedere "Variabili di configurazione RSC".
rscadm: variabile o valore non valido
Durante l'esecuzione del sottocomando set, sono stati specificati una variabile o un valore non validi. Per i valori corretti, vedere "Variabili di configurazione RSC".
SINTASSI: rscadm <comando> [opzioni]
Per una lista dei comandi, digitare rscadm help.
SINTASSI: rscadm date [-s] | [[mmgg]HHMM | mmggHHMM[ss]aa][.SS]
Intervalli dei parametri della data:
01 <= mm <= 12
01 <= dd <= 31
01 <= HH <= 23
00 <= MM <= 59
19 <= cc <= 22
00 <= yy <= 99
00<= SS <= 59
SINTASSI: rscadm download [boot] <file>
SINTASSI: rscadm resetrsc [-s]
SINTASSI: rscadm send_event [-c] "messaggio"
SINTASSI: rscadm set <variabile> <valore>
SINTASSI: rscadm show [variabile]
SINTASSI: rscadm useradd <nome_utente>
SINTASSI: rscadm userdel <nome_utente>
SINTASSI: rscadm userpassword <nome_utente>
SINTASSI: rscadm userperm <nome_utente> [cuar]
L'utente che si sta tentando di aggiungere possiede già un profilo RSC su questo server.
SINTASSI: rscadm usershow [nome_utente]