Installation et mise en œuvre du module Amon

L'ensemble des familles et, ainsi, des variables sont définies dans un nœud <variables></variables>.

Un conteneur famille permet d'avoir des catégories de variables. Celle-ci correspond à un onglet dans l'interface. Les familles sont incluses obligatoirement dans une balise <variables>.

Les attributs de la balise family sont les suivants :

• l'attribut name (obligatoire) est à la fois le nom et l'identifiant de la famille ;

• l'attribut mode permet de définir le mode d'affichage de la famille :

  • mode basic par défaut ;
  • mode normal ;
  • mode expert.

• l'attribut icon définit une image associée à l'onglet ;

• l'attribut hidden indique si la famille doit être affichée ou non, sa valeur pouvant être modifiée via une condition (voir plus bas).

Une variable contient une description et, optionnellement, une valeur EOLE par défaut.

Les variables peuvent être à valeur unique ou multi-valuées.

Les balises <variable> sont incluses obligatoirement dans une balise <family>.

Les attributs de la balise variable sont les suivants :

• l'attribut name (obligatoire) est le nom de la variable ;
• l'attribut type (obligatoire) permet d'utiliser un type EOLE avec des vérifications automatiques (fonctions de vérifications associées a chaque type de variable) ;

• l'attribut description permet de définir le libellé à afficher dans l'interface de configuration du module ;
• l'attribut multi permet de spécifier qu'une variable pourra avoir plusieurs valeurs (par exemple pour un DNS, on aura plusieurs adresses IP de serveurs DNS) ;
• l'attribut mode permet de définir le mode d'affichage de la variable (basic, normal ou expert) ;
• si l'attribut hidden vaut True, la variable ne sera pas affichée dans l'interface de configuration (on peut par exemple souhaiter masquer des variables dont la valeur est calculée automatiquement) ;
• si l'attribut disabled vaut True, la variable sera déclarée comme désactivée.
• si l'attribut mandatory vaut True, la variable sera considérée comme obligatoire, cet attribut remplace l'ajout d'un check obligatoire au niveau des conditions :
• si l'attribut redefine vaut True, cela permet de redéfinir une variable déjà définie dans un autre dictionnaire ;
• si l'attribut exists vaut False, cela permet de définir une variable si et seulement si elle n'a pas déjà été définie dans un autre dictionnaire.
• si l'attribut remove_check vaut True pour une variable redéfinie, alors toutes les validations (check) associées à cette variable sont réinitialisées ;
• si l'attribut remove_condition vaut True pour une variable redéfinie, alors toutes les conditions associées à cette variable sont réinitialisées (attention, remove_condition n'est disponible qu'à partir de la version EOLE 2.5.2) ;
• si l'attribut auto_freeze vaut True, la variable devient à verrouillage automatique. Sa valeur est verrouillée dès le premier enregistrement de la configuration. Dans l'interface de configuration du module, ces variables sont identifiées par la présence d'un cadenas. Ce dernier apparaît verrouillé une fois le serveur instancié ;
• si l'attribut auto_save vaut True, la variable devient à enregistrement obligatoire. Sa valeur est obligatoirement enregistrée dans le fichier de configuration et elle n'est donc pas automatiquement modifiée si sa valeur par défaut change au niveau des dictionnaires. On retrouve ainsi un fonctionnement équivalent à celui disponible sur EOLE 2.3.

Les principaux types de variables Creole sont les suivants :

• number : la valeur de la variable doit être du type "int". La fonction python int(value) ne doit pas retourner d'erreur ;

• string : la valeur de la variable doit être du type "unicode" ;

• ip : valeur de type IP. La valeur doit passer ce test : IPy.IP('{0}/32'.format(value)) ;

• local_ip : la même chose que IP, sauf que les adresses réservées et privées soulèvent un warning (voir IPy pour des informations sur les adresses réservées et privées) ;

• netmask : adresse de masque réseau. La valeur doit passer ce test : IPy.IP('0.0.0.0/{0}'.format(value)) ;

• network : adresse réseau. La valeur doit passer ce test : IPy.IP(value) ;

• broadcast : adresse de broadcast. : La valeur doit passer ce test : IPy.IP('{0}/32'.format(value)) ;

• netbios : alphanumérique autorisé sauf pour le 1er caractère qui doit forcement être du type alpha, minimum 2 et maximum 15 caractères ;

• domain :

  • adresse IP. La valeur doit passer ce test : IPy.IP('{0}/32'.format(value))

  ou

  • alphanumérique et '.' autorisé sauf pour le 1er caractère qui doit forcement être du type alpha. Le '.' est obligatoire. Minimum 2 et maximum 255 caractères ;

• domain_strict : nom DNS uniquement (adresse IP interdite) ;

• unix_user : nom d'utilisateur ou de groupe Unix ;

• web_address : adresse Internet. Doit débuter par http:// ou https:// ;

• hostname :

  • adresse IP. La valeur doit passer ce test : IPy.IP('{0}/32'.format(value))

  ou

  • alphanumérique autorisé sauf pour le 1er caractère qui doit forcement être du type alpha.Minimum 2 et maximum 63 caractères ;

• hostname_strict : nom d'hôte uniquement (adresse IP interdite) ;

• mail : adresse e-mail ;

• port : entier compris entre 1 et 65535 ;

• filename : tout chemin Unix (fichier ou répertoire) ;

• oui/non : seules valeurs possibles : "oui" et "non" ;

• yes/no : seules valeurs possibles : "yes" et "no" ;

• on/off : seules valeurs possibles : "on" et "off" ;

A l'intérieur d'une balise <variable>, il est possible de définir une balise <value> permettant de spécifier la valeur par défaut de la variable.

Les séparateurs permettent de définir des barres de séparation au sein d'une famille de variable dans l'interface de configuration.

Les séparateurs définis dans un dictionnaire sont placés dans la balise <separators></separators> dans la balise <variables>.

A l'intérieur de la balise <separators> il faut spécifier autant de balises <separator> que de séparateurs souhaités.

Les attributs de la balise separator sont les suivants :

• l'attribut name (obligatoire) correspond au nom de la variable suivant le séparateur ;
• si l'attribut never_hidden vaut True, le séparateur sera affiché même si la variable associée est masquée.

Dans le cas où il n'y a aucune variable à afficher dans le bloc défini par le séparateur, celui-ci est forcément masqué.