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

Capítulo 4 Utilización del shell de comandos de RSC

La forma más sencilla de utilizar Remote System Control es a través de la interfaz gráfica de usuario, desde donde se puede acceder a la Ayuda en línea.

Si se necesita utilizar RSC y la interfaz gráfica no está disponible, se puede utilizar el shell de comandos de RSC. Se trata de una sencilla interfaz de línea de comandos que permite administrar o diagnosticar el estado del servidor, así como configurar RSC.

RSC admite un máximo de dos conexiones telnet por servidor, que pueden ser sesiones de la interfaz de línea de comandos o conexiones de la interfaz gráfica con la consola del servidor (Abrir consola). RSC admite también hasta tres sesiones simultáneas de la interfaz gráfica de usuario.

Después de entrar en la cuenta de RSC, aparece el indicador del shell de RSC (rsc>), y pueden empezar a introducirse los comandos necesarios. En este capítulo se explica cómo entrar en una cuenta de RSC, así como el uso y la sintaxis de los comandos de la aplicación.

La tabla siguiente contiene un resumen de los comandos de RSC, cada uno de los cuales se explica con mayor detalle en las secciones posteriores.

Tabla 4-1 Comandos del shell de RSC

Nombre 

Descripción 

environment

Muestra información del estado actual del entorno. 

shownetwork

Muestra la configuración que tenga la red en ese momento. 

console

Establece conexión con la consola del servidor. 

break

Pone el servidor en modo depuración. 

xir

Genera una restauración del servidor iniciada externamente. 

bootmode

Controla el comportamiento del firmware del servidor, si va seguido por una restauración del servidor en un periodo de 10 minutos (similar a las combinaciones de L1-tecla en los teclados Sun). 

reset

Restaura el servidor de forma inmediata. 

poweroff

Apaga el servidor. 

poweron

Enciende el servidor. 

loghistory

Muestra la historia de todos los eventos registrados en la memoria intermedia de eventos de RSC. 

consolehistory

Muestra la historia de todos los mensajes de consola registrados en la memoria intermedia. 

consolerestart

Devuelve los registros de consola de arranque y ejecución a su estado "original". 

set

Permite definir las variables de configuración. 

show

Muestra una o varias variables de configuración. 

date

Muestra o permite definir la fecha y hora. 

password

Permite cambiar la contraseña de acceso a RSC. 

useradd

Permite agregar 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 las contraseñas de los usuarios. 

userperm

Permite definir los permisos de acceso de los usuarios. 

resetrsc

Restaura RSC de forma inmediata. 

help

Muestra una lista de todos los comandos del shell de RSC con una breve descripción de cada uno. 

version

Muestra la versión de firmware de RSC. 

logout

Finaliza la sesión del shell de RSC en curso. 


Nota -

Algunos comandos precisan un nivel de permiso de usuario específico. Consulte "userperm nombreusuario [c][u][a][r] " para obtener más información sobre los niveles de permiso.


En las secciones siguientes se ofrece información más detallada sobre cada uno de los comandos.

Entrada en la cuenta de RSC

Después de instalar y configurar el software de RSC y de configurar su cuenta de usuario, puede conectarse a RSC y entrar en la cuenta recién definida utilizando una estación de trabajo Solaris, un PC con Windows o un computador que disponga de un software de emulación de terminales ASCII.

Siga estos pasos para entrar en su cuenta de RSC:

  1. Conéctese con RSC utilizando uno de estos cinco métodos:

    1. Utilice PPP (point-to-point protocol) para conectarse a la red Ethernet de su empresa y, a continuación el comando telnet para conectarse a RSC.

      Acuda al administrador de la red si no conoce el nombre del servidor de RSC (normalmente es nombreservidor-rsc).

    2. Si ya se encuentra conectado a la red Ethernet de su empresa, utilice el comando telnet para conectarse a RSC.

    3. Conéctese al módem de RSC utilizando el protocolo PPP. Para poderlo hacer, es preciso habilitar antes PPP.

    4. Si PPP no está habilitado en el puerto serie, establezca una conexión directa con el módem de RSC.

    5. Conecte la máquina cliente directamente al puerto serie de RSC.

      Para poder utilizar esta opción, deberá deshabilitar PPP mediante el shell de RSC o mediante la utilidad rscadm para definir la variable de configuración ppp_enabled con el valor false, o bien hacerlo con la interfaz gráfica de usuario.

      Una vez que se ha establecido la conexión, aparece la siguiente pantalla:


      RSC version 1.0
      Please login:
      Please enter password:

  2. Introduzca su nombre de entrada a RSC.

  3. Introduzca la contraseña de acceso a RSC.

    Observará que la contraseña no se ve en la pantalla. Después de introducirla correctamente, RSC muestra este indicador:


    rsc>
     
    

    Puede introducir los comandos del shell de RSC desde el indicador rsc>.

Las entradas se almacenan en el registro de eventos de RSC, que además envía un mensaje de alerta si detecta cinco intentos fallidos de entrada en un periodo de cinco minutos. También se puede configurar RSC para que desconecte cualquier sesión conectada al puerto serie si transcurren más de diez minutos sin actividad. Consulte "serial_hw_handshake ".

Comandos de estado y control del servidor

Los siguientes comandos de RSC muestran el estado del servidor o permiten controlar su funcionamiento:

environment

Utilice el comando environment para obtener una visión instantánea del estado en que se encuentra el entorno del servidor, lo que incluye las temperaturas, el estado de la fuente de alimentación, el de los indicadores luminosos del panel frontal, la posición del selector, etc. La pantalla utiliza un formato similar al del comando UNIX prtdiag(1m). Por ejemplo:

rsc> environment

==================== Environmental Status ====================

System Temperatures (Celsius):
------------------------------
      CPU0    42
      CPU1    52
       MB0    33
       MB1    27
       PDB    29
      SCSI    25

=================================
Front Status Panel:
-------------------

Keyswitch position is in On mode.

System LED Status:  DISK ERROR      POWER 
                      [OFF]         [ ON]      
                POWER SUPPLY ERROR  ACTIVITY 
                      [OFF]         [ ON]      
                    GENERAL ERROR   THERMAL ERROR  
                      [OFF]         [OFF]      

=================================

Disk LED Status:    OK = GREEN  ERROR = YELLOW
        DISK  5: [EMPTY]    DISK  3: [EMPTY]    DISK  1:    [OK]
        DISK  4: [EMPTY]    DISK  2:    [OK]    DISK  0:    [OK]

=================================

Fan Bank:
---------
Bank      Speed     Status
         (0-255)    
----      -----     ------
 SYS       151        OK

=================================

Power Supplies:
---------------

Supply     Status
------     ------
  0          OK  
  1          OK  

=================================

rsc> 

shownetwork

El comando shownetwork muestra la configuración actual de la red. Por ejemplo:


rsc> shownetwork
RSC network configuration is:
DHCP server: 129.149.2.3
IP Address: 129.149.2.6
Gateway Address: 129.149.2.7, 129.149.2.8
Netmask: 255.255.255.0
Ethernet Address: ae:30:30:00:00:01
rsc>

console

Utilice el comando console para introducir el modo de consola RSC y conectarse a la consola del servidor desde el shell de RSC. Al usar este comando, el sistema muestra el indicador normal de Solaris. Si no se designa RSC como consola del servidor, no aparece nada en pantalla.

Es necesario disponer de permiso de usuario de nivel C para poder utilizar este comando. Para volver al indicador de RSC se emplea una secuencia de teclas de escape, cuya definición predeterminada es ~. (tilde punto). Consulte "escape_char ".

break

Utilice el comando break si desea poner el servidor en modo depuración. Es necesario disponer de permiso de usuario de nivel C para poder usar este comando. El selector del panel frontal del servidor no debe estar en posición de bloqueo (Lock) y el puerto serie del servidor debe estar designado como consola (consulte el Capítulo 6). El modo depuración puede utilizar kadb u OBP.

xir

Este comando genera el equivalente a una restauración del servidor iniciada externamente (XIR). Es preciso disfrutar de permiso de usuario de nivel R para poder utilizarlo. El servidor entra en modo OBP y muestra el indicador ok. Este comando resulta útil para depurar el software controlador o los núcleos, ya que se conserva la mayor parte de la memoria y los registros del servidor. Para reanudar el funcionamiento del sistema después de utilizar el comando xir, es preciso rearrancar el servidor.

bootmode [-u] [normal|forth|reset_nvram|diag| skip_diag]

Este comando permite controlar el comportamiento del firmware después de restaurar el servidor. Su funcionalidad es idéntica a la de las combinaciones de teclas con L1 en los teclados Sun. Es necesario disponer de permiso de usuario de nivel R para utilizar este comando. Si emplea bootmode sin argumentos, RSC muestra la opción de modo_arranque actual.

El valor de bootmode anula el de la variable diag-switch? de OBDiag del servidor, pero únicamente si es inmediatamente después de la siguiente restauración. Si RSC no detecta ninguna restauración durante un periodo de 10 minutos, no tiene en cuenta el comando bootmode. Por ejemplo:


rsc> bootmode forth
rsc> reset

Para definir la opción diag o skip_diag, es necesario especificar detrás del comando bootmode los comandos poweroff y poweron en un plazo de 10 minutos. Por ejemplo:


rsc> bootmode skip_diag
rsc> poweroff
rsc> poweron

Para forzar la entrada y salida de la consola a RSC, utilice la opción -u antes de especificar el modo de arranque.

La tabla siguiente contiene una descripción de los modos que pueden especificarse al utilizar el comando bootmode.

Tabla 4-2 Modos utilizados con el comando bootmode

Modo 

Descripción 

-u

Fuerza al servidor a redireccionar la consola a RSC. La opción -u debe preceder a cualquier modo_arranque que se especifique. Requiere la restauración del servidor.

normal

