Parámetros de la línea de comandos

Nuevos parámetros de línea de comandos en la versión 11.40

El sistema operativo SANtricity versión 11.40 introduce, en las controladoras E2800 y E5700 con servicios web integrados, la capacidad para interactuar en la línea de comandos con un protocolo HTTPS seguro. De forma opcional, estas controladoras pueden utilizar el protocolo SYMbol para interacciones en la línea de comandos. El protocolo SYMbol es el único admitido por las controladoras E2700 y E5600. A fin de conservar los scripts existentes y minimizar el tiempo de transición, la gramática y las opciones de la CLI se conservan en la mayor medida posible. No obstante, existen algunas diferencias en las funcionalidades de las controladoras E2800 y E5700 con respecto a la seguridad, la autenticación, AutoSupport y la mensajería de alertas por las cuales cierta gramática de la CLI se torna obsoleta para dichas controladoras. Sin embargo, en algunos casos, la gramática solo es obsoleta en E2800 o E5700 cuando se utiliza el protocolo https nuevo.

Existen parámetros nuevos que solo se aplican al tipo de cliente https y, por lo tanto, solo se aplican a las controladoras E2800 o E5700.

Para acceder a una lista de comandos nuevos y obsoletos de esta versión, consulte Cambios en los comandos de script y de la CLI en esta versión.

Parámetro Definición
-clientType

Este argumento fuerza la creación de un motor de scripts adecuado. Este parámetro opcional se utiliza con uno de los valores siguientes:

  • auto: la detección de dispositivos se realiza automáticamente a fin de detectar el tipo de motor de scripts adecuado.
  • https: se crea un motor de scripts basado en REST.
  • symbol: se crea un motor de scripts basado en SYMbol.
-u

Después de este parámetro se debe incluir la variable username. El nombre de usuario solo se requiere para el tipo de cliente https. Este argumento no se aplica al tipo de cliente symbol y se omite de forma silenciosa.

Si se especifica el argumento de nombre de usuario, se lleva a cabo la detección de dispositivos para determinar el tipo de cliente correcto (https o symbol).

-P

Este argumento requiere uno de estos dos argumentos:

  • password_file: contiene la contraseña que se debe utilizar para la autenticación.
  • - (un guion): se lee la contraseña desde stdin.

Es preciso tener en cuenta que la adición de este argumento se aplica a todas las controladoras, independientemente de si se utilizan los tipos de cliente https o symbol.

-k Este argumento opcional permite a un cliente https operar en modo no seguro. Esto significa que el certificado de la cabina de almacenamiento no se valida. De forma predeterminada, si se omite, se realiza la autenticación adecuada. Este argumento no se aplica al tipo de cliente symbol y se omite de forma silenciosa.

Parámetros de línea de comandos que solo se aplican a las controladoras E2700 o E5600

Dado que las controladoras E2700 y E5600 no cuentan con funcionalidades de gestión de alerta integradas, estos parámetros de línea de comandos son aplicables. No lo son en las controladoras E2800 o E5700.

Parámetro Definición
-a Añade un destino de captura de protocolo simple de gestión de redes (SNMP) o un destino de alertas de correo electrónico.
  • Cuando se añade un destino de captura SNMP, la comunidad SNMP se define automáticamente como el nombre de la comunidad de la captura, y host es la dirección IP o el nombre de host de servidor de nombres de dominio (DNS) del sistema a los cuales se debe enviar la captura.
  • Cuando se añade una dirección de correo electrónico como destino de alertas, email-address es la dirección de correo electrónico a la cual se desea enviar el mensaje de alerta.
Restricción: Esta opción de línea de comandos es obsoleta para las cabinas de almacenamiento E2800 y E5700. Use la API de RESTful, SANtricity System Manager o comandos cURL.
-m Especifica el nombre de host o la dirección IP del servidor de correo electrónico desde el cual se envían las notificaciones de alertas por correo electrónico.
Restricción: Esta opción de línea de comandos es obsoleta para las cabinas de almacenamiento E2800 y E5700. Use la API de RESTful, SANtricity System Manager o comandos cURL.
-s (minúscula) Muestra la configuración de alerta en el archivo de configuración cuando se utiliza con el parámetro -d.
Restricción: Esta opción de línea de comandos es obsoleta para las cabinas de almacenamiento E2800 y E5700. Use la API de RESTful, SANtricity System Manager o comandos cURL.
-x (minúscula) Quita un destino de captura SNMP o un destino de alertas por correo electrónico. community es el nombre de comunidad SNMP de la captura, y host es la dirección IP o el nombre de host DNS del sistema a los que se desea enviar la captura.
Restricción: Esta opción de línea de comandos es obsoleta para las cabinas de almacenamiento E2800 y E5700. Use la API de RESTful, SANtricity System Manager o comandos cURL.

