Red Hat Enterprise Virtualization - Extractor service


The Red Hat Enterprise Virtualization - Extractor service  ETL imports data from a Red Hat Enterprise Virtualization (RHEV) environment using the REST API exposed by the RHEV Manager.

TrueSight Capacity Optimization supports Red Hat Enterprise Virtualization versions 3.3, 3.4, 3.5, 4.0, and 4.1.

Imported entities

For information on imported entities for the following entity types, see:

Legend:

Datacenter - RHEV

Storage Cluster - RHEV

Storage Domain - RHEV

Storage Host - RHEV

Virtual Cluster - RHEV

Virtual Host - KVM

Virtual Machine - KVM

Note

The RHEV ETL displays the data from the Physical View of a system, whereas, the Agent displays the data from the Virtual View of the same system.

Relationships

The following table indicates the type of relationship between primary and secondary entity types:

Primary Entity Type

Secondary Entity Type

Relationship type

Comment

Datacenter - RHEV

Virtual Cluster - RHEV

DC_CONTAINS_VHC

 

Datacenter - RHEV

Storage Domain - RHEV

DC_CONTAINS_SD

Grouped in the "Storage Domains" folder

Virtual Cluster - RHEV

Virtual Host - KVM

VHC_CONTAINS_VH

Grouped in the "Virtual Hosts" folder

Virtual Cluster - RHEV

Virtual Machine - KVM

VHC_CONTAINS_GM

Grouped in the "Virtual Machines" folder

Storage Cluster - RHEV

Storage Host - RHEV

SHC_CONTAINS_SH

Grouped in the "Storage Hosts" folder

Virtual Host - KVM

Virtual Machine - KVM

VH_CONTAINS_GM

Hidden in the tree

Integration steps

To integrate TrueSight Capacity Optimization with the CSV columnar file parser, perform the following task:

  1. Navigate to Administration >  ETL & SYSTEM TASKS > ETL tasks.
  2. In the ETL tasks page, click Add > Add ETL under the Last run tab.
  3. In the Add ETL page, set values for the following properties under each expandable tab. 

    Note

    Basic properties are displayed by default in the Add ETL page. These are the most common properties that you can set for an ETL, and it is acceptable to leave the default selections for each as is. Click Add run configuration.

    Basic properties

    Note

    To view or configure Advanced properties, click Advanced. You do not need to set or modify these properties unless you want to change the way the ETL works. These properties are for advanced users and scenarios only.

    Advanced properties

  4. Click Save.
    You return to the Last run tab under the ETL tasks page.
  5. Validate the results in simulation mode: In the ETL tasks table under ETL tasks > Last run, locate your ETL (ETL task name), click run_etl.png to run the ETL.
    After you run the ETL, the Last exit column in the ETL tasks table will display one of the following values:
    • OK: The ETL executed without any error in simulation mode.
    • WARNING: The ETL execution returned some warnings in simulation mode. Check the ETL log.
    • ERROR: The ETL execution returned errors and was unsuccessful. Edit the active Run configuration and try again.
    • FAILED: The ETL execution failed.
    • ENDED:  The ETL execution ended
    • KILLED: The ETL execution was abruptly terminated using the Kill command.
  6. Switch the ETL to production mode: To do this, perform the following task:
    1. In the ETL tasks table under ETL tasks > Last run, click the ETL under the Name column.
    2. In the Run configurations table in the ETL details page, click edit icon.png to edit the active run configuration.
    3. In the Edit run configuration page, navigate to the Run configuration expandable tab and set Execute in simulation mode to No.
    4. Click Save.
  7. Locate the ETL in the ETL tasks table and click run_etl.png to Run it (Start active run configuration).
    After you run the ETL, it will extract the data form the source and transfer it to the TrueSight Capacity Optimization database.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*