Fusion de configurations de poste client

La fonction Fusion des configurations de poste client (Endpoint Configuration Merging) utilise l'agent EM pour combiner plusieurs fichiers de configuration AEMP (enregistrés sur le même poste client) en une seule configuration.Les nœuds, conditions réutilisables et bibliothèques de messages de chaque configuration sont ajoutés à la configuration fusionnée.

La fusion est réalisée en ajoutant chaque configuration distincte à un répertoire sur le poste client et en spécifiant, dans un fichier de manifeste, les configurations à fusionner.L'agent EM surveille le répertoire de fusion et fusionne automatiquement les configurations lorsque vous ajoutez un fichier de manifeste à ce répertoire.

La fusion des configurations de poste client permet à différentes entités commerciales de fonctionner indépendamment sur des zones particulières d'une configuration, qui peuvent alors être fusionnées pour créer une seule configuration. Lorsqu'il est nécessaire d'apporter des changements mineurs à des configurations volumineuses, vous pouvez créer un snippet (extrait) de la zone qui a changé. Vous pouvez ensuite fusionner ce snippet sur les postes client, si bien que vous n'avez pas besoin de distribuer en mode Push des configurations volumineuses.

Dans cette section :

Composants d'une fusion

La fusion des configurations repose sur les composants suivants.

Configuration de base

Chaque fusion doit comporter une configuration de base. Il s'agit de la première configuration de la fusion, à laquelle les autres configurations sont ajoutées.Une configuration fusionnée récupère les attributs globaux de la configuration de base, notamment les paramètres personnalisés, les options d'audit et tous les paramètres de personnalisation.

Il est donc indispensable que les paramètres qui ne sont pas fusionnés soient définis dans la configuration de base.

Par défaut, la configuration de base est le fichier AEMP créé lorsque vous enregistrez une configuration active sur un poste client :

%ProgramData%\AppSense\Environment Manager\Configuration.aemp

La configuration de base et toutes les configurations qui composent la fusion doivent être de version Environment Manager 10.0 ou supérieure. Mettez à niveau les configurations de version plus ancienne avant la fusion.

Configurations constituantes

Une configuration fusionnée est constituée d'une configuration de base, plus une ou plusieurs configurations constituantes.Les configurations constituantes sont des fichiers AEMP, ajoutés à la configuration de base pendant la fusion. Pour faire partie d'une fusion, les configurations constituantes doivent être stockées dans le répertoire MergeConfigs.

Les nœuds, pré-déclencheurs, nom d'utilisateur Exécuter comme et messages utilisateur des constituants sont inclus dans la fusion. Les autres paramètres, comme les options d'audit, sont tirés uniquement de la configuration de base. La configuration de base et toutes les configurations qui composent la fusion doivent être de version Environment Manager 10.0 ou supérieure. Mettez à niveau les configurations de version plus ancienne avant la fusion.

Répertoire MergeConfigs

Ce répertoire est l'emplacement où les configurations constituantes destinées à la fusion sont stockées, et l'emplacement où la fusion est déclenchée si le système détecte un fichier de manifeste valide.

Lorsque vous démarrez le service EMCoreService sur un poste client, le répertoire MergeConfigs est créé :

%ProgramData%\AppSense\Environment Manager\MergeConfigs

Ce répertoire est sécurisé : seuls les administrateurs peuvent y écrire des données.Cela garantit que les utilisateurs finaux ne peuvent pas altérer les configurations de fusion.

Manifeste

Le manifeste est un fichier XML qui contient les détails des configurations à fusionner et détermine la configuration qui doit servir de base. La fusion démarre lorsque l'agent détecte un manifeste dans le répertoire MergeConfigs.

Les manifestes sont créés à l'aide de l'outil de ligne de commande ManifestGen.

Voici un fichier exemple, merge_manifest.xml.

<MergeManifest UseSystemBase="true" WaitForConfigs="true">