Parámetros de línea de comandos que se aplican a todas las controladoras que se ejecutan con el tipo de cliente symbol

Parámetro Definición
-R (mayúscula) Define el rol de usuario para la contraseña. Los roles pueden ser los siguientes:
  • admin: el usuario posee privilegios para cambiar la configuración de la cabina de almacenamiento.
  • monitor: el usuario posee privilegios para visualizar la configuración de la cabina de almacenamiento, pero no puede realizar cambios.

El parámetro -R solo es válido cuando se utiliza junto con –p, que especifica la definición de una contraseña para la cabina de almacenamiento.

-R solo es obligatorio si la función de doble contraseña está habilitada en la cabina de almacenamiento. El parámetro -R no es necesario en las siguientes condiciones:

  • No está habilitada la función de doble contraseña en la cabina de almacenamiento.
  • Solo hay configurado un rol de administrador, y el rol de supervisor no está configurado en la cabina de almacenamiento.

Parámetros de línea de comandos aplicables a todas las controladoras y todos los tipos de cliente

Parámetro Definición
host-name-or-IP-address Especifica el nombre de host o la dirección del protocolo de Internet (IP) (xxx.xxx.xxx.xxx) de una cabina de almacenamiento gestionada en banda o fuera de banda.
  • Si se va a gestionar una cabina de almacenamiento con un host a través de administración del almacenamiento en banda, se debe utilizar el parámetro -n o el parámetro -w si hay más de una cabina de almacenamiento conectada al host.
  • Si se va a gestionar una cabina de almacenamiento con administración del almacenamiento fuera de banda a través de la conexión Ethernet de cada controladora, se debe especificar el valor host-name-or-IP-address de las controladoras.
  • Si previamente se configuró una cabina de almacenamiento en Enterprise Management Window, es posible especificar la cabina de almacenamiento por el nombre proporcionado por el usuario mediante el parámetro -n.
  • Si previamente se configuró una cabina de almacenamiento en Enterprise Management Window, es posible especificar la cabina de almacenamiento por su identificador a nivel mundial (WWID) mediante el parámetro -w.
-A Añade una cabina de almacenamiento al archivo de configuración. Si después del parámetro -A no se incluye host-name-or-IP-address, la detección automática analiza la subred local en busca de cabinas de almacenamiento.
-c Indica que se introducirán uno o más comandos de script para ejecutarlos en la cabina de almacenamiento especificada. Cada comando debe finalizar con punto y coma (;). No es posible colocar más de un parámetro -c en la misma línea de comandos. Es posible incluir más de un comando de script después del parámetro -c.
-d Muestra el contenido del archivo de configuración de script. El contenido del archivo tiene el siguiente formato: storage-system-name host-name1 host-name2
-e Ejecuta los comandos sin realizar primero una comprobación de la sintaxis.
-F (mayúscula) Especifica la dirección de correo electrónico desde la cual se enviarán las alertas.
-f (minúscula) Especifica el nombre de un archivo que contiene comandos de script que se desean ejecutar en la cabina de almacenamiento especificada. El parámetro -f es similar al -c en cuanto a que ambos están dirigidos a comandos de script en ejecución. -c ejecuta comandos de script individuales. -f ejecuta un archivo de comandos de script.

De manera predeterminada, se ignoran todos los errores que surgen durante la ejecución de los comandos de script en un archivo, y el archivo se sigue ejecutando. Para anular este comportamiento, se debe utilizar el comando set session errorAction=stop en el archivo de script.

-g Especifica un archivo ASCII que contiene la información de contacto del remitente del correo electrónico que se incluirá en las notificaciones de alertas por correo electrónico. La CLI asume que el archivo ASCII es de solo texto, sin delimitadores ni ningún tipo de formato. No se debe utilizar el parámetro -g si existe un archivo userdata.txt.
-h Especifica el nombre de host que ejecuta el agente SNMP al cual está conectada la cabina de almacenamiento. El parámetro -h se utiliza con los parámetros siguientes:
  • -a
  • -x
-I (mayúscula) Especifica el tipo de información que se incluirá en las notificaciones de alertas por correo electrónico. Se pueden seleccionar estos valores:
  • eventOnly: solo se incluye en el correo electrónico la información de evento.
  • profile: se incluye en el correo electrónico la información del perfil de la cabina y del evento.

Es posible especificar la frecuencia de las entregas de correo electrónico con el parámetro -q.

-i (minúscula) Muestra la dirección IP de las cabinas de almacenamiento conocidas. Se utiliza el parámetro -i con el parámetro -d. El contenido del archivo tiene el siguiente formato:

