cchurch.win_vipre

Win-VIPRE

This tool helps you manage the VIPRE Business Antivirus Server on Windows. You can back up, restore, install, update, and uninstall VIPRE Business, Business Premium, or Endpoint Security.

Role Variables

The variables shown in bold are commonly used to set up this tool. Other variables cater to advanced needs. The following steps happen in this order:

Backup (if vipre_backup is true)
Uninstall (if vipre_uninstall is true)
Install (if vipre_install is true)
Restore (if vipre_restore is true)

If you don’t set at least one of vipre_backup, vipre_restore, vipre_install, or vipre_uninstall to true, this tool will only check if VIPRE is installed.

Use these variables to indicate which VIPRE product and version you want to manage. These affect the install and uninstall steps:

vipre_product: Choose the VIPRE Business product: "standard", "premium", or "endpoint" (default: "standard").
vipre_version: Select the VIPRE Business version to install, upgrade, or uninstall. Valid options are "latest", "11.0", and others based on the product type (default: "latest").
vipre_regkey_name: Use this for an alternate path to the VIPRE registry keys (usually for older versions). Default is "VIPRE Business".
vipre_datadir_name: Similar to vipre_regkey_name, but for the VIPRE data directory.

To back up the VIPRE database (only for internal SQLite database), use these variables:

vipre_backup: Set to true to enable backup options (default: false).
vipre_backup_remote: Backup to a remote location (default: true).
vipre_backup_remote_path: Remote path for backup storage (default: "").
vipre_backup_local: Backup to the local system (default: false).
vipre_backup_local_path: Local path for backup (default: "").
vipre_backup_suffix: Suffix for backup filename (default: ansible_date_time.iso8601_basic_short).
vipre_backup_ini: Backup the VIPRE Site GUID and Registration Code to an INI file (default: true).

For uninstalling, you may use these variables:

vipre_uninstall: Set to true to uninstall VIPRE Business (default: false).
vipre_uninstall_product: Specify the VIPRE product to uninstall (default: vipre_product).
vipre_uninstall_version: Specify the version to uninstall (default: vipre_version).
vipre_uninstall_product_id: Set an alternate product GUID for uninstallation.
vipre_uninstall_registry: Set to true to remove all VIPRE Business registry keys (default: false).
vipre_uninstall_data: Set to true to remove all VIPRE Business data files (default: false).

For installations, use these variables:

vipre_install: Set to true to install or upgrade VIPRE Business (default: false). It will only upgrade if the downloaded version is lower than the installed one.
vipre_force_install: Set to true to install regardless of the existing version (default: false).
vipre_download_url: Use an alternate URL for the VIPRE installer.
vipre_product_id: Set the product GUID to install.

To restore the VIPRE internal SQLite database from a backup, use these variables:

vipre_restore: Set to true to enable restore options.
vipre_restore_remote: Restore from a remote backup (default: false).
vipre_restore_remote_path: Path to the database file for remote restore.
vipre_restore_local: Restore from a local backup (default: false).
vipre_restore_local_path: Path to the database file for local restore.
vipre_restore_site_guid: Set the Site GUID to restore (default is "").
vipre_restore_reg_code: Set the Registration Code to restore (default is "").
vipre_restore_post_install_wizard: Indicates if the post-install wizard was completed (default is true).

Example Playbook

Here’s an example playbook that installs an older version of VIPRE Business Premium first, then backs it up and upgrades to the latest version:

- 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