Chapter 2. Setting Up the Red Hat Virtualization Manager and Hosts

Prerequisites

Install a 4.2 environment as described in the Installation Guide or Self-Hosted Installation Guide, depending on your environment. Alternatively, upgrade your 4.x environment to 4.2.

2.1. Copying OpenShift Ansible Files

  1. On the Manager machine, copy /etc/ovirt-engine-metrics/config.yml.example to config.yml: 

    # cp /etc/ovirt-engine-metrics/config.yml.example /etc/ovirt-engine-metrics/config.yml

  2. Update the values of /etc/ovirt-engine-metrics/config.yml to match the details of your specific environment: 

    # vi /etc/ovirt-engine-metrics/config.yml
    Important

    All parameters are mandatory.

    Table 2.1. config.yml Parameters

    NameDefault ValueDescription

    ovirt_env_name

    Yes

    The environment name. This is used to identify data collected from the Manager for this Red Hat Virtualization environment.

    Use the following conventions:

    • Include only alphanumeric characters and hyphens ( "-" ).
    • The name cannot begin with a hyphen or a number, or end with a hyphen.
    • A maximum of 49 characters can be used.
    • Wildcard patterns (for example, ovirt-metrics) cannot be used.

    fluentd_elasticsearch_host

    No

    The address or FQDN of the Elasticsearch server host.

  3. Copy the Manager’s public key to your Metrics Store machine: 

    # mytemp=$(mktemp -d)

# cp /etc/pki/ovirt-engine/keys/engine_id_rsa $mytemp

# ssh-keygen -y -f $mytemp/engine_id_rsa > $mytemp/engine_id_rsa.pub

# ssh-copy-id -i $mytemp/engine_id_rsa.pub root@fluentd_elasticsearch_host

    It should ask for root password (on first attempt), supply it. After that, run: 

    # rm -rf $mytemp

    To test that you are able to log into the metrics store machine from the engine, run: 

    # ssh -i /etc/pki/ovirt-engine/keys/engine_id_rsa root@fluentd_elasticsearch_host

  4. As the root user, run the Ansible script that generates the Ansible inventory and vars.yaml files and copies them to the Metrics Store machine (by default to / (root)): 

    # /usr/share/ovirt-engine-metrics/setup/ansible/configure_ovirt_machines_for_metrics.sh \
--playbook=ovirt-metrics-store-installation.yml