Arranque normal. El servidor ejecuta diagnóstico de bajo nivel. Requiere la restauración del servidor. 

forth

Introduce el intérprete Forth tan pronto como es posible (equivale a L1-F en el teclado). Requiere la restauración del servidor. 

reset_nvram

Restaura el valor predeterminado en todas la variables de NVRAM (equivale a L1-N en el teclado). Requiere la restauración del servidor. 

diag

Fuerza al servidor a ejecutar todas las pruebas de diagnóstico (equivale a L1-D en el teclado). Requiere el apagadoy encendido del servidor. 

skip_diag

Fuerza al servidor a omitir las pruebas de diagnóstico (equivale a L1-S en el teclado). Requiere el apagado y encendido del servidor. 


Nota -

Los modos diag y skip_diag sólo tienen efecto si el comando bootmode va seguido de los comandos poweroff y poweron en un periodo de 10 minutos.


reset

Este comando fuerza la restauración del servidor de forma inmediata. Es preciso disponer de permiso de usuario de nivel R para poder utilizarlo. El servidor rearranca se acuerdo con el modo_arranque que se le haya designado.


Nota -

La configuración predeterminada del firmware de Sun Enterprise 250 no llama a POST cuando se restaura el servidor. Sin embargo, este comportamiento puede cambiar mediante los valores de las variables de NVRAM. Si precisa más información, consulte el manual Platform Notes: Sun Enterprise 250 Server.


poweroff

El comando poweroff se utiliza para apagar el servidor y es preciso disponer de permiso de nivel R para usarlo. No tiene ningún efecto si el servidor ya se encuentra apagado. Al ejecutarlo, RSC puede seguir funcionando ya que utiliza la alimentación auxiliar del servidor.

poweron

El comando poweron se utiliza para encender el servidor y es necesario tener permiso de usuario de nivel R para usarlo. Este comando no tiene ningún efecto si se da alguna de las condiciones siguientes:

Comandos de visualización de registros de RSC

Los siguientes comandos de RSC permiten realizar diversas operaciones con los archivos de registro de RSC y de consola:

loghistory [index [+|-]n] [pause n]

El comando loghistory se utiliza sin subcomandos si se quiere ver la historia de todos los eventos registrados en la memoria intermedia de eventos de RSC. Tales eventos incluyen cualquier comando de RSC que cambie el estado del sistema. El comando puede emplearse también en su forma abreviada, lhist.

Los comandos siguientes permiten controlar la visualización de loghistory.

index [+|-]n

El subcomando index se utiliza para designar la posición de la memoria intermedia a partir de la cual se inicia la visualización. Incluye las siguientes opciones:

El contador se inicia en 1, lo que significa que index +1 indica la primera línea de la memoria intermedia e index -1 indica la última. Por ejemplo:


rsc> loghistory index -30

Este comando muestra las 30 últimas líneas y cualquier otra línea que se haya agregado a la memoria intermedia entre el momento en que el comando inicia su ejecución y el momento en que la finaliza.

pause n

El subcomando pause se utiliza para mostrar n líneas del registro cada vez (es similar al comando more). El valor de n debe ser un entero con decimales y el valor predeterminado es ver el registro de RSC entero, sin pausas.

Cada evento almacenado en el registro posee el siguiente formato:


$TIME $HOSTNAME $EVENTID $mensaje

EVENTID es un identificador exclusivo del evento, TIME es la hora a la que tuvo lugar (según la hora definida en RSC) y mensaje es una descripción fácilmente comprensible del evento.

A continuación se ofrece un ejemplo de entrada del registro:


FRI JAN 01 07:33:03 1999 sst4828: 00060003: "El sistema RSC ha arrancado"

consolehistory [boot|run|oboot|orun] [index [+|-]n] [pause n]

El comando consolehistory se utiliza para ver los mensajes de consola registrados en las memorias intermedias de RSC. Sin argumentos, el comando muestra todo el contenido de cualquier memoria intermedia de consola que tenga información. También puede utilizarse en su forma abreviada, chist.

Existen cuatro registros de consola:

Las memorias intermedias boot y oboot pueden contener hasta 8 Kbytes de información, mientras que run y orun pueden almacenar hasta 16 Kbytes.

Cuando se inicia el arranque de encendido, RSC empieza a llenar el registro de arranque original (oboot) con los datos procedentes de la consola del servidor. Cuando está lleno, escribe los datos en el registro original de ejecución (orun) y cuando orun se llena, empieza a sobrescribir los datos antiguos de este mismo registro.

Si RSC detecta una restauración del servidor mientras escribe en orun, cambia automáticamente al registro boot. Cuando éste se llena, cambia al registro run y, cuando run está lleno, empieza a sobrescribir los datos antiguos de este mismo registro.

Si RSC detecta una restauración del servidor mientras escribe en el registro run actual, vuelve a cambiar al registro boot actual.

pause n

El subcomando pause se utiliza para ver n líneas del registro cada vez (similar al comando more). n debe ser un número entero decimal y el valor predeterminado es ver 10 líneas del registro cada vez.

