Guía del usuario de Remote System Control (RSC) de Sun

Capítulo 5 Utilidad `rscadm`

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.

Subcomandos de `rscadm`

`help`

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.

`date [-s] date [[mmdd]HHMM|mmddHHMM[ss]aa]][.SS]`

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.

`set` `variable valor`

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"

`show [variable]`

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.

`resetrsc [-s]`

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.

`download [boot]archivo`

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.

`send_event [-c]mensaje`

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.

`modem_setup`

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.

Subcomandos de administración de cuentas de usuario

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] ")

Mensajes de error de `rscadm`

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