Versions Compared

Old Version 5

changes.mady.by.user benjamin martin

Saved on

compared with

New Version 6

changes.mady.by.user Montassier Paul

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Scroll Ignore
scroll-viewporttrue
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-epubtrue
scroll-htmlfalse
Panel
titleSommaire

Table of Contents
stylenone

Présentation

La configuration du collecteur défini dans le fichier de configuration de la source ( voir la page  Collecteur de type synchronizer-collector-linker ( pour lier 2 Shinkens ) pour plus de détails ) peut être consultée dans cet onglet :

Elle est divisée en 5 chapitres :

  • Configuration générale
  • Options de mélange des sources
  • Choix de l'espace où seront placé placés les éléments importés
  • Paramètres spécifiques à la source
  • Clé de synchronisation ( sync_key )

Remarque : Cet onglet ne permet pas encore d'éditer la configuration ( => → Sera implémenté dans une prochaine version )

Configuration générale

Panel

Ce chapitre contient tous les paramètres pour le chargement et fonctionnement des sources en général.

Nom du paramètre dans l'interfaceNom du paramètre dans le fichierDescription
Modules
code
No Format
source_name

Nom de la source affichée dans l'interface de configuration en page d'accueil.

  • Dois être unique, 
  • d'une  longueur inférieure à 40 caractères,
    • et ne dois pas contenir le caractère "$"

    Caractères autorisés : lettres, chiffres, underscore ( _ ), et trait d'union ( - )

    • Doit être unique.
    • Doit commencer par une lettre.
    • D'une longueur maximum de 40 caractères.
    Type de Module
    code
    No Format
     module_type

    Type de module chargé par le Synchroniser. Pour cette source, le module_type est "synchronizer-collector-linker".

    Intervalle d'import
    code
    No Format
    import_interval

    Délai écoulé entre les imports automatiques de la source. 

    • Un nombre ( en minutes ).
    • Si vaut 0, la source ne sera jamais exécutée automatiquement, uniquement manuellement. 
    Ordre
    code
    No Format
    order

    L'ordre de la source dans l'interface de configuration

    , qui

    . L'ordre a un impact dans

    la fusion des données lors des imports de sources

    le mélange des sources( voir la page Le mélange des sources & les clés de synchronisation (sync-key) ).

    • Un nombre
  • Voir la page du Synchronizer  pour plus d'information au sujet des fusions. 


    Info
    iconfalse
    titleRemarque

    Si l'ordre est changé

    Remarque : Si vous changez l'ordre

    depuis l'interface

    ( page d’accueil )

    , le fichier .cfg sera mis à jour.


    Description
    code
    No Format
    description
    		Description de la source.

    Options de mélange des sources

    Panel



    Mode de mélange des sources

    Grace au paramètre "Mode de mélange des sources" ( merge_mode dans le fichier de configuration de la source ), il est possible de modifier la gestion d'une source lors de l'étape du mélange des sources .Voir ( voir la page :  Concept général et utilisation des sources ).


    La valeur par défaut est : all

    Les valeurs possibles sont : 

    Nom du paramètre dans l'interfaceNom du paramètre dans le fichier

    merge_mode
    Code Block
    merge_mode

    Ce paramètre peut avoir les valeurs suivantes :




    		Valeurs dans le fichierDescription


    		dont_merge_with_other

    Les éléments récoltés par cette source seront importés, mais pas fusionnés avec les autres sources.

    Ce qui implique que si un élément de cette source possède une clé de synchronisation commune avec une autre

    source alors

    source, la source provoquera un conflit et ces éléments ne pourront pas être importés

    et provoquera un conflit

    .

    À utiliser si

    votre

    la source

    vous

    donne un élément complet

    et

    qui ne doit pas être modifié, ni par l'interface de configuration ni par d'autres sources.



    		only_with_syncui

    Si un élément importé par cette source est aussi récolté par "

    Syncui

    syncui", ils seront fusionnés pour ne donner qu'un élément.

    A

    À utiliser si

    votre

    la source

    vous donne

    importe un élément complet

    et que vous voulez le modifier

    qui ne doit être modifié que via l'interface de configuration.



    		all_without_syncui

    Si un même élément est importé par plusieurs sources

    (à part "Syncui")

    dont est exclu la "syncui", alors les éléments seront fusionnés pour n'en donner qu'un.

    À utiliser si

    votre

    la source

    vous

    donne un élément à compléter avec d'autres sources, mais qui ne doit pas être modifié par l'interface de configuration.



    		all  (valeur par défaut)

    Si un même élément est importé par plusieurs sources,

    alors

    les éléments seront fusionnés pour n'en donner qu'un.

    Cas par défaut : les éléments de cette source seront complétés avec les autres sources et les modifications de l'interface de configuration.



    Info

    Syncui La "syncui" est une source qui importe tous les éléments de l'interface de configuration.

    Chaque fois qu'une source est importée, elle l'est la "syncui" est automatiquement importée aussi. Si une source ne se mélange pas avec Syncuila "syncui", les modifications sur l'interface de configuration ne seront pas prises en compte ignorées.

    Info

    Les sources désactivées ne sont pas prises en compte lors du mélange des sources.

    Détecter les nouveaux éléments

    Les éléments proposés par la source sont soumis au calcul des nouveautés ( cf. Les voir la page Modules de détection Sources ( imports ) et de Taggers ( qualification ) ).


    Nom du paramètre dans l'interfaceNom du paramètre dans le fichier

    compute_new_element
    Code Blocknoformat
    compute_new_element

    Ce paramètre peut avoir les valeurs suivantes :



    		Valeurs dans le fichierDescription


    authorized 

    (valeur par défaut)

    		Activée => → le mécanisme de calcul des nouveautés analysera les éléments de la source pour identifier les nouveaux éléments par rapport à l'espace de données Staging.


    		never_newDésactivée => → les éléments de la source n’apparaîtront pas en tant que nouveauNouveau, même s'ils n'ont jamais été importés par rapport à l'espace de données Staging.

    Calculer les différences

    Les éléments proposés par la source sont soumis au calcul des différences ( cf. Les voir la page Modules de détection Sources ( imports ) et de Taggers ( qualification ) ).


    Nom du paramètre dans l'interfaceNom du paramètre dans le fichier

    compute_element_difference
    Code Blocknoformat
    compute_element_difference

    Ce paramètre peut avoir les valeurs suivantes :



    		Valeurs dans le fichierDescription


    authorized 

    (valeur par défaut)

    Activée => → le mécanisme de calcul des différences analysera les éléments de la source pour identifier toute différence calculer les différences par rapport à l'espace de données Staging.



    		never_difference

    Désactivée => → les éléments de la source n’apparaîtront pas en tant que différence, même s'ils possèdent des différences par rapport a à l'espace de données Staging.

    Suppression des éléments absents

    Détecter les éléments qui ne sont plus présent dans la source

    Permet Ce paramètre permet de proposer en suppression, les éléments qui ne sont plus présents dans la ou les source/s.


    Nom du paramètre dans l'interfaceNom du paramètre dans le fichier

    compute_deleted_element_not

    _in_source

    Code Blocknoformat
    compute_deleted_element_not
