Propriétés

Propriétés de la CLI

Les propriétés sont des couples nom/valeur saisis au clavier et associés à un contexte. Les propriétés associées à un contexte donné peuvent être affichées à l'aide de la commande "help properties". L'exemple suivant indique comment extraire les propriétés associées aux préférences d'un utilisateur :

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

Obtention de propriétés

La commande get permet de récupérer les propriétés d'un contexte donné. L'exemple suivant illustre l'utilisation de la commande get pour récupérer les préférences d'un utilisateur :

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

Obtention d'une valeur de propriété unique

La commande get renvoie toute propriété saisie en tant qu'argument. Par exemple, pour obtenir la valeur de la propriété login_screen :

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

Saisie semi-automatique par tabulation

Appuyer sur la touche de tabulation après avoir saisi la commande get permet d'afficher les noms des propriétés disponibles. Par exemple, pour afficher une liste des propriétés disponibles pour le service iSCSI :

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

Définition des propriétés

La commande set permet de définir une propriété sur une valeur spécifique, le nom de la propriété et sa valeur étant séparés par le caractère égal. Par exemple, pour définir la propriété login_screen sur "shares" :

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

Notez que dans le cas de propriétés constituant un état de l'appareil, définir la propriété n'a pas pour effet de changer la valeur, mais la valeur définie est enregistrée avec l'indication que la valeur de la propriété est non validée.

Validation d'une valeur de propriété définie

Pour forcer l'application des valeurs de propriétés définies, elles doivent être explicitement validées, ce qui permet la modification de plusieurs valeurs en une modification unique et cohérente. Exécutez la commande commit pour valider toute valeur de propriété non validée :

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

Si vous tentez de quitter un contexte contenant des propriétés non validées, le système vous avertit que la sortie du contexte vous fera perdre les valeurs de propriétés définies, et vous serez invité à confirmer que vous souhaitez quitter le contexte. Par exemple :

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) 

Définition d'une valeur de propriété validée de manière implicite

Si une propriété associée à un contexte est définie à partir d'un autre contexte, c'est-à-dire si la commande set suit une commande ayant pour effet de changer le contexte, la validation est implicite et intervient avant que le contrôle ne revienne au contexte d'origine. Par exemple :

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

Définition d'une propriété sur une liste de valeurs

Certaines propriétés acceptent les listes de valeurs. Pour ces propriétés, les éléments de la liste doivent être séparés par des virgules. Par exemple, la propriété servers du service NTP peut être définie sur une liste de serveurs 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

Définition d'une propriété sur une valeur contenant des caractères spéciaux

Si une valeur de propriété contient une virgule, le signe égal, une apostrophe ou un espace, l'ensemble de la valeur doit être placé entre guillemets. Par exemple, pour définir la propriété des partages sharenfs en lecture seule pour le projet par défaut, mais accorder un accès en lecture/écriture à l'hôte "kiowa". Pour plus d'informations, reportez-vous au Chapter 12, Partages, projets et schéma.

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

Propriétés immuables

Certaines propriétés sont inaltérables. Vous pouvez obtenir leurs valeurs mais pas les définir. Toute tentative de définir une propriété inaltérable se solde par une erreur. L'exemple suivant illustre une tentative de définition de la propriété inaltérable space_available du projet par défaut. Pour plus d'informations, reportez-vous au Chapter 12, Partages, projets et schéma.

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"

D'autres propriétés ne sont inaltérables que dans certaines conditions. Pour ces propriétés, la commande set n'est pas valide. Par exemple, si l'utilisateur nommé bmc est un utilisateur réseau, la propriété fullname sera inaltérable :

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