<MergeFiles>

<FileEntry Name="config2.aemp" Checksum="563621a479c06d6d357b327283320288"/>

<FileEntry Name="config4.aemp" Checksum="4bc481043e6991253de15ec6993ee43f"/>

</MergeFiles>

</MergeManifest>

Attributs et balises du manifeste

Attribut/Balise Description
MergeManifest Nœud racine de la configuration.
MergeFiles Balise conteneur de la liste des fichiers AEMP à inclure dans la fusion.
FileEntry Name Identifie une configuration à inclure dans la fusion.Le fichier doit exister dans le répertoire MergeConfigs pour être inclus dans la fusion.

UseSystemBase

(Facultatif)

Peut être défini sur true (vrai) ou false (faux). Demande au système d'inclure ou d'exclure le fichier configuration.aemp par défaut dans la fusion. Il s'agit du fichier de configuration active (configuration.aemp) résidant sous %ProgramData%\AppSense\Environment Manager. Si la valeur est définie sur true (vrai), la configuration de base doit déjà exister sur les postes client où vous déployez le manifeste. Sinon, la fusion échoue. Si vous choisissez false (faux), la première configuration de la liste MergeFiles est utilisée comme configuration de base, sauf si l'attribut BaseConfig en indique une autre.

WaitForConfigs

(Facultatif)

Détermine le comportement du système lorsqu'un fichier XML de manifeste est détecté dans le répertoire MergeConfigs mais que certaines des configurations nommées sont absentes.Vous pouvez choisir :
  • True (vrai) - La fusion attend indéfiniment, jusqu'à ce que toutes les configurations référencées dans le manifeste soient présentes, puis le système effectue la fusion.
  • False (faux) - La fusion échoue si le système détecte dans le répertoire MergeConfigs un manifeste qui fait référence à une configuration absente.
Si vous employez un programme d'installation (un MSI, par exemple) pour distribuer en mode Push des configurations et un manifeste vers les postes client, il est recommandé de définir cette option sur « true » (vrai) car vous ne pouvez pas garantir l'ordre dans lequel les configurations et le manifeste vont être ajoutés. Cela ne s'applique pas si vous utilisez le fichier SystemBase Configuration.aemp. Si la fusion par manifeste est déclenchée et que le fichier Configuration.aemp est absent, la fusion échoue. Le système n'attend pas d'obtenir la configuration de base.

Checksum

(Facultatif)

Somme de contrôle MD5 propre à un fichier AEMP. S'il figure dans le manifeste, le fichier AEMP du dossier MergeConfigs doit porter la même somme de contrôle pour être inclus dans la fusion. Les configurations de base ne sont pas référencées par une somme de contrôle.

Outil ManifestGen

ManifestGen est un outil de ligne de commande qui crée le fichier de manifeste XML servant à définir et à déclencher la fusion des configurations. Ce fichier XML contient les détails des fichiers AEMP à fusionner, et il peut déterminer si la configuration de base de la fusion doit être le fichier .aamp de la configuration système ou d'une configuration constituante.

Si le fichier merge_manifest.xml existe déjà dans le répertoire de sortie, l'outil échoue et le nouveau manifeste n'est pas créé. Le fichier existant n'est pas écrasé.

Pour faciliter l'utilisation de cet outil, ajoutez-le sous à la variable d'environnement Path, sous Propriétés système avancées > Variables d'environnement > Path :
%PROGRAMFILES%\AppSense\Environment Manager\Console

Création d'un manifeste

  1. Enregistrez les configurations à fusionner dans le répertoire MergeConfigs :
  2. %ProgramData%\AppSense\Environment Manager\MergeConfigs
  3. Ouvrez l'interface de ligne de commande.
  4. Entrez cd %programdata%\appsense\environment manager pour changer de répertoire.
  5. Entrez manifestgen mergeconfigs\*.aemp.

