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
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
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
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
La commande select, ou une commande placée entre guillemets, permet de sélectionner un nœud dynamique par propriété. Par exemple, pour sélectionner la commande key-000 par utilisateur :
hostname:configuration services sftp keys> show Keys: NAME MODIFIED CIPHER USER COMMENT key-000 2015-6-5 19:48:23 RSA u1 1 hostname:configuration services sftp keys> "user=u1" hostname:configuration services sftp key-000>
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.
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)
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:>
Certaines propriétés acceptent une liste 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 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
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, la propriété des partages sharenfs pour le projet par défaut peut être définie en lecture seule, mais peut accorder un accès en lecture/écriture à l'hôte kiowa. Pour plus d'informations, reportez-vous à la section Partages et projets.
dory:> shares select default dory:shares default> set sharenfs="ro,rw=kiowa" sharenfs = ro,rw=kiowa (uncommitted) dory:shares default> commit
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 à la section Partages et projets.
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"
Rubriques connexes