Chapter 1. Getting Started

The Administration Portal allows you to monitor, create and maintain your Red Hat Enterprise Virtualization platform using an interactive graphical user interface (GUI). The GUI functions in two modes, tree or flat, allowing you to navigate to the system's resources, either hierarchically or directly. The powerful Search feature ensures that you can locate any resource in the enterprise, wherever it may be in the hierarchy; and you can use Tags and Bookmarks to help you to store the results of your searches for later reference.
It is assumed that you have correctly installed Red Hat Enterprise Virtualization, including Directory Services, and have logged into the Administration Portal. If you are attempting to set up Red Hat Enterprise Virtualization, it is recommended that you read the Red Hat Enterprise Virtualization Quick Start Guide and the Red Hat Enterprise Virtualization Installation Guide 3.0.

1.1. Graphical User Interface

After you have successfully logged into Red Hat Enterprise Virtualization, the Administration Portal displays. The graphical interface consists of a number of contextual panes and menus, and can be used in two modes, tree mode and flat mode. Tree mode allows you to browse the object hierarchy of a data center, and is the recommended manner of operation. The elements of the GUI are shown in the diagram below.
User Interface Elements of the Administration Portal

Figure 1.1. User Interface Elements of the Administration Portal

User Interface Elements

  • Header
    The Header Bar contains the name of the current logged in user, the Sign out button, the About button, and the Configure button. The About button provides access to version information. The Configure button allows you to configure user roles. The Guide provides a shortcut to the book you are reading now.
  • Search Bar
    The Search bar allows you to quickly search for resources such as hosts and virtual machines. You can build queries to find the resources that you need. Queries can be as simple as a list of all the hosts in the system, or much more complex. As you type each part of the search query, you will be offered choices to assist you in building the search. The star icon can be used to save the search as a bookmark.
  • Resource Tabs
    All Resources, such as Hosts and Clusters, can be managed using the appropriate tab. Additionally, the Events and Monitor tabs allow you to manage and view events across the entire system.
    Clicking a tab displays the results of the most recent search query on the selected object. For example, if you recently searched for all virtual machines starting with "M", clicking the virtual machines tab displays a list of all virtual machines starting with "M".
    The Administration Portal uses the following tabs: Data Centers, Clusters, Hosts, Storage, Virtual Machines, Pools, Templates, Users, Events, and Monitor.
  • Results list
    Perform a task on an individual item, multiple items, or all the items in the results list, by selecting the item(s) and then clicking the relevant action button. If multiple selection is not possible, the button is disabled.
    Details of a selected item display in the details pane.
  • Details Pane
    The Details pane displays detailed information about a selected item in the Results Grid. If multiple items are selected, the Details pane displays information on the first selected item only.
  • Bookmarks Pane
    Bookmarks are used to save frequently-used or complicated searches for repeated use. Bookmarks can be added, edited, or removed.
  • Alerts/Events Pane
    The Alerts pane lists all events with a severity of Error or Warning. The system records all events, which are listed as audits in the Alerts section. Like Events, Alerts can also be viewed in the lowermost panel of both the Monitor and Events tab, by re-sizing the panel and clicking the Alert tab. This tabbed panel also appears in other tabs, such as the Hosts tab.

Administration Portal Minimum Supported Browser Resolution

The minimum supported resolution viewing the Administration Portal in a web browser is 1024x768. When viewed at a lower resolution, the Administration Portal will not render correctly.

1.1.1. Tree Mode and Flat Mode

The Administration Portal provides two different modes for managing your resources, tree mode and flat mode. Tree mode displays resources in a hierarchical view per data center, from the highest level of the data center, down to the individual virtual machine. Tree mode provides a visual representation of the virtualization system. Working in tree mode is highly recommended for most operations.
Tree Mode

Figure 1.2. Tree Mode

Flat mode offers powerful search functionality and allows you to customize how you manage your system. It gives you access to any resource, regardless of its position in the enterprise. In this mode the full power of the search feature can be used. Flat mode does not limit you to viewing the resources of a single hierarchy, but allows you to search across data centers, or storage domains. For example, you may need to find all virtual machines that are using more than 80% CPU across clusters and data centers, or locate all hosts that have the highest utilization. Flat mode makes this possible. In addition, certain objects are not in the data centers hierarchy, so they will not appear in tree mode. Pools and users are not parts of the data centers hierarchy, and can be accessed only in flat mode.
To access flat mode, click on the "System" item in the pane on the left-hand side of the screen. You will know that you are in flat mode if the "Pools" and "Users" resource tabs appear.
Flat Mode

Figure 1.3. Flat Mode

1.1.2. Using the Guide Me facility

At set up or configuration time, a number of tasks must be completed in sequence. The Administration Portal provides prompts in the form of context sensitive Guide Me dialog box, buttons and icons. The Guide Me dialog box allows you to directly perform the required tasks. The Guide Me dialog box is context sensitive, and only displays the actions that are appropriate to the resource that is being configured. The Guide Me dialog box can be accessed at any time by clicking the Guide Me button on the resource toolbar. You can use the Guide Me facility to set up or configure data centers, storage, and clusters, and its use in specific contexts is described in later sections of this document.
New Data Center Guide Me Dialog Box

Figure 1.4. New Data Center Guide Me Dialog Box