oVirt Engine Setup

This role has been migrated to oVirt Ansible Collection, please use latest version from there. This repository is now readonly and no longer used for active development

Installs required packages for oVirt Engine deployment, generates answerfile and runs engine-setup. Optionally the role updates oVirt engine packages.

Note

Please note that when installing this role from Ansible Galaxy you are instructed to run following command:

$ ansible-galaxy install ovirt.engine-setup

This will download the role to the directory with the same name as you specified on the command line, in this case ovirt.engine-setup. However note that this is case sensitive. Therefore if you specify for example OVIRT.engine-setup, the same role will be downloaded, but it will be placed in a directory named OVIRT.engine-setup. If this is the case, you always have to use this role with the upper case prefix. That's why you need to be careful how you specify the name of the role on command line.

For the RPM installation we install three legacy names - oVirt.engine-setup, ovirt.engine-setup and ovirt-engine-setup. You can use any of these names. This documentation and examples in this repository use name ovirt.engine-setup. oVirt.engine-setup and ovirt-engine-setup role names have been deprecated.

Target Systems

engine

Requirements

Environment with configured repositories
Ansible version 2.9.0

Role Variables

By default engine-setup uses an answer file specific for version of oVirt based on ovirt_engine_setup_version parameter. You can provide your own answer file to ovirt_engine_setup_answer_file_path variable.

Common options for role:

Name	Default value	Description
ovirt_engine_setup_answer_file_path	UNDEF	Path to custom answerfile for `engine-setup`.
ovirt_engine_setup_use_remote_answer_file	False	If `True`, use answerfile's path on the remote machine. This option should be used if the installation occurs on the remote machine and the answerfile is located there as well.
ovirt_engine_setup_update_setup_packages	False	If `True`, setup packages will be updated before `engine-setup` is executed. It makes sense if Engine has already been installed.
ovirt_engine_setup_perform_upgrade	False	If `True`, this role is used to perform an upgrade.
ovirt_engine_setup_product_type	oVirt	One of ["oVirt", "RHV"], case insensitive.
ovirt_engine_setup_offline	False	If `True`, updates for all packages will be disabled.
ovirt_engine_setup_restore_engine_cleanup	False	Remove the configuration files and clean the database associated with the Engine, relevant only when `ovirt_engine_setup_restore_file` is defined
ovirt_engine_setup_restore_file	UNDEF	Restored the engine with a backup file which created with engine-backup.
ovirt_engine_setup_restore_scopes	UNDEF	List of scopes following values are available: ["all", "files", "db", "dwhdb", "cinderlibdb"].
ovirt_engine_setup_restore_options	{}	Dictionary that will add engine restore options as "`--key`=`value`" when `value` is not empty, otherwise it will append "`--key`" only.

Common options for engine:

Name	Default value	Description
ovirt_engine_setup_version	4.4	Allowed versions: [4.1, 4.2, 4.3, 4.4].
ovirt_engine_setup_package_list	[]	List of extra packages to be installed on engine apart from `ovirt-engine` package.
ovirt_engine_setup_fqdn	UNDEF	Host fully qualified DNS name of the server.
ovirt_engine_setup_organization	UNDEF	Organization name for certificate.
ovirt_engine_setup_firewall_manager	firewalld	Specify the type of firewall manager to configure on Engine host, following values are available: `firewalld`,`iptables` or empty value (`null`) to skip firewall configuration.
ovirt_engine_setup_require_rollback	UNDEF	If `True`, setup will require to be able to rollback new packages in case of a failure. If not specified, the default answer from `engine-setup` will be used. Valid for updating/upgrading.
ovirt_engine_setup_admin_password	UNDEF	Password for the automatically created administrative user of the oVirt Engine.
ovirt_engine_setup_wait_running_tasks	False	If `True`, engine-setup will wait for running tasks to finish. Valid for `ovirt_engine_setup_version` >= 4.2.
ovirt_engine_cinderlib_enable	False	If `True`, cinderlib is enabled. Valid for `ovirt_engine_setup_version` >= 4.3.
ovirt_engine_grafana_enable	True	If `True`, Grafana integration will be set up. Valid for `ovirt_engine_setup_version` >= 4.4.
ovirt_engine_setup_engine_configs	[]	List of dictionaries with keys `key`, `value` and `version`. The engine-config will be called with parametrs "-s `key`=`value`" when specified `version` it will append "--cver=`version`" to the config.

Engine Database:

