Chapter 1. Installing CloudForms
CloudForms Management Engine is able to be installed and ready to configure in a few quick steps. After downloading CloudForms Management Engine as a virtual machine image template from the Red Hat Customer Portal, the installation process takes you through the steps of uploading the appliance to a supported virtualization or cloud provider.
After installing the CloudForms Management Engine Appliance, you must configure the database for Red Hat CloudForms. See Section 2.3, “Configuring a Database for CloudForms Management Engine”.
1.1. Obtaining the CloudForms Management Engine Appliance
- Go to access.redhat.com and log in to the Red Hat Customer Portal using your customer account details.
- Click Downloads in the menu bar.
- Click A-Z to sort the product downloads alphabetically.
- Click → to access the product download page.
- From the list of installers and images, select the CFME Red Hat Virtual Appliance download link.
1.2. Uploading the Appliance on Red Hat Enterprise Virtualization Manager
Uploading the CloudForms Management Engine Appliance file onto Red Hat Enterprise Virtualization Management systems has the following requirements:
44 GB of storage space on both the export domain and the local partition where
/tmpresides since the
OVFarchive is locally expanded into that directory.
rhevm-image-uploaderpackage containing the
engine-image-uploaderscript to your local machine.
# yum install rhevm-image-uploader
It is recommended to use
-v(verbose logging) when using the
engine-image-uploaderscript to see the progression of the upload.
- Depending on your infrastructure, allow approximately 90 minutes for the upload.
OVFis uploaded and imported as a template, add a network adapter to the template itself.
1.3. Using the Image Uploader Tool
engine-image-uploader command allows you to list export storage domains and upload virtual machine images in
OVF format to an export storage domain and have them automatically recognized in the Red Hat Enterprise Virtualization Manager.
The image uploader only supports
gzip-compressed OVF files created by Red Hat Enterprise Virtualization.
The archive contains images and master directories in the following format:
|-- images | |-- [Image Group UUID] | |--- [Image UUID (this is the disk image)] | |--- [Image UUID (this is the disk image)].meta |-- master | |---vms | |--- [UUID] | |--- [UUID].ovf
The basic syntax for the image uploader command is:
engine-image-uploader [options] listengine-image-uploader [options] upload [file].[file]...[file]
The image uploader command supports two actions: list, and upload.
- The list action lists the export storage domains to which images can be uploaded.
- The upload action uploads images to the specified export storage domain.
You must specify one of the above actions when you use the
engine-image-uploader command. Moreover, you must specify at least one local file to use the upload action.
There are several parameters to further refine the
engine-image-uploader command. You can set defaults for any of these parameters in the
- -h, --help
- Displays information on how to use the image uploader command.
[PATH]as the configuration file the command will use. The default is
[PATH]as the specific file name the command will use to write log output. The default is
[PATH]as the certificate for validating the engine. The default is
- -i, --insecure
- Specifies that no attempt will be made to verify the engine.
- Sets quiet mode, reducing console output to a minimum.
- Sets verbose mode, providing more console output.
- -f, --force
- Specifies that no attempt will be made to verify the engine.
Force mode is necessary when the source file being uploaded has the same file name as an existing file in the destination export domain. This option forces the existing file to be overwritten.
Red Hat Enterprise Virtualization Manager Options
- -u [USER], --user=[USER]
Specifies the user whose credentials will be used to execute the command. The
[USER]is specified in the format
[username]@[domain]. The user must exist in the specified domain and be known to the Red Hat Enterprise Virtualization Manager.
- -r [FQDN], --engine=[FQDN]
Specifies the IP address or fully qualified domain name of the Red Hat Enterprise Virtualization Manager from which the images will be uploaded. It is assumed that the image uploader is being run from the same machine on which the Red Hat Enterprise Virtualization Manager is installed. The default value is
Export Storage Domain Options
The following options specify the export domain to which the images will be uploaded. These options cannot be used together; you must use either the
-e option or the
- -e [EXPORT_DOMAIN], --export-domain=[EXPORT_DOMAIN]
Sets the storage domain
EXPORT_DOMAINas the destination for uploads.
- -n [NFSSERVER], --nfs-server=[NFSSERVER]
Sets the NFS path
[NFSSERVER]as the destination for uploads.
- Import Options
- The following options allow you to customize which attributes of the images being uploaded are included when the image is uploaded to the export domain.
- -i, --ovf-id
Specifies that the
UUIDof the image will not be updated. By default, the command generates a new
UUIDfor images that are uploaded. This ensures there is no conflict between the ID of the image being uploaded and the images already in the environment.
- -d, --disk-instance-id
Specifies that the
instance IDfor each disk in the image will not be renamed. By default, the command generates new
UUIDsfor disks in images that are uploaded. This ensures there are no conflicts between the disks on the image being uploaded and the disks already in the environment.
- -m, --mac-address
Specifies that network components in the image will not be removed from the image. By default, the command removes network interface cards from image being uploaded to prevent conflicts with network cards on other virtual machines already in the environment. If you do not use this option, you can use the Administration Portal to add network interface cards to newly imported images and the Manager will ensure there are no
- -N [NEW_IMAGE_NAME], --name=[NEW_IMAGE_NAME]
- Specifies a new name for the image being uploaded.
1.3.1. Uploading the Appliance with the Image Uploader
The following procedure uploads the CloudForms Management Engine Appliance using the Image Uploader tool.
- Change to the directory containing the CloudForms Management Engine Appliance.
Run the following command:
# engine-image-uploader -N `newimagename` -e `myexportdomain` -v -m upload cfme-rhevm-5.3-15.x86_64.rhevm.ova
newimagenamewith your chosen name for the image, and substitute
myexportdomainwith your chosen export storage domain.
Enter the password of the default administrative user for your Red Hat Enterprise Virtualization Manager when prompted.
Please provide the REST API password for the admin@internal oVirt Engine user (CTRL+D to abort): **********Important
Ensure your Red Hat Enterprise Virtualization Manager has administrator access to the chosen export storage domain.
It takes approximately 90 minutes to upload the CloudForms Management Engine Appliance file to the Red Hat Enterprise Virtualization Manager.
1.4. Uploading the Appliance Manually
The following procedure provides manual upload instructions if the Image Uploader tool is not available or fails to upload.
- Log into a host in your Red Hat Enterprise Virtualization with a mount to the Export storage domain.
- Change to the Export storage domain’s directory.
Copy the CloudForms Management Engine Appliance
OVFarchive to this directory.
OVFfile using the
$ tar xvf cfme-rhevm-5.3-15.x86_64.rhevm.ova
Set the following permissions:
chown -R 36:36 images/ chown -R 36:36 master/
1.5. Running CloudForms Management Engine
After uploading the appliance to the export storage domain, import it as a template and create a virtual machine. Use the following procedure as a guide.
Import the appliance image from the export storage domain as a template in a Red Hat Enterprise Virtualization data storage domain. Use the
newimagenameyou specified when you uploaded the image to find the image to import as a template. Once the import is complete, check the template for a network interface (NIC). If the template does not include one, create a NIC for it.
- Create a new virtual machine using the CloudForms Management Engine Appliance template as a basis. See the Red Hat Enterprise Virtualization Administrator Guide for instructions.
- Add a database disk if you are hosting the database on the same machine as the appliance.
- Start the newly created CloudForms Management Engine Appliance virtual machine.
Your Red Hat Enterprise Virtualization environment now contains a running CloudForms Management Engine Appliance.