Chapter 2. Installing Metrics Store

Prerequisites

2.1. Create the Metrics Store virtual machines

To create the Metrics Store virtual machines, perform the following tasks:

  1. Configure the Metrics Store installation.
  2. Create the following Metrics Store virtual machines:

    • The Metrics Store Installer virtual machine - a temporary virtual machine for deploying Red Hat OpenShift and services on the Metrics Store virtual machines.
    • One or more Metrics Store virtual machines.
  3. Verify the Metrics Store virtual machines.

Configure the Metrics Store installation

  1. Log in to the Manager machine using SSH.
  2. Update the packages:

    # yum update
  3. Copy metrics-store-config.yml.example to create metrics-store-config.yml:

    # cp /etc/ovirt-engine-metrics/metrics-store-config.yml.example /etc/ovirt-engine-metrics/config.yml.d/metrics-store-config.yml
  4. Edit the parameters in metrics-store-config.yml to match your installation environment, and save the file. The parameters are documented in the file.
  5. To set the logical network that is used for the metrics-store-installer and Metrics Store virtual machines, add the following lines to metrics-store-config.yml:

    # ovirt_template_nics - the following are the default values for setting the logical network used by the metrics_store_installer and the Metrics Store virtual machines
    ovirt_template_nics:
      - name: nic1
        profile_name: ovirtmgmt
        interface: virtio
  6. On the Manager machine, copy /etc/ovirt-engine-metrics/secure_vars.yaml.example to /etc/ovirt-engine-metrics/secure_vars.yaml:

    # cp /etc/ovirt-engine-metrics/secure_vars.yaml.example /etc/ovirt-engine-metrics/secure_vars.yaml
  7. Edit the parameters in /etc/ovirt-engine-metrics/secure_vars.yaml to match the details of your specific environment.
  8. Encrypt the secure_vars.yaml file:

    # ansible-vault encrypt /etc/ovirt-engine-metrics/secure_vars.yaml

Create Metrics Store virtual machines

  1. Go to the ovirt-engine-metrics directory:

    # cd /usr/share/ovirt-engine-metrics
  2. Run the ovirt-metrics-store-installation playbook to create the virtual machines:

    # ANSIBLE_JINJA2_EXTENSIONS="jinja2.ext.do" ./configure_ovirt_machines_for_metrics.sh --playbook=ovirt-metrics-store-installation.yml --ask-vault-pass
    Note

    To enable verbose mode for debugging, add -vvv to the end of the command, or add '-v' to enable light verbose mode, or add -vvvv to enable connection debugging. For more extensive debugging options, enable debugging through the Ansible playbook as described in Enable debugging via Ansible playbook

Verify the creation of the virtual machines

  1. Log in to the Administration Portal.
  2. Click ComputeVirtual Machines to verify that the metrics-store-installer virtual machine and the Metrics Store virtual machines are running.

2.2. Configure networking for Metrics Store virtual machines

Network configuration prerequisites

  • In the metrics-store-config.yml DNS zone parameter, public_hosted_zone should be defined as a wildcard DNS record (*.example.com). That wildcard DNS should resolve to the IP address of your master0 virtual machine.
  • Add the hostnames of the Metrics Store virtual machines to your DNS server.

Set a static MAC address for a Metrics Store virtual machine (optional)

  1. Log in to the Administration Portal.
  2. Click ComputeVirtual Machines and select a Metrics Store virtual machine.
  3. In the Network Interfaces tab, select a NIC and click Edit.
  4. Select Custom MAC Address, enter the MAC address, and click OK.
  5. Reboot the virtual machine.

Configure firewall ports

The following table describes the firewall settings needed for communication between the ports used by Metrics Store.

Table 2.1. Configure the firewall to allow connections to specific ports

IDPort(s)ProtocolSourcesDestinationsPurpose

MS1

9200

TCP

RHV Red Hat Virtualization Hosts
RHV Manager

Metrics Store VM

Transfer data to ElasticSearch.

MS2

5601

TCP

Kibana user

Metrics Store VM

Give users access to the Kibana web interface.

Note

Whether a connection is encrypted depends on how you deployed the software.

2.3. Deploy Metrics Store services on Red Hat OpenShift

Deploy and verify Red Hat OpenShift, Elasticsearch, Curator (for managing Elasticsearch indices and snapshots), and Kibana on the Metrics Store virtual machines.

Procedure

  1. Log in to the metrics-store-installer virtual machine.
  2. Run the install_okd playbook to deploy Red Hat OpenShift and Metrics Store services to the Metrics Store virtual machines:

    # ANSIBLE_CONFIG="/usr/share/ansible/openshift-ansible/ansible.cfg" \
      ANSIBLE_ROLES_PATH="/usr/share/ansible/roles/:/usr/share/ansible/openshift-ansible/roles" \
      ansible-playbook -i integ.ini install_okd.yaml -e @vars.yaml -e @secure_vars.yaml --ask-vault-pass
    Note

    To enable verbose mode for debugging, add -vvv to the end of the command, or add '-v' to enable light verbose mode, or add -vvvv to enable connection debugging.

  3. Verify the deployment by logging in to each Metrics Store virtual machine:

    1. Log in to the openshift-logging project:

      # oc project openshift-logging
    2. Check that the Elasticsearch, Curator, and Kibana pods are running:

      # oc get pods

      If Elasticsearch is not running, see Troubleshooting related to ElasticSearch in the OpenShift Container Platform 3.11 documentation.

  4. Check the Kibana host name and record it so you can access the Kibana console in Chapter 4, Verify the Metrics Store installation:

    # oc get routes

Cleanup

  1. Log in to the Administration Portal.
  2. Click ComputeVirtual Machines and delete the metrics-store-installer virtual machine.