cchurch.win_vipre

Descripción general Versiones Perspectivas

Win-VIPRE

Gestiona el servidor antivirus VIPRE Business en Windows. Realiza copias de seguridad, restauraciones, instalaciones, actualizaciones y desinstalaciones de VIPRE Business, Business Premium o Endpoint Security.

Variables del Rol

Las variables resaltadas en negrita a continuación son las que normalmente se utilizan para configurar el rol; otras variables son para uso avanzado. Los pasos en el rol se ejecutan siempre en el siguiente orden:

Copia de seguridad (cuando vipre_backup es true)
Desinstalación (cuando vipre_uninstall es true)
Instalación (cuando vipre_install es true)
Restauración (cuando vipre_restore es true)

Sin establecer al menos una de vipre_backup, vipre_restore, vipre_install o vipre_uninstall en true, el rol solo verificará si VIPRE está instalado.

Utiliza las siguientes variables para especificar el producto y la versión de VIPRE que se van a gestionar. Estas variables afectan los pasos de instalación y desinstalación de este rol:

vipre_product: Producto VIPRE Business, debe ser uno de "standard", "premium" o "endpoint", el valor predeterminado es "standard".
vipre_version: Versión de VIPRE Business para instalar, actualizar o desinstalar. Los valores válidos son "latest", "11.0" y "10.0" (solo para "endpoint"), "10.1" (para "standard" y "premium"), y "9.6", "9.5" y "9.3" (para cualquier producto); el valor predeterminado es "latest".
vipre_regkey_name: Especifica un componente de ruta alternativo para las claves de registro de VIPRE, generalmente solo necesario para versiones antiguas al usar una vipre_download_url o vipre_product_id personalizadas. El valor predeterminado es "VIPRE Business".
vipre_datadir_name: Especifica un componente de ruta alternativo para el directorio de datos de VIPRE, generalmente solo necesario para versiones antiguas al usar una vipre_download_url o vipre_product_id personalizadas. El valor predeterminado es "VIPRE Business".

Para hacer una copia de seguridad de la base de datos VIPRE (solo la base de datos interna SQLite, SQL Server no es compatible aún), utiliza las siguientes variables:

vipre_backup: Establece en true para habilitar las distintas opciones de copia de seguridad a continuación, el valor predeterminado es false.
vipre_backup_remote: Realiza una copia de seguridad de la base de datos en un destino en el sistema remoto, el valor predeterminado es true.
vipre_backup_remote_path: Ruta remota para almacenar la copia de seguridad de la base de datos. El valor predeterminado es "", que utiliza el archivo completo de la base de datos con vipre_backup_suffix agregado.
vipre_backup_local: Realiza una copia de seguridad de la base de datos en un destino en el sistema local (controlador), el valor predeterminado es false.
vipre_backup_local_path: Ruta local para almacenar la copia de seguridad de la base de datos. El valor predeterminado es "", que utiliza el directorio actual (playbook_dir) y el nombre del archivo de la base de datos con vipre_backup_suffix agregado.
vipre_backup_suffix: Sufijo que se añadirá al nombre de archivo de la copia de seguridad de la base de datos, el valor predeterminado es ansible_date_time.iso8601_basic_short, que agrega una marca de tiempo.
vipre_backup_ini: Realiza una copia de seguridad del GUID del sitio VIPRE y el código de registro en un archivo INI junto con la copia de seguridad de la base de datos, el valor predeterminado es true. El nombre del archivo INI será el mismo que el nombre del archivo de copia de seguridad de la base de datos con .ini agregado.

Para desinstalaciones, se pueden usar las siguientes variables:

vipre_uninstall: Establecer en true para desinstalar VIPRE Business y habilitar las distintas opciones de desinstalación a continuación, el valor predeterminado es false.
vipre_uninstall_product: Especifica el producto VIPRE a desinstalar, el valor predeterminado es vipre_product.
vipre_uninstall_version: Especifica la versión de VIPRE a desinstalar, el valor predeterminado es vipre_version.
vipre_uninstall_product_id: Especifica un GUID de producto alternativo para desinstalar, el valor predeterminado se basa en vipre_uninstall_product y vipre_uninstall_version.
vipre_uninstall_registry: Establecer en true para eliminar todas las claves de registro de VIPRE Business, el valor predeterminado es false.
vipre_uninstall_data: Establecer en true para eliminar todos los archivos de datos de VIPRE Business (generalmente en %ProgramData%), el valor predeterminado es false.

Para instalaciones, se pueden usar las siguientes variables:

vipre_install: Establecer en true para instalar o actualizar VIPRE Business, el valor predeterminado es false. VIPRE se actualizará cuando la versión descargada sea inferior a la versión instalada.
vipre_force_install: Establecer en true para forzar la instalación incluso si la versión instalada es inferior o igual a la versión descargada, el valor predeterminado es false.
vipre_download_url: Especificar una URL de descarga alternativa para el instalador de VIPRE, el valor predeterminado se basa en vipre_version y vipre_product.
vipre_product_id: Especificar el GUID del producto que se instalará, el valor predeterminado se basa en vipre_version y vipre_product.

Para restaurar la base de datos interna SQLite de VIPRE desde una copia de seguridad, utiliza las siguientes variables:

vipre_restore: Establecer en true para habilitar las distintas opciones de restauración a continuación.
vipre_restore_remote: Restaurar la base de datos desde un archivo de copia de seguridad en el sistema remoto, el valor predeterminado es false. Si se establece en true, vipre_restore_local debe ser false.
vipre_restore_remote_path: Ruta remota al archivo de base de datos; debe ser proporcionada si vipre_restore_remote es true.
vipre_restore_local: Restaurar la base de datos desde un archivo de copia de seguridad en el sistema local (controlador), el valor predeterminado es false. Si se establece en true, vipre_restore_remote debe ser false.
vipre_restore_local_path: Ruta local al archivo de base de datos; debe ser proporcionada si vipre_restore_local es true.
vipre_restore_site_guid: Especificar el valor del GUID del sitio para restaurar en el registro; el valor predeterminado es "", que no restaura el GUID del sitio.
vipre_restore_reg_code: Especificar el valor del código de registro para restaurar en el registro; el valor predeterminado es "", que no restaura el código de registro. Esta opción solo actualiza el registro, por lo que puede ser sobreescrita si la base de datos no coincide.
vipre_restore_post_install_wizard: Establecer una clave de registro que indique que el asistente de post-instalación se ha ejecutado; el valor predeterminado es true.

Ejemplo de Playbook

El siguiente ejemplo de playbook instala una versión anterior de VIPRE Business Premium en la primera invocación del rol, luego realiza una copia de seguridad y actualiza a la versión más reciente en la segunda invocación:

- 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