/ovirt-ansible-engine-setup

Install required packages for oVirt Engine deployment, generates answerfile and runs engine-setup with it.

Primary LanguageHTMLApache License 2.0Apache-2.0

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