_in_source

    Ce paramètre peut avoir les valeurs suivantes :



    		Valeurs dans le fichierDescription


    disabled

    (valeur par défaut)

    Les éléments qui ne sont plus présents dans la(les) source(s) cette source, ni dans aucunes autres, ne seront pas proposés à la suppression.



    delete_if_missing_in

    _all_sources

    Les éléments, qui ne sont plus présents dans cette source et qui n'existent pas dans les autres sources

    (sauf Syncui)

    à l'exception de la "syncui", seront proposés à la suppression.


    Warning

    La prise en compte de ce paramètre dépend de la valeur de put_in. Si cette valeur correspond à source_space ( sa valeur par défaut ), alors le paramètre compute_deleted_element_not_in_source sera ignoré.



    delete_if_missing_in

    _this_source

    Les éléments qui ne sont plus présents dans cette source seront proposés à la suppression.


    Warning

    La prise en compte de ce paramètre dépend de la valeur de put_in. Si cette valeur correspond à source_space ( sa valeur par défaut ), alors le paramètre compute_deleted_element_not_in_source sera ignoré.




    Choix de l'espace où seront

    placé

    placés les éléments importés

    Panel



    Mettre dans l'espace

    Permet d'Ce paramètre permet de choisir l'espace où appliquer les différences et d' importer les nouveaux éléments de cette source directement : en Staging ou , en Production ou bien de les laisser dans l'espace de calcul des sources comme ( comportement par défaut ) .


    Nom du paramètre dans l'interfaceNom du paramètre dans le fichier

    put_in
    Code Blocknoformat
    put_in

    Ce paramètre peut avoir les valeurs suivantes :




    		Valeurs dans le fichierDescription


    source_space

    (valeur par défaut)

    Les éléments sont sauvegardés dans l'espace de donnée "Sources". Cette espace sera comparée avec l'espace de données "Staging" afin de calculer les nouveautés et les différences.



    staging

    Les éléments sont sauvegardés dans les espaces de données "Espace de calcul des Sources" et "Staging".



    production

    Les éléments sont sauvegardés dans les espaces de données "Espace de calcul des Sources", "Staging" et "Production".




    production_and_reload_arbiter

    Les éléments sont sauvegardés dans les espaces de données "Espace de calcul des Sources", "Staging" et "Production".
    L'Arbiter est redémarré afin de soumettre les changements à la supervision. 


    Info

    Une source avec l'option put_in à production_and_reload_arbiter ne redémarrera l'Arbiter que si elle a des modifications à pousser en production.

    Info

    À noter:  Une source avec le paramètre "put in" à la valeur "production" ou "production_and_reload_arbiter" ne poussera en production que les changements qui proviennent de la source et non tous les changements à appliquer en production (tous les changements visibles dans la page de production).

    Ce qui implique que si un utilisateur supprime un élément importé par une source avec le paramètre "put_in" à la valeur "production" ou "production_and_reload_arbiter" alors que l'élément est réimporté par la source : il y aura en production 2 éléments avec le même nom, car la suppression manuelle de l'élément ne sera pas prise en compte ce qui provoquera une erreur.
    Une source avec l'option put_in à production_and_reload_arbiter ne redémarrera l'Arbiter que si elle a des modifications à pousser en production.

    Utilisateur utilisé pour la sauvegarde des changements

    Option qui permet de choisir l'utilisateur qui apparaîtra comme étant le dernier à avoir mis à jour les éléments.

    Info

    À Noter:  lL'utilisateur doit être obligatoirement un administrateur Shinken.

    Nom du paramètre dans l'interfaceNom du paramètre dans le fichierValeurs dans le fichierDescription
    put_in_user
    Code Blocknoformat
    put_in_user
    		shinken-coreLes nouveaux éléments et les éléments différents importés par cette source auront la valeur de cette clé comme utilisateur faisant la dernière modification.

    Clés spécifiques à la source

    Panel

    Image Removed

    Ce chapitre liste tous les paramètres qui sont spécifiques au fonctionnement de cette

    source

    .

    Paramètres de connexion à Mongo

    La discovery conserve sa configuration ( ses plages réseau, ses règles  de découvertes, ... ) dans une base MongoDB. Ces paramètres permettent de s'y connecter.

    Info

    Il est préférable d'utiliser la même base que le Synchronizer

    Nom du paramètre dans l'interfaceNom du paramètre dans le fichierValeurs dans le fichierDescriptionmongodb_database
    Code Block
    mongodb_database
    synchronizerLe nom de la base de donnéesmongodb_uri
    Code Block
    mongodb_uri
    mongodb://localhost/?safe=falseAdresse du mongo à utiliser

    Anchor
    discoverySyncKeys
    discoverySyncKeys

    Clés de synchronisation

    Les clés de synchronisation sont des valeurs utilisées lors de l'étape du mélange des sources ( Voir Modules de Sources ( imports ) et de Taggers ( qualification ) ) qui permet de choisir quel élément de cette source se mélange avec quel élément d'une autre source ( Voir Le mélange des sources & les clés de synchronisation (sync-key) ).

    Propriétés par défaut utilisé pour la construction des clés de synchronisation

    Propriétés par défaut utilisé utilisées pour la construction des clés de synchronisation :


    Propriété Type d'élémentInfo
    Code Blocknoformat
    Nom de l'élément
    		Tous les élémentsCette propriété ne peut pas être retirée des propriétés utilisées pour faire les clés de synchronisation
    Code Blocknoformat
    _SE_UUID
    		Tous les élémentsCette propriété ne peut pas être retirée des propriétés utilisées pour faire les clés de synchronisation
    Code Blocknoformat
    address
    		hôte