Document URL: https://access.redhat.com/documentation/en/red-hat-cloudforms/4.2/paged/installing-red-hat-cloudforms-on-red-hat-enterprise-virtualization/
Section Number and Name: 1.4 Uploading the Appliance Manually
Describe the issue:
Section 1.4 says to cd to the NFS share for the export domain, copy the .ova to that directory, and then unpack it with tar. This is incorrect. It should say to run the ls command, find a directory with a long GUID name, cd to that directory, and do the tar command from there.
Suggestions for improvement:
Append something like this under step 2:
Change to the Export storage domain’s directory.
Copy the Red Hat CloudForms appliance OVF archive to this directory.
Issue the ls command and look for a directory named after a GUID.
cd to that directory
Extract the OVF file using the tar command:
tar xvf ../cfme-rhevm-22.214.171.124-1.x86_64.rhevm.ova
Pick up with the chown commands as documented in the original step 5.
Now the extracted files are in the correct directory tree. Also notice the tar command above uses the correct filename downloaded from the user portal.
Here is how I did it after cleaning up from the first try. After going through the process below, my RHVM export domain showed the new appliance in the Admin portal GUI.
[root@storage2015 rhevexports]# ls
[root@storage2015 rhevexports]# cd 4a8fc2b1-0a57-47fd-b622-7e170981305b/
[root@storage2015 4a8fc2b1-0a57-47fd-b622-7e170981305b]# ls
dom_md images master
[root@storage2015 4a8fc2b1-0a57-47fd-b622-7e170981305b]# tar xvf ../cfme-rhevm-126.96.36.199-1.x86_64.rhevm.ova
[root@storage2015 4a8fc2b1-0a57-47fd-b622-7e170981305b]# chown -R 36:36 master/
[root@storage2015 4a8fc2b1-0a57-47fd-b622-7e170981305b]# chown -R 36:36 images/
Assigning to Dayle for review.
Created attachment 1266529 [details]
Revised "Uploading the Appliance Manually" section
I've revised the steps in this section now (preview attached).
Could you please have a look and let me know if the instructions are correct now, and clear enough?
Sorry it took me so long to look this over. The new instructions look like they match what I put in the BZ. Think about including an example, so installers know why we want them to chown images/ and master/. You can use the one I pasted into the bz if you want.
Thanks for reviewing, Greg! I'll add your example then so it makes more sense to readers.
Created attachment 1269129 [details]
Revised version of Uploading Appliance Manually - with CLI example text
The 4.2 Installing Red Hat CloudForms on Red Hat Virtualization guide has been republished to the Customer Portal with revised section "1.2.3. Uploading the Appliance Manually", available here: