Bookmark this page

Navigating the VM Portal and the Administration Portal

Objectives

After completing this section, you should be able to describe the purposes of the VM Portal and the Administration Portal, and provide a high-level overview of each user interface.

Accessing and Using the VM Portal

The VM Portal is dedicated primarily to users of particular virtual machines. Usually, those users are assigned with the UserRole role. This role allows for easy access to the console of a virtual machines, as well as the ability to start, stop, restart, or shut them down. It is designed for users who do not need to access any of the Red Hat Virtualization environment resources. Users with the PowerUserRole role have access to more advanced options in the VM Portal than users with the UserRole role. Users with the PowerUserRole role can manage virtual machines, virtual disks, templates, and network interfaces to the virtual machines, and can also start, stop, restart, or shutdown the virtual machines.

To access the VM Portal, open your web browser and go to the server with Red Hat Virtualization Manager installed. Click the VM Portal link to open the login page. Enter your user name and password. Select the appropriate profile for your domain and click Log In.

The screen in the VM Portal is divided into three sections: the header bar, the toolbar, and the virtual machines pane. The refresh button, user drop-down menu, and messages drop-down menu are presented on the header bar.

Buttons that allow you to perform additional actions are presented on the toolbar. For example, users with the PowerUserRole role will see the Create Virtual Machine button on the toolbar. However, users with the UserRole role will not see any buttons on the toolbar.

Virtual machines are presented in the virtual machines pane. This pane displays the operating system, name, state, and management menu for the virtual machines.

Figure 4.11: VM portal

Hover over the user drop-down menu in the header bar to get the current user. This drop-down menu has a Log out option for logging out of the VM Portal. The user menu also has Options (to add save SSH key) and About (to get portal and REST API versions).

The virtual machines allows you to access the console of a virtual machine. Every instance displaying the the operating system logo represents a virtual machine in an individual box called a card.

Each virtual machine card has a Run button, used to start the virtual machine. To access the console of the virtual machine, click the Console button. Use the drop-down menu on the virtual machine card to suspend, stop, and restart the virtual machine.

Figure 4.12: VM portal

To display the statistics of a particular virtual machine, click the name of the virtual machine.

Figure 4.13: Virtual machine statistics

The PowerUserRole extends the functionality of the VM Portal for the users with this role because these users have additional permissions within the Red Hat Virtualization environment.

The following table outlines additional actions available and unavailable in the VM Portal to users with the PowerUserRole and UserRole roles respectively, .

ActionPowerUserRoleUserRole
Create, edit, and remove virtual machinesYesNo
Manage virtual disks and network interfacesYesNo
Create and use virtual machine snapshotsYesNo

Accessing and Using the Administration Portal

The Administration Portal is dedicated to administrators of the Red Hat Virtualization environment that are assigned at least one administrative role, such as the SuperUser or DataCenterAdmin role. This portal is designed for users who need to manage Red Hat Virtualization environment resources.

To access the Administration Portal, open your web browser and go to the server with Red Hat Virtualization Manager installed. Click the Administration Portal link to open the login page. Enter the administrative user name and password. Select the internal profile and click Log In.

The Red Hat Virtualization Administration Portal is divided into menus that appear in the navigation pane on the left. Navigate to resources using the options presented on these menus.

Figure 4.14: Administration portal

The following table outlines the actions available and unavailable in the Administration Portal to users with the SuperUser and DataCenterAdmin roles respectively.

ActionSuperUserDataCenterAdmin
Create, and remove data centersYesNo
Edit data centerYesYes
Create, and remove clusters within a data centerYesNo
Edit cluster within a data centerYesYes
Manage virtual machines within a cluster in the permitted data centerYesYes

Searching Resources

The Administration Portal has a powerful search bar that you can use to effectively find resources in the Red Hat Virtualization infrastructure. Search supports both free-text searches and syntax-based searches. An autocomplete feature makes it easy for administrators who are unfamiliar with the search syntax to quickly construct effective searches. Frequently used searches can be bookmarked.

The formal search syntax has one required field: the type of resource to be returned in the search results. If no other parameters are provided, all resources are returned. Search results can be narrowed to match a rich set of search criteria, which is useful when looking for a single virtual machine or host on a site managing thousands of guest virtual machines on hundreds of hosts.

The following is the syntax for search bar expressions.

Result-type: [Criteria...] [sortby Sort_spec]

The Result-type part of the syntax is a Red Hat Virtualization resource such Vms, DataCenter, Host, Events, Cluster, Storage, or Template.

The following example shows a search for virtual machines that are configured with 2048 MB RAM or more.

Vms: memory >= 2028

Optional Criteria is an expression of the form: Property Operator Value.

  • Property is the thing being matched, like machine name.

  • Operator is how things are compared (= != > < >= <=).

  • Value is the value to match.

An optional sortby directive can be associated with a sorting specification to sort the results based on various criteria in ascending or descending order.

References

Further information on the Administration Portal interface is available in the Using the Administration Portal chapter of Introduction to the Administration Portal for Red Hat Virtualization at https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.3/html-single/introduction_to_the_administration_portal/chap-using_the_administration_portal

Further information on the VM Portal interface is available in the Accessing the VM Portal chapter of Introduction to the VM Portal for Red Hat Virtualization at https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.3/html-single/introduction_to_the_vm_portal/index

Revision: rh318-4.3-c05018e