win_vipre

Win-VIPRE

Управление сервером антивируса VIPRE Business на Windows. Резервное копирование, восстановление, установка, обновление и удаление VIPRE Business, Business Premium или Endpoint Security.

Переменные роли

Переменные, выделенные жирным шрифтом, обычно используются для настройки роли; остальные переменные предназначены для продвинутого использования. Действия в роли всегда выполняются в следующем порядке:

Резервное копирование (если vipre_backup равно true)
Удаление (если vipre_uninstall равно true)
Установка (если vipre_install равно true)
Восстановление (если vipre_restore равно true)

Если не установить хотя бы одну из переменных vipre_backup, vipre_restore, vipre_install или vipre_uninstall в значение true, роль просто проверит, установлен ли VIPRE.

Используйте следующие переменные для указания продукта и версии VIPRE, которые будут управляться. Эти переменные влияют на этапы установки и удаления данной роли:

vipre_product: Продукт VIPRE Business, должен быть одним из "standard", "premium" или "endpoint", по умолчанию - "standard".
vipre_version: Версия VIPRE Business для установки, обновления или удаления. Допустимые значения: "latest", "11.0" и "10.0" (только для "endpoint"), "10.1" (для "standard" и "premium"), и "9.6", "9.5" и "9.3" (для любого продукта); по умолчанию - "latest".
vipre_regkey_name: Укажите альтернативный компонент пути к ключам реестра VIPRE, обычно это нужно только для старых версий при использовании пользовательского vipre_download_url или vipre_product_id. По умолчанию - "VIPRE Business".
vipre_datadir_name: Укажите альтернативный компонент пути к директории данных VIPRE, обычно это нужно только для старых версий при использовании пользовательского vipre_download_url или vipre_product_id. По умолчанию - "VIPRE Business".

Для резервного копирования базы данных VIPRE (только внутренней базы данных SQLite, SQL Server еще не поддерживается), используйте следующие переменные:

vipre_backup: Установите в true, чтобы включить различные варианты резервного копирования, по умолчанию - false.
vipre_backup_remote: Резервное копирование базы данных в каталог на удаленной системе, по умолчанию - true.
vipre_backup_remote_path: Удаленный путь для хранения резервной копии базы данных. По умолчанию - "", что использует полный файл базы данных с добавленным vipre_backup_suffix.
vipre_backup_local: Резервное копирование базы данных в каталог на локальной (управляющей) системе, по умолчанию - false.
vipre_backup_local_path: Локальный путь для хранения резервной копии базы данных. По умолчанию - "", что использует текущую директорию (playbook_dir) и имя файла базы данных с добавленным vipre_backup_suffix.
vipre_backup_suffix: Суффикс, который будет добавлен к имени файла резервной копии базы данных, по умолчанию - ansible_date_time.iso8601_basic_short, что добавляет временную метку.
vipre_backup_ini: Резервное копирование Site GUID и регистрационного кода VIPRE в INI файл вместе с резервной копией базы данных, по умолчанию - true. Имя INI файла будет таким же, как имя файла резервной копии базы данных с добавленным .ini.

Для удаления можно использовать следующие переменные:

vipre_uninstall: Установите в true, чтобы удалить VIPRE Business и включить различные варианты удаления, по умолчанию - false.
vipre_uninstall_product: Укажите продукт VIPRE для удаления, по умолчанию - vipre_product.
vipre_uninstall_version: Укажите версию VIPRE для удаления, по умолчанию - vipre_version.
vipre_uninstall_product_id: Укажите альтернативный GUID продукта для удаления, по умолчанию основывается на vipre_uninstall_product и vipre_uninstall_version.
vipre_uninstall_registry: Установите в true, чтобы удалить все ключи реестра VIPRE Business, по умолчанию - false.
vipre_uninstall_data: Установите в true, чтобы удалить все данные VIPRE Business (обычно в %ProgramData%), по умолчанию - false.

Для установки можно использовать следующие переменные:

vipre_install: Установите в true, чтобы установить или обновить VIPRE Business, по умолчанию - false. VIPRE будет обновлён, если загруженная версия ниже установленной.
vipre_force_install: Установите в true, чтобы принудительно установить, даже если установленная версия меньше или равна загруженной, по умолчанию - false.
vipre_download_url: Укажите альтернативный URL для загрузки установщика VIPRE, по умолчанию основывается на vipre_version и vipre_product.
vipre_product_id: Укажите GUID продукта, который будет установлен, по умолчанию основывается на vipre_version и vipre_product.

Чтобы восстановить внутреннюю базу данных SQLite VIPRE из резервной копии, используйте следующие переменные:

vipre_restore: Установите в true, чтобы включить различные варианты восстановления.
vipre_restore_remote: Восстановите базу данных из файла резервной копии на удаленной системе, по умолчанию - false. Если установлено в true, то vipre_restore_local должно быть false.
vipre_restore_remote_path: Удаленный путь к файлу базы данных; должен быть указан, если vipre_restore_remote равно true.
vipre_restore_local: Восстановите базу данных из файла резервной копии на локальной (управляющей) системе, по умолчанию - false. Если установлено в true, то vipre_restore_remote должно быть false.
vipre_restore_local_path: Локальный путь к файлу базы данных; должен быть указан, если vipre_restore_local равно true.
vipre_restore_site_guid: Укажите значение Site GUID, чтобы восстановить в реестре; по умолчанию - "", что не восстанавливает Site GUID.
vipre_restore_reg_code: Укажите значение регистрационного кода для восстановления в реестре; по умолчанию - "", что не восстанавливает регистрационный код. Эта опция только обновляет реестр, поэтому может быть перезаписана, если база данных не совпадает.
vipre_restore_post_install_wizard: Установите ключ реестра, указывающий, что мастер установки после установки был выполнен; по умолчанию - true.

Пример Playbook

Следующий пример playbook устанавливает старую версию VIPRE Business Premium при первом вызове роли, затем выполняет резервное копирование и обновление до последней версии при втором вызове:

- 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