Name	Default value	Description
ovirt_engine_setup_db_host	localhost	IP address or host name of a PostgreSQL server for Engine database. By default the database will be configured on the same host as the Engine.
ovirt_engine_setup_db_port	5432	Engine database port.
ovirt_engine_setup_db_name	engine	Engine database name.
ovirt_engine_setup_db_user	engine	Engine database user.
ovirt_engine_setup_db_password	UNDEF	Engine database password.
ovirt_engine_setup_engine_vacuum_full	False	Used only when upgrading. If `True`, engine database vacuum will be performed before upgrade.

Engine Data Warehouse Database:

Name	Default value	Description
ovirt_engine_setup_dwh_db_configure	True	If `True`, the DWH Database will be configured manually.
ovirt_engine_setup_dwh_db_host	localhost	IP address or host name of a PostgreSQL server for DWH database. By default the DWH database will be configured on the same host as the Engine.
ovirt_engine_setup_dwh_db_port	5432	DWH database port.
ovirt_engine_setup_dwh_db_name	ovirt_engine_history	DWH database name.
ovirt_engine_setup_dwh_db_user	ovirt_engine_history	DWH database user.
ovirt_engine_setup_dwh_db_password	UNDEF	DWH database password.
ovirt_engine_setup_dwh_vacuum_full	False	Used only when upgrading. If `True`, DWH databse vacuum will be performed before upgrade.

OVN related options:

Name	Default value	Description
ovirt_engine_setup_provider_ovn_configure	True	If `True`, OVN provider will be configured. Valid for `ovirt_engine_setup_version` >= 4.2.
ovirt_engine_setup_provider_ovn_username	admin@internal	Username for OVN.
ovirt_engine_setup_provider_ovn_password	UNDEF	Password for OVN.

Apache related options:

Name	Default value	Description
ovirt_engine_setup_apache_config_root_redirection	True	If `True`, `engine-setup` will configure the default page in Apache to automatically redirect clients to ovirt-engine default page.
ovirt_engine_setup_apache_config_ssl	True	If `False`, `engine-setup` will not configure Apache SSL settings and administrators will need to configure it manually.

Dependencies

None

Example Playbook

---
# Example of oVirt setup:
- name: Setup oVirt
  hosts: engine
  vars_files:
    # Contains encrypted `ovirt_engine_setup_admin_password` variable using ansible-vault
    - passwords.yml
  vars:
    ovirt_engine_setup_version: '4.2'
    ovirt_engine_setup_organization: 'of.ovirt.engine.com'
  roles:
    - ovirt.engine-setup


# Example of RHV setup:
- name: Setup RHV
  hosts: engine
  vars_files:
    # Contains encrypted `ovirt_engine_setup_admin_password` variable using ansible-vault
    - passwords.yml
  vars:
    ovirt_engine_setup_version: '4.2'
    ovirt_engine_setup_organization: 'rhv.redhat.com'
    ovirt_engine_setup_product_type: 'rhv'
  roles:
    - ovirt.engine-setup


# Example of oVirt setup with engine_configs:
- name: Setup oVirt
  hosts: engine
  vars_files:
    # Contains encrypted `ovirt_engine_setup_admin_password` variable using ansible-vault
    - passwords.yml
  vars:
    ovirt_engine_setup_version: '4.4'
    ovirt_engine_setup_organization: 'of.ovirt.engine.com'
    ovirt_engine_setup_engine_configs:
      - key: SpiceProxyDefault
        value: prot://proxy
        version: general

  roles:
    - ovirt.engine-setup


# Example of oVirt engine restore from file with cleanup engine before:
- name: restore oVirt engine
  hosts: engine
  vars_files:
    # Contains encrypted `ovirt_engine_setup_admin_password` variable using ansible-vault
    - passwords.yml
  vars:
    ovirt_engine_setup_version: '4.4'
    ovirt_engine_setup_organization: 'of.ovirt.engine.com'
    ovirt_engine_setup_restore_engine_cleanup: true
    ovirt_engine_setup_restore_file: '/path/to/backup.file'
    ovirt_engine_setup_restore_scopes:
      - 'files'
      - 'db'
    ovirt_engine_setup_restore_options:
      log: '/path/to/file.log'
      restore-permissions: ''
      provision-all-databases: ''

  roles:
    - ovirt.engine-setup

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

README.md

README.md

oVirt Engine Setup

This role has been migrated to oVirt Ansible Collection, please use latest version from there. This repository is now readonly and no longer used for active development

Note

Target Systems

Requirements

Role Variables

Dependencies

Example Playbook

Files

README.md

Latest commit

History

README.md

File metadata and controls

oVirt Engine Setup

This role has been migrated to oVirt Ansible Collection, please use latest version from there. This repository is now readonly and no longer used for active development

Note

Target Systems

Requirements

Role Variables

Dependencies

Example Playbook