RHEL5.2 VIRTUALIZATION GUIDE REVIEW

 

Erroneous content:

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/chap-Virtualization-Compatibility_of_host_and_guest_combinations.html

 

The table needs two additional lines:

 

    Para-virtualized    ia64    ia64

    Fully virtualized   ia64    ia64

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/chap-Virtualization-Installing_guests.html

 

unclear whether the planning questions are referring to the host (dom0) or to the guest (domU)

 

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/sect-Virtualization-Guest_operating_system_installation_processes-Installing_a_Windows_XP_Guest_as_a_fully_virtualized_guest.html

 

should mention this is restricted to i686 and x86_64; ia64 doesn't support Windows as a guest

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/sect-Virtualization-Guest_operating_system_installation_processes-Installing_a_Windows_2003_SP1_Server_Guest_as_a_fully_virtualized_guest.html

 

should mention this is restricted to i686 and x86_64; ia64 doesn't support Windows as a guest

 

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/sect-Virtualization-Virtualized_block_devices-Adding_additional_storage_devices_to_a_guest.html

 

much easier to use M suffix on dd.  Use count=0 instead of count=1 to avoid writing the single block of zeros.  With these two changes, the examples become:

 

 sparse:     dd if=/dev/zero of=FileName.img bs=1M seek=4096 count=0

 non-sparse: dd if=/dev/zero of=FileName.img bs=1M count=4096

 

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/chap-Virtualization-Server_best_practices.html

 

this page refers to running applications on the hypervisor;

this is confusing and should probably be changed to dom0,

especially since the next chapter refers to dom0

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/chap-Virtualization-Securing_the_host.html

 

There are several ways to implement security you should know about when integrating Red Hat Virtualization into your systems.

    - remove "you should know about"

 

Together with other people in your organization,you should create a 'deployment plan'

    - could it be considered presumptuous to tell the customer

      "Together with other people in your organization"

 

The less things running on dom0, the higher the level of security.

    - s/less/fewer/

 

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/sect-Virtualization-Virtualized_network_devices-Laptop_network_configuration.html

 

in the “Configuring NAT…” example why isn’t there any case for status and restart

 

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/sect-Virtualization-Additional_Para_virtualized_Hardware_Configuration-Virtual_Storage_Devices.html

 

    disk = [ "file:/var/lib/xen/images/rhel5_64_fv.dsk,hda,w",

        "tap:aio:/var/lib/xen/images/UserStorage1.dsk,xvda,w" ]

        "tap:aio:/var/lib/xen/images/UserStorage2.dsk,xvdb,w" ]

    -- obvious typo

 

    [root@rhel5]# df /mnt/pvdisk_p1

    -- /mnt/pvdisk_p1 doesn't appear anywhere else on the page

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/sect-Virtualization-Introduction_to_Para_virtualized_Drivers-System_requirements.html

 

There should be a statement that clarifies that the “Minimum guest operating system version” are architecture dependant

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/sect-Virtualization-Para_virtualization_Restrictions_and_Support.html

 

To be consistent w/ the rest of the document you should put the following paragraph into a “Note”:

“After installing the para-virtualized drivers on a guest operating system you should only use the xm command or virsh to start the guests. If xm is not used the network interfaces (for example, eth1 and so on) will not be connected correctly during boot. This problem is known and the Bugzilla number is 300531 and a bug fix is in progress. The bug connects the network interface to qemu-dm and subsequently limits the performance dramatically. “

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/sect-Virtualization-Installation_and_Configuration_of_Para_virtualized_Drivers.html

 

At the beginning of this section there should be a statement around the fact that people should check the support table to verify that the PV drivers are supported in their environment.

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/chap-Virtualization-Starting_or_stopping_a_domain_during_the_boot_phase.html

 

"The chkconfig xendomains off command terminates all running

domains and shuts down the domains on the next boot."

    -- this is ambiguous or wrong, it should be written more like

       the explanation for "chkconfig xendomains on"

 

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/chap-Virtualization-Managing_guests_with_xend.html

 

What is the default value of xend_unix_server?

 

