Edition 5
1801 Varsity Drive
Raleigh, NC 27606-2072 USA
Phone: +1 919 754 3700
Phone: 888 733 4281
Fax: +1 919 754 3701
Mono-spaced Bold
To see the contents of the filemy_next_bestselling_novelin your current working directory, enter thecat my_next_bestselling_novelcommand at the shell prompt and press Enter to execute the command.
Press Enter to execute the command.Press Ctrl+Alt+F2 to switch to the first virtual terminal. Press Ctrl+Alt+F1 to return to your X-Windows session.
mono-spaced bold. For example:
File-related classes includefilesystemfor file systems,filefor files, anddirfor directories. Each class has its own associated set of permissions.
Choose → → from the main menu bar to launch Mouse Preferences. In the Buttons tab, click the Left-handed mouse check box and click to switch the primary mouse button from the left to the right (making the mouse suitable for use in the left hand).To insert a special character into a gedit file, choose → → from the main menu bar. Next, choose → from the Character Map menu bar, type the name of the character in the Search field and click . The character you sought will be highlighted in the Character Table. Double-click this highlighted character to place it in the Text to copy field and then click the button. Now switch back to your document and choose → from the gedit menu bar.
Mono-spaced Bold Italic or Proportional Bold Italic
To connect to a remote machine using ssh, typesshat a shell prompt. If the remote machine isusername@domain.nameexample.comand your username on that machine is john, typessh john@example.com.Themount -o remountcommand remounts the named file system. For example, to remount thefile-system/homefile system, the command ismount -o remount /home.To see the version of a currently installed package, use therpm -qcommand. It will return a result as follows:package.package-version-release
Publican is a DocBook publishing system.
mono-spaced roman and presented thus:
books Desktop documentation drafts mss photos stuff svn books_tests Desktop1 downloads images notes scripts svgs
mono-spaced roman but add syntax highlighting as follows:
package org.jboss.book.jca.ex1; import javax.naming.InitialContext; public class ExClient { public static void main(String args[]) throws Exception { InitialContext iniCtx = new InitialContext(); Object ref = iniCtx.lookup("EchoBean"); EchoHome home = (EchoHome) ref; Echo echo = home.create(); System.out.println("Created Echo"); System.out.println("Echo.echo('Hello') = " + echo.echo("Hello")); } }
sgordon@redhat.com
). When submitting a bug report, be sure to mention the manual's identifier: Red_Hat_Enterprise_Virtualization-Installation_Guide.
Table of Contents

No eXecute flag (NX) is also required. To check that your processor supports the required virtualization extensions, and that they are enabled:
rescue parameter.
# grep -E 'svm|vmx' /proc/cpuinfo
kvm modules are loaded in the kernel:
# lsmod | grep kvm
kvm_intel or kvm_amd then the kvm hardware virtualization modules are loaded and your system meets requirements.
0.5.
(8 GB x 0.5) + 4 GB = 8 GB
Fakeraid Devices are not Supportedfakeraid devices. Where a fakeraid device is present it must be reconfigured such that it no longer runs in RAID mode.
Red Hat Enterprise Virtualization Manager (v.3 x86_64) channel, also referred to as rhel-x86_64-server-6-rhevm-3, provides Red Hat Enterprise Virtualization Manager. The Channel Entitlement Name for this channel is Red Hat Enterprise Virtualization Manager (v3).
JBoss Application Platform (v 5) for 6Server x86_64 channel, also referred to as jbappplatform-5-x86_64-server-6-rpm, provides the supported release of the application platform on which the manager runs. The Channel Entitlement Name for this channel is JBoss Enterprise Application Platform (v 4, zip format).
RHEL Server Supplementary (v. 6 64-bit x86_64) channel, also referred to as rhel-x86_64-server-supplementary-6, provides the supported version of the Java Runtime Environment (JRE). The Channel Entitlement Name for this channel is Red Hat Enterprise Linux Server Supplementary (v. 6).
rhn-channel --list command to confirm the list of channels to which the server is subscribed.
Register to Red Hat Network
rhn_register command to register the system with the Red Hat Network. To complete registration successfully you will need to supply your Red Hat Network username and password. Follow the onscreen prompts to complete registration of the system.
# rhn_register
Subscribe to Required Channels
rhn-channel command.
Using the Red Hat Network Web Interface
Using the rhn-channel Command
rhn-channel command to subscribe the system to each of the required channels. The commands which need to be run are:
# rhn-channel --add --channel=rhel-x86_64-server-6-rhevm-3 # rhn-channel --add --channel=jbappplatform-5-x86_64-server-6-rpm # rhn-channel --add --channel=rhel-x86_64-server-supplementary-6
rhn-channel Errorsrhn-channel command will result in an error:
Error communicating with server. The message was: Error Class Code: 37 Error Class Info: You are not allowed to perform administrative tasks on this system. Explanation: An error has occurred while processing your request. If this problem persists please enter a bug report at bugzilla.redhat.com. If you choose to submit the bug report, please be sure to include details of what you were trying to do when this error occurred and details on how to reproduce this problem.
rhn-channel then to add the Red Hat Network channel to the system you must use the web user interface.
admin user. Authentication for other users is supported by attaching directory services domains using the provided domain management tool, rhevm-manage-domains. Currently the two supported providers of directory services for use with the Red Hat Enterprise Virtualization Manager are Identity, Policy, and Audit (IPA) and Microsoft Active Directory.
rhevm-setup script is able to set the required firewall rules automatically. Where an existing firewall configuration exists this step is able to be skipped. This allows the required changes to be manually integrated with the existing firewall script(s).
| Port(s) | Protocol | Source | Destination | Purpose |
|---|---|---|---|---|
| 22 | TCP |
|
| SSH (optional) |
| 8080, 8443 | TCP |
|
|
Provides HTTP and HTTPS access to the manager.
|
/etc/sysconfig/nfs file:
$ cat /etc/sysconfig/nfs LOCKD_TCPPORT=32803 LOCKD_UDPPORT=32769 MOUNTD_PORT=892 RQUOTAD_PORT=875 STATD_PORT=662 STATD_OUTGOING_PORT=2020
| Port(s) | Protocol | Source | Destination | Purpose |
|---|---|---|---|---|
| 22 | TCP |
|
| Secure Shell (SSH) access. |
| 5634 - 6166 | TCP |
|
|
Remote guest console access via VNC and Spice. These ports must be open to facilitate client access to virtual machines.
|
| 16514 | TCP |
|
|
Virtual machine migration using
libvirt.
|
| 49152 - 49216 | TCP |
|
|
Virtual machine migration and fencing using VDSM. These ports must be open facilitate both automated and manually initiated migration of virtual machines.
|
| 54321 | TCP |
|
|
VDSM communications with the Manager and other virtualization hosts.
|
| Port(s) | Protocol | Source | Destination | Purpose |
|---|---|---|---|---|
| 88, 464 | TCP, UDP |
|
| Kerberos authentication. |
| 389, 636 | TCP |
|
| Lightweight Directory Access Protocol (LDAP) and LDAP over SSL. |
| Name | UID | GID | Auxiliary Group |
|---|---|---|---|
vdsm
| 36 | nil | 109 |
kvm
| nil | 36 | nil |
qemu
| 107 | 107 | nil |