storage-system-name IP-address1 IPaddress2

-n Especifica el nombre de la cabina de almacenamiento en la que se desean ejecutar los comandos de script. Este nombre es opcional cuando se utiliza host-name-or-IP-address. Si se va a utilizar un método en banda para la gestión de la cabina de almacenamiento, se debe utilizar el parámetro -n en caso de que más de una cabina de almacenamiento esté conectada al host en la dirección especificada. El nombre de la cabina de almacenamiento se requiere cuando no se utiliza host-name-or-IP-address. El nombre de la cabina de almacenamiento configurado para utilizar en Enterprise Management Window (es decir, el nombre que está en el archivo de configuración) no debe ser un nombre duplicado de ninguna otra cabina de almacenamiento configurada.
-o Especifica un nombre de archivo para todo el texto de salida que se genera como resultado de la ejecución de los comandos de script. Se utiliza el parámetro -o con los parámetros siguientes:
  • -c
  • -f

Si no se especifica un archivo de resultados, el texto de salida va a los resultados estándar (stdout). Todos los resultados de los comandos que no sean comandos de script se envían a stdout, independientemente de si este parámetro está establecido.

-p Define la contraseña de la cabina de almacenamiento en la cual se desean ejecutar comandos. No es necesaria una contraseña en las siguientes condiciones:
  • No se configuró una contraseña en la cabina de almacenamiento.
  • La contraseña está especificada en un archivo de script en ejecución.
  • La contraseña se especifica con el parámetro -c y el siguiente comando:
set session password=password
-P

Este argumento requiere uno de estos dos argumentos:

  • password_file: contiene la contraseña que se debe utilizar para la autenticación.
  • - (guion): lee la contraseña de stdin.

Es preciso tener en cuenta que la adición de este argumento se aplica a todas las controladoras, independientemente de si se utilizan los tipos de cliente https o symbol.

-q Especifica la frecuencia con la que se desean recibir notificaciones de eventos y el tipo de información que contienen estas notificaciones. Siempre se genera para cada evento de nivel crucial elevado una notificación de alertas por correo electrónico que contiene al menos la información básica del evento.

Los siguientes son valores válidos para el parámetro -q:

  • everyEvent: se devuelve información con cada notificación de alertas por correo electrónico.
  • 2: se devuelve información una vez cada dos horas, como máximo.
  • 4: se devuelve información una vez cada cuatro horas, como máximo.
  • 8: se devuelve información una vez cada ocho horas, como máximo.
  • 12: se devuelve información una vez cada 12 horas, como máximo.
  • 24: se devuelve información una vez cada 24 horas, como máximo.

Con el parámetro -I se puede especificar el tipo de información en las notificaciones de alertas por correo electrónico.

  • Si el parámetro -I se establece en eventOnly, el único valor válido para el parámetro -q es everyEvent.
  • Si el parámetro -I se establece en los valores profile o supportBundle, esta información se incluye en los correos electrónicos según la frecuencia especificada por el parámetro -q.
-quick Disminuye la cantidad de tiempo necesaria para ejecutar una operación de línea única. Un ejemplo de operación de línea única es el comando recreate snapshot volume. Este parámetro reduce la cantidad de tiempo, ya que no ejecuta procesos en segundo plano durante la ejecución del comando.

No se debe utilizar este parámetro para operaciones que involucran varias operaciones de línea única. El uso excesivo de este comando puede sobrecargar la controladora con más comandos de los que puede procesar, lo que provoca un fallo operativo. Además, las actualizaciones de estado y de configuración que generalmente se recogen de procesos en segundo plano, no están disponibles para la CLI. Este parámetro provoca el fallo de las operaciones que dependen de la información de referencia.

-S (mayúscula) Suprime los mensajes informativos sobre el progreso de los comandos que aparecen cuando se ejecutan comandos de script. (La supresión de los mensajes informativos también se denomina modo silencioso). Este parámetro suprime los mensajes que indican lo siguiente:
  • Performing syntax check
  • Syntax check complete
  • Executing script
  • Script execution complete
  • SMcli completed successfully
-v Muestra el estado general actual de los dispositivos conocidos en un archivo de configuración cuando se utiliza con el parámetro -d.
-w Especifica el WWID de la cabina de almacenamiento. Este parámetro es una alternativa al parámetro -n. Utilice el parámetro -w con -d para mostrar los WWID de las cabinas de almacenamiento conocidas. El contenido del archivo tiene el siguiente formato:

storage-system-name world-wide-ID IP-address1 IP-address2

-X (mayúscula) Elimina una cabina de almacenamiento de una configuración.
-? Muestra la información de uso de los comandos de la CLI.