Consulte "loghistory [index [+|-]n] [pause n] " si desea ver una descripción del subcomando index.


Nota -

Las marcas de tiempo incluidas en los registros de consola reflejan la hora del servidor y pueden diferenciarse ligeramente de las marcas de tiempo de RSC contenidas en el registro de eventos de RSC. Para obtener más información sobre la forma de sincronizar la hora de RSC y del servidor mediante la utilidad rscadm, consulte "date [-s] date [[mmdd]HHMM|mmddHHMM[ss]aa]][.SS]".


consolerestart

El comando consolerestart hace que los registros de arranque y ejecución actuales se conviertan en los registros "originales" (denominados oboot y orun). Para ello, copia el contenido de las memorias intermedias de boot y run en las de oboot y orun sustituyendo el contenido de éstas últimas. A continuación vacía las memorias de boot y run. Es preciso tener permiso de usuario de nivel A para utilizar este comando.

Cada vez que agregue un componente de hardware en el servidor, rearranque éste y ejecute el comando consolerestart de forma que el componente nuevo aparezca en los registros de consola originales.

Comandos de configuración de RSC

Utilice los comandos siguientes para definir o ver los valores de configuración de RSC o del servidor:

set variable valor

El comando set permite definir variables de configuración de RSC. Es necesario tener permiso de usuario de nivel A para poder utilizarlo. Consulte "Variables de configuración de RSC" si desea ver una explicación de estas variables.

Los cambios efectuados en algunas variables no tienen efecto hasta que el SSP correspondiente a RSC se restaura con los comandos resetrsc o rscadm resetrsc.

Es posible utilizar una cadena vacía ("") para definir una variable con valor nulo. Si desea definir una variable con una cadena que contiene espacios, escriba ésta entre comillas. Por ejemplo:


rsc> set page_info2 ""
rsc> set page_init1 "&F &E0"

show [variable]

El comando show se utiliza para ver el valor de las variables de configuración de RSC. Sólo puede especificarse una variable y, si no se especifica ninguna, RSC muestra el valor de todas ellas. Consulte "Variables de configuración de RSC" para obtener más información.

date [[mmdd]HHMM|mmddHHMM[ss]aa][.SS]

El comando date se utiliza sin argumentos para ver la fecha y la hora actuales de RSC. Si se dispone de permiso de usuario de nivel A, puede utilizarse también para definir la fecha y la hora actuales. La tabla siguiente contiene los componentes del formato de fecha.

Tabla 4-3 Componentes del comando date

Opción 

Descripción 

mm

Número del mes 

dd

Número del día del mes 

HH

Hora (sistema de 24 horas) 

MM

Minutos 

.SS

Segundos 

ss 

Los dos primeros dígitos del año (los correspondientes al siglo) 

aa

Los dos últimos dígitos del año 

Se puede omitir el mes, el día y el año, en cuyo caso se aplican los valores actuales de forma predeterminada.

Ejemplos:


rsc> date 091521451998
rsc> date 09152145
rsc> date 2145 

En el primer ejemplo se establecen, como fecha y hora, el 15 de septiembre de 1998, a las 9:45 p.m. En el segundo ejemplo, se establece el 15 de septiembre del año en curso, a las 9:45 p.m. En el último ejemplo se establece la hora 9:45 p.m. del día, mes y año en curso.


Nota -

Cada vez que arranca el servidor, establece la fecha y la hora actuales de RSC, aunque para mantener la hora de RSC sincronizada con la del servidor, Sun Microsystems recomienda la creación de una secuencia de comandos que utilice el comando rscadm date -s para actualizar la hora de RSC periódicamente con arreglo a la hora del servidor. El comando de shell de RSC date no sincroniza la hora de RSC con la del servidor.


password

El comando password permite cambiar la contraseña de acceso a la cuenta de RSC a la que se ha entrado. Se comporta de forma similar al comando passwd(1) de UNIX.

Al utilizarlo para cambiar una contraseña, RSC solicita la contraseña actual y, si se introduce correctamente, solicita la nueva contraseña. Después de introducirla, RSC vuelve a pedir la contraseña nueva como confirmación y la cambia si las dos veces se ha introducido de forma idéntica. Por ejemplo:


rsc> password
password: Changing password for nombreusuario
Enter login password: 
Enter new password: 
Re-enter new password: 
rsc>

El formato de las contraseñas tiene que respetar las siguientes limitaciones:

useradd nombreusuario

Se utiliza para agregar cuentas de usuario de RSC. Es necesario tener permiso de usuario de nivel U para hacer uso de este comando. El número máximo de cuentas de RSC permitido es cuatro y los caracteres admitidos para el nombreusuario son:

El campo de nombre de usuario admite un máximo de ocho caracteres, debe contener al menos un carácter alfabético en minúscula y el primer carácter debe ser alfabético. Si no se cumplen estas normas, el sistema envía un aviso y la ejecución del comando falla.

