Document URL: https://access.redhat.com/documentation/en/red-hat-cloudforms/4.2-beta/single/installing-red-hat-cloudforms-on-vmware-vsphere/#installing-vmware-vddk

Section Number and Name: 3.1 "Installing VMware VDDK on Red Hat CloudForms"

Describe the issue: 

In the "Installing Red Hat CloudForms on VMware vSphere" for both CloudForms 4.1 and 4.2-beta:

https://access.redhat.com/documentation/en/red-hat-cloudforms/4.1/single/installing-red-hat-cloudforms-on-vmware-vsphere/

https://access.redhat.com/documentation/en/red-hat-cloudforms/4.2-beta/single/installing-red-hat-cloudforms-on-vmware-vsphere/#installing-vmware-vddk

It reads:
"Execution of SmartState Analysis on virtual machines within a VMware environment requires the Virtual Disk Development Kit (VDDK). Red Hat CloudForms supports VDDK 5.5."

And also:
"Download VDDK 5.5 (VMware-vix-disklib-5.5.0-1284542.x86_64.tar.gz at the time of this writing) from the VMware website."

By "at the time of this writing" does it imply one must/should download the latest? (5.5.5) or use the version that is specified in the manual "5.5.0-1284542". (and only that version).

VDDK Version 5.5 link: https://developercenter.vmware.com/web/sdk/55/vddk
Latest: 5.5.5 (but it is NOT recommended, see below)

There is this article:

Why does smart state analysis fails in CloudForms 3.2 using VDDK 5.5.5?
https://access.redhat.com/solutions/2270471

In it one can read:
"Resolution: VDDK 5.5.4 or higher (excluding 5.5.5)" 

It basically means one should not install 5.5.5?

But also there is this article: 

Installing the Vmware 6.0 VDDK on a Red Hat CloudForms Management Engine Appliance
https://access.redhat.com/articles/2078103

"You can either install Virtual Disk Development Kit 5.5, or use the following procedure to install Virtual Disk Development Kit version 6.0 or above."

VMWare link: https://developercenter.vmware.com/web/sdk/60/vddk
Latest: 6.0.2

While the article itself solves an issue with people using that vddk version, it says "VMware vSphere 6 virtual machine with Virtual Disk Development Kit 6.0".


Suggestions for improvement: 

The guide "Installing Red Hat CloudForms on VMware vSphere":
 * does not mention any vcenter 5 / vcenter 6 prefered vddk version
 * it explicitly says to use vddk 5.5.0

But:
 * article 2270471 says vddk 5.5.5 must not be used (for the old cfme <3.2>, does that even apply to current cfme?)
 * article 2078103 says one can install vddk 6.0 or 5.5 for vcenter 6. but what is the criteria for that?

And also:
 * put a note to which appliance to install the vddk in a multi-appliance setup (worker appliance on vmware?).

Thanks in advance.