Deploy ManageIQ in oVirt

Important Update

This role has moved to the oVirt Ansible Collection. Please use the latest version from that location. This repository is now readonly and not used for active development.

The ovirt.manageiq role downloads a ManageIQ/CloudForms QCOW image and sets it up in oVirt/Red Hat Virtualization (RHV).

This role helps you to create a virtual machine, attach the ManageIQ disk, wait for the ManageIQ system to start up, and register oVirt as an infrastructure provider.

Note

When installing this role from Ansible Galaxy, run the following command:

$ ansible-galaxy install ovirt.manageiq

This will download the role into a folder named ovirt.manageiq, as specified. Keep in mind that the name is case-sensitive. For example, if you use OVIRT.manageiq, it will download to a folder named OVIRT.manageiq, and you must always reference it with that name. Be careful with case when entering the role name.

For RPM installations, you can use any of these three names: oVirt.manageiq, ovirt.manageiq, or ovirt-manageiq. This documentation uses ovirt.manageiq. The other two names are deprecated.

Requirements

• oVirt version must be 4.0.4 or higher.
• Ansible version must be 2.9 or higher.
• ovirt-imageio should be installed and running.
• oVirt Python SDK version 4.

Additional checks:

• Verify if ovirt-imageio-proxy is running:

systemctl status ovirt-imageio-proxy

• Verify if ovirt-imageio-daemon is running on the hosts:

systemctl status ovirt-imageio-daemon

You will also need the CA certificate of the engine. Set the ovirt_ca variable with the path to this CA certificate.

Limitations

• This role does not support Ansible Check Mode (Dry Run), since it uses some modules that do not support it. This will change when all modules used by this role support it.

Role Variables

QCOW variables:

Engine login variables:

Virtual machine variables:

For more detailed variables regarding disks, network interfaces, and ManageIQ configurations, please refer to the full documentation.

Example Playbook

Make sure to use Ansible vault for password security.

Here’s an example to deploy ManageIQ:

---
- name: Deploy ManageIQ to oVirt engine
  hosts: localhost
  connection: local
  gather_facts: false

  vars_files:
    - passwords.yml  # Contains secured passwords

  vars:
    engine_fqdn: ovirt.example.com
    engine_user: admin@internal
    engine_cafile: /etc/pki/ovirt-engine/ca.pem

    miq_qcow_url: http://releases.manageiq.org/manageiq-ovirt-hammer-6.qc2
    miq_vm_name: manageiq_hammer6
    miq_vm_cluster: mycluster

    metrics_fqdn: metrics.example.com
    metrics_port: 8443
    metrics_user: admin

  roles:
    - ovirt.manageiq

Follow these examples to deploy ManageIQ effectively in your environment!