userdel nombreusuario

Permite eliminar cuentas de usuario de RSC. Es preciso tener permiso de usuario de nivel U para utilizar este comando.

usershow [nombreusuario]

Muestra las cuentas de usuarios de RSC. Es preciso tener permiso de usuario de nivel U para utilizar este comando. Si no se suministra ningún argumento, se muestran todas las cuentas. La información que aparece en pantalla incluye el nombre del usuario, los permisos que posee y si tiene una contraseña asignada. Por ejemplo:


rsc> usershow
Username Permissions Password?
setup    cuar        Assigned
msmith   c--r        None
rsc>

userpassword nombreusuario

Permite definir o cambiar la contraseña de las cuentas de usuario que se especifiquen. Es preciso tener permiso de usuario de nivel U para utilizar este comando. RSC no solicita la contraseña existente. Consulte la explicación del comando password para ver las normas relativas al formato de la contraseña. Ejemplo:


rsc> userpassword msmith
New password: 
Re-enter new password: 
rsc>

userperm nombreusuario [c][u][a][r]

Permite definir o cambiar los niveles de permiso para las cuentas de usuario especificadas.

Todos los usuarios de RSC pueden ver la información relativa a la aplicación. Con los argumentos siguientes se incrementa el nivel de autorización que éstos poseen:

Es preciso tener permiso de usuario de nivel U para utilizar este comando y se pueden especificar de cero a cuatro autorizaciones. El nivel de autorización predeterminado para una cuenta de RSC nueva es "ninguna" de las anteriores.

Si no se especifica ningún nivel de autorización, RSC establece como único permiso para nombreusuario el de lectura, aunque el permiso de usuario predeterminado para la cuenta que se crea durante el procedimiento de instalación es cuar (todas las autorizaciones).

Los usuarios que sólo poseen permiso de lectura pueden utilizar exclusivamente los comandos siguientes:

resetrsc

resetrsc restaura totalmente RSC, lo que pone fin a todas las sesiones en curso de la aplicación. Es preciso tener permiso de usuario de nivel A para utilizar este comando. También se puede restaurar RSC mediante el comando rscadm resetrsc.

Otros comandos de RSC

help

El comando help muestra una lista de todos los comandos del shell, junto con una breve descripción de cada uno de ellos.

version [-v]

El comando version muestra la versión del firmware que se ejecuta en RSC. Utilice la opción -v si desea obtener información más detallada. Ejemplos:


rsc> version
RSC Bootmon version: 0.23
RSC version: 0.23
rsc> version -v
RSC Bootmon version: 0.23
RSC Bootmon checksum: A91695A9
RSC version: 0.23
RSC firmware checksum: 4FF151DA
RSC firmware built Apr 28 1998, 12:31:15
rsc>

logout

El comando logout pone fin a la sesión de RSC y cierra la conexión con la aplicación.

Variables de configuración de RSC

RSC posee variables de configuración no volátiles que pueden modificarse para cambiar el comportamiento de RSC. Durante el proceso de instalación, se definen la mayoría de ellas de forma automática, pero estas definiciones pueden cambiarse posteriormente utilizando la interfaz gráfica de usuario, el shell de RSC o el comando rscadm set.

Es necesario tener permiso de usuario de nivel A para definir las variables de configuración desde la interfaz gráfica o desde el shell y es preciso entrar en el servidor como usuario root para poder usar el comando rscadm set.

El comando show permite ver la definición de las variables de configuración, mientras que el comando set permite definirlas. Los cambios en las variables tienen efecto inmediato, salvo en los casos indicados a continuación.

Es posible utilizar una cadena vacía ("") para definir una variable con valor nulo. Para definir variables con una cadena que incluye espacios, escriba ésta entre comillas.

Variables del puerto serie

serial_baud

Permite establece la velocidad en baudios del puerto serie de RSC. Los valores admitidos son:

El valor predeterminado es 9600 y los cambios que sufra tienen efecto en la siguiente conexión de entrada que se efectúe a través del puerto serie de RSC.

Si se cambia esta velocidad después de configurar el módem del puerto serie, es necesario volver a configurar el módem. Consulte "Reconfiguración del módem necesaria después de cambiar los valores del puerto serie de RSC".

serial_parity

Mediante esta variable se define la paridad del puerto serie de RSC. Los valores admitidos son none, odd o even, y el predeterminado es none. Los cambios de esta variable tienen efecto en la siguiente conexión de entrada que se realice a través del puerto serie de RSC.

Si se cambia el valor de paridad después de configurar el módem del puerto serie, es necesario volver a configurar el módem. Consulte "Reconfiguración del módem necesaria después de cambiar los valores del puerto serie de RSC".

serial_stop

Se utiliza para definir el número de bits de parada de RSC. Los valores admitidos son 1 o 2, y el predeterminado es 1. Los cambios en esta variable tienen efecto en la siguiente conexión de entrada que se realice a través del puerto serie de RSC.

