Propiedades

Propiedades de la CLI

Las propiedades son pares de nombre/valor asociados con un contexto. Para determinar las propiedades de un contexto dado, se puede ejecutar el comando "help properties". A continuación, se presenta un ejemplo de recuperación de las propiedades asociadas con las preferencias de un usuario:

dory:configuration preferences> help properties
Properties that are valid in this context:

  locale               => Locality

  login_screen         => Initial login screen

  session_timeout      => Session timeout

  session_annotation   => Current session annotation

  advanced_analytics   => Make available advanced analytics statistics

Obtención de propiedades

Las propiedades de un contexto dado se pueden recuperar con el comando get. A continuación, se presenta un ejemplo del uso del comando get para recuperar las preferencias de un usuario:

 dory:configuration preferences> get 
                       locale = C
                 login_screen = status/dashboard
              session_timeout = 15
           session_annotation = 
           advanced_analytics = false

Obtención del valor de una única propiedad

El comando get devuelve todas las propiedades que se incluyan como argumentos. Por ejemplo, para obtener el valor de la propiedad login_screen:

dory:configuration preferences> get login_screen
                 login_screen = status/dashboard

Finalización con tabulación

El comando get finalizará con tabulación con los nombres de las propiedades disponibles. Por ejemplo, para ver una lista de las propiedades disponibles para el servicio iSCSI:

dory:> configuration services iscsi get tab 
<status>            isns_server         radius_secret       target_chap_name
isns_access         radius_access       radius_server       target_chap_secret

Establecimiento de propiedades

El comando set configurará una propiedad con un valor especificado; el nombre de la propiedad y su valor se separan con el signo igual. Por ejemplo, para configurar la propiedad login_screen como "shares":

dory:configuration preferences> set login_screen=shares
                 login_screen = shares (uncommitted)

Tenga en cuenta que en el caso de las propiedades que constituyen el estado del dispositivo, la configuración de las propiedades no cambia el valor, sino que registra el valor definido e indica que el valor de la propiedad no está confirmado.

Confirmación de un valor definido para una propiedad

Para forzar que los valores definidos para una propiedad surtan efecto, se los debe confirmar explícitamente, lo que permite que se modifiquen varios valores como un único cambio coherente. Para confirmar los valores de propiedades que no estén confirmados, use el comando commit:

dory:configuration preferences> get login_screen 
                 login_screen = shares (uncommitted)
dory:configuration preferences> commit
dory:configuration preferences> get login_screen
                 login_screen = shares

Si intenta salir de un contexto que contiene propiedades no confirmadas, se le advertirá que al hacerlo se abandonarán los valores definidos para las propiedades y se le solicitará que confirme que desea salir. Por ejemplo:

dory:configuration preferences> set login_screen=maintenance/hardware
                 login_screen = maintenance/hardware (uncommitted)
dory:configuration preferences> done
You have uncommitted changes that will be discarded. Are you sure? (Y/N) 

Configuración de un valor de propiedad con confirmación implícita

Si se configura una propiedad de un contexto desde otro contexto, es decir, si se agregó el comando set a un comando que cambia de contexto, la confirmación es implícita y se realiza antes de que se regrese el control al contexto de origen. Por ejemplo:

dory:> configuration preferences set login_screen=analytics/worksheets
                 login_screen = analytics/worksheets
dory:>

Configuración de una propiedad con una lista de valores

Algunas propiedades tienen listas de valores. Para estas propiedades, los elementos de la lista se deben separar con comas. Por ejemplo, la propiedad servers de NTP se puede configurar con una lista de servidores NTP:

dory:configuration services ntp> set servers=0.pool.ntp.org,1.pool.ntp.org
                      servers = 0.pool.ntp.org,1.pool.ntp.org (uncommitted)
dory:configuration services ntp> commit

Configuración de una propiedad con un valor que contiene caracteres especiales

Si el valor de una propiedad contiene una coma, un signo igual, comillas o un espacio, todo el valor se debe indicar entre comillas. Por ejemplo, para configurar la propiedad sharenfs del proyecto predeterminado para que sea de solo lectura pero permita acceso de lectura y escritura al host "kiowa". Para obtener información, consulte el Chapter 12, Recursos compartidos, proyectos y esquemas.

dory:> shares select default
dory:shares default> set sharenfs="ro,rw=kiowa"
                     sharenfs = ro,rw=kiowa (uncommitted)
dory:shares default> commit

Propiedades invariables

Algunas propiedades son inmutables; es posible obtener sus valores, pero no se los puede definir. Si se intenta configurar una propiedad inmutable, se genera un error. Por ejemplo, si se intenta configurar la propiedad inmutable space_available del proyecto predeterminado. Para obtener información, consulte el Chapter 12, Recursos compartidos, proyectos y esquemas.

dory:> shares select default
dory:shares default> get space_available 
              space_available = 1.15T
dory:shares default> set space_available=100P
error: cannot set immutable property "space_available"

Hay propiedades que son inmutables solamente en ciertas condiciones. Para estas propiedades, el comando set no es válido. Por ejemplo, si el usuario llamado bmc es un usuario de red, la propiedad fullname será inmutable:

dory:> configuration users select bmc set fullname="Rembrandt Q. Einstein"
error: cannot set immutable property "fullname"