8080 and 8443 respectively.
RHEV Manager will be installed using the following configuration: ================================================================= http-port: 8080 https-port: 8443 host-fqdn: manager.demo.redhat.com auth-pass: ******** db-pass: ******** org-name: Red Hat default-dc-type: NFS nfs-mp: /isodomain iso-domain-name: ISODomain override-iptables: yes Proceed with the configuration listed above? (yes|no):
rhevm-setup with an answer file. An answer file contains answers to the questions asked by the setup command.
--gen-answer-file parameter to set the location to which the answer file must be saved. The rhevm-setup command will record your answers to the file.
# rhevm-setup --gen-answer-file=ANSWER_FILE--answer-file parameter to set the location of the answer file that must be used. The command rhevm-setup command will use the answers stored in the file to complete installation.
# rhevm-setup --answer-file=ANSWER_FILErhevm-setup --help for further information.
# yum remove classpathx-jafyum to ensure that the most up to date versions of all installed packages are in use.
# yum upgradeyum to initiate installation of the rhevm package and all dependencies. You must run this command as the root user.
#yuminstallrhevm
rhevm-setup command is provided to assist with this task. The script asks you a series of questions, the answers to which form the basis for system configuration. Once all required values have been provided the updated configuration is applied and the Red Hat Enterprise Virtualization Manager services are started.
Start Setup Script
rhevm-setup as the root user.
# rhevm-setup
Set Port for HTTP
8080, press Enter. To use an alternative value enter it in the field, and then press Enter.
HTTP Port [8080] :
manager.demo.redhat.com using the default HTTP port value, 8080, the URL to access the entry page over HTTP is http://manager.demo.redhat.com:8080/.
Set Port for HTTPS
8443, press Enter. To use an alternative value enter it in the field, and then press Enter.
HTTPS Port [8443] :
8443 is selected it changes the URL that must be used to access the Red Hat Enterprise Virtualization Manager over HTTPS.
manager.demo.redhat.com using the default HTTPS port value, 8443, the URL to access the entry page over HTTPS is https://manager.demo.redhat.com:8443/.
Set Fully Qualified Domain Name (FQDN)
Host fully qualified domain name, note that this name should be fully resolvable [manager.demo.redhat.com] :
Set Administrator Password
internal, the administrative user is called admin. External authentication domains are added as a post-installation step using the rhevm-manage-domains command.
admin user. You will be asked to enter it a second time to confirm your selection.
Password for Administrator (admin@internal) :
Set Database Password
Database password (required for secure authentication with the locally created database) :
Set Organization Name
Subject field of the certificate used to secure communications with the Red Hat Enterprise Virtualization Manager.
Organization Name for the Certificate :
Configure Default Storage Type
Default data center. You are able to add further data centers that use different storage types from the Administration Portal at any time.
The default storage type you will be using ['NFS'| 'FC'| 'ISCSI'] [NFS] :
NFS). The other available values are:
FC),
ISCSI), and
NFS, FC, and ISCSI options are used to connect to remote storage. Red Hat Enterprise Virtualization also supports The LOCALFS storage type which allows the use of local storage attached to the virtualization hosts, but this storage type is not supported for the Default data center.
NFS, press Enter. To select FC, or ISCSI then enter the value and then press Enter.
Configure NFS ISO Domain
Should the installer configure NFS share on this server to be used as an ISO Domain? ['yes'| 'no'] [yes] :
no and press Enter.
Mount point path:
_) and the hyphen (-).
Display name for the ISO domain:
Default data center.
Configure Firewall
rhevm-setup script is able to configure this automatically, but selecting this option overrides any existing firewall configuration. Where there is an existing firewall configuration that needs to be maintained you must manually configure the firewall to include the additional rules required by the Red Hat Enterprise Virtualization Manager.
Firewall ports need to be opened. You can let the installer configure iptables automatically overriding the current configuration. The old configuration will be backed up. Alternately you can configure the firewall later using an example iptables file found under /usr/share/rhevm/conf/iptables.example Should the installer configure iptables now? ['yes'| 'no'] [yes] :
yes and then press Enter.
no and then press Enter. You will need to add rules equivalent to those found in /usr/share/rhevm/conf/iptables.example to your iptables configuration.
Confirm Configuration
RHEV Manager will be installed using the following configuration: ================================================================= http-port: 8080 https-port: 8443 host-fqdn: manager.demo.redhat.com auth-pass: ******** db-pass: ******** org-name: Red Hat default-dc-type: NFS nfs-mp: /isoshare iso-domain-name: ISODomain override-iptables: yes Proceed with the configuration listed above? (yes|no):
yes and then press Enter to apply the configuration.
no and then Enter to revisit the configuration.
SSH Certificate fingerprint, SSH Public key fingerprint, and Red Hat Enterprise Virtualization Manager URL for your records.
Installing:
Creating JBoss Profile... [ DONE ]
Creating CA... [ DONE ]
Setting Database Security... [ DONE ]
Creating Database... [ DONE ]
Updating the Default Data Center Storage Type... [ DONE ]
Editing JBoss Configuration... [ DONE ]
Editing RHEV Manager Configuration... [ DONE ]
Configuring the Default ISO Domain... [ DONE ]
Configuring Firewall (iptables)... [ DONE ]
Starting JBoss Service... [ DONE ]
**** Installation completed successfully ******
(Please allow RHEV Manager a few moments to start up.....)
Additional information:
* SSL Certificate fingerprint: 4C:A4:8F:93:62:50:C1:63:C8:09:70:77:07:90:FD:65:5B:3C:E8:DD
* SSH Public key fingerprint: fa:71:38:88:58:67:ae:f0:b1:17:fe:91:31:6c:66:6e
* A default ISO share has been created on this host.
If IP based access restrictions are required, please edit /isoshare entry in /etc/exports
* The firewall has been updated, the old iptables configuration file was saved to /usr/share/rhevm/conf/iptables.backup.103654-09092011_866
* The installation log file is available at: /var/log/rhevm/rhevm-setup_2011_09_09_10_32_56.log
* Please use the user "admin" and password specified in order to login into RHEV Manager
* To configure additional users, first configure authentication domains using the 'rhevm-manage-domains' utility
* To access RHEV Manager please go to the following URL: http://manager.demo.redhat.com:8080
rhevm-cleanup utility to allow quick and easy removal of the data files associated with the installation. Once this has been run you are able to remove the Red Hat Enterprise Virtualization Manager packages using yum.
rhevm-cleanup command removes all existing Red Hat Enterprise Virtualization Manager data. This includes configuration settings, certificates, and database tables.
rhevm-cleanup command on the system that Red Hat Enterprise Virtualization Manager is installed on. You must be logged in as the root user to run rhevm-cleanup.
Would you like to proceed? (yes|no): yes
yes and then press Enter to proceed with removal of Red Hat Enterprise Virtualization Manager.
rhevm-cleanup command displays a message confirming that the Red Hat Enterprise Virtualization data files have been removed successfully.
RHEV Manager cleanup finished successfully!
yum to remove the relevant packages. While still logged in as the root user run:
# yum remove rhevm* vdsm-bootstrap
http://manager.demo.redhat.com:8080/RHEVManager. Substitute manager.demo.redhat.com with the fully qualified domain name provided during Red Hat Enterprise Virtualization Manager installation. Additionally, where a non-default HTTP port was selected during installation replace 8080 with the port that was chosen.
this certificate link. When prompted select to Open the file. On Internet Explorer 9 the prompt appears at the bottom of the screen. Earlier versions will display a dialog box instead.