Si se cambia el valor de bits de parada después de configurar el módem del puerto serie, es necesario volver a configurar el módem. Consulte "Reconfiguración del módem necesaria después de cambiar los valores del puerto serie de RSC".

serial_data

Permite definir el número de bits de datos de RSC. Los valores admitidos son 7 y 8, y el predeterminado es 8. Los cambios en esta variable tienen efecto en la siguiente conexión de entrada que se realice a través del puerto serie de RSC.

Si se cambia el valor de bits de datos después de configurar el módem del puerto serie, es necesario volver a configurar el módem. Consulte "Reconfiguración del módem necesaria después de cambiar los valores del puerto serie de RSC".

serial_hw_handshake

Esta variable controla si RSC utiliza intercambio de señalización inicial del hardware en el puerto serie. Los valores admitidos son true y false, y el predeterminado es true. Si se define con true, se habilitan el control de flujo del hardware y el control del módem. Con el valor false, RSC desconecta cualquier sesión establecida a través del puerto serie cuando han transcurrido 10 minutos sin actividad.

ppp_local_ip_addr

Esta variable se utiliza para especificar la dirección IP (Internet Protocol) que utilizará RSC durante la sesión PPP. Utilice la notación con puntos habitual. Si la variable está vacía, RSC espera que el nodo remoto defina la dirección IP de forma dinámica. El valor predeterminado es 0.0.0.0 (vacía) y los cambios que se efectúen en la variable tienen efecto en la siguiente conexión PPP a través del puerto serie.

ppp_remote_ip_addr

Esta variable se utiliza para especificar la dirección IP del nodo remoto durante una sesión PPP. Debe utilizarse la notación de puntos habitual para la dirección. Si la variable está vacía, RSC espera que el nodo remoto ya tenga una dirección IP asignada para la sesión PPP. El valor predeterminado es 0.0.0.0 (vacía) y los cambios que se efectúen en la variable tienen efecto en la siguiente conexión PPP a través del puerto serie.

ppp_enabled

Esta variable permite especificar si PPP es el protocolo predeterminado en el puerto serie de RSC. Los valores admitidos son true o false, y el predeterminado es false. Los cambios que se efectúen en la variable tienen efecto en la siguiente conexión PPP a través del puerto serie.

Variables de mensajes de alerta

page_enabled

Esta variable se utiliza para especificar si se ha habilitado un servicio de buscapersonas para enviar los mensajes de alerta de RSC. Los valores admitidos son true o false, y el predeterminado es false.

mail_enabled

Esta variable se utiliza para especificar si se ha habilitado un sistema de correo electrónico para enviar los mensajes de alerta de RSC. Los valores admitidos son true o false, y el predeterminado es false.

page_info1

Esta variable contiene el número de teléfono y el número de identificación del servicio buscapersonas para enviar mensajes de alerta TAP a un buscapersonas. Utilice el carácter @ para separar el número de teléfono del identificador. Los caracteres admitidos son:

Si las variables page_info1 y page_info2 están vacías, o la variable page_enabled tiene el valor false, no se producen envíos a buscapersonas. page_info1 está vacía como valor predeterminado. Ejemplo:


rsc> set page_info1 0914420500@1234332

page_init1

Esta variable contiene una cadena de comandos AT (attention) para configurar el módem de RSC antes de enviar mensajes de alerta al buscapersonas 1.

page_password1

Esta variable contiene la contraseña de acceso al servicio buscapersonas utilizado para enviar los mensajes de alerta al buscapersonas 1. La contraseña debe ser una cadena alfanumérica de seis caracteres como máximo.

page_baud1

Esta variable determina la velocidad de baudios que empleará el puerto serie al enviar mensajes de alerta al buscapersonas 1. Los valores admitidos son 300, 1200, 2400, 4800 y 9600. Una vez que RSC ha enviado el mensaje al buscapersonas, se restituye el valor definido en la variable serial_baud.

page_data1

Esta variable determina el número de bits de datos utilizado en el puerto serie de RSC para enviar mensajes de alerta al buscapersonas 1. Los valores admitidos son 7 y 8. Una vez que RSC ha enviado el mensaje, se restituye el valor de bits de datos especificado en la variable serial_data.

page_parity1

Esta variable determina el valor de paridad que utilizará el puerto serie de RSC para enviar mensajes de alerta al buscapersonas 1. Los valores admitidos son none, odd y even. Una vez que RSC ha enviado el mensaje, se restituye el valor de paridad especificado en la variable serial_parity.

page_stop1

Esta variable determina el número de bits de parada que utilizará el puerto serie de RSC para enviar mensajes de alerta al buscapersonas 1. Los valores admitidos son 1 y 2. Una vez que RSC ha enviado el mensaje, se restituye el valor de bits de parada especificado en la variable serial_stop.

page_info2

Esta variable contiene el número de teléfono y el número de identificación del servicio buscapersonas para enviar mensajes de alerta TAP a otro buscapersonas. Utilice el carácter @ para separar el número de teléfono del identificador. Los caracteres admitidos son:

