Chapter 3. Virtual Machines
The heterogeneous virtual machine container and guest support combined with the ability to analyze information inside the virtual machine - such as disk space, patch level or installed applications - provides in-depth information across the virtual environment. This rich set of information enables Red Hat CloudForms users to improve problem resolution times and effectively manage virtual machines.
The Virtual Machines pages display all virtual machines that were discovered by your server. Note that if you have applied a filter to a user, it will be in effect here. The Virtual Machines taskbar is a menu driven set of buttons that provide access to functions related to virtual machines.
- History button
- Refresh screen button
- Taskbar
- Name search bar/Advanced Search button
- View buttons
- Download buttons
- Navigation bar
- Sort dropdown
- Main area in Grid View
- Provider/Filter Navigation
The console uses Virtual Thumbnails to describe virtual machines and templates. Each thumbnail contains four quadrants by default. This allows you to glance at a virtual machine for a quick view of its contents.
- Top left quadrant: Operating system of the Virtual Machine
- Bottom left quadrant: Virtual Machine Hosts software
- Top right quadrant: Power state of Virtual Machine or Status icon
- Bottom right quadrant: Number of Snapshots for this Virtual Machine
Icon | Description |
---|---|
| Template: Virtual Template |
| Retired: When a virtual machine or instance is no longer required, it can be retired. Once a virtual machine or instance reaches its retirement date, it is immediately shut down and not allowed to restart. If an attempt to restart is made, Red Hat CloudForms will shut down the virtual machine or instance. |
| Archived: An archived virtual machine has no host or datastore associated with it. Archiving is done to move virtual machines to a low cost storage, either on demand or during retirement, if requested, to avoid incurring extra cost on a virtualized infrastructure due to virtual machine sprawl. |
| Orphaned: An orphaned virtual machine has no host but has a datastore associated with it. Orphaned virtual machines are those that have been removed from their providers but still exist on the storage. An orphaned virtual machine is unable to identify the associated host. A virtual machine also shows as orphaned if it exists on a different host than the host expected by the provider’s server. |
| Disconnected: A disconnected virtual machine is one that has lost connection to either the provider’s storage, host, or both. A disconnect is usually a result of network issues on the provider side. For instance, if during virtual machine provisioning the storage is not set up or deleted, the virtual machine will still exist on the provider, but will not run on the host as it has lost connection to its provider’s storage. |
| On: Virtual Machine is powered on. |
| Off: Virtual Machine is powered off. |
| Suspended: Virtual Machine has been suspended. |
The Virtual Machines page has three accordions organizing your virtual machines and templates in different ways. All of these accordions share a set of common controls:
- Use VMs and Templates to view your virtual machines and templates organized by Provider. In addition, you can see archived and orphaned items here.
- Use VMs to view, apply filters, and collect information about all of your virtual machines.
- Use Templates to view, apply filters, and collect information about all of your templates.
Through the console, you are able to view your virtual machines in multiple ways. For your virtual machines, you can:
- Filter virtual machines
- Change views
- Sort
- Create a report
- Search by MyTags
- Search by collected data
3.1. Filtering Virtual Machines and Templates
The Virtual Machine Filter accordion is provided so that you can easily navigate through groups of virtual machines. You can use the ones provided or create your own through Advanced Filtering capabilities.
- Navigate to → → .
- Go to the VMs or Templates accordion.
- Click on the desired filter from the left pane.
3.1.1. Creating a Virtual Machine or Template Filter
- Navigate to → → .
- Go to the VMs or Templates accordion.
-
Click All VMs or All Templates, then click
(Advanced Search) to open the expression editor.
Use the expression editor to choose the appropriate options for your criteria. Based on what you choose, different options will show.
- For all of the types of searches, you have the options of creating an alias and requested user input. Select Use Alias to create a user friendly name for the search. If you are requested user input for the search, this text will show in the dialog box where the input is requested.
Click Field to create criteria based on field values.
Click Count of to create criteria based on the count of something, such as the number of snapshots for a virtual machine, or the number of virtual machines on a host.
Click Tag to create criteria based on tags assigned to your virtual infrastructure, such as for power states or production tagging.
Click Registry to create criteria based on registry values, such as the DCOM status of a Windows system. Note this criteria applies only to Windows operating systems.
Click Find to seek a particular value, and then check a property.
-
Click
(Commit Expression Element Changes) to add the expression.
- Click Save.
- Type in a name for the search expression in Save this VM search as. (Note that this title depends on the type of resource you are searching.) To set the filter to show globally, check Global search.
- Click Save.
The filter is saved and will show in the My Filters area of the Filter accordion. If you checked Global search, the filter will show under Global Filters.
3.1.2. Loading a Report Filter or Search Expression
- Navigate to → → .
- Click the accordion for the items to search either VMs or Templates.
-
Click
(Advanced Search) to open the expression editor.
- Click Load.
Select either a saved virtual machine search or a virtual machine report filter.
NoteThe set of items to select will depend on the type of resource you are searching.
- Click Load to load the search expression.
If you want to edit the expression, click on it and make any edits for the current expression.
-
Click
(Commit expression element changes) to add the changes.
-
Click
(Undo the previous change) to remove the change you just made.
-
Click
(Redo the previous change) to put the change that you just made back.
-
Click
(AND with a new expression element) to create a logical AND with a new expression element.
-
Click
(OR with a new expression element) to create a logical OR with a new expression element.
-
Click
(Wrap this expression element with a NOT) to create a logical NOT on an expression element or to exclude all the items that match the expression.
-
Click
(Remove this expression element) to take out the current expression element.
-
Click
- Click Load.
- Click Apply.
3.2. Changing Views for Virtual Machines and Templates
While you can set the default view for different pages from the settings menu, then
→ → , the current view can also be controlled from the Virtual Machines pages.- Navigate to → → .
- Click the accordion for the items to view.
Click the appropriate button for the desired view.
-
Click
for Grid View.
-
Click
for Tile View.
-
Click
for List View.
-
Click
3.3. Sorting Virtual Machines and Templates
Virtual machines and templates can be sorted by Name, Cluster, Host, Datastore, Compliance, Last Analysis Time, Total Snapshots, or Region.
- Navigate to → → .
- Click the accordion for the items to sort.
To sort virtual machines or templates when in grid or tile view:
- From the Sort by dropdown, click the attribute to sort.
To sort virtual machines or templates when in list view:
- Select the List View.
- Click on the Column Name to sort. For example, click on Cluster to sort by the name of the cluster.
3.4. Creating a Virtual Machine or Template Report
For a listing of virtual machines and templates, you can create a quick report in CSV, TXT, or PDF formats.
- Navigate to → → .
- Click the accordion for the items for report creation.
Click
(Download).
-
Click
for a TXT file.
-
Click
for a CSV file.
-
Click
for a PDF file.
-
Click
3.5. Searching for Virtual Machines or Templates
To the right of the taskbar on the Virtual Machines page, you can enter names or parts of names for searching. You can search in the following ways:
-
Type characters that are included in the name. For example, if you type
sp1
, all Virtual Machines whose names includesp1
appear, such asWindows2003sp1
andSp1clone
. -
Use
*
at the end of a term to search for names that begin with specific characters. For example, typev*
to find all virtual machines whose names begin with the letterv
. -
Use
\*
at the beginning of a term to search for names that end with specific characters. For example, type*sp2
to find all virtual machines whose names end withsp2
. - Erase all characters from the search box to go back to viewing all virtual machines.
Search for virtual machines or templates:
- Navigate to → → .
Click the accordion for the items to search.
- In the Name Filter bar in the upper right corner of the window, type your criteria.
-
Click
(Search by Name within results) or press Enter.
- Type in other criteria to filter on what is currently displayed.
-
Click
(Search by Name within results) or press Enter.
3.6. Analyzing Virtual Machines and Templates
Analyze a virtual machine to collect metadata such as user accounts, applications, software patches, and other internal information. If Red Hat CloudForms is not set up for automatic analysis, perform a manual analysis of a virtual machine. To perform a SmartState analysis, Red Hat CloudForms requires a running SmartProxy with visibility to the virtual machine’s storage location. If the virtual machine is associated with a host or provider, ensure the virtual machine is registered with that system to be properly analyzed; the server requires this information since a snapshot might be created.
SmartState Analysis of a virtual machine requires access to its host. To perform a successful analysis, edit the virtual machine’s host and enter the host’s authentication credentials.
- Navigate to → → .
- Click the accordion for the items to analyze.
- Check the Virtual Machines and Templates to analyze.
-
Click
(Configuration), then
(Perform SmartState Analysis).
- Click OK.
3.6.1. Red Hat Enterprise Virtualization Prerequisites
3.6.1.1. SmartState Analysis on Red Hat Enterprise Virtualization Manager 3.1 and Above - Storage Support Notes
Note the following requirements when performing SmartState Analysis on Red Hat Enterprise Virtualization Manager 3.1 and above.
NFS
- The Red Hat CloudForms appliance requires a mount to the NFS datastore.
iSCSI / FCP
- For Red Hat Enterprise Virtualization 3.1 and 3.2, clusters must use full Red Hat Enterprise Linux hosts and not Red Hat Enterprise Virtualization Hypervisor hosts. You can use either type of host in Red Hat Enterprise Virtualization 3.3 and above.
- Each Red Hat CloudForms appliance performing SmartState Analysis requires sharable, non-bootable DirectLUN access to each attached iSCSI/FCP storage domain. In order to perform smart analysis, the appliance must mount the data storage as a DirectLUN disk.
- A Red Hat CloudForms appliance must reside in each datacenter with the iSCSI / FCP storage type.
Other Notes
The Edit Management Engine Relationship option enables the VM SmartState Analysis job to determine the datacenter where a Red Hat CloudForms appliance is running and thus to identify what storage it has access to in a Red Hat Enterprise Virtualization environment.
- After setting up a Red Hat CloudForms appliance and performing a refresh of the provider, find the Red Hat CloudForms appliance in the Virtual Machine accordion list and view its summary screen.
- Click → .
- Select the server that relates to this instance of the Red Hat CloudForms appliance.
If you attach a DirectLUN disk after configuring the Red Hat CloudForms database, access the appliance in a terminal and run pvscan
to detect the DirectLUN disk. Alternatively, in Red Hat CloudForms 5.2.1 and above, you can restart the appliance to detect the disk automatically.
3.6.1.2. SmartState Analysis on Red Hat Enterprise Virtualization Manager 3.0 - Storage Support Notes
There are two additional steps required to perform a SmartState Analysis on Red Hat Enterprise Virtualization Manager 3.0 using iSCSI
or FCP
storage. NFS storage does not have these requirements.
Enable
DirectLUN
support for the host and Red Hat CloudForms appliance that performs the analysis.-
Enable
DirectLUN
on host. Enable
DirectLUN
on the Red Hat CloudForms appliance. To do this, edit the desired Red Hat Enterprise Virtualization storage and get theLUNID
value. Then, on the Red Hat CloudForms appliance virtual machine in the Red Hat Enterprise Virtualization user interface, right-click and select → and enter the following in the Custom Properties edit box:directlun=<LUN ID>:readonly
If you have multiple storage domains, separate them by a comma, similar to:
directlun=<LUN ID 1>:readonly,<LUN ID 2>:readonly,<LUN ID N>:readonly
NoteThe Red Hat CloudForms appliance must reside in the same data center as the storage you are trying to connect. If you have multiple data centers with
iSCSI
orFCP
storage, you need a Red Hat CloudForms appliance in each data center to support virtual machine scanning.
-
Enable
Set Server Relationship - This is required to allow the virtual machine SmartState analysis job to determine which data center a Red Hat CloudForms appliance is running and therefore identify what storage it has access to in a Red Hat Enterprise Virtualization environment.
- After setting up a Red Hat CloudForms appliance and performing a refresh of the Provider, find the Red Hat CloudForms appliance in the Virtual Machine accordion list and view its summary screen.
-
Click
(Configuration), and then
(Edit Server Relationship).
- Select the server that relates to this instance of the Red Hat CloudForms appliance.
3.6.2. VMware vSphere Prerequisites
3.6.2.1. Installing VMware VDDK on Red Hat CloudForms
Execution of SmartState Analysis on virtual machines within a VMware environment requires the Virtual Disk Development Kit (VDDK). Red Hat CloudForms supports VDDK 5.5.
Download VDDK 5.5 (
VMware-vix-disklib-5.5.0-1284542.x86_64.tar.gz
at the time of this writing) from the VMware website.NoteIf you do not already have a login ID to VMware, then you will need to create one. At the time of this writing, the file can be found by navigating to Automation Tools and SDKs, and select vSphere Virtual Disk Development Kit 5.5. Alternatively, find the file by searching for it using the Search on the VMware site.
→ → → . Expand-
Download and copy the
VMware-vix-disklib-5.5.0-1284542.x86_64.tar.gz
file to the/root
directory of the appliance. -
Start an
SSH
session into the appliance. Extract and install
VDDK 5.5
. using the following commands:# cd /root # tar -xvf VMware-vix-disklib-5.5.0-1284542.x86_64.tar.gz # cd vmware-vix-disklib-distrib # ./vmware-install.pl
Accept the defaults during the installation.
Installing VMware VIX DiskLib API. You must read and accept the VMware VIX DiskLib API End User License Agreement to continue. Press enter to display it. Do you accept? (yes/no) yes Thank you. What prefix do you want to use to install VMware VIX DiskLib API? The prefix is the root directory where the other folders such as man, bin, doc, lib, etc. will be placed. [/usr] [userinput]#(Press Enter)# The installation of VMware VIX DiskLib API 5.5.0 build-1284542 for Linux completed successfully. You can decide to remove this software from your system at any time by invoking the following command: "/usr/bin/vmware-uninstall-vix-disklib.pl". Enjoy, --the VMware team
Run
ldconfig
in order for Red Hat CloudForms to find the newly installed VDDK library.NoteUse the following command to verify the VDDK files are listed and accessible to the appliance:
# ldconfig -p | grep vix
- Restart the Red Hat CloudForms appliance.
The VDDK is now installed on the Red Hat CloudForms appliance. This enables use of the SmartState Analysis Server Role on the appliance.
3.7. Comparing Virtual Machines and Templates
The Red Hat CloudForms Server allows you to compare multiple virtual machines. This allows you to see how different virtual machines are from their original template. This helps detect missing patches, unmanaged user accounts, or unauthorized services.
Use the comparison feature to:
- Compare multiple virtual machines from different hosts.
- Compare multiple virtual machines side-by-side.
- Quickly see similarities and differences among multiple virtual machines and a base.
- Narrow the comparison display to categories of properties.
- Print or export in the comparison results to a PDF or CSV file.
Compare virtual machines and templates:
- Navigate to → → .
- Click the accordion for the items to analyze.
- Check the items to compare.
Click
, and then
. The comparison displays in a compressed view with a limited set of properties listed.
-
To delete an item from the comparison, click
at the bottom of the items column. This option is only available when comparing more than two virtual machines.
-
To view many items on one screen, go to a compressed view by clicking
. To return to an expanded view, click
.
To limit the mode of the view, there are two buttons in the task bar.
-
Click
to see all details for an attribute.
-
Click
to limit the view to if an attribute exists compared to the base or not. This only applies to attributes that can have a boolean property. For example, a user account exists or does not exist, or a piece of hardware that does or does not exist.
-
Click
- To change the base virtual machine that all the others are compared to, click its label at the top of its column.
- To go to the summary screen for a virtual machine, click its or icon.
3.7.1. Virtual Machine and Templates Comparison Sections
The following table describes the different sections for comparison information.
Section | Description |
---|---|
Properties | Use this section to see basic information on the file location of the virtual machine, its name, and the virtual machine monitor vendor. Hardware, disk, CD/DVD drives, floppy drive, network adapter, and volume information is also included. |
Security | Use this to see users and groups for the virtual machine, including those which may be unauthorized compared to a template. |
Configuration | Use this to see Guest Applications, Win32 services, Linux Init Processes, Kernel Drivers, File System Drivers, and Patches. |
My Company Tags | Use this to see all tags. |
3.7.2. Using the Virtual Machine Comparison Sections
Use the comparison sections to view various comparison data and display the data in different ways.
- On the left of a comparison screen, select what categories of properties to display.
- Click Apply.
- Click the plus sign next to the sections name to expand it.
The following descriptions pertain to the Expanded View
. Whether you see the value of a property or an icon representing the property depends on the properties type.
- A property displayed in the same color as the base means that the compared virtual machine matches the base for that property.
- A property displayed in a different color from the base means that the compared virtual machine does not match the base for that property.
If you are in the Compressed View
, the values of the properties will not be displayed. The icons shown below will describe all items.
-
A
(checkmark) means that the compared virtual machine matches the base for that property. If you hover over it, the value of the property will display.
-
A
(x) means that the compared virtual machine does not match the base for that property. If you hover over it, the value of the property will display.
-
A
- Click the minus sign next to the sections name to collapse it.
Your comparison can be viewed in multiple ways. Export the data or create a report from your comparison for analysis using external tools.
3.7.3. Creating a Virtual Machine Comparison Report
Output the data from a comparison report in TXT, CSV or PDF formats.
- Create the comparison for the report.
Click the output button for the chosen report type.
-
Click
(Download comparison report in TXT format) for a text file.
-
Click
(Download comparison report in CSV format) for a CSV file.
-
Click
(Download comparison report in PDF format) for a PDF file.
-
Click
3.8. Controlling the Power State of Red Hat Virtualization Virtual Machines
Follow this procedure to control the power states of Red Hat Virtualization VMs through the Red Hat CloudForms console.
- Navigate to → → .
- Click on a VM to change the power state.
Click Power Operations, then click the button for the desired power operation. Available operations will depend on the current power state of the VM.
-
Click
(Shutdown Guest) to shutdown the guest OS on the VM.
-
Click
(Restart Guest) to restart the guest OS on the VM.
-
Click
(Power On) to power on the VM.
-
Click
(Power Off) to power off the VM.
-
Click
(Suspend) to suspend the VM.
-
Click
- Click OK.
3.9. Refreshing Virtual Machines and Templates
Refresh your virtual machines to get the latest data the provider or host can access. This includes information such as the power state, container, and hardware devices attached to the virtual machine.
- Navigate to → → .
- Click the accordion for the items to analyze.
- Check the items to refresh.
-
Click
(Configuration), and then
(Refresh Relationships and Power States) on the Virtual Machine Taskbar.
The console returns a refreshed list of the data associated with the selected virtual machines.
3.10. Extracting Running Processes from Virtual Machines and Templates
Red Hat CloudForms can collect processes running on Windows virtual machines. To do this, enter domain credentials for the zone where the virtual machine is located.
For more information, see General Configuration.
The virtual machine must be running and must have an IP address in the VMDB, usually obtained from a SmartState Analysis.
- Navigate to → → .
- Check the Virtual Machines to collect the processes.
-
Click
(Configuration), and then
(Extract Running Processes) on the Taskbar.
- Click OK.
The server returns the running processes. View the summary of the virtual machine to see the details.
3.11. Setting Ownership for Virtual Machines and Templates
You can set the owner of a group of virtual machines and templates by either individual user or group. This allows you an additional way to filter and can be used to enforce quotas.
- Navigate to → → .
- Click the accordion for the items to change.
- Check the items to set ownership.
-
Click
(Configuration), and then
(Set Ownership) on the Virtual Machine Taskbar.
From the Select an Owner dropdown, select a user, and from the Select a Group dropdown, select a group.
- Click Save.
3.12. Removing Virtual Machines and Templates from the VMDB
If a virtual machine has been decommissioned or you need to perform some troubleshooting, you might need to remove a specific virtual machine from the VMDB. This does not however remove the virtual machine or template from its Datastore or Provider.
- Navigate to → → .
- Click the accordion for the items to remove.
- Check the items to remove.
-
Click
(Configuration), and then
(Remove from the VMDB) button.
- Click OK.
3.13. Tagging Virtual Machines and Templates
- Navigate to → → .
- Click the accordion for the items to tag.
- Check the items to tag.
-
Click
(Policy), and then
(Edit Tags).
Select a customer tag from the first dropdown, and then a value for the tag.
3.14. Viewing a VMware Virtual Machine’s Storage Profile
VMware storage profiles allow you to assign policies to datastores. Storage profiles are used to tag virtual machines to ensure they operate in compliance with settings in the datastore.
Red Hat CloudForms retrieves VMware virtual machine storage profile information in the inventory, and associates the virtual machines and disks with them.
To view a virtual machine’s storage profile:
- Navigate to → → .
- Click a VMware virtual machine to open its summary page.
- The VMware Storage Profile is listed under Properties.
You can assign a storage profile when provisioning a VMware virtual machine in Red Hat CloudForms, by using the virtual machine as a template to clone. See Provisioning Virtual Machines in Provisioning Virtual Machines and Hosts for instructions.
3.15. Viewing Running Processes after Collection
- Click a virtual machine with collected processes.
- From the Diagnostics area, click Running Processes.
The most recent collection of running processes is displayed. Sort this list by clicking on the column headers.
3.16. Editing Virtual Machine or Template Properties
Edit the properties of a virtual machine or template to set parent and child virtual machines. SmartState Analysis also can detect this.
- Navigate to → → .
- Click the accordion for the items to edit.
- Click the item to edit properties.
-
Click
(Configuration), and then
(Edit selected item) on the Taskbar.
- From the Parent VM dropdown, select the parent virtual machine.
- From Child VM selection, select virtual machines that are based on the current virtual machine from the list of Available VMs.
- Click Save.
3.17. Setting Ownership of a Virtual Machine or Template
Set the owner of a virtual machine or template by either individual user or group. This allows you an additional way to filter configuration items.
- Navigate to → → .
- Click the accordion for the items to analyze.
- Click the item to set ownership.
-
Click
(Configuration), and then
(Set Ownership) on the taskbar.
From the Select an Owner dropdown, select a user.
- From the Select a Group dropdown, select a group.
- Click Save.
3.18. Right Sizing a Virtual Machine
Red Hat CloudForms uses collected statistics to recommend the best size for a virtual machine. Red Hat CloudForms uses the information from the Normal Operating Range to calculate the recommendations.
- Navigate to → → .
- Click a virtual machine for right-sizing.
-
Click
(Configuration), and then
(Right-Size Recommendations) button.
A new page appears with three levels of Memory and CPU recommendations, Conservative, Moderate, and Aggressive, next to the Normal Operating Range statistics.
3.19. Viewing Capacity and Utilization Charts for a Virtual Machine
You can view capacity and utilization data for virtual machines that are part of a cluster. Note that daily charts only include full days of data. If all 24 data points for a day are not available, daily charts are not displayed. For some capacity and utilization data, Red Hat CloudForms calculates and shows trend lines in the charts which are created using linear regression. The calculation uses the capacity and utilization data collected by Red Hat CloudForms during the interval you specify.
You must have a server with network visibility to your provider assigned the server role of Capacity & Utilization Collector to use this feature.
The virtual machine must be powered on to collect the data.
- From → → , click the accordion that you want to view capacity data for.
- Click the item you want to view.
-
Click
(Monitoring), and then
(Utilization).
From Interval, select to view Daily, Hourly, or Most Recent Hour data points. When choosing Daily, you can also select the Date, and how far back you want to go from that date. When selecting Hourly, you can select the date for which you want to view hourly data. If you are using Time Profiles, you will be able to select that as an option, also.
From Compare to, select Parent Host or Parent Cluster. The capacity and utilization charts for both items will show simultaneously.
Daily charts only include full days of data. This means Red Hat CloudForms does not show daily data for a day without a complete 24 data point range for a day.
For information about data optimization including utilization trend reports, see Chapter 6, Data Optimization.
3.20. Viewing the Virtual Machine or Template Timeline
View the timeline of events for a virtual machine or template if registered to a Host.
- Navigate to → → .
- Click the virtual machine to view the timeline.
-
Click
(Monitoring), and then
(Timelines) on the taskbar.
From Options, customize the period of time to display, and the types of events to view.
- Use the Interval dropdown to select hourly or daily data points.
- Use Date to type the date of the timeline to display.
- If viewing a daily timeline, use Show to set how many days back to go. The maximum history is 31 days.
- The three Event Group dropdowns allow selection of different event groups to display. Each has its own color.
- From the Level dropdown, select either a Summary event or a Detail list of events. For example, the detail level of a Power On event might include the power on request, the starting event, and the actual Power On event. If you select Summary, you only see the Power On event in the timeline.
- To see more detail on an item in the timeline, click on it. A balloon appears with a clickable link to the resource.
3.21. Virtual Machine or Template Summary
When you click on a specific virtual machine or template, you will see the Virtual Thumbnail, and an operating system-specific screen of the item, called the Summary. Where applicable, click on a subcategory of the Summary to see more detail on that section.
When you perform a SmartState Analysis on a virtual machine or template, you get more detailed information in these categories.
Properties include information such as the base operating system, hostname, IP addresses, Virtual Machine vendor, CPU Affinity, devices attached to the system, and snapshots. This includes the ability to analyze multiple partitions, multiple disks, Linux logical volumes, extended partitions, and Windows drives. Some categories can be clicked on for additional detail. For example, click Container to view notes associated with a virtual machine.
Lifecycle shows the date of discovery and the last analysis. If a retirement date or owner has been set, these display as well.
Relationships include information on the parent host, genealogy such as parent and child virtual machines, and drift.
- Storage Relationships shows relationships to Filers, LUNs, Volumes and File Shares.
VMsafe shows properties of the VMsafe agent if it is enabled.
Normal Operating Ranges shows the values for the normal operating range for this virtual machine. These statistics are used in calculating right sizing recommendations.
Power Management displays the current power state, last boot time, and last power state change. State Changed On is the date that the virtual machine last changed its power state. This is a container view of the power state, therefore a restart of the operating system does not cause the container power state to change and will not update this value.
Security includes information on users, groups, and security patches. Recall that the items shown on the Summary screen change based on the guest operating system.
Configuration includes information on applications, services, packages, and init processes. This section changes depending on the base operating system.
- Datastore Allocation Summary shows how many and how much disk space has been allocated to this virtual machine as well as disk alignment and thin provisioning information.
Datastore Actual Usage Summary shows how much disk and memory the virtual machine is actually using.
- Diagnostics provides a link to viewing running processes and the information from the latest collected event logs.
- Smart Management shows all tags assigned to this virtual machine.
3.22. Viewing the Operating System Properties
View details of the operating system from the Virtual Machine Summary or the accordion. For Windows systems, see Account Policies for the virtual machine.
- From Summary. → → , click on the item to view its
- From the Properties section, click Operating System.
An expanded view of the operating systems properties and Account Policies displays. This varies based on the operating system.
3.23. Viewing Virtual Machine or Template Snapshot Information
View the list of snapshots to see a history of their creation and size. Red Hat CloudForms provides the description, size, and creation time of the snapshot as well as a view of the genealogy of the snapshots.
Snapshot size is only available after the successful completion of a SmartState Analysis.
- Navigate to → → .
- Click the appropriate accordion containing the item you wish to view the snapshots of.
- Click on the item to view its Summary.
- From the Summary, click Snapshots in the Properties area.
- The list of snapshots show in a tree format and captures their genealogy.
3.24. Viewing User Information for a Virtual Machine or Template
Red Hat CloudForms’s SmartState Analysis feature returns user information. Drill into the user to get details on the user’s account, including group memberships.
- Navigate to → → .
- Click the accordion for the item to view user information.
- Click on the item to view its Summary.
- From the Security section of the Virtual Machine Summary, click Users.
- Click the user to view details.
3.25. Viewing Group Information for a Virtual Machine or Template
Red Hat CloudForms’s SmartState Analysis feature returns group information. Explore a group to get a list of its users.
- Navigate to → → .
- Click the accordion for the item to view user information.
- Click on the item to view its Summary.
- From the Security section of the Virtual Machine Summary, click Groups.
- Click the group to view users.
3.26. Viewing Genealogy of a Virtual Machine or Template
Red Hat CloudForms detects the lineage of a virtual machine. View a virtual machine’s lineage and compare the virtual machines that are part of its tree. This also allows tagging of virtual machines that share genealogy.
- Navigate to → → .
- Click the accordion for the item to view genealogy.
- Click on the item to view its Summary.
- From the Relationships area in the Summary, click Genealogy.
3.27. Comparing Genealogy of a Virtual Machine or Template
- Navigate to → → .
- Click the accordion for the item to view genealogy.
- Click on the item to view its Summary.
- From the Relationships area in the Summary, click Genealogy.
- Check the items to compare.
-
Click
(Compare Selected VMs).
3.28. Tagging Virtual Machines or Templates with a Common Genealogy
- Navigate to → → .
- Click the accordion for the item to view genealogy.
- Check the items to tag.
-
Click
(Policy), and then
(Edit Tags).
Select a customer tag from the first dropdown, and then a value for the tag.
3.29. Detecting Drift on Virtual Machines or Templates
The configuration of a virtual machine might change over time. Drift is the comparison of a virtual machine to itself at different points in time. The virtual machine needs analysis at least twice to collect this information. Detecting drift provides you the following benefits:
- See the difference between the last known state of a machine and its current state.
- Review the configuration changes that happen to a particular virtual machine between multiple points in time.
- Review the host and datastore association changes that happen to a particular virtual machine between multiple points in time.
- Review the classification changes that happen to a virtual machine between two time checks.
- Capture the configuration drifts for a single virtual machine across a time period.
Detect drift on virtual machines or templates:
- Navigate to → → .
- Click on the item to view its Summary.
- From the Relationships area in the Summary, click Drift History.
- Check the analyses to compare.
-
Click
(Select up to 10 timestamps for Drift Analysis) at the top of the screen. The results display.
- Check the Drift sections on the left to view in your comparison.
- Click Apply.
The following descriptions pertain to the Expanded View
. Whether you see the value of a property or an icon representing the property depends on the properties type.
- A property displayed in the same color as the base means the compared analysis matches the base for that property.
- A property displayed in a different color from the base means the compared analysis does not match the base for that property.
If you are in the Compressed View
, the values of the properties are not displayed. All items are described by the icons shown below.
-
A
(checkmark) means that the compared analysis matches the base for that property. If you hover over it, the value of the property will display.
-
A
(triangle) means the compared analysis does not match the base for that property. If you hover over it, the value of the property displays. Click the minus sign next to the sections name to collapse it.
-
A
To limit the scope of the view, you have three buttons in the Resource button area.
-
Click
(All attributes) to see all attributes of the sections you selected.
-
Click
(Attributes with different values) to see only the attributes that are different across the drifts.
-
Click
(Attributes with the same values) to see only the attributes that are the same across drifts.
-
Click
To limit the mode of the view, there are two buttons in the Resource button area.
-
Click
(Details Mode) to see all details for an attribute.
-
Click
(Exists Mode) to only see if an attribute exists compared to the base or not. This only applies to attributes that can have a Boolean property. For example, a user account exists or does not exist, or a piece of hardware that does or does not exist.
-
Click
This creates a drift analysis. Download the data or create a report from your drift for analysis using external tools.
3.30. Creating a Drift Report for a Virtual Machine or Template
- Create the comparison to analyze.
-
Click
(Download).
Click the output button for the type of report you want.
-
Click
(Download drift report in text format) for a text file.
-
Click
(Download drift report in CSV format) for a csv file.
-
Click
(Download drift report in PDF format) for a PDF file.
-
Click
3.31. Viewing Analysis History for a Virtual Machine or Template
Each time a SmartState Analysis is performed on a virtual machine, a record is created of the task. This information is accessed either from the virtual machine accordion or the virtual machine summary. Use this detail to find when the last analysis was completed and if it completed successfully. If the analysis resulted in an error, the error is shown here.
- Navigate to → → .
- Click the accordion for the item to view genealogy.
- Click on the item to view its Summary.
From the Relationships area in the Summary, click Analysis History. A history of up to the last 10 analyses is displayed.
- Click on a specific analysis to see its details.
3.32. Viewing Disk Information for a Virtual Machine or Template
Each time a SmartState Analysis is performed on a virtual machine or template, information on the disks associated with the item is collected. This includes free and used space information as well as the type of disk and file system.
- Navigate to → → .
- Click on the item to view its Summary.
- From Datastore Allocation Summary, click Disks.
A list of the disks for the item with type, file system, size, and usage information is displayed.
3.33. Reconfiguring Virtual Machines
Memory, processors, and disks can be reconfigured on existing VMware and Red Hat Virtualization virtual machines using the Reconfigure this VM button.
You can reconfigure multiple components on a virtual machine using one request, or make each reconfiguration separately. Confirm your changes using the Submit button.
The following restrictions apply to adding and removing Red Hat Virtualization virtual machine disks:
- Supported by Red Hat Virtualization 4.0 and above.
- Only a single bootable disk is supported.
- The virtual machine requires at least one existing disk to allow adding additional disks. This is because the destination storage cannot be specified from the Red Hat CloudForms dialog, so the storage associated with the existing disk is reused.
3.33.1. Adding a Disk to a Virtual Machine
A disk can be added to a VMware or Red Hat Virtualization virtual machine with the following steps:
- Navigate to → → .
- Select the target virtual machine.
-
Click
(Configuration), and then
(Reconfigure this VM).
- Click Add Disk.
- Specify the disk type, mode, size, and dependency options.
- Click Submit.
After the disk has been added, you can view the new disk by navigating to Devices to view the new disk.
→ → . . Open the target virtual machine, then click3.33.2. Removing a Virtual Machine Disk
A disk can be removed from a VMware or Red Hat Virtualization virtual machine with the following steps:
- Navigate to → → .
- Select the target virtual machine.
-
Click
(Configuration), and then
(Reconfigure this VM).
- Click Delete next to the disk to remove.
- Click Submit.
3.33.3. Resizing a Virtual Machine Disk
This functionality is available on VMware virtual machines only.
You can extend a VMware virtual machine’s disk with the following steps:
- Navigate to → → .
- Select the target virtual machine.
-
Click
(Configuration), and then
(Reconfigure this VM).
- Click Resize next to the disk you want to resize to show resizing options.
- Specify the desired memory size and units (MB or GB). A disk can only be extended in size.
- Click Confirm Resize to select the values. Alternatively, selecting Cancel Resize shows the original values.
- Click Submit.
The disk resizing request is then processed for the virtual machine.
3.33.4. Increasing or Decreasing a Virtual Machine’s Memory Size
You can increase or decrease a VMware or Red Hat Virtualization virtual machine’s memory size with the following steps:
- Navigate to → → .
- Select the target virtual machine.
-
Click
(Configuration), and then
(Reconfigure this VM).
- Select Yes next to Memory to show memory options.
- Specify the desired memory size and units (MB or GB).
- Click Submit.
The memory add request is then processed for the virtual machine.
3.33.5. Reconfigure a Virtual Machine’s Processors
You can reconfigure a VMware or Red Hat Virtualization virtual machine’s processors with the following steps:
- Navigate to → → .
- Select the target virtual machine.
-
Click
(Configuration), and then
(Reconfigure this VM).
Select Yes next to Processors to show processor options.
- Specify the number of sockets and the number of cores per socket. The reconfiguration screen will calculate the Total Processors.
- Click Submit.
The virtual machine’s processors are then reconfigured.
3.33.6. Adding or Removing Virtual Machine Network Adapters
This functionality is available on VMware virtual machines only.
You can add or remove network adapters on a VMware virtual machine from the Reconfigure this VM button.
3.33.6.1. Adding a Network Adapter to a VMware Virtual Machine
To add a network adapter to a virtual machine:
- Navigate to → → .
- Select the target virtual machine.
-
Click
(Configuration), and then
(Reconfigure this VM).
- Click Add Network next to the disk you want to resize to show resizing options.
- Select the type of adapter from the list under vLan.
- Click Confirm Add.
- Click Submit.
A request to add the network adapter is then processed for the virtual machine. You can view the details for the new network adapter by navigating to the Reconfigure this VM area. When the network adapter is added, a name and MAC address are assigned to the adapter.
3.33.6.2. Removing a Network Adapter from a VMware Virtual Machine
To remove a network adapter from a virtual machine:
- Navigate to → → .
- Select the target virtual machine.
-
Click
(Configuration), and then
(Reconfigure this VM).
- Click Delete next to the network adapter you want to remove.
- Click Submit.
3.34. Viewing Event Logs for a Virtual Machine or Template
Using an Analysis Profile, collect event log information from your virtual machines.
This feature is only available for Windows.
- Navigate to → → .
- Click the accordion for the item to view event logs.
- Click on the item to view its Summary.
- From Diagnostics click Event Logs.
The collected event log entries are displayed. Sort this list by clicking on the column headers.
3.35. Remote Consoles
A console is a graphical window that allows you to view the start up screen, shut down screen, and desktop of a virtual machine, and to interact with that virtual machine in a similar way to a physical machine.
Red Hat CloudForms offers the following support for HTML5-based VNC, SPICE, and WebMKS consoles:
- VNC and SPICE consoles for Red Hat Virtualization Manager with websocket proxy.
- VMware’s WebMKS HTML5-based console type.
- VNC consoles for OpenStack using OpenStack-supplied websocket proxy.
- VMware no longer supports the MKS console type. Also, VMRC is no longer a browser plugin but a native desktop application. As a result, the VMware MKS and the VMRC plugin options have been disabled in CloudForms.
-
Currently, attempting to connect to the VMware WebMKS console for a virtual machine fails when the server security type is set to
2
for that virtual machine. - Due to VMware licensing restrictions, Red Hat cannot ship the WebMKS SDK in CloudForms. For information on how to configure WebMKS support in CloudForms, see Section 3.35.2, “Configuring WebMKS Support in CloudForms”.
All of the above make use of the websocket protocol supported by all recent versions of browsers, and can use SSL to encrypt the websocket connection.
- OpenStack
- Red Hat CloudForms only makes an API call to get the URL for the console and open that console in a web browser; see Directly Connect to a VNC Console in the Red Hat OpenStack Platform Instances and Images Guide for more details.
- Red Hat Enterprise Virtualization Manager and VMware
By default, the websocket connection runs over HTTPS or HTTP based on how the application was accessed. Under an appliance, you will most likely use HTTPS, and, therefore, the websocket connection will be wss:// (websocket with SSL).
When configuring Red Hat Virtualization Manager for virtual machine console access, set the display type for each virtual machine to
noVNC
orSPICE HTML5
. Support for the SPICE HTML5 console client is offered as a technology preview. For more information on configuring console options, see Configuring Console Options in the Red Hat Virtualization Virtual Machine Management Guide.
3.35.1. Configuring Console Access to VMware ESXi Hosts At A Network Layer
When configuring access to the VNC or HTML5 console, make sure that at a network layer:
- All VNC ports (5900-6000) are opened from the machine on which you access the Red Hat CloudForms Console to the Red Hat CloudForms.
- All VNC ports (5900-6000) are opened from the Red Hat CloudForms to each VMware ESXi host running virtual machines that you want to access.
- The firewall on VMware ESXi hosts is enabled and that the VMware ESXi host firewall ports are opened.
The VNC service (
gdbserver
) is running and that thegdbserver
service has an association with ports 5900-6000 usually defined with a/etc/vmware/firewall/service.xml
firewall rules configuration.The
gdbserver
ruleset must be enabled on each ESXi host running virtual machines that will be accessed through the HTML5 console or VNC console on the Red Hat CloudForms. The ruleset can be configured on the host itself, or using the VMware vCenter web user interface.
The following procedures apply to VMware vCenter 5.0 and later.
3.35.1.1. Using SSH to Configure VMware ESXi Hosts to Enable Console Access
Configure the gdbserver
ruleset on the host using SSH.
Access the host:
# ssh host@example.com
Set the
gdbserver
parameter:# esxcli network firewall ruleset set --ruleset-id gdbserver --enabled true
Confirm that the ruleset is active:
# esxcli network firewall ruleset list
3.35.1.2. Using the VMware vCenter Web Interface to Configure ESXi Hosts to Enable Console Access
Configure the gdbserver
ruleset on the host using the VMware vCenter web user interface.
- Select the ESXi host in the VMware vCenter web interface.
- Click the Manage tab.
- Click the Settings sub tab.
- Click → from the list on the left.
- Click Edit.
-
Select the
gdbserver
ruleset, and then click OK.
3.35.1.3. Configuring the VMware ESXi Host Firewall Ports for Console Access
Follow these steps to configure the VMware ESXi host firewall ports for HTML5 or VNC console access to guest virtual machine consoles. The firewall ports must be enabled on each VMware ESXi host running virtual machines that will be accessed through the HTML5 or VNC console on the Red Hat CloudForms.
- Log in to your vSphere Client and select → → .
- In the Hosts/Clusters tree view, select the VMware ESXi host you want to configure for HTML5 or VNC console access.
- Select the Configuration tab and open the Software box.
- Select Security Profile.
- Navigate to the Firewall Properties dialog window by selecting the Properties link from the Firewall section.
- In the Firewall Properties, scroll down to GDB Server and select it.
- Click OK.
3.35.2. Configuring WebMKS Support in CloudForms
Complete the following steps to enable WebMKS support in CloudForms.
- Log in to the CloudForms user interface appliance console as the root user.
On the CloudForms user interface appliances, create a folder titled
webmks
in the/var/www/miq/vmdb/public/
directory./var/www/miq/vmdb/public/webmks
-
Download and extract the contents of VMware WebMKS SDK into the
webmks
folder. - Log in to the CloudForms user interface as an administrative user. If you are already logged in, refresh the settings page in the CloudForms user interface for the changes to take effect.
- From the settings menu, select Configuration.
- Click on the Settings accordion, then click Zones.
- Click the zone where the CloudForms server is located.
- Click on the server.
- Under VMware Console Support, select VMware WebMKS from the Use list.
- Click Save.
3.35.3. Opening a Console for a Virtual Machine
Open a web-based VNC or SPICE console for a virtual machine.
- Navigate to → → .
- Click on the virtual machine that you want to access.
-
Click
(Access) and select VM Console or Web Console.
The virtual machine console opens in a new tab in your browser.
3.36. Managing Virtual Machine Snapshots
A snapshot is a view of a virtual machine’s operating system and applications on any or all available disks at a given point in time. Take a snapshot of a virtual machine before you make a change to it that may have unintended consequences. You can use a snapshot to return a virtual machine to a previous state.
View virtual machines by infrastructure providers by navigating to
→ → .3.36.1. Creating a Virtual Machine Snapshot
To create a snapshot of a virtual machine:
- Navigate to → → .
- Select the target virtual machine, and open it to view its details.
- Under Properties, click Snapshots to show information about the virtual machine’s snapshots.
-
Click
(Create a new snapshot for this VM).
- Enter snapshot details in Description.
-
(Optional) Select Snapshot VM memory for the snapshot to preserve the virtual machine’s current runtime state. This option will appear only if the VM Power State is
(On).
- Click Create.
3.36.2. Deleting a Virtual Machine Snapshot
To delete a virtual machine snapshot:
- Navigate to → → .
- Select the target virtual machine, and open it to view its details.
- Under Properties, click Snapshots to show information about the virtual machine’s snapshots.
- Select the snapshot to delete under Available Snapshots.
-
Click
and select Delete Selected Snapshot.
- Click OK.
3.36.3. Reverting a Virtual Machine to a Snapshot
A virtual machine can be reverted to a previous state using a snapshot.
The virtual machine state must be powered off
for the Revert to selected snapshot option to be available.
To revert a virtual machine to a snapshot:
- Power the virtual machine off.
- Navigate to → → .
- Select the target virtual machine, and open it to view its details.
- Under Properties, click Snapshots to show information about the virtual machine’s snapshots.
- Select the snapshot to revert to under Available Snapshots.
-
Click
(Revert to selected snapshot).
- Click OK.
3.37. Creating a Template Based on a Virtual Machine
A template is a copy of a virtual machine (VM) that you can use to simplify the subsequent, repeated creation of similar VMs. Templates capture the configuration of software, configuration of hardware, and the software installed on the VM on which the template is based.
Virtual machines must meet the following criteria to publish as templates:
- The VM must not be blank, archived or orphaned.
- The VM must be associated with a Red Hat Virtualization provider.
-
Red Hat Virtualization provider 4.0 or higher, with
use_ovirt_engine_sdk
set totrue
in/var/www/miq/vmdb/config/settings.yml
on your CloudForms appliance. -
The VM power state is
OFF
. - Sealing a template is not supported for Windows OS VMs.
To create a template based on an existing VM:
- Navigate to → → .
- Click on a Red Hat Virtualization provider.
- Select a VM.
-
Click
(Lifecycle), then click
(Publish selected VM to a Template).
Under the Request tab, provide Request Information and identify a Manager:
- Enter an E-Mail address.
- Provide a First and Last name in the individual fields.
- Enter a Manager name.
Assign tags to the new template in the Purpose tab.
- Click on a tag category and check applicable tags.
Use fields in the Catalog tab to identify the source VM and provide details for the template:
- Select the source VM from the Name field.
(Optional) Check Seal Template.
NoteSealing, which uses the
virt-sysprep
command, removes system-specific details from a virtual machine before creating a template based on that VM. This prevents the original VM’s details from appearing in subsequent VMs that are created using the same template. It also ensures the functionality of other features, such as predictable vNIC order.- The Number of VMs indicates the output will be a single template.
- Provide a Name and Description for the created template.
Under the Environment tab, specify information for the storage domain in which to create the template’s disks.
Check Choose Automatically to allow CloudForms to determine the destination cluster and datastore.
Or, manually enter cluster and datastore information using the following steps:
- Select the cluster with which to associate the template from the Cluster list. By default, this is identical to the cluster of the source VM.
- Choose a Datastore for the destination to create the template’s disks.
Provide provisioning and retirement information for VMs based on the template in the Schedule tab.
- Select Schedule or Immediately on Approval for Schedule Info to determine when to provision the VM.
- Set the Time to Retirement under Lifespan using the drop-down menu.
- Click Submit.