https://manager.demo.redhat.com:8443/RHEVManager. Substitute manager.demo.redhat.com with the URL provided during installation. Additionally where a non-default HTTPS port was selected during installation, replace 8443 in the URL with the port that was chosen.
ca.cer certificate and install the RHEV-GUI-CertificateInstaller.exe certificate.

admin as your User Name. Enter the password that was set during installation in the Password field. Select the internal domain from the Domain list.

SELECT statement. The result set of the SELECT statement populates the virtual table returned by the view. If the optional comprehensive management history database has been enabled, the history tables and their associated views are stored in the rhevm_history database.

rhevm_history database, see Procedure 4.1, “Install and Configure History Database”.
rhevm_history database prior to installing JasperReports.
Install Required Packages
yum to initiate installation of the rhevm-reports-dwh package, or the rhevm-reports package if you also intend to install Red Hat Enterprise Virtualization Manager Reports. You must run this command as the root user on the system hosting the Red Hat Enterprise Virtualization Manager.
# yum install rhevm-reports-dwh# yum install rhevm-reportsConfirm Package Installation
yum installs the packages. Some further configuration is, however, required before the reports functionality can be used.
Configure History Database
rhevm-dwh-setup command to configure the Extract, Transform, Load (ETL) process and database scripts used to create and maintain a working history database.
root user on the system hosting the Red Hat Enterprise Virtualization Manager.
# rhevm-dwh-setupjbossas service. The rhevm-dwh-setup command asks you:
Would you like to stop the JBoss service? (yes|no):
yes and then press Enter to proceed. The command then:
jbossas service,
rhevm_history database, and
jbossas service.
rhevm_history database has been created. The Red Hat Enterprise Virtualization Manager is configured to log information to this database for reporting purposes.
yum to install the Red Hat Enterprise Virtualization Manager Reports package, rhevm-reports, if you did not already do this when performing the datawarehouse installation. This package must be installed on the system that the Red Hat Enterprise Virtualization Manager is installed. You must be logged in as the root user.
# yum install rhevm-reportsroot user on the system hosting the Red Hat Enterprise Virtualization Manager.
# rhevm-reports-setupjbossas service. The rhevm-reports-setup command asks you:
In order to proceed the installer must stop the JBoss service Would you like to stop the JBoss service? (yes|no):
rhev-admin). Note that the reports system maintains its own set of credentials.
Please choose a password for the admin user (rhevm-admin):
http://demo.redhat.com:8080/rhevm-reports, replacing demo.redhat.com with the fully qualified domain name of the Red Hat Enterprise Virtualization Manager. If during Red Hat Enterprise Virtualization Manager installation you selected a non-default HTTP port replace 8080 with the port chosen.
rhevm-admin and the password you set during reports installation to log in for the first time. Note that the first time you log into Red Hat Enterprise Virtualization Manager Reports a number of web pages are generated, as a result your initial attempt to login may take some time to complete.
root user to initiate the upgrade process.
yum update rhevm-setup as the root user. Once this has been done to commence an upgrade of the Red Hat Enterprise Virtualization Manager run the rhevm-upgrade command, again as the root user. No additional parameters are required. The command will produce output when it has completed each step of the upgrade process.
# rhevm-upgrade
Checking for updates....
Stopping JBoss Service... DONE!
Backing Up RHEVM DB... DONE!
Updating RHEVM rpm... DONE!
Updating RHEVM DB... DONE!
Running post install configuration... DONE!
Starting JBoss... DONE!
Upgrade log available at /var/log/rhevm/rhevm-upgrade_2011_07_27_08_15_10.log
DB Backup available at /usr/share/rhevm/db-backups/tmpVCI0WM.sql
To upgrade the history service or the reporting package, please run yum update rhevm-reports* and then rhevm-dwh-setup and rhevm-reports-setup.