Si las variables page_info1 y page_info2 están vacías, o la variable page_enabled tiene el valor false, no se producen envíos a buscapersonas. page_info2 está vacía como valor predeterminado. Ejemplo:


rsc> set page_info2 0914420596@4433444

page_init2

Esta variable contiene una cadena de comandos AT (attention) para configurar el módem de RSC antes de enviar mensajes de alerta al buscapersonas 2.

page_password2

Esta variable contiene la contraseña de acceso al servicio buscapersonas utilizado para enviar los mensajes de alerta al buscapersonas 2. La contraseña debe ser una cadena alfanumérica de seis caracteres como máximo.

page_baud2

Esta variable determina la velocidad en baudios que empleará el puerto serie al enviar mensajes de alerta al buscapersonas 2. Los valores admitidos son 300, 1200, 2400, 4800 y 9600. Una vez que RSC ha enviado el mensaje al buscapersonas, se restituye el valor definido en la variable serial_baud.

page_data2

Esta variable determina el número de bits de datos utilizado en el puerto serie de RSC para enviar mensajes de alerta al buscapersonas 2. Los valores admitidos son 7 y 8. Una vez que RSC ha enviado el mensaje, se restituye el valor de bits de datos especificado en la variable serial_data.

page_parity2

Esta variable determina el valor de paridad que utilizará el puerto serie de RSC para enviar mensajes de alerta al buscapersonas 2. Los valores admitidos son none, odd y even. Una vez que RSC ha enviado el mensaje, se restituye el valor de paridad especificado en la variable serial_parity.

page_stop2

Esta variable determina el número de bits de parada que utilizará el puerto serie de RSC para enviar mensajes de alerta al buscapersonas 2. Los valores admitidos son 1 y 2. Una vez que RSC ha enviado el mensaje, se restituye el valor de bits de parada especificado en la variable serial_stop.

customerinfo

Esta variable contiene información sobre el usuario y su contenido se utiliza habitualmente en el mensaje de alerta enviado a un buscapersonas o a una dirección de correo electrónico. Puede incluir, por ejemplo:

Esta cadena puede tener hasta ocho caracteres, que incluyen caracteres alfanuméricos y guión (-). El valor predeterminado es la variable vacía.

hostname

Esta variable contiene el nombre del servidor directamente conectado a RSC, el cual se incluye en los mensajes de alerta enviados por la aplicación. Esta cadena puede tener hasta ocho caracteres compuestos por letras, números o guiones (-). El valor predeterminado es la variable vacía.

mailuser

Esta variable contiene la dirección de correo electrónico a la que se enviarán los mensajes de alerta. La cadena tiene un límite de 40 caracteres y, como valor predeterminado, está vacía. Aunque sólo se admite una dirección de correo electrónico, pueden utilizarse alias de correo para notificar los problemas a varias personas a la vez.

mailhost

Esta variable contiene una lista direcciones IP (separadas por el signo de dos puntos) a las que RSC envía los mensajes de alerta SMTP. Se efectúan intentos de envío a cada dirección hasta que se envía correctamente el mensaje SMTP. Especifique las direcciones con la notación de puntos habitual. Por ejemplo:


rsc> set mailhost 139.143.4.2:139.142.4.15

Sólo pueden especificarse dos direcciones como máximo. Si la variable está vacía, o si la variable mail_enabled tiene el valor false, no se enviará ningún mensaje por correo. El valor predeterminado es la variable vacía.

Variables del puerto Ethernet

ip_mode

Esta variable se utiliza para controlar la forma en que RSC configura la dirección IP de su puerto Ethernet. Elija el valor de ip_mode de acuerdo con los servicios disponibles en la red a la que se ha conectado RSC. En la lista siguiente se describen todos los valores disponibles.

El valor predeterminado es dhcp. Los cambios en esta variable tienen efecto después de la siguiente restauración de RSC.

ip_addr

Esta variable sólo se utiliza si la variable ip_mode está definida con config. Especifique la dirección IP con la notación de puntos habitual. El valor predeterminado es 0.0.0.0 (vacía). Los cambios en esta variable sólo tienen efecto después de la siguiente restauración de RSC.

ip_netmask

Sólo se utiliza si la variable ip_mode está definida con config. Especifique la máscara de subred en la notación con puntos habitual de Internet. El valor predeterminado es 0.0.0.0 (vacía) y los cambios en esta variable sólo tienen efecto después de volver a restaurar RSC.

ip_gateway

Sólo se utiliza si la variable ip_mode está definida con config. Es el portal predeterminado al que RSC enviará sus paquetes IP cuando el destino no esté en su misma subred. Especifique la dirección IP con la notación de puntos habitual de Internet. El valor predeterminado es 0.0.0.0 (vacía) y los cambios en esta variable sólo tienen efecto después de volver a restaurar RSC.

Variable de la sesión de consola

escape_char