Si vous exécutez manifestgen dans le dossier MergeConfigs, l'agent détecte le manifeste dès sa création et lance immédiatement la fusion.

Si l'opération réussit, le fichier merge_manifest.xml est créé sous : %ProgramData%\AppSense\Environment Manager

Le manifeste peut désormais être utilisé pour déclencher la fusion et créer une configuration.

Commandes supplémentaires

Vous pouvez utiliser des arguments dans l'outil ManifestGen pour modifier le manifeste et influer sur la fusion. Vous pouvez spécifier une autre configuration de base, indiquer le fichier de sortie et créer un manifeste sans valeur de somme de contrôle pour les configurations.

Suffixe Description et syntaxe
-o Dossier de sortie - Indiquer l'emplacement de création du fichier manifest.xml file. Par exemple, manifestgen mergeconfigs\*.aemp -o c:\configs crée le manifeste dans le dossier Configs sur le lecteur C.
-b Configuration de base - Permet d'identifier la configuration de base et d'exclure la configuration de base par défaut. Par exemple, manifestgen mergeconfigs\*.aemp -b config1.aemp crée un manifeste qui crée une configuration fusionnée où Config1.aemp est désigné comme configuration de base.
-nc Aucune entrée de somme de contrôle - Par défaut, chaque configuration répertoriée dans le manifeste porte une somme de contrôle MD5 qui identifie une configuration de façon unique.Si la somme de contrôle figurant dans le manifeste est différente de celle de la configuration choisie, la fusion échoue ou attend une configuration portant la somme de contrôle correcte. Si vous utilisez le suffixe -nc avec l'outil ManifestGen, les sommes de contrôle ne sont pas répertoriées dans le manifeste, ce qui signifie que la fusion réussit si les noms de fichier de configuration sont corrects, quelle que soit la valeur de somme de contrôle.Par exemple : manifestgen mergeconfigs\*.aemp -nc
-nw Le comportement par défaut en cas d'ajout d'un manifeste au répertoire MergeConfigs consiste à attendre indéfiniment, jusqu'à ce que toutes les configurations du manifeste soient présentes, puis d'effectuer la fusion.Avec le suffixe -nw, la fusion échoue si les configurations répertoriées sont absentes lorsque vous ajoutez le manifeste au répertoire MergeConfigs. Par exemple : manifestgen mergeconfigs\*.aemp -nw. Si le manifeste répertorie cinq configurations mais que quatre seulement sont présentes lorsque vous ajoutez le manifeste au répertoire MergeConfigs, la fusion échoue. Si vous employez un programme d'installation (un MSI, par exemple) pour distribuer en mode Push des configurations et des manifestes vers les postes client, il est recommandé de ne pas utiliser ce suffixe car vous ne pouvez pas garantir l'ordre dans lequel les configurations et les manifestes vont être ajoutés.

Modification d'un manifeste

Bien que les manifestes puissent être modifiés et créés dans un éditeur de texte, il est recommandé d'utiliser l'outil ManifestGen parce qu'il garantit que le fichier merge_manifest.xml est au format correct. Par exemple, si vous utilisez « & » dans un nom de fichier, l'outil ManifestGen lui ajoute un caractère d'échappement pour que le fichier XML soit valide.

Après sa création, le fichier de manifeste peut être modifié pour changer des attributs comme la configuration de base et l'ordre d'exécution de la fusion.

Par exemple, la commande :

manifestgen mergeconfigs\*.aemp -b mergeconfigs\config3.aemp -nc

crée un manifeste qui ne contient pas la configuration de base par défaut et où config3.aemp est désigné comme configuration de base. L'attribut WaitForConfigs est défini sur sa valeur par défaut (true) et les sommes de contrôle ne sont pas incluses.

<MergeManifest UseSystemBase="false" WaitForConfigs="true">

<MergeFiles>

<FileEntry Name="config3.aemp" BaseConfig="true"/>

