La utilidad rscadm y sus subcomandos permiten administrar RSC desde el sistema principal. Es necesario entrar en el servidor como usuario root para poderla utilizar. La mayoría de los subcomandos de rscadm también se encuentran disponibles desde el shell de comandos de RSC, pero rscadm resulta más conveniente para:
Reconfigurar RSC cuando se desconocen las contraseñas de las cuentas.
Restaurar RSC cuando no responde.
Hacer una copia de seguridad de los datos de configuración.
Descargar el firmware de RSC.
Sincronizar la fecha y la hora de RSC con las del servidor.
La utilidad rscadm incluye los siguientes subcomandos.
Tabla 5-1 Subcomandos de rscadm
Subcomando |
Descripción |
---|---|
help |
Muestra una lista de comandos de rscadm y una breve descripción de cada uno de ellos. |
date |
Permite ver o definir la fecha y hora actuales. |
set |
Permite definir las variables de configuración. |
show |
Muestra el valor de una o varias variables de configuración. |
resetrsc |
Restaura RSC de forma inmediata. |
download |
Permite descaragr el firmware en la PROM flash de RSC. |
send_event |
Registra eventos y puede enviar también mensajes de alerta. |
modem_setup |
Permite cambiar la configuración del módem conectado al puerto serie de RSC. |
useradd |
Permite añadir cuentas de usuario de RSC. |
userdel |
Permite borrar cuentas de usuario de RSC. |
usershow |
Muestra las características de las cuentas de usuario de RSC. |
userpassword |
Permite definir o cambiar la contraseña de los usuarios. |
userperm |
Permite establecer las autorizaciones del usuario. |
Muestra en pantalla un mensaje de Ayuda básico que incluye la lista de los subcomandos de rscadm y una breve descripción de cada uno de ellos.
El subcomando date se utiliza para ver la fecha y hora actuales. Con la opción -s se puede sincronizar la hora de RSC con la del servidor. Si desea establecer en RSC una fecha y una hora distintas de las del servidor, suministre una fecha con el comando.
Consulte "date [[mmdd]HHMM|mmddHHMM[ss]aa][.SS] " si desea ver una descripción de los formatos de fecha.
El subcomando set se utiliza para definir las variables de configuración de RSC. Consulte "Variables de configuración de RSC" si desea ver la descripción de cada una de ellas.
Es posible utilizar una cadena vacía ("") para que la variable tenga valor nulo. Para definir una cadena que incluya espacios o caracteres especiales de shell UNIX, escríbala entre comillas. Por ejemplo:
# rscadm set page_info2 "" # rscadm set page_init1 "&F &E0"
Este subcomando se utiliza para ver el valor de una o varias variables de configuración de RSC. Si no se especifica la variable, RSC muestra todas ellas. Consulte "Variables de configuración de RSC" si desea ver la descripción de cada variable.
Este subcomando restaura RSC de forma inmediata. Para finalizar las conexiones de forma limpia antes de la restauración, utilice la opción -s. Si no se suministra este argumento, se efectúa una restauración completa y se interrumpen todas las conexiones.
Con este subcomando se puede descargar en RSC el nuevo firmware contenido en archivo. Si se especifica boot, el contenido de archivo se instalará en la sección de arranque de la memoria no volátil de RSC, de lo contrario, se instalará en la sección de firmware principal de dicha memoria.
Cuando la transferencia finaliza, RSC se restaura. Si el botón selector del sistema principal está en la posición de bloqueo (Lock), no se podrá actualizar el firmware y aparecerá un mensaje de error.
Este subcomando se utiliza para introducir un evento en el registro de eventos de RSC. Utilice la opción -c si además desea que RSC envíe un mensaje de alerta con arreglo a la configuración existente para estos mensajes. El mensaje es una cadena ASCII de no más de 80 caracteres. Para utilizar una cadena que incluya espacios o caracteres especiales de shell UNIX, escríbala entre comillas.
Consulte el Apéndice C si desea ver un ejemplo de secuencia de comandos Perl que utiliza este subcomando para enviar un mensaje de alerta.
Con este subcomando se puede cambiar la configuración del módem conectado al puerto serie de RSC. Si el módem está correctamente conectado, se pueden introducir los comandos AT estándar y ver las respuestas que éste envía. Al comienzo de una línea, utilice el carácter de escape (~) seguido de un punto para salir del subcomando. Ejemplo:
# rscadm modem_setup AT <enter> OK ~. #
La secuencia de escape de rscadm modem_setup es siempre ~. La consola de RSC tiene un carácter de salida configurable, pero en el caso de rscadm modem_setup está codificado en el hardware.
Para administrar las cuentas de usuario desde el sistema principal utilizando rscadm, entre en el sistema como usuario root y ejecute la utilidad rscadm con los siguientes subcomandos:
useradd (consulte "useradd nombreusuario ")
userdel (consulte "userdel nombreusuario ")
usershow (consulte "usershow [nombreusuario] ")
userpassword (consulte "userpassword nombreusuario")
userperm (consulte "userperm nombreusuario [c][u][a][r] ")
Esta sección contiene una explicación de los mensajes de error que puede enviar la utilidad rscadm. Los últimos 12 mensajes son de error de uso de los comandos.
Es PRECISO ser usuario root para ejecutar este programa
El mensaje ya explica las razones del error.
Las contraseñas no coinciden, pruebe otra vez
Durante la ejecución del subcomando userpassword es preciso introducir la contraseña dos veces. Si la segunda contraseña no coincide con la primera, el sistema pide que se vuelva a introducir.
rscadm: comando desconocido
Ha utilizado un subcomando de rscadm que no es válido.
rscadm: contraseña incorrecta
Ha introducido un formato de contraseña incorrecto. Las contraseñas deben tener entre 6 y 8 caracteres, y deben contener al menos dos caracteres alfabéticos y uno numérico o especial.
rscadm: descarga denegada, ¿selector en modo bloqueo?
No se puede ejecutar el subcomando download cuando el selector del servidor está en la posición de bloqueo (Lock).
rscadm: el archivo no es un registro válido
El archivo que se debe descargar mediante el subcomando download no es un archivo de registro s válido.
rscadm: el firmware de RSC no responde
El firmware principal de RSC no responde. Puede que RSC esté arrancando, que el firmware principal esté dañado o que RSC tenga un problema de hardware.
rscadm: el mensaje de evento no puede superar los 80 caracteres
El mensaje del subcomando send_event no puede tener más de 80 caracteres.
rscadm: el nombre de usuario no empezaba por una letra o no hay ninguna letra minúscula
Ha utilizado un formato incorrecto para el nombre de usuario al agregar una cuenta de RSC
rscadm: el nombre de usuario no existe
El nombre de usuario especificado no está asociado a ninguna cuenta de RSC del servidor.
rscadm: el usuario ya existe
El usuario que trata de agregar ya tiene una cuenta de RSC en el servidor.
rscadm: Error al descargar el archivo
Se ha producido un error interno al ejecutar el subcomando download.
rscadm: ERROR, ha fallado la inic. de retorno de llamada
Se ha producido un error interno durante la ejecución del subcomando download.
rscadm: ERROR INTERNO, desbordamiento en retorno de llamada
Se ha producido un error interno al ejecutar el subcomando download.
rscadm: ERROR INTERNO en la definición de fecha
Se trata de un error interno del software de rscadm.
rscadm: ERROR, las contraseñas no coinciden
Durante la ejecución del subcomando userpassword es preciso introducir la contraseña dos veces. Si la segunda contraseña no coincide con la primera, el sistema pide que se vuelva a introducir. Si no coincide por segunda vez, el subcomando falla.
rscadm: ERROR, no se ha podido establecer la cola de mensajes
Se ha producido un error interno al ejecutar el subcomando download.
rscadm: ha fallado la descarga, RSC ha indicado un error de borrado
Al ejecutar el subcomando download, RSC ha notificado un problema de hardware cuando trataba de programar la EEPROM de RSC.
rscadm: ha fallado la descarga, RSC ha indicado un error de int_wp
Al ejecutar el subcomando download, RSC ha notificado un problema de hardware cuando trataba de programar la EEPROM de RSC.
rscadm: ha fallado la descarga, RSC ha indicado un error de rango
Al ejecutar el subcomando download, RSC ha notificado un problema de hardware cuando trataba de programar la EEPROM de RSC.
rscadm: ha fallado la descarga, RSC ha indicado un error de verificación
Al ejecutar el subcomando download, RSC ha notificado un problema de hardware cuando trataba de programar la EEPROM de RSC.
rscadm: ha fallado la descarga, RSC ha indicado un error de vpp
Al ejecutar el subcomando download, RSC ha notificado un problema de hardware cuando trataba de programar la EEPROM de RSC.
rscadm: ha fallado la descarga, RSC ha indicado un error de wp
Al ejecutar el subcomando download, RSC ha notificado un problema de hardware cuando trataba de programar la EEPROM de RSC.
rscadm: la línea de comandos es demasiado larga
Compruebe si hay una línea de comandos excesivamente larga.
rscadm: la longitud máxima del nombre de usuario es - 8
El nombre de usuario introducido superaba los ocho caracteres. La longitud máxima admitida para estos nombres es de ocho caracteres.
rscadm: no se ha detectado el hardware de RSC o se ha encontrado un archivo de bloqueo. Sólo se puede ejecutar una copia de rscadm cada vez
El mensaje aclara las razones del error.
rscadm: no se ha podido abrir el archivo
Al ejecutar el subcomando download, no se ha podido abrir el archivo especificado en la línea de comandos.
rscadm: no se ha podido agregar el usuario
RSC ha detectado un error interno al intentar agregar una cuenta de usuario. la SEEPROM puede estar dañada.
rscadm: no se ha podido cambiar la contraseña
RSC ha detectado un error interno al intentar cambiar la contraseña de usuario. La SEEPROM de RSC puede estar dañada.
rscadm: no se ha podido crear el subproceso
Ha fallado una llamada de creación de subproceso durante la ejecución del subcomando modem_setup.
rscadm: no se ha podido definir la fecha de RSC
RSC ha detectado un error interno al tratar de definir la fecha.
rscadm: no se ha podido efectuar la conexión con el módem
RSC no ha podido conectarse al módem durante la ejecución del subcomando modem_setup. Compruebe si el módem está conectado. Puede ser que haya algún servicio buscapersonas que lo esté utilizando o que RSC esté conectado a otro módem.
rscadm: no se ha podido efectuar la desconexión del módem
RSC no se ha desconectado del módem durante la ejecución del subcomando modem_setup.
rscadm: no se ha podido eliminar el usuario
RSC ha detectado un error interno al intentar eliminar una cuenta de usuario. la SEEPROM puede estar dañada.
rscadm: no se ha podido enviar el mensaje de alerta
El firmware de RSC no ha podido enviar el mensaje de evento durante la ejecución del subcomando send_event.
rscadm: no se ha podido leer la fecha de RSC
Se ha producido un error indeterminado en el firmware de RSC al tratar de obtener la fecha de esta aplicación.
rscadm: no se ha podido obtener información sobre el usuario
RSC ha detectado un error interno al intentar acceder a la información del usuario durante la ejecución del subcomando usershow. La SEEPROM de RSC puede estar dañada.
rscadm: no se han podido cambiar los permisos
RSC ha detectado un error interno al intentar cambiar los permisos de usuario. La SEEPROM de RSC puede estar dañada.
rscadm: No se han podido enviar los datos del módem a RSC
RSC no reconoce la recepción de datos. Compruebe si está en funcionamiento.
rscadm: No se puede restaurar el hardware de RSC
Ha fallado la restauración completa del hardware de RSC durante la ejecución del subcomando resetrsc.
rscadm: no se pueden enviar datos a RSC
RSC no reconoce el envío de datos. Compruebe si la aplicación está funcionando.
rscadm: nombre de usuario incorrecto
Ha introducido caracteres no permitidos en el nombre de usuario.
rscadm: RSC ha dado una respuesta incorrecta
RSC ha devuelto una respuesta incorrecta durante la ejecución de un subcomando user*. Esto se considera un error interno de RSC o de rscadm.
rscadm: RSC ha devuelto datos ilegibles
Este error puede producirse en distintas situaciones, tal y como se indica.
rscadm: RSC ha indicado error desconocido
RSC ha notificado un estado desconocido (ni correcto, ni incorrecto) durante la ejecución del subcomando download.
rscadm: RSC ha indicado error grave
RSC ha comunicado la existencia de un error no documentado durante la ejecución del subcomando download.
rscadm: RSC no ha respondido durante la descarga
RSC no introducido el modo de arranque adecuadamente durante la ejecución del subcomando download.
rscadm: RSC no ha respondido durante la inicialización del arranque
Se ha producido un error interno al ejecutar el subcomando download.
rscadm: RSC no puede liberar memoria
Este mensaje puede generarse en varias situaciones. La utilidad rscadm no ha podido liberar el mensaje recibido del firmware de RSC.
rscadm: RSC no responde a las peticiones
No se ha enviado la respuesta que se esperaba de RSC. Compruebe si la aplicación está funcionando.
rscadm: variable o valor no válidos
La variable o el valor introducidos durante la ejecución del subcomando set no son válidos. Consulte "Variables de configuración de RSC" para conocer los valores correctos.
rscadm: variable no válida
Ha introducido una variable incorrecta durante la ejecución del subcomando set. Consulte "Variables de configuración de RSC" para conocer los valores correctos.
USO: rscadm <comando> [opciones]
Para obtener la lista de subcomandos, escriba rscadm help.
USO: rscadm date [-s] | [[mmdd]HHMM | mmddHHMM[ssaa]][.SS]
Los parámetros de fecha admiten los rangos siguientes:
01 <= mm <= 12
01 <= dd <= 31
01 <= HH <= 23
00 <= MM <= 59
19 <= cc <= 22
00 <= yy <= 99
00<= SS <= 59
USO: rscadm download [boot] <archivo>
USO: rscadm resetrsc [-s]
USO: rscadm send_event [-c] "mensaje"
USO: rscadm set <variable> <valor>
USO: rscadm show [variable]
USO: todas las cuentas de usuario permitidas están en uso
Este error se produce cuando se intenta agregar una cuenta de usuario y RSC tiene ya cuatro cuentas configuradas. RSC sólo admite cuatro cuentas de usuario, por lo que es necesario eliminar una antes de agregar otra nueva.
USO: rscadm useradd <nombreusuario>
USO: rscadm userdel <nombreusuario>
USO: rscadm userpassword <nombreusuario>
USO: rscadm userperm <nombreusuario> [cuar]
El usuario que trata de agregar ya tiene una cuenta de RSC en el servidor.
USO: rscadm usershow [nombreusuario]