Are there any default values for xend_reallocation_address and xend_address?

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/chap-Virtualization-Managing_CPUs.html

 

seems to be missing useful content, such as *how* to manage cpus

 

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/chap-Virtualization-Starting_xend_with_the_host.html

 

seems to be mostly a repeat of the information at

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/chap-Virtualization-Managing_guests_with_xend.html

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/chap-Virtualization-Virtualization_live_migration.html

 

This section only talks about para-virtualized guests migration; what about fully virtualized guests which is supported for x86 but not for ia64. There should be a paragraph on fully virtualized guests and the limititations related to the different archs.

 

inconsistent use of parens/non-parens when referrring to configuration parameters, pick one...

 

same page, (xend-relocation-address ") and others have a strange lonely double-quote.  This is probably an accident of formatting conversion.  It appears on other pages too.

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/sect-Virtualization-Virtualization_live_migration-An_example_of_a_configuration_for_live_migration.html

 

Title could be simpler, "An example configuration for live migration", i.e. drop "of a"

 

This paragraph should be highlighted in a “Warning” or a “Note”:

“Make sure the directory is exported with the correct options, if you are exporting the default directory /var/lib/xen/images/ make sure you ONLY export /var/lib/xen/images/ and NOT /var/lib/xen/ as this directory is used by the xend daemon and other Xen components, sharing it will likely cause unpredictable behavior”

 

s/the exampled used/the example used/

 

"Run a simple loop inside the guest to print out time and hostname every 2 seconds." ... but the sample loop uses "sleep 3"

 

The text doesn’t match the commands – this whole first example of migration from et-virt07 to et-virt08 is all messed up. For example:

“Initiate a live migration to et-virt08”

does NOT match the command

“[et-virt08 ~]# xm migrate --live xentesttravelvm01 et-virt07”

 

One of the samples starts with the line:

        # doit script

This will prevent the following line from being processed (by the kernel):

        #!/bin/bash

The doit line should be removed.

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/sect-Virtualization-Remote_management_of_virtualized_guests-Remote_management_with_ssh.html

 

instructions end early.  There needs to be some example of how to make use of the stuff that was just explained, such as how to connect to those machines using virt-manager

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/sect-Virtualization-Remote_management_of_virtualized_guests-Remote_management_over_TLS_and_SSL.html

 

http://libvirt.org/remote.html should be a link instead of plain text

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/chap-Virtualization-Red_Hat_Virtualization_tools.html

 

using grep is unnecessary, just do:

    lsof -i :5900

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/chap-Virtualization-Managing_guests_with_virsh.html

 

Chapter 21. Managing guests with virsh

23.1. virsh the command line interface tool for virtualization

These two sections are doubly documenting the same tool.

 

Bad sentence structure:

“You can make a new guest session from an XML machine definition. If you have a pre-existing guest that you created previously with the xm tool or the virt-install command.

 

s/ To terminate, destroy or delete guest use the virsh command with the destroy/ To terminate, destroy or delete guest use the virsh command with destroy/

 

s/ To display the guest list and the current state with virsh/ To display the guest list and their current state with virsh/

 

Confusing statement, why use “the” CPU? What CPU?

“running domains are currently active on the CPU”

 

“Configuring Memory allocation” and “Configuring max memory” is 2 different version of the same info- please delete one.

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/chap-Virtualization-Configuring_GRUB.html

 

The following sentence is repeated twice:

“This limits the amount of memory that is available for domain0. “

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/chap-Virtualization-Booting_a_Guest_Domain.html

 

 

Chapter 25. Starting a guests during boot

 

    The main comment for this section is that it has nothing to

    do with starting guests at boot.  It provides a single

    example of starting a guest manually, and even that is just

    a rehash of explanation given in previous chapters.

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/sect-Virtualization-THow_To_troubleshoot_Red_Hat_Virtualization-Debugging_and_Troubleshooting_Red_Hat_Virtualization.html

 

Right after the brctl examples, there's a line that starts with "Other

utilities which can be used...".   This sentence ends prematurely.   Was

it supposed to be a subsection title?

 

Could tools (such as iostat, lsof, etc) listed at the start of the Troubleshooting section also have one lines describing them like done for strace, vncviewer, vncserver?

 

Is 'sysstat' an RPM package containing iostat and sar?   The description

on p.253 make it sound like a command.

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/sect-Virtualization-THow_To_troubleshoot_Red_Hat_Virtualization-Important_Directory_Locations.html

 

First sentence of Section 4 missing some words - you should do what with the log files?

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/sect-Virtualization-THow_To_troubleshoot_Red_Hat_Virtualization-Troubleshooting_with_the_logs.html

In Section "Troubleshooting with a serial console", the example shown

uses grub, which isn't used on ia64.   Should something be noted for

ia64?

 

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/sect-Virtualization-THow_To_troubleshoot_Red_Hat_Virtualization-Full_virtualization_guest_console_access.html

In this section it says "you must edit

the configuration file in the /etc/xen directory".   What do you edit in there?  It doesn't say.   In addition, this is a grub example.   Should something be noted for ia64?

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/sect-Virtualization-THow_To_troubleshoot_Red_Hat_Virtualization-SELinux_Considerations.html

Reference is made to the boolean parameter xend_disable_trans, but it is not used in the example (xend_disable_t is used).

 

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

Typos:

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/chap-Virtualization-System_requirements.html

 

s/Fiber Channel/Fibre Channel/

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/chap-Virtualization-Virtualization_limitations.html

 

s/(see(see Chapter 13/(see Chapter 13/

 

Also in the last sentence in the “note”

s/presen/present/

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/sect-Virtualization-Installing_Red_Hat_Virtualization_packages_on_the_host-Installing_Red_Hat_Virtualization_during_a_new_Red_Hat_Enterprise_Linux_installation.html

 

s/manaully/manually/

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/sect-Virtualization-Installing_Red_Hat_Virtualization_packages_on_the_host-Installing_Red_Hat_Virtualization_on_an_existing_Red_Hat_Enterprise_Linux_system.html

 

s/install/install/

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/sect-Virtualization-Installing_guests-Create_a_guest_using_virt_manager.html

 

in paragraph 8.

s/installtion/installation/

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/sect-Virtualization-Guest_operating_system_installation_processes-Installing_Red_Hat_Enterprise_Linux_5_as_a_para_virtualized_guest.html

 

The sentence “After your guest has completed it is initial bootstrap …” should be “After your guest has completed its initial bootstrap …” i.e “its” instead of “it is”

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/sect-Virtualization-Installing_guests-Create_a_guest_using_virt_install.html

 

    virt-install output should be properly aligned; that

    would make the sample output a lot easier to read

 

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/sect-Virtualization-Virtualized_block_devices-Configuring_persistent_storage_in_a_Red_Hat_Enterprise_Linux_5_environments.html

 

Title has inconsistency “in a Red Hat….environments” word “environment should be singular

 

s/4 device/4 devices/

 

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/chap-Virtualization-Virtualized_network_devices.html

 

In “Those chapters provide a details description…”

s/details/detailed

 

in Note s/Chapter. Chapter 13/Chapter 13/

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/sect-Virtualization-Virtualized_network_devices-Laptop_network_configuration.html

 

s/ it has access the same interface all the time/ it has access to the same interface all the time/

s/ the procedure outline below / the procedure outlined below

s/ allow the the guests/allow the guests/

s/configuration to suite your local/configuration to suit your local/

 

 

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/chap-Virtualization-Managing_guests_with_xend.html

 

    s/dom0 cpus/dom0-cpus/

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/chap-Virtualization-Managing_CPUs.html

 

s/its typically better/it’s typically better/

 

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/chap-Virtualization-Managing_guests_with_Virtual_Machine_Managervirt_manager.html

 

s/with shell privilages on the host/with shell privileges on the host/

 

 

http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/sect-Virtualization-THow_To_troubleshoot_Red_Hat_Virtualization-Interpreting_Error_Messages.html

 

s/xm create –c va base/ xm create –c va-base/

 

s/depreciation/deprecation/