Red Hat Training

A Red Hat training course is available for Red Hat Virtualization

2.8. Configuration History Views

To query a configuration view, run SELECT * FROM view_name;. For example: 
# SELECT * FROM v4_0_configuration_history_datacenters;
To list all available views, run: 
# \dv

Note

delete_date does not appear in latest views because these views provide the latest configuration of living entities, which, by definition, have not been deleted.

2.8.1. Data Center Configuration

The following table shows the configuration history parameters of the data centers in the system.

Table 2.8. v4_0_configuration_history_datacenters

Name Type Description
history_id integer The ID of the configuration version in the history database.
datacenter_id uuid The unique ID of the data center in the system.
datacenter_name character varying(40) Name of the data center, as displayed in the edit dialog.
datacenter_description character varying(4000) Description of the data center, as displayed in the edit dialog.
is_local_storage boolean A flag to indicate whether the data center uses local storage.
create_date timestamp with time zone The date this entity was added to the system.
update_date timestamp with time zone The date this entity was changed in the system.
delete_date timestamp with time zone The date this entity was deleted from the system.

2.8.2. Datacenter Storage Domain Map

The following table shows the relationships between storage domains and data centers in the system.

Table 2.9. v4_0_map_history_datacenters_storage_domains

Name Type Description
history_id integer The ID of the configuration version in the history database.
storage_domain_id uuid The unique ID of this storage domain in the system.
datacenter_id uuid The unique ID of the data center in the system.
attach_date timestamp with time zone The date the storage domain was attached to the data center.
detach_date timestamp with time zone The date the storage domain was detached from the data center.

2.8.3. Storage Domain Configuration

The following table shows the configuration history parameters of the storage domains in the system.

Table 2.10. v4_0_configuration_history_storage_domains

Name Type Description
history_id integer The ID of the configuration version in the history database.
storage_domain_id uuid The unique ID of this storage domain in the system.
storage_domain_name character varying(250) Storage domain name.
storage_domain_type smallint
  • 0 - Data (Master)
  • 1 - Data
  • 2 - ISO
  • 3 - Export
storage_type smallint
  • 0 - Unknown
  • 1 - NFS
  • 2 - FCP
  • 3 - iSCSI
  • 4 - Local
  • 6 - All
create_date timestamp with time zone The date this entity was added to the system.
update_date timestamp with time zone The date this entity was changed in the system.
delete_date timestamp with time zone The date this entity was deleted from the system.

2.8.4. Cluster Configuration

The following table shows the configuration history parameters of the clusters in the system.

Table 2.11. v4_0_configuration_history_clusters

Name Type Description
history_id integer The ID of the configuration version in the history database.
cluster_id uuid The unique identifier of the datacenter this cluster resides in.
cluster_name character varying(40) Name of the cluster, as displayed in the edit dialog.
cluster_description character varying(4000) As defined in the edit dialog.
datacenter_id uuid The unique identifier of the datacenter this cluster resides in.
cpu_name character varying(255) As displayed in the edit dialog.
compatibility_version character varying(40) As displayed in the edit dialog.
datacenter_configuration_version integer The data center configuration version at the time of creation or update.
create_date timestamp with time zone The date this entity was added to the system.
update_date timestamp with time zone The date this entity was changed in the system.
delete_date timestamp with time zone The date this entity was deleted from the system.

2.8.5. Host Configuration

The following table shows the configuration history parameters of the hosts in the system.

Table 2.12. v4_0_configuration_history_hosts

Name Type Description
history_id integer The ID of the configuration version in the history database.
host_id uuid The unique ID of the host in the system.
host_unique_id character varying(128) This field is a combination of the host's physical UUID and one of its MAC addresses, and is used to detect hosts already registered in the system.
host_name character varying(255) Name of the host (same as in the edit dialog).
cluster_id uuid The unique ID of the cluster that this host belongs to.
host_type smallint
  • 0 - RHEL Host
  • 2 - RHEV Hypervisor Node
fqdn_or_ip character varying(255) The host's DNS name or its IP address for Red Hat Virtualization Manager to communicate with (as displayed in the edit dialog).
memory_size_mb integer The host's physical memory capacity, expressed in megabytes (MB).
swap_size_mb integer The host swap partition size.
cpu_model character varying(255) The host's CPU model.
number_of_cores smallint Total number of CPU cores in the host.
number_of_sockets smallint Total number of CPU sockets.
cpu_speed_mh numeric(18,0) The host's CPU speed, expressed in megahertz (MHz).
host_os character varying(255) The host's operating system version.
kernel_version character varying(255) The host's kernel version.
kvm_version character varying(255) The host's KVM version.
vdsm_version character varying The host's VDSM version.
vdsm_port integer As displayed in the edit dialog.
threads_per_core smallint Total number of threads per core.
hardware_manufacturer character varying(255) The host's hardware manufacturer.
hardware_product_name character varying(255) The product name of the host's hardware.
hardware_version character varying(255) The version of the host's hardware.
hardware_serial_number character varying(255) The serial number of the host's hardware.
cluster_configuration_version integer The cluster configuration version at the time of creation or update.
create_date timestamp with time zone The date this entity was added to the system.
update_date timestamp with time zone The date this entity was changed in the system.
delete_date timestamp with time zone The date this entity was deleted from the system.

