Contextos de la CLI

Uno de los principios centrales de la CLI es el contexto en el que se ejecutan los comandos. El contexto dicta cuáles son los elementos del sistema que se pueden gestionar y cuáles son los comandos que están disponibles. Los contextos tienen una estructura de árbol en la que los contextos en sí pueden contener otros contextos anidados y la estructura por lo general refleja la de las vistas de la BUI.

Contexto raíz

El contexto inicial al iniciar sesión es el contexto raíz, que actúa como contexto principal o ascendiente de todos los contextos. Para navegar a un contexto, ejecute el nombre del contexto como comando. Por ejemplo, las funciones disponibles en la vista de Chapter 4, Configuración de red del explorador están disponibles en el contexto configuration de la CLI. Para tener acceso, desde el contexto raíz, escriba directamente lo siguiente:

dory:> configuration
dory:configuration> 

Tenga en cuenta que el indicador cambia para reflejar el contexto, y el contexto se proporciona entre los dos puntos y el signo mayor que del indicador.

Contextos secundarios

El comando show muestra los contextos secundarios. Por ejemplo, desde el contexto configuration:

dory:configuration> show
Children:
                             net => Configure networking
                        services => Configure services
                         version => Display system version
                           users => Configure administrative users
                           roles => Configure administrative roles
                     preferences => Configure user preferences
                          alerts => Configure alerts
                         storage => Configure Storage

Estos contextos secundarios corresponden a las vistas disponibles en la vista de Chapter 6, Configuración de red de área de almacenamiento del explorador, que incluye Chapter 4, Configuración de red, Chapter 11, Servicios del dispositivo ZFSSA y Chapter 7, Configuración de usuario, PreferencesChapter 8, Configuración de preferencias de dispositivos ZFSSA, etc. Para seleccionar uno de estos contextos secundarios, escriba el nombre correspondiente:

dory:configuration> preferences 
dory:configuration preferences> 

Puede navegar a un contexto descendiente directamente desde uno ascendiente; para ello, especifique los contextos intermedios separados por espacios. Por ejemplo, para navegar directamente a configuration preferences desde el contexto raíz, simplemente escríbalo:

dory:> configuration preferences
dory:configuration preferences>

Contextos secundarios dinámicos

Algunos contextos secundarios son dinámicos porque corresponden no a vistas fijas del explorador, sino a entidades dinámicas que fueron creadas por el usuario o el sistema. Para navegar a estos contextos, use el comando select, seguido del nombre del contexto dinámico. Los nombres de los contextos dinámicos incluidos en un contexto dado se muestran con el comando list. Por ejemplo, el contexto users es estático, pero cada usuario es su propio contexto dinámico.

dory:> configuration users
dory:configuration users> list 
NAME                     USERNAME                 UID        TYPE
John Doe                 bmc                      12345      Dir
Super-User               root                     0          Loc

Para seleccionar el usuario llamado bmc, ejecute el comando select bmc:

dory:configuration users> select bmc 
dory:configuration users bmc> 

De manera alternativa, en algunos contextos, los comandos select y destroy se pueden utilizar para seleccionar una entidad en función de sus propiedades. Por ejemplo, se puede ejecutar el siguiente comando para seleccionar las entradas de log emitidas por el módulo reboot del contexto maintenance logs system:

dory:maintenance logs system> select module=reboot 
dory:maintenance logs system entry-034> show
Properties:                                   
  timestamp = 2010-8-14 06:24:41
     module = reboot
   priority = crit
       text = initiated by root on /dev/console syslogd: going down on signal 15

Como con otros comandos, select se puede agregar a un comando de modificación de contexto. Por ejemplo, para seleccionar el usuario llamado bmc desde el contexto raíz:

dory:> configuration users select bmc 
dory:configuration users bmc>

Último contexto

Use el comando last para navegar hasta un contexto creado o seleccionado con anterioridad. Este comando actualmente está implementado sólo en el contexto de acciones de replicación.

En el siguiente ejemplo se crea una acción de replicación y, a continuación, se usan los comandos last y get id para recuperar el identificador de la acción de replicación. Luego se selecciona una acción diferente y se usan los comandos last y get id para recuperar el identificador de la acción de replicación más recientemente visitada.

dory:shares p1/share replication> list
           TARGET          STATUS     NEXT
action-000  oakmeal         idle       Sync now
action-001  dory            idle       Sync now
dory:shares p1/share replication> create
dory:shares p1/share action (uncommitted)> set target=dory
                       target = dory (uncommitted)
dory:shares p1/share action (uncommitted)> set pool=p0
                         pool = p0 (uncommitted)
dory:shares p1/share action (uncommitted)> commit
dory:shares p1/share replication> last
dory:shares p1/share action-002> get id
                           id = 7034367a-d4d8-e26f-fa93-c3b454e3b595
dory:shares p1/share action-002> done
dory:shares p1/share replication> select action-000
dory:shares p1/share action-000> get id
                           id = 9895d9f4-7b23-ebe1-faf2-d85a581e3dff
dory:shares p1/share action-000> done
dory:shares p1/share replication> last get id
                           id = 9895d9f4-7b23-ebe1-faf2-d85a581e3dff
dory:shares p1/share replication>