<FileEntry Name="config1.aemp"/>

</MergeFiles>

</MergeManifest>

Pour modifier le manifeste, ouvrez-le dans un éditeur de texte, apportez les changements requis et enregistrez le fichier.

Dans notre exemple, UseSystemBase est défini sur « true » (vrai) et la commande BaseConfig a été supprimée du fichier config3.aemp. L'ordre de fusion a également été changé.

<MergeManifest UseSystemBase="true" WaitForConfigs="true">

<MergeFiles>

<FileEntry Name="config1.aemp"/>

<FileEntry Name="config3.aemp"/>

</MergeFiles>

</MergeManifest>

Lors de la fusion, le fichier configuration.aemp de la configuration de base par défaut est inclus dans la fusion en tant que configuration de base, et l'ordre dans lequel les configurations constituantes sont fusionnées dans la configuration de base est inversé. Notez que la configuration désignée comme configuration de base inclut les paramètres de configuration globaux (notamment, les paramètres personnalisés) que vous souhaitez inclure dans la fusion. Par conséquent, soyez prudent lorsque vous choisissez une autre configuration comme base.

Si vous définissez BaseConfig="true" pour une configuration et UseSystemBase="true" dans le même manifeste, cela provoque un conflit et la fusion échoue.

Outil BatchConfig

Seuls les fichiers AEMP dernière version peuvent être inclus dans une fusion. L'outil BatchConfig convertit les anciens fichiers AEMP et snippets XML vers le format AEMP de version correcte.

Vous pouvez convertir plusieurs fichiers à la fois ; le système génère un fichier de sortie pour chaque entrée.

Si une ou plusieurs configurations de la source existent déjà dans le répertoire de sortie, l'outil échoue et aucune configuration n'est convertie.

Pour faciliter l'utilisation de cet outil, ajoutez-le sous à la variable d'environnement Path, sous Propriétés système avancées > Variables d'environnement > Path :
%PROGRAMFILES%\AppSense\Environment Manager\Console

Conversion en batch des fichiers de configuration

  1. Enregistrez ou copiez les fichiers AEMP et XML à convertir vers un seul dossier.
  2. Ouvrez l'interface de ligne de commande.
  3. Entrez BatchConfigTool, puis les détails nécessaires (dossiers source et cible), au format suivant :

    BatchConfigTool <répertoire-source\type-fichier> -o <répertoire-sortie>

Exemples de conversion en batch

BatchConfigTool C:\Configs\Source\*.xml -o C:\Configs\Output

Cet exemple convertit les snippets (extraits) XML présents dans le répertoire source en fichiers AEMP de version actuelle, enregistrés dans le dossier de sortie. Ce même format permet de mettre à jour d'anciens fichiers AEMP vers la version actuelle :

BatchConfigTool C:\Configs\Source\*.aemp -o C:\Configs\Output

Vous pouvez également convertir simultanément les deux types de fichier :

BatchConfigTool C:\Configs\Source\*.aemp C:\Configs\Source\*.xml -o C:\Configs\Output

Dans l'exemple suivant, le répertoire Source contenait un fichier AEMP 8.3 et deux snippets XML. Après la conversion, le répertoire de sortie contient trois fichiers AEMP dans la version actuelle.

ð

L'outil BatchConfig est installé avec la console Environment Manager. Cependant, vous pouvez l'installer séparément à l'aide des programmes d'installation EnvironmentManagerPolicyTools 32 et 64 bits disponibles sur le support d'installation User Workspace Manager.

Événements d'audit - Fusion des configurations de poste client

De nouveaux événements d'audit pour la fusion des configurations de poste client ont été ajoutés à Environment Manager.Lorsque vous les affichez dans l'observateur d'événements Windows (sélectionnez Journal Windows > Applications), ces événements fournissent des détails supplémentaires, notamment la cause de l'échec de la fusion.

Rubriques connexes