cchurch.win_vipre

Win-VIPRE

Gérer le serveur antivirus VIPRE Business sur Windows. Sauvegarde, restauration, installation, mise à jour et désinstallation de VIPRE Business, Business Premium ou Endpoint Security.

Variables du rôle

Les variables mises en gras ci-dessous sont celles généralement utilisées pour configurer le rôle; les autres variables sont pour un usage avancé. Les étapes du rôle s'exécutent toujours dans l'ordre suivant :

Sauvegarde (lorsque vipre_backup est true)
Désinstallation (lorsque vipre_uninstall est true)
Installation (lorsque vipre_install est true)
Restauration (lorsque vipre_restore est true)

Sans au moins une des variables vipre_backup, vipre_restore, vipre_install ou vipre_uninstall définie sur true, le rôle vérifiera seulement si VIPRE est installé.

Utilisez les variables suivantes pour spécifier le produit et la version VIPRE à gérer. Ces variables affectent les étapes d'installation et de désinstallation de ce rôle :

vipre_product : Produit VIPRE Business, doit être l'un de "standard", "premium" ou "endpoint", par défaut c'est "standard".
vipre_version : Version de VIPRE Business à installer, mettre à jour ou désinstaller. Les valeurs valides sont "latest", "11.0" et "10.0" (pour "endpoint" uniquement), "10.1" (pour "standard" et "premium"), et "9.6", "9.5" et "9.3" (pour tout produit); par défaut c'est "latest".
vipre_regkey_name : Spécifiez un composant de chemin alternatif pour les clés de registre VIPRE, généralement nécessaire uniquement pour les anciennes versions lors de l'utilisation d'une vipre_download_url ou d'un vipre_product_id personnalisés. Par défaut c'est "VIPRE Business".
vipre_datadir_name : Spécifiez un composant de chemin alternatif pour le répertoire de données VIPRE, généralement nécessaire uniquement pour les anciennes versions lors de l'utilisation d'une vipre_download_url ou d'un vipre_product_id personnalisés. Par défaut c'est "VIPRE Business".

Pour sauvegarder la base de données VIPRE (base de données SQLite interne uniquement, SQL Server n'est pas encore supporté), utilisez les variables suivantes :

vipre_backup : Défini sur true pour activer les différentes options de sauvegarde ci-dessous, par défaut c'est false.
vipre_backup_remote : Sauvegarder la base de données à un emplacement sur le système distant, par défaut c'est true.
vipre_backup_remote_path : Chemin distant pour stocker la sauvegarde de la base de données. Par défaut c'est "", ce qui utilise le nom du fichier de base de données complet avec vipre_backup_suffix ajouté.
vipre_backup_local : Sauvegarder la base de données à un emplacement sur le système local (contrôlant), par défaut c'est false.
vipre_backup_local_path : Chemin local pour stocker la sauvegarde de la base de données. Par défaut c'est "", ce qui utilise le répertoire courant (playbook_dir) et le nom du fichier de base de données avec vipre_backup_suffix ajouté.
vipre_backup_suffix : Suffixe à ajouter au nom du fichier de sauvegarde de la base de données, par défaut c'est ansible_date_time.iso8601_basic_short qui ajoute un horodatage.
vipre_backup_ini : Sauvegarder le GUID du site VIPRE et le code d'enregistrement dans un fichier INI à côté de la sauvegarde de la base de données, par défaut c'est true. Le nom du fichier INI sera le même que celui de la sauvegarde de la base de données avec .ini ajouté.

Pour les désinstallations, les variables suivantes peuvent être utilisées :

vipre_uninstall : Défini sur true pour désinstaller VIPRE Business et activer les différentes options de désinstallation ci-dessous, par défaut c'est false.
vipre_uninstall_product : Spécifiez le produit VIPRE à désinstaller, par défaut c'est vipre_product.
vipre_uninstall_version : Spécifiez la version VIPRE à désinstaller, par défaut c'est vipre_version.
vipre_uninstall_product_id : Spécifiez un GUID de produit alternatif à désinstaller, par défaut basé sur vipre_uninstall_product et vipre_uninstall_version.
vipre_uninstall_registry : Défini sur true pour supprimer toutes les clés de registre de VIPRE Business, par défaut c'est false.
vipre_uninstall_data : Défini sur true pour supprimer tous les fichiers de données de VIPRE Business (généralement dans %ProgramData%), par défaut c'est false.

Pour les installations, les variables suivantes peuvent être utilisées :

vipre_install : Défini sur true pour installer ou mettre à jour VIPRE Business, par défaut c'est false. VIPRE sera mis à jour lorsque la version téléchargée est inférieure à la version installée.
vipre_force_install : Défini sur true pour forcer l'installation même si la version installée est inférieure ou égale à la version téléchargée, par défaut c'est false.
vipre_download_url : Spécifiez une URL de téléchargement alternative pour l'installateur VIPRE, par défaut basé sur vipre_version et vipre_product.
vipre_product_id : Spécifiez le GUID du produit qui sera installé, par défaut basé sur vipre_version et vipre_product.

Pour restaurer la base de données SQLite interne VIPRE à partir d'une sauvegarde, utilisez les variables suivantes :

vipre_restore : Défini sur true pour activer les différentes options de restauration ci-dessous.
vipre_restore_remote : Restaurer la base de données à partir d'un fichier de sauvegarde sur le système distant, par défaut c'est false. Si défini sur true, vipre_restore_local doit être false.
vipre_restore_remote_path : Chemin distant vers le fichier de base de données ; doit être fourni si vipre_restore_remote est true.
vipre_restore_local : Restaurer la base de données à partir d'un fichier de sauvegarde sur le système local (contrôlant), par défaut c'est false. Si défini sur true, vipre_restore_remote doit être false.
vipre_restore_local_path : Chemin local vers le fichier de base de données ; doit être fourni si vipre_restore_local est true.
vipre_restore_site_guid : Spécifiez la valeur du GUID du site à restaurer dans le registre ; par défaut c'est "", ce qui ne restaure pas le GUID du site.
vipre_restore_reg_code : Spécifiez la valeur du code d'enregistrement à restaurer dans le registre ; par défaut c'est "", ce qui ne restaure pas le code d'enregistrement. Cette option ne met à jour que le registre, donc elle peut être écrasée si la base de données ne correspond pas.
vipre_restore_post_install_wizard : Définir une clé de registre indiquant que l'assistant post-installation a été exécuté ; par défaut c'est true.

Exemple de Playbook

Le playbook exemple suivant installe une version plus ancienne de VIPRE Business Premium lors de la première invocation du rôle, puis effectue une sauvegarde et une mise à niveau vers la dernière version lors de la seconde invocation :

- hosts: vipre
  vars:
    vipre_product: premium
  roles:
    - role: cchurch.vipre
      vipre_version: 10.1
      vipre_install: true
    - role: cchurch.vipre
      vipre_backup: true
      vipre_install: true