Go to main content

Guía de administración de Oracle® ZFS Storage Appliance, versión OS8.8.x

Salir de la Vista de impresión

Actualización: Agosto de 2021
 
 

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:

hostname: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

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:

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

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

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

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:

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

El comando select, o un comando escrito entre comillas dobles, se usa para seleccionar un nodo dinámico por propiedad. Por ejemplo, para seleccionar key-000 por usuario:

hostname:configuration services sftp keys> show
Keys:

NAME    MODIFIED            CIPHER   USER    COMMENT
key-000 2019-6-5 19:48:23   RSA      u1      1

hostname:configuration services sftp keys> "user=u1"
hostname:configuration services sftp key-000>

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":

hostname: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.

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:

hostname:configuration preferences> get login_screen
                 login_screen = shares (uncommitted)
hostname:configuration preferences> commit
hostname: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:

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

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 el control regrese al contexto de origen. Por ejemplo:

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

Algunas propiedades tienen una lista 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:

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

Si el valor de una propiedad contiene una coma, un signo igual, comillas o un espacio, todo el valor se debe escribir entre comillas dobles. Por ejemplo, la propiedad de recurso compartido sharenfs del proyecto por defecto se puede configurar para que sea de solo lectura, pero permita acceso de lectura y escritura al host kiowa. Para obtener más información, consulte Recursos compartidos y proyectos.

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

Algunas propiedades son inmutables; es posible obtener sus valores, pero no se las 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 más información, consulte Recursos compartidos y proyectos.

hostname:> shares select default
hostname:shares default> get space_available 
              space_available = 1.15T
hostname: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:

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

Temas relacionados