Con esta variable se determina el carácter de la secuencia de escape con la que terminará una sesión de consola para volver al shell de RSC. La secuencia de escape se aplica a todos los usuarios de RSC dentro del mismo servidor y consta del carácter de escape seguido de un punto. El carácter de escape predeterminado es ~ (tilde).

La secuencia de escape debe constar de un solo carácter alfanumérico o bien de un carácter de control. Para introducir un carácter de control como escape, escriba "^" (Shift-6) para representar la tecla Control, seguido de otro carácter. Si éste último es una interrogación (?), se selecciona la tecla Delete, de lo contrario el segundo carácter se convierte en un carácter de control y se utiliza en la secuencia de escape. Por ejemplo, si se introduce ^y para definir el carácter de escape, los usuarios utilizarán Control-y para finalizar la sesión de consola.

Mensajes de error del shell de RSC

Esta sección contiene información complementaria sobre los mensajes de error recibidos en el indicador rsc>.

Errores de uso

Esta sección contiene una lista de mensajes de error que aparecen si se utiliza incorrectamente la sintaxis de los comandos. Consulte la descripción del comando en este capítulo para ver la sintaxis adecuada.


Invalid command. Type 'help' for list of commands.


Usage: bootmode [-u] [normal|forth|reset_nvram|diag|skip_diag]


Usage: break


Usage: consolehistory [boot|run|oboot|orun] [index [+|-]<n>]


Usage: consolerestart


Usage: date [[mmdd]HHMM | mmddHHMM[cc]yy][.SS]


Usage: loghistory [index [+|-]<n>]


Usage: password


Usage: poweroff


Usage: poweron


Usage: reset


Usage: resetrsc


Usage: set <variable> <value>


Usage: shownetwork


Usage: useradd <username>


Usage: userdel <username>


Usage: userpassword <username>


Usage: userperm <username> [c][u][a][r]


Usage: version [-v]


Usage: xir

Errores generales

RSC informa de los siguientes errores de tipo general.


Could not get username for user <nombreusuario>

Se ha producido un error de SEEPROM al ejecutar el comando userpassword


Error adding user <nombreusuario>

Se ha producido un error al ejecutar el comando useradd. Este mensaje irá seguido de otro más detallado.


Error changing password for <nombreusuario>

Se ha producido un error de SEEPROM al ejecutar el comando userpassword.


Error changing password for <nombreusuario>

Se ha producido un error al ejecutar el comando userpassword. Este mensaje irá seguido de otro más detallado.


Error changing password for <nombreusuario>

During execution of the userpassword command, a SEEPROM error occurred.


Error changing password for <nombreusuario> - password must be at least three characters different from old password - password must not be based on username

La contraseña que ha introducido no es válida.


Error deleting user <nombreusuario>

Se ha producido un error al ejecutar el comando userdel. Este mensaje irá seguido de otro más detallado.


Error displaying user <nombreusuario>

Se ha producido un error al ejecutar el comando usershow. Este mensaje irá seguido de otro más detallado.


Error setting permission for <nombreusuario>

Se ha producido un error al ejecutar el comando userperm. Este mensaje irá seguido de otro más detallado.


ERROR: username did not start with letter or did not contain lowercase letter.

El nombre de usuario que ha introducido no es válido.


Failed to allocate buffer for console mode.

RSC no ha podido asignar suficiente memoria para conectarse a la consola durante la ejecución del comando console


Failed to allocate memory!

RSC no ha podido asignar suficiente memoria para mostrar el valor de la variable durante la ejecución del comando show.


Failed to get password for <nombreusuario>

Se ha producido un error de SEEPROM al ejecutar el comando userpassword.


Failed to set <variable> to <value>

RSC ha encontrado un error de SEEPROM durante la ejecución del comando set.


Invalid login

Ha fallado el intento de entrada. Este mensaje aparece en el indicador de entrada.


Invalid password

Ha introducido una contraseña incorrecta con el comando userpassword.


Invalid permission: <permiso>

Ha introducido un permiso de usuario que no es válido. Los permisos admitidos son [c] [u] [a] [r]. Consulte "userperm nombreusuario [c][u][a][r] ".


Malformed username

Ha especificado un usuario que no existe con el comando userpassword, userperm o userdel.


No free user slots

Este error se produce si se intenta agregar una nueva cuenta de RSC cuando ya existen cuatro cuentas configuradas. RSC admite sólo cuatro cuentas, por lo que es preciso eliminar una antes de agregar otra.


Passwords don't match

Las dos entradas de la nueva contraseña no coinciden.


Permission denied

Ha tratado de ejecutar un comando del shell para el que no tiene el nivel de permiso de usuario adecuado.


Sorry, wrong password

La contraseña introducida no coincide con la contraseña existente.


Unable to get value of variable <variable>

Ha utilizado un nombre de variable incorrecto al ejecutar el comando show.


User already registered

El usuario que intenta agregar ya tiene una cuenta de RSC en ese servidor.


User does not exist

El nombre de usuario especificado no tiene asociada ninguna cuenta de RSC en ese servidor.