2.8.6. Host Interface Configuration

The following table shows the configuration history parameters of the host interfaces in the system.

Table 2.13. v4_0_configuration_history_hosts_interfaces

Name Type Description
history_id integer The ID of the configuration version in the history database.
host_interface_id uuid The unique ID of this interface in the system.
host_interface_name character varying(50) The interface name as reported by the host.
host_id uuid Unique ID of the host this interface belongs to.
host_interface_type smallint
  • 0 - rt18139_pv
  • 1 - rt18139
  • 2 - e1000
  • 3 - pv
host_interface_speed_bps integer The interface speed in bits per second.
mac_address character varying(59) The interface MAC address.
logical_network_name character varying(50) The logical network associated with the interface.
ip_address character varying(20) As displayed in the edit dialog.
gateway character varying(20) As displayed in the edit dialog.
bond boolean A flag to indicate if this interface is a bonded interface.
bond_name character varying(50) The name of the bond this interface is part of (if it is part of a bond).
vlan_id integer As displayed in the edit dialog.
host_configuration_version integer The host configuration version at the time of creation or update.
create_date timestamp with time zone The date this entity was added to the system.
update_date timestamp with time zone The date this entity was changed in the system.
delete_date timestamp with time zone The date this entity was deleted from the system.

2.8.7. Virtual Machine Configuration

The following table shows the configuration history parameters of the virtual machines in the system.

Table 2.14. v4_0_configuration_history_vms

Name Type Description
history_id integer The ID of the configuration version in the history database.
vm_id uuid The unique ID of this virtual machine in the system.
vm_name character varying(255) The name of the virtual machine.
vm_description character varying(4000) As displayed in the edit dialog.
vm_type smallint
  • 0 - Desktop
  • 1 - Server
cluster_id uuid The unique ID of the cluster this virtual machine belongs to.
template_id uuid The unique ID of the template this virtual machine is derived from. The field is for future use, as the templates are not synchronized to the history database in this version.
template_name character varying(40) Name of the template from which this virtual machine is derived.
cpu_per_socket smallint Virtual CPUs per socket.
number_of_sockets smallint Total number of virtual CPU sockets.
memory_size_mb integer Total memory allocated to the virtual machine, expressed in megabytes (MB).
operating_system smallint
  • 0 - Other OS
  • 1 - Windows XP
  • 3 - Windows 2003
  • 4 - Windows 2008
  • 5 - Linux
  • 7 - Red Hat Enterprise Linux 5.x
  • 8 - Red Hat Enterprise Linux 4.x
  • 9 - Red Hat Enterprise Linux 3.x
  • 10 - Windows 2003 x64
  • 11 - Windows 7
  • 12 - Windows 7 x64
  • 13 - Red Hat Enterprise Linux 5.x x64
  • 14 - Red Hat Enterprise Linux 4.x x64
  • 15 - Red Hat Enterprise Linux 3.x x64
  • 16 - Windows 2008 x64
  • 17 - Windows 2008 R2 x64
  • 18 - Red Hat Enterprise Linux 6.x
  • 19 - Red Hat Enterprise Linux 6.x x64
  • 20 - Windows 8
  • 21 - Windows 8 x64
  • 23 - Windows 2012 x64
  • 1001 - Other
  • 1002 - Linux
  • 1003 - Red Hat Enterprise Linux 6.x
  • 1004 - SUSE Linux Enterprise Server 11
  • 1193 - SUSE Linux Enterprise Server 11
  • 1252 - Ubuntu Precise Pangolin LTS
  • 1253 - Ubuntu Quantal Quetzal
  • 1254 - Ubuntu Raring Ringtails
  • 1255 - Ubuntu Saucy Salamander