Red Hat Enterprise Virtualization Hypervisor (v.6 x86_64) channel, also referred to by the identifier rhel-x86_64-server-6-rhevh in Red Hat Network.
rhev-hypervisor.iso is now a symbolic link to a uniquely-named version of the hypervisor ISO image, such as /usr/share/rhev-hypervisor/rhevh-6.2-20111006.0.el6.iso. Different versions of the hypervisor ISO can be installed alongside each other, allowing administrators to run and maintain a cluster on a previous version of the hypervisor while upgrading another cluster for testing.
/usr/share/rhev-hypervisor/rhev-hypervisor5.iso and /usr/share/rhev-hypervisor/rhev-hypervisor6.iso are also created as needed. They link to the most recent installed version of the ISO for Red Hat Enterprise Virtualization Hypervisor 5 and Red Hat Enterprise Virtualization Hypervisor 6 respectively.
Red Hat Enterprise Virtualization Hypervisor (v.6 x86_64) channel from the list presented on the screen, then click the Change Subscription button to finalize the change.
root user.
yum to install the rhev-hypervisor and rhev-hypervisor-tools packages.
# yum install "rhev-hypervisor*"
/usr/share/rhev-hypervisor/ directory. The symbolic link /usr/share/rhev-hypervisor/rhev-hypervisor.iso is updated to point to the ISO image.
rhevh-iso-to-disk and rhevh-iso-to-pxeboot scripts are installed to the /usr/bin directory.
Automatic boot in 30 seconds... is displayed, and begins counting down from thirty, press any key to skip the automatic boot process.
rescue parameter to the list of boot parameters shown on the screen, then press Enter. This action will boot the hypervisor in rescue mode.
# grep -E 'svm|vmx' /proc/cpuinfo
# lsmod | grep kvm
kvm_intel or kvm_amd then the kvm hardware virtualization modules are loaded and the system meets the requirements. If the output does not include the required modules then you must check that your hardware supports the virtualization extensions and that they are enabled in the system's BIOS.
rhevh-iso-to-disk to Create USB Install Mediarhevh-iso-to-disk command will install a hypervisor onto a USB storage device. The rhevh-iso-to-disk command is part of the rhev-hypervisor package. Devices created with this command are able to boot the hypervisors on systems which support booting via USB.
rhevh-iso-to-disk command usage follows this structure:
# rhevh-iso-to-diskimagedevice
device parameter is the partition name of the USB storage device to install to. The image parameter is a ISO image of the hypervisor. The default hypervisor image location is /usr/share/rhev-hypervisor/rhev-hypervisor.iso. The rhevh-iso-to-disk command requires devices to be formatted with the FAT or EXT3 file system.
rhevh-iso-to-diskrhevh-iso-to-disk uses a FAT or EXT3 formatted partition or block device.
/dev/sdb or similar device name.
/dev/sdb1 or similar device name.
rhevh-iso-to-disk command to copy the .iso file to the disk. The --format parameter formats the disk. The --reset-mbr initializes the Master Boot Record (MBR). The example uses a USB storage device named /dev/sdc.
rhevh-iso-to-disk# rhevh-iso-to-disk --format --reset-mbr /usr/share/rhev-hypervisor/rhev-hypervisor.iso /dev/sdc Verifying image... /usr/share/rhev-hypervisor/rhev-hypervisor.iso: eccc12a0530b9f22e5ba62b848922309 Fragment sums: 8688f5473e9c176a73f7a37499358557e6c397c9ce2dafb5eca5498fb586 Fragment count: 20 Checking: 100.0% The media check is complete, the result is: PASS. It is OK to use this media. Copying live image to USB stick Updating boot config file Installing boot loader syslinux: only 512-byte sectors are supported USB stick set up as live image!
/dev/sdc) is ready to be used to boot a system and install the hypervisor on it.
dd to Create USB Install Mediadd command can also be used to install a hypervisor onto a USB storage device. Media created with the command can boot the hypervisor on systems which support booting via USB. Red Hat Enterprise Linux provides dd as part of the coreutils package. Versions of dd are also available on a wide variety of Linux and Unix operating systems.
dd command through installation of Red Hat Cygwin, a free Linux-like environment for Windows. Refer to Procedure 7.2, “Using dd to Create USB Install Media on Systems Running Windows” for instruction on the installation and use of Red Hat Cygwin to install the hypervisor to a USB storage device.
dd command usage follows this structure:
# dd if=imageof=device
device parameter is the device name of the USB storage device to install to. The image parameter is a ISO image of the hypervisor. The default hypervisor image location is /usr/share/rhev-hypervisor/rhev-hypervisor.iso. The dd command does not make assumptions as to the format of the device as it performs a low-level copy of the raw data in the selected image.
dd to Create USB Install Mediadd command to copy the .iso file to the disk. The example uses a USB storage device named /dev/sdc.
dd# dd if=/usr/share/rhev-hypervisor/rhev-hypervisor.iso of=/dev/sdc 243712+0 records in 243712+0 records out 124780544 bytes (125 MB) copied, 56.3009 s, 2.2 MB/s
dd command will overwrite all data on the device specified for the of parameter. Any existing data on the device will be destroyed. Ensure that the correct device is specified and that it contains no valuable data before invocation of the dd command.
/dev/sdc) is ready to boot a hypervisor.
dd to Create USB Install Media on Systems Running Windowsrhsetup.exe executable will download.
Administrator user run the downloaded rhsetup.exe executable. The Red Hat Cygwin installer will display.
dd utility. This is automatically selected for installation.
rhev-hypervisor.iso file downloaded from Red Hat Network to C:\rhev-hypervisor.iso.
Administrator user run Red Hat Cygwin from the desktop. A terminal window will appear.
cat /proc/partitions to see the drives and partitions currently visible to the system.
Administrator@test /
$ cat /proc/partitions
major minor #blocks name
8 0 15728640 sda
8 1 102400 sda1
8 2 15624192 sda2
cat /proc/partitions command and compare the output to that of the previous run. A new entry will appear which designates the USB storage device.
Administrator@test /
$ cat /proc/partitions
major minor #blocks name
8 0 15728640 sda
8 1 102400 sda1
8 2 15624192 sda2
8 16 524288 sdb
dd command to copy the rhev-hypervisor.iso file to the disk. The example uses a USB storage device named /dev/sdb. Replace sdb with the correct device name for the USB storage device to be used.
dd Command Under Red Hat CygwinAdministrator@test / $ dd if=/cygdrive/c/rhev-hypervisor.iso of=/dev/sdb& pid=$!
dd command will overwrite all data on the device specified for the of parameter. Any existing data on the device will be destroyed. Ensure that the correct device is specified and that it contains no valuable data before invocation of the dd command.
dd included with Red Hat Cygwin can take significantly longer than the equivalent on other platforms.
USR1 signal. This can be achieved by issuing the kill in the terminal window as follows:
kill -USR1 $pid
dd Initiated Copy210944+0 records in 210944+0 records out 108003328 bytes (108 MB) copied, 2035.82 s, 53.1 kB/s [1]+ Done dd if=/cygdrive/c/rhev-hypervisor.iso of=/dev/sdb
/dev/sdb) is ready to boot a hypervisor.
cdrecord command. The cdrecord command is part of the cdrecord package which is installed on Red Hat Enterprise Linux by default.
# rpm -q cdrecord cdrecord-2.01-10.7.el5
# yum install cdrecord
cdrecord dev=device /iso/file/path//dev/cdrw) device available and the default hypervisor image location, /usr/share/rhev-hypervisor/rhev-hypervisor.iso.
cdrecord Command# cdrecord dev=/dev/cdrw /usr/share/rhev-hypervisor/rhev-hypervisor.iso
isomd5sum) to verify the integrity of the installation media every time the hypervisor is booted. If media errors are reported in the boot sequence you have a bad CD-ROM. Follow the procedure above to create a new CD-ROM or DVD.
scsi_id functions with multipath. Devices where this is not the case include USB storage and some older ATA disks.


/dev/ttyS0.