default_host uuid As displayed in the edit dialog, the ID of the default host in the system.
high_availability boolean As displayed in the edit dialog.
initialized boolean A flag to indicate if this virtual machine was started at least once for Sysprep initialization purposes.
stateless boolean As displayed in the edit dialog.
fail_back boolean As displayed in the edit dialog.
usb_policy smallint As displayed in the edit dialog.
time_zone character varying(40) As displayed in the edit dialog.
vm_pool_id uuid The ID of the pool to which this virtual machine belongs.
vm_pool_name character varying(255) The name of the virtual machine's pool.
created_by_user_id uuid The ID of the user that created this virtual machine.
cluster_configuration_version integer The cluster configuration version at the time of creation or update.
default_host_configuration_version integer The host configuration version at the time of creation or update.
create_date timestamp with time zone The date this entity was added to the system.
update_date timestamp with time zone The date this entity was changed in the system.
delete_date timestamp with time zone The date this entity was deleted from the system.

2.8.8. Virtual Machine Interface Configuration

The following table shows the configuration history parameters of the virtual interfaces in the system.

Table 2.15. v4_0_configuration_history_vms_interfaces

Name Type Description
history_id integer The ID of the configuration version in the history database.
vm_interface_id uuid The unique ID of this interface in the system.
vm_interface_name character varying(50) As displayed in the edit dialog.
vm_interface_type smallint
The type of the virtual interface.
  • 0 - rt18139_pv
  • 1 - rt18139
  • 2 - e1000
  • 3 - pv
vm_interface_speed_bps integer The average speed of the interface during the aggregation in bits per second.
mac_address character varying(20) As displayed in the edit dialog.
logical_network_name character varying(50) As displayed in the edit dialog.
vm_configuration_version integer The virtual machine configuration version at the time of creation or update.
create_date timestamp with time zone The date this entity was added to the system.
update_date timestamp with time zone The date this entity was changed in the system.
delete_date timestamp with time zone The date this entity was deleted from the system.

2.8.9. Virtual Machine Device Configuration

The following table shows the relationships between virtual machines and their associated devices, including disks and virtual interfaces.

Table 2.16. v4_0_configuration_history_vms_devices

Name Type Description
history_id integer The ID of the configuration version in the history database.
vm_id uuid The unique ID of the virtual machine in the system.
device_id uuid The unique ID of the device in the system.
type character varying(30) The type of virtual machine device. This can be "disk" or "interface".
address character varying(255) The device's physical address.
is_managed boolean Flag that indicates if the device is managed by the Manager.
is_plugged boolean Flag that indicates if the device is plugged into the virtual machine.
is_readonly boolean Flag that indicates if the device is read only.
vm_configuration_version integer The virtual machine configuration version at the time the sample was taken.
device_configuration_version integer The device configuration version at the time the sample was taken.
create_date timestamp with time zone The date this entity was added to the system.
update_date timestamp with time zone The date this entity was added to the system.
delete_date timestamp with time zone The date this entity was added to the system.

2.8.10. Virtual Disk Configuration

The following table shows the configuration history parameters of the virtual disks in the system.

Table 2.17. v4_0_configuration_history_vms_disks

Name Type Description
history_id integer The ID of the configuration version in the history database.
vm_disk_id uuid The unique ID of this disk in the system.
vm_disk_name text The name of the virtual disk, as displayed in the edit dialog.
vm_disk_description character varying(500) As displayed in the edit dialog.
image_id uuid The unique ID of the image in the system.
storage_domain_id uuid The ID of the storage domain this disk image belongs to.
vm_disk_size_mb integer The defined size of the disk in megabytes (MB).
vm_disk_type smallint
As displayed in the edit dialog. Only System and Data are currently used.
  • 0 - Unassigned
  • 1 - System
  • 2 - Data
  • 3 - Shared
  • 4 - Swap
  • 5 - Temp
vm_disk_format smallint
As displayed in the edit dialog.
  • 3 - Unassigned
  • 4 - COW
  • 5 - RAW
is_shared boolean Flag that indicates if the virtual machine's disk is shared.
create_date timestamp with time zone The date this entity was added to the system.
update_date timestamp with time zone The date this entity was changed in the system.
delete_date timestamp with time zone The date this entity was deleted from the system.

2.8.11. User Details History

The following table shows the configuration history parameters of the users in the system.

Table 2.18. v4_0_users_details_history

Name Type Description
user_id uuid The unique ID of the user in the system, as generated by the Manager.
first_name character varying(255) The user's first name.
last_name character varying(255) The user's last name.
domain character varying(255) The name of the authorization extension.
username character varying(255) The account name.
department character varying(255) The organizational department the user belongs to.
user_role_title character varying(255) The title or role of the user within the organization.
email character varying(255) The email of the user in the organization.
external_id text The unique identifier of the user from the external system.
active boolean A flag to indicate if the user is active or not. This is checked hourly. If the user can be found in the authorization extension then it will remain active. A user becomes active on successful login.
create_date timestamp with time zone The date this entity was added to the system.
update_date timestamp with time zone The date this entity was changed in the system.
delete_date timestamp with time zone The date this entity was deleted from the system.