upgrade parameter. This will automatically upgrade and reboot the system, rather than displaying the interactive configuration menu. For more information, see the Red Hat Enterprise Linux — Hypervisor Deployment Guide.
Disk Configuration
Boot disk
Automatically Detected Device Selection
Manual Device Selection
Please enter the disk to use for booting RHEV Hypervisor /dev/sda
Installation Disk(s)
Please select the disk(s) to use for installation of RHEV Hypervisor Enter multiple entries separated by commas /dev/mmcblk0,/dev/mmcblk1______________
Password
admin user. The installation script prompts you to enter the desired password in both the Password and Confirm Password fields.
RHEV Hypervisor Installation Finished Successfully will be displayed. Select the button and press Enter to reboot the system.
Please login as 'admin' to configure the node localhost login:
admin at the prompt and press Enter. When prompted enter the password which was set during the installation process and press Enter again to log in.
Device Identification
IPv4 Settings
Dynamic (DHCP) Network Configuration
Static Network Configuration
IPv4 Settings [ ] Disabled [ ] DHCP [*] Static IP Address: 192.168.122.100_ Netmask: 255.255.255.0___ Gateway 192.168.1.1_____
IPv6 Settings
VLAN Configuration
Save Network Configuration
admin password for both local and remote access. SSH password authentication is also enabled or disabled via this screen.
Enable SSH Password Authentication
Change admin Password
admin password in the Password field. You should use a strong password.
admin password in the Confirm Password field. Ensure that the value entered in the Confirm Password field matches the value entered in the Password field exactly. Where this is not the case an error message will be displayed to indicate that the two values are different.
Logrotate Configuration
Rsyslog Configuration
514.
netconsole Configuration
6666.
Save Configuration
kdump file) in the event of a system failure. These kdump files are essential for debugging and support.
Kernel Configuration
NFS location
example.redhat.com:/var/crash
SSH location
root@example.redhat.com
Save Configuration
iSCSI Initiator Name
iqn.1994-05.com.redhat:5189835eeb40
Save Configuration
root password and enables SSH password authentication. Once the hypervisor has successfully been added to the manager it is recommended SSH password authentication is disabled.
Configuration Using a Management Server Address
8443. Where a different port was selected during Red Hat Enterprise Virtualization Manager installation then it should be specified here, replacing the default value.
Configuration Using a Password
Save Configuration
Authentication
Profile Name
Update Source
To Connect Directly to RHN
[*] RHN [ ] Satellite [ ] Subscription Asset Manager URL: ________________________________________ CA : ________________________________________
To Connect via Satellite
[ ] RHN [*] Satellite [ ] Subscription Asset Manager URL: https://your-satellite.example.com CA : https://your-satellite.example.com/pub/RHN-ORG-TRUSTED-SSL-CERT
To Connect via Subscription Asset Manager
[ ] RHN [ ] Satellite [*] Subscription Asset Manager URL: https://subscription-asset-manager.example.com CA : https://subscription-asset-manager.example.com/pub/RHN-ORG-TRUSTED-SSL-CERT
HTTP Proxy
HTTP Proxy Server: proxy.example.com__ Port: 8080_ Username: puser________ Password: ******_______
Save Configuration
| Red Hat Enterprise Linux Version | Red Hat Enterprise Virtualization 2.2 clusters | Red Hat Enterprise Virtualization 3.0 clusters | Red Hat Enterprise Virtualization 3.0 clusters in 2.2 compatibility mode |
|---|---|---|---|
| 5.6+ | Supported | Unsupported | Supported |
| 6.2+ | Unsupported | Supported | Supported |
Install Red Hat Enterprise Linux
vdsm package will fail to create the required system user. The authentication files required by the useradd command must be accessible to the installer. Red Hat Directory Server (RHDS) recommends a security policy with a mixture of local files and LDAP. Following this recommendation will resolve this issue.
Configure VLANs
VLANs are configured for access to the Red Hat Enterprise Virtualization Manager.
Check Red Hat Network Subscriptions
Red Hat Enterprise Virt Management Agent (v 6 x86_64) channel in Red Hat Network, also referred to as rhel-x86_64-rhev-mgmt-agent-6, on Red Hat Network. If you do not have the appropriate subscription entitlements, contact Red Hat Customer Service.
rhn_register command as root to register it. To complete registration successfully you will need to supply your Red Hat Network username and password. Follow the onscreen prompts to complete registration of the system.
# rhn_register
Red Hat Enterprise Virt Management Agent (v 6 x86_64) channel to the machine. To add the channel subscription to the system from the Red Hat Network web interface:
Red Hat Enterprise Virt Management Agent (v 6 x86_64) channel from the list presented on the screen, then click the Change Subscription button to finalize the change.
Edit hosts file
/etc/hosts file (on the Red Hat Enterprise Linux host) for the Red Hat Enterprise Virtualization Manager server to enable vdsm and other services to connect properly to the host.
server1.example.com, Active Directory uses that address and creates a sub-address named rhev-manager.server1.example.com.
/etc/hosts file on the Red Hat Enterprise Linux Host. The following screen output sample resembles the contents of the file:
127.0.0.1 localhost.localdomain localhost ::1 localhost6.localdomain6 localhost6
/etc/hosts with the IP address and both variants of the Red Hat Enterprise Virtualization Manager domain names. The following screen output sample resembles the required contents of the file:
127.0.0.1 localhost.localdomain localhost ::1 localhost6.localdomain6 localhost6 10.0.0.1 server1.example.com rhev-manager.server1.example.com
Open firewall ports
iptables to open the required ports. These steps replace any existing firewall configuration with that required for Red Hat Enterprise Virtualization Manager. If you have existing firewall rules with which this configuration must be merged then you must manually edit the rules defined in the iptables configuration file, /etc/sysconfig/iptables.
# iptables --flush
iptables rules.
# iptables --append INPUT -m state --state ESTABLISHED,RELATED -j ACCEPT # iptables --append INPUT -p icmp -j ACCEPT # iptables --append INPUT -i lo -j ACCEPT # iptables --append INPUT -p tcp --dport 22 -j ACCEPT # iptables --append INPUT -p tcp --dport 16514 -j ACCEPT # iptables --append INPUT -p tcp --dport 54321 -j ACCEPT # iptables --append INPUT -p tcp -m multiport --dports 5634:6166 -j ACCEPT # iptables --append INPUT -p tcp -m multiport --dports 49152:49216 -j ACCEPT # iptables --append INPUT -j REJECT --reject-with icmp-host-prohibited # iptables --append FORWARD -m physdev ! --physdev-is-bridged -j REJECT --reject-with icmp-host-prohibited
iptables commands add firewall rules to accept network traffic on a number of ports. These include:
22 for SSH,
5634 to 6166 for guest console connections,
16514 for libvirt virtual machine migration traffic,
49152 to 49216 for VDSM virtual machine migration traffic, and
54321 for the Red Hat Enterprise Virtualization Manager.
# service iptables save
iptables service is configured to start on boot and has been restarted, or started for the first time if it wasn't already running.
# chkconfig iptables on # service iptables restart
Configure sudo access
root on the host. The default configuration stored in /etc/sudoers contains values to allow this. If this file has been modified since Red Had Enterprise Linux installation these values may have been removed. As root run visudo to ensure that the /etc/sudoers contains the default configuration values. Where it does not they must be added.
# Allow root to run any commands anywhere root ALL=(ALL) ALL
Enable SSH access for root
root with an encrypted key for authentication. To ensure that SSH is configured and root is able to use it to access the system follow these additional steps.
/root/.ssh/authorized_keys.
# yum install openssh-server
chkconfig to verify which run-levels SSH is enabled at.
# chkconfig --list sshd sshd 0:off 1:off 2:on 3:on 4:on 5:on 6:off
on for run-levels 3, 4, and 5. This is the default configuration.
chkconfig to enable it for the required run-levels. The /etc/init.d/sshd script can then be used to ensure the service is currently started.
# chkconfig --level 345 sshd on # /etc/init.d/sshd start
chkconfig --list sshd again and check the output. It should now show the daemon as on at run-level 3, 4, and 5.
root user. This is also a requirement for the Red Hat Enterprise Virtualization Manager to successfully access the machine. In some cases administrator's may have disabled this ability.
/etc/ssh/sshd_config for the value PermitRootLogin. This must be done while logged in as root.
# grep PermitRootLogin /etc/ssh/sshd_config PermitRootLogin no
PermitRootLogin is set to no the value must be changed to yes. To do this edit the configuration file.
# vi /etc/ssh/sshd_config
# /etc/init.d/sshd reload Reloading sshd: [ OK ]
root user should now be able to access the system via SSH.


| alom | Sun Integrated Lights Out Manager (ILOM) |
| apc | APC Master MasterSwitch network power switch |
| bladecenter | IBM Bladecentre Remote Supervisor Adapter |
| drac5 | Dell Remote Access Controller for Dell computers |
| eps | ePowerSwitch 8M+ network power switch |
| ilo | HP Integrated Lights Out standard |
| ipmilan | Intelligent Platform Management Interface |
| rsa | IBM Remote Supervisor Adaptor |
| rsb | Fujitsu-Siemens RSB management interface |
| wti | WTI Network PowerSwitch |
Installing. Once installation is complete, the status will update to Reboot and then Awaiting. The host must be activated for the status to change to Up.
Up. Virtual machines can now run on the host.

Table of Contents
Default. The storage type of the data center is set based on the one selected during installation. If you wish to make use of other storage types then you will need to add additional data centers and clusters to support them.



| Cluster CPU Name | AMD Opteron G1 | AMD Opteron G2 | AMD Opteron G3 |
|---|---|---|---|
| AMD Opteron G1 | Supported | Supported | Supported |
| AMD Opteron G2 | - | Supported | Supported |
| AMD Opteron G3 | - | - | Supported |
| Cluster CPU Name | Intel Conroe | Intel Penryn | Intel Nehalem | Intel Westmere |
|---|---|---|---|---|
| Intel Conroe Family | Supported | Supported | Supported | Supported |
| Intel Penryn Family | - | Supported | Supported | Supported |
| Intel Nehalem Family | - | - | Supported | Supported |
| Intel Westmere Family | - | - | - | Supported |

rhevm and uses this logical network for all traffic.
rhevm network is created and labeled as the Management logical network. The rhevm logical network is intended for management traffic between the Red Hat Enterprise Virtualization Manager and virtualization hosts. Other types of traffic that are common to all Red Hat Enterprise Virtualization environments are:
Logical Network. For example, a data center may have the following networks,
rhevm) is defined for a data center.
Storage logical network for a data center, apply the Storage logical network to a cluster, and implement the Storage logical network for hosts. This process can be repeated for each logical network being added to a data center.

Storage network to the cluster.

Storage network to your data center. On the Logical Networks tab of the Default data center, you should have at least two networks - rhevm and Storage. You can repeat this process for each logical network being added to a data center


interface Port-channel11 switchport access vlan 153 switchport mode access spanning-tree portfast disable spanning-tree bpduguard disable spanning-tree guard root interface GigabitEthernet0/16 switchport access vlan 153 switchport mode access channel-group 11 mode active interface GigabitEthernet0/17 switchport access vlan 153 switchport mode access

Up.

Install nfs-utils
$ rpm -qi nfs-utilsyum while logged in as the root user:
# yum install nfs-utilsConfigure Boot Scripts
nfs and rpcbind services must start at boot time. Use the chkconfig command while logged in as root to modify the boot scripts.
#chkconfig --add rpcbind#chkconfig --add nfs#chkconfig rpcbind on#chkconfig nfs on
#service rpcbind start#service nfs start
Create Directory
# mkdir /exports/iso/exports/iso with the name, and path of the directory you wish to use.
Export Directory
/etc/exports configuration file. Each export path appears on a separate line followed by a tab character and any additional NFS options. Exports to be attached to the Red Hat Enterprise Virtualization Manager must have the read, and write, options set.
/exports/iso using NFS for example you add the following line to the /etc/exports file.
/exports/iso *(rw)/exports/iso with the name, and path of the directory you wish to use.
Reload NFS Configuration
/etc/exports file to take effect the service must be told to reload the configuration. To force the service to reload the configuration run the following command as root:
# service nfs reloadSet Permissions
/exports/iso is the directory to be used as an NFS share.
# chown -R 36:36 /exports/isochmod command. The following command arguments set the required permissions on the /exports/iso directory.
# chmod 0755 /exports/iso
| Name: Enter a suitably descriptive name. |
| Data Center: Select the required Data Center from the drop-down list. |
| Domain Function/ Storage Type: In the drop down menu, select Data → NFS. The storage domain types which are not compatible with the Default data center are grayed out. After you select your domain type, the Export Path field appears. |
Export path: Enter the IP address or a resolvable hostname of the chosen host. The export path should be in the format of 192.168.0.10:/Images/ISO or domain.example.com:/Images/ISO |
| Use Host: Select any of the hosts from the drop down menu. Only hosts which belong in the pre-selected data center will display in this list. |
Storage Domain for a Volume Group. A Volume Group is a set of pre-defined Logical Unit Numbers (LUNs). Red Hat Enterprise Virtualization supports creation of a Storage Domain from a pre-existent Volume Group or a set of LUNs. Neither Volume Groups nor LUNs are able to be attached to more than one Storage Domain at a time.

3260.

Storage Domain for a Volume Group. A Volume Group is a set of pre-defined Logical Unit Numbers (LUNs). Red Hat Enterprise Virtualization supports creation of a Storage Domain from a pre-defined Volume Group or a set of LUNs. Neither Volume Groups nor LUNs are able to be attached to more than one Storage Domain at a time.

/data/images. This is the only path permitted for a Red Hat Enterprise Virtualization Hypervisor. On a Red Hat Enterprise Linux host other paths are supported but the directories to support it must be manually created first.
vdsm user and kvm group. These permissions are set automatically on the /data/images path for Red Hat Enterprise Virtualization Hypervisor hosts. you must set them manually on paths to be used for local storage on Red Hat Enterprise Linux hosts.
# chown 36:36 /data /data/images # chmod 0755 /data /data/images
/data directory. Any path is permitted on a Red Hat Enterprise Linux host. Follow these instructions to add local storage:
/data/images.
root user.
rhevm-iso-uploader command to upload the ISO image. This action will take some time, the amount of time varies depending on the size of the image being uploaded and available network bandwidth.
RHEL6.iso is uploaded to the ISO domain called ISODomain using NFS. The command will prompt for an administrative username and password. The username must be provided in the form username@domain.
# rhevm-iso-uploader --iso-domain=ISODomain upload RHEL6.iso/usr/share/virtio-win/virtio-win.iso
/usr/share/virtio-win/virtio-win.vfd
/usr/share/rhev-guest-tools-iso/rhev-tools-setup.iso
rhevm-iso-uploader command to upload these images to your ISO storage domain. Once the image files have been uploaded they can be attached to, and used by, virtual machines.
virtio-win.iso, virtio-win.vfd, and rhev-tools-setup.iso image files are uploaded to the ISODomain ISO storage domain.
# rhevm-iso-uploader --iso-domain=ISODomain upload /usr/share/virtio-win/virtio-win.iso /usr/share/virtio-win/virtio-win.vfd /usr/share/rhev-guest-tools-iso/rhev-tools-setup.isoTable of Contents
| Log File | Description |
|---|---|
/var/log/rhevm/rhevm-setup-
|
Log from the rhevm-setup command. A log is generated each time the command is run. The date and time of the run is used in the filename to allow multiple logs to exist concurrently.
|
/var/log/rhevm/rhevm-upgrade-
|
Log from the rhevm-upgrade command. A log is generated each time the command is run. The date and time of the run is used in the filename to allow multiple logs to exist concurrently.
|
/var/log/rhevm/rhevm-dwh/rhevm-dwh-setup-
|
Log from the rhevm-dwh-setup command. This is the command used to create the rhevm_history database for reporting. A log is generated each time the command is run. The date and time of the run is used in the filename to allow multiple logs to exist concurrently.
|
/var/log/rhevm/rhevm-reports/rhevm-reports-setup-
|
Log from the rhevm-reports-setup command. This is the command used to install the Red Hat Enterprise Virtualization Manager Reports modules. A log is generated each time the command is run. The date and time of the run is used in the filename to allow multiple logs to exist concurrently.
|
| Log File | Description |
|---|---|
/var/log/rhevm/rhevm.log
| Reflects all Red Hat Enterprise Virtualization Manager GUI crashes, Active Directory look-ups, Database issues, and other events. |
| Log File | Description |
|---|---|
| Client side log of messages output by the Administration Portal WPF applet. |

ipa object-operation
# ipa user-add command to create IPA users. Numerous options are available to customize the way your IPA users are created. Use the ipa help user command to access the available help on operations regarding user creation. Password management can be performed as a separate operation or as part of the initial user creation process. This, and other aspects of creating IPA users, are discussed below.
# ipa user-add command to create an IPA user. You can run this command with or without additional parameters. If you omit any of the required parameters, the interface will prompt you for the information.
ipa user-add command was executed without any additional parameters; all required information was entered in interactive mode.
# ipa user-add
First name: Ryan
Last name: Andrews
User login [randrews]:
---------------------
Added user "randrews"
---------------------
User login: randrews
First name: Ryan
Last name: Andrews
Full name: Ryan Andrews
Display name: Ryan Andrews
Initials: RA
Home directory: /home/randrews
GECOS field: randrews
Login shell: /bin/sh
Kerberos principal: randrews@IPADOCS.ORG
UID: 1316000004ipa passwd <user login> to create a password for the user. This is a temporary password, or one-time password (OTP), and the user is required to change it the first time they log in. This is done intentionally, so that an administrator can reset a password for a user but they are unable to take advantage of that knowledge, because the user must change the password when they first log in.
--password option to the ipa user-add command. This will force the command to prompt for an initial password. As an alternative, echo the password directly into the command:
# echo "secret123" | ipa user-add asmart --first=Alex --last=Smart --password
--------------------
Added user "asmart"
--------------------
User login: asmart
First name: Alex
Last name: Smart
Full name: Alex Smart
Display name: Alex Smart
Initials: AS
Home directory: /home/asmart
GECOS field: asmart
Login shell: /bin/sh
Kerberos principal: asmart@IPADOCS.ORG
UID: 1315400003
kinit <user login> to log in to IPA. This will prompt you for a password and then immediately request a password change.
Forest and associated Domain, refer to the Microsoft documentation at: http://technet.microsoft.com/en-au/library/cc772464(WS.10).aspx.
Domain to:
Join a computer to the domain.
Modify the membership of a group.
Administrator userAdministrator account as the Red Hat Enterprise Virtualization Manager administrative user.
internal this is only used for the admin user. To add and remove other users from the system it is first necessary to add the directory service(s) in which they are found.
rhevm-manage-domains, to add and remove domains provided by these services. In this way it is possible to grant access to the Red Hat Enterprise Virtualization environment to users stored across multiple domains. This is true even where some users are stored in a domain managed by Active Directory and others are stored in a domain managed by IPA.
rhevm-manage-domains command on the machine to which Red Hat Enterprise Virtualization Manager was installed. The rhevm-manage-domains command must be run as the root user.
Usage: rhevm-manage-domains -action=ACTION [options]addeditdeletevalidatelist-domain=DOMAIN-domain parameter is mandatory for add, edit, and delete.
-user=USER-user parameter is mandatory for add, and optional for edit.
-interactive-passwordFile option, must be used to provide the password for use with the add action.
-passwordFile=FILE-interactive option, must be used to provide the password for use with the add action.
-configFile=FILE-configFile parameter is always optional.
-reportvalidate action all validation errors encountered will be reported in full.
rhevm-manage-domains command's help output:
# rhevm-manage-domains --help
rhevm-manage-domains to perform basic manipulation of the Red Hat Enterprise Virtualization Manager domain configuration.
rhevm-manage-domains command to add the directory.demo.redhat.com domain to the Red Hat Enterprise Virtualization Manager configuration. The configuration is set to use the admin user when querying the domain with the password to be provided interactively.
# rhevm-manage-domains -action=add -domain='directory.demo.redhat.com' -user='admin' -interactive loaded template kr5.conf file setting default_tkt_enctypes setting realms setting domain realm success User guid is: 80b71bae-98a1-11e0-8f20-525400866c73 Successfully added domain directory.demo.redhat.com
rhevm-manage-domains command to edit the directory.demo.redhat.com domain in the Red Hat Enterprise Virtualization Manager configuration. The configuration is updated to use the admin user when querying this domain with the password to be provided interactively.
# rhevm-manage-domains -action=edit -domain=directory.demo.redhat.com -user=admin -interactive loaded template kr5.conf file setting default_tkt_enctypes setting realms setting domain realmo success User guid is: 80b71bae-98a1-11e0-8f20-525400866c73 Successfully edited domain directory.demo.redhat.com
rhevm-manage-domains command to remove the directory.demo.redhat.com domain from the Red Hat Enterprise Virtualization Manager configuration. Users defined in the removed domain will no longer be able to authenticate with Red Hat Enterprise Virtualization Manager. The entries for the affected users will remain defined in Red Hat Enterprise Virtualization Manager until they are explicitly removed.
admin user from the internal domain will be able to log in until another domain is added.
# rhevm-manage-domains -action=delete -domain='directory.demo.redhat.com' WARNING: Domain directory.demo.redhat.com is the last domain in the configuration. After deleting it you will have to either add another domain, or to use the internal admin user in order to login. Successfully deleted domain directory.demo.redhat.com. Please remove all users and groups of this domain using the Administration portal or the API.
rhevm-manage-domains command to validate the Red Hat Enterprise Virtualization Manager configuration. The command attempts to log into each listed domain with the credentials provided in the configuration. If the attempt is successful then the domain is reported as valid.
# rhevm-manage-domains -action=validate User guid is: 80b71bae-98a1-11e0-8f20-525400866c73 Domain directory.demo.redhat.com is valid.
rhevm-manage-domains command to list the domains defined in the Red Hat Enterprise Virtualization Manager configuration. For each configuration entry the command displays the domain, the username — in User Principle Name (UPN) format, and whether the domain is local or remote.
# rhevm-manage-domains -action=list Domain: directory.demo.redhat.com User name: admin@DIRECTORY.DEMO.REDHAT.COM This domain is a remote domain.
rhevm-config.
--cver parameter is used to specify which configuration version is to be used. The default configuration version is general.
rhevm-config command's help output:
# rhevm-config --help--list parameter to list available configuration keys.
# rhevm-config --list--all parameter to list available configuration values.
# rhevm-config --all--get parameter to get the value of a specific key.
# rhevm-config --get KEY_NAMEKEY_NAME with the name of the key to retrieve. The tool returns the key name, value, and the configuration version. Optionally the --cver parameter is used to specify the configuration value from which the value should be retrieved.
--set parameter to set the value of a specific key. You must also set the configuration version to which the change is to apply using the --cver parameter.
# rhevm-config --set KEY_NAME=KEY_VALUE --cver=VERSIONKEY_NAME with the name of the key to set, and replace KEY_VALUE with the value to assign to it. In an environment with more than one configuration version you must also take care to replace VERSION with the name of the configuration version in use.
# rhevm-config --get=SearchResultsLimit --cver=general
100
# rhevm-config --set SearchResultsLimit=50 --cver=general
rhevm-iso-uploader. You must be logged in as the root user to run it successfully. You must provide the administration credentials for the Red Hat Enterprise Virtualization environment on the command line. Full usage information, including a list of all valid options for the command, is available by running the rhevm-iso-uploader -h command.
Usage:rhevm-iso-uploader[options]listrhevm-iso-uploader[options]upload[file].[file]...[file]
list, and upload.
list parameter lists the available ISO storage domains. These storage domains are the valid targets for ISO uploads. By default the list is obtained from the Red Hat Enterprise Virtualization Manager installation on the local machine.
upload parameter uploads the selected ISO file(s) to the specified ISO storage domain. By default the transfer is performed using NFS however SSH is also available.
list or upload parameter is provided. Where upload is selected then the name of at least one local file to upload must also be provided.
rhevm-iso-uploader command has a large number of options.
--version-h, --help--quiet--log-file=PATHPATH as the log file the command should use for its own log output.
--conf-file=PATHPATH as the configuration file the command should use.
-v, --verbose-f, --force-u USER, --user=USERUSER. This must be a user that exists in directory services, and is known to the Red Hat Enterprise Virtualization Manager. The user must be specified in the format user@domain, where user replaced by the username, and domain is replaced by the directory services domain in use.
-r FQDN, --rhevm=FQDNFQDN. FQDN must be replaced by the fully qualified domain name of the manager. By default it is assumed that the ISO uploader is being run on the same machine as the manager. Therefore the default value for this parameter is localhost.
-i, --iso-domain=ISODOMAINISODOMAIN as the destination for uploads.
-n, --nfs-server=NFSSERVERNFSSERVER as the destination for uploads. This option is an alternative to --iso-domain, the two must not be used at the same time.
# rhevm-iso-uploader --nfs-server=storage.demo.redhat.com:/iso/path upload RHEL6.0.iso--ssh-user=USERUSER as the SSH username to use for the upload.
--ssh-port=PORTPORT as the port to use when connecting to SSH.
-k KEYFILE, --key-file=KEYFILEKEYFILE as the public key to use for SSH authentication. If no key is set the program will prompt you to enter the password of the user specified instead.
#rhevm-iso-uploader listPlease provide the REST API username for RHEV-M (CTRL+D to abort):admin@directory.demo.redhat.comPlease provide the REST API password for RHEV-M (CTRL+D to abort): ISO Storage Domain List: ISODomain #rhevm-iso-uploader --iso-domain=Please provide the REST API username for RHEV-M (CTRL+D to abort):ISODomainuploadRHEL6.isoadmin@directory.demo.redhat.comPlease provide the REST API password for RHEV-M (CTRL+D to abort):
rhevm-log-collector. You must be logged in as the root user to run it successfully. You must provide the administration credentials for the Red Hat Enterprise Virtualization environment on the command line. Full usage information, including a list of all valid options for the command, is available by running the rhevm-log-collector -h command.
Usage:rhevm-log-collector[options]list[all, clusters, datacenters]rhevm-log-collector[options]collect
list, and collect.
list parameter lists either the hosts, clusters, or data centers attached to the Red Hat Enterprise Virtualization Manager. You are then able to filter log collection based on the listed objects.
collect parameter performs log collection from the Red Hat Virtualization Manager. The collected logs are placed in an archive file under the /tmp/logcollector directory. The rhevm-log-collector command outputs the specific filename that it chose to use when log collection is completed.
rhevm-log-collector command has a large number of options. You can use these options to further refine the scope of log collection.
--version-h, --help--conf-file=PATHPATH as the configuration file the tool is to use.
--local-tmp=PATHPATH as the directory to which retrieved logs are to be saved. Default is /tmp/logcollector.
--ticket-number=TICKETTICKET as the ticket, or case number, to associate with the SOS report.
--upload=FTP_SERVERFTP_SERVER as the destination for retrieved logs to be sent using FTP. Do not use this option unless advised to by a Red Hat support representative.
--quiet--log-file=PATHPATH as the log file the command should use for its own log output. Note that this is not to be confused with the --local-tmp parameter.
-v, --verboseA and B where the name of the host matches pattern SalesHost*.
--no-hypervisors-u USER, --user=USERUSER. This must be a username that exists in directory services, and is known to the Red Hat Enterprise Virtualization Manager. The user must be specified in the format user@domain, where user is replaced by the username, and domain is replaced by the directory services domain in use.
-r FQDN, --rhevm=FQDNFQDN. FQDN must be replaced by the fully qualified domain name of the manager. By default it is assumed that the log collector is being run on the same machine as the manager. Therefore the default value for this parameter is localhost.
-c CLUSTER, --cluster CLUSTERCLUSTER. The cluster(s) for inclusion must be specified in a comma separated list of cluster names or match patterns.
-d DATACENTER, --data-center DATACENTERDATACENTER. The data center(s) for inclusion must be specified as a comma separated list of data center names or match patterns.
-H HOSTS_LIST, --hosts=HOSTS_LISTHOSTS_LIST. The hosts for inclusion must be specified as a comma separated list of hostnames, fully qualified domain names, or IP addresses. Match patterns for each type of value are also valid.
--java-home, --jboss-user, and jboss-pass parameters must also be provided.
--jboss-home=JBOSS_HOME/var/lib/jbossas.
--java-home=JAVA_HOME/usr/lib/jvm/java.
--jboss-profile=JBOSS_PROFILE'rhevm-slimmed'.
--enable-jmx--jboss-user=JBOSS_USERadmin.
--jboss-logsize=LOG_SIZE--jboss-stdjar=STATESTATE with on, or off. The default is on.
--jboss-servjar=STATESTATE with on, or off. The default is on.
--jboss-twiddle=STATESTATE with on, or off. The default is on.
--jboss-appxml=XML_LIST'all'.
--ssh-host=PORTPORT as the port to use for SSH connections with virtualization hosts.
-k KEYFILE, --key-file=KEYFILEKEYFILE as the public SSH key to be used for accessing the virtualization hosts.
--max-connections=MAX_CONNECTIONSMAX_CONNECTIONS as the maximum concurrent SSH connections for logs from virtualization hosts. The default is 10.
pg-pass is specified. The database username, and database name also must be specified if they were changed from the default values during installation.
pg-dbhost, and optionally supply a pg-host-key, to collect remote logs. The PostgreSQL SOS plugin must be installed on the database server for remote log collection to be successful.
--no-postgresql--pg-user=USERUSER as the username to use for connections with the database server. The default is postgres.
--pg-dbname=DBNAMEDBNAME as the database name to use for connections with the database server. The default is rhevm.
--pg-dbhost=DBHOSTDBHOST as the hostname for the database server. The default is localhost.
--pg-host-key=KEYFILEKEYFILE as the public identity file (private key) for the database server. This value is not set by default as it is not required where the database exists on the local host.
#rhevm-log-collectorPlease provide the username for rhevm (CTRL+D to abort): admin@directory.demo.redhat.com Please provide the password for rhevm (CTRL+D to abort): Host list (datacenter=None, cluster=None, host=None): Data Center | Cluster | Hostname/IP Address SalesDataCenter | SalesCluster | 192.168.122.250 EngineeringDataCenter | EngineeringCluster | 192.168.122.251 FinanceDataCenter | FinanceCluster | 192.168.122.252 #rhevm-log-collector collectPlease provide the username for rhevm (CTRL+D to abort): admin@directory.demo.redhat.com Please provide the password for rhevm (CTRL+D to abort): About to collect information from 3 hypervisors. Continue? (Y/n): Y INFO: Gathering information from selected hypervisors... INFO: collecting information from 192.168.122.250 INFO: collecting information from 192.168.122.251 INFO: collecting information from 192.168.122.252 INFO: finished collecting information from 192.168.122.250 INFO: finished collecting information from 192.168.122.251 INFO: finished collecting information from 192.168.122.252 Please provide the password to dump the PostgreSQL database (CTRL+D to abort): INFO: Gathering PostgreSQL the RHEV-M database and log files from localhost... INFO: Gathering RHEV-M information... Please provide the password for jboss (CTRL+D to abort): INFO: Log files have been collected and placed in /tmp/logcollector/sosreport-rhn-account-20110804121320-ce2a.tar.xz. The MD5 for this file is 6d741b78925998caff29020df2b2ce2a and its size is 26.7M
| Revision History | |||
|---|---|---|---|
| Revision 5-0 | Tuesday November 22 2011 | ||
| |||
| Revision 4-0 | Friday November 04 2011 | ||
| |||
| Revision 3-0 | Thursday October 13 2011 | ||
| |||
| Revision 3-0 | Monday August 22 2011 | ||
| |||
| Revision 2-0 | Friday August 5 2011 | ||
| |||
| Revision 1-0 | Wednesday December 15 2010 | ||
| |||