search

MicrosoftDocs / azure-docs

Open source documentation of Microsoft Azure
https://docs.microsoft.com/azure
Creative Commons Attribution 4.0 International
10.28k stars 21.47k forks source link

VDDK installation instruction need to be updated with accurate information. #92013

Closed jackchenwork closed 2 years ago

jackchenwork commented 2 years ago

[Enter feedback here]

Currently the instruction state:

  1. Download VMware Virtual Disk Development Kit 6.7.0 from VMware, Inc.
  2. Extract the downloaded file, copy the contents of the extracted folder and paste them in another folder on the appliance - C:\Program Files\VMware\VMware Virtual Disk Development Kit

The kit from Vmware is VMware-vix-disklib-6.7.0-8535999.x86_64.zip file and when it's extracted, it's extracted into a VMware-vix-disklib-6.7.0-8535999.x86_64 folder.

Copying subfolders from VMware-vix-disklib-6.7.0-8535999.x86_64 into "C:\Program Files\VMware\VMware Virtual Disk Development Kit" doesn't work.
Copying VMware-vix-disklib-6.7.0-8535999.x86_64 into "C:\Program Files\VMware\VMware Virtual Disk Development Kit" doesn't work.

Took me quite some time to find VMware-vix-disklib-6.7.0-8535999.x86_64 need to be renamed as VMware-vix-disklib , then copy into "C:\Program Files\VMware\VMware Virtual Disk Development Kit" folder.

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

SadiqhAhmed-MSFT commented 2 years ago

@jackchenwork Thanks for the feedback. We will review your feedback with the content owner and update the documentation as required.

Vikram1988 commented 2 years ago

@jackchenwork the instructions clearly say that you need to copy the contents of the extracted folder. It means the files within the extracted folder and copy it to the desired location. The issue has not been reported to us before so I am not sure if its the issue with the instructions

jackchenwork commented 2 years ago

The zip file from Vmware is called VMware-vix-disklib-6.7.0-*.x86_64.zip.

When you extract it, it has files :

2022-04-27 05:08 PM

. 2022-04-27 05:08 PM .. 2022-04-27 05:08 PM bin 2022-04-27 05:08 PM doc 2022-04-27 05:08 PM 65,194 EULA.rtf 2022-04-27 05:08 PM include 2022-04-27 05:08 PM lib 2022-04-27 05:08 PM 35,041 patents.rtf

Your document suggested "copy the contents of the extracted folder and paste them in another folder on the appliance - C:\Program Files\VMware\VMware Virtual Disk Development Kit"

If you copy all those files directly into "C:\Program Files\VMware\VMware Virtual Disk Development Kit", it won't work.

What need to be done is you need to create a new folder called "C:\Program Files\VMware\VMware Virtual Disk Development Kit\VMware-vix-disklib\" , and copy all those files into the VMware-vix-disklib subfolder.

Vikram1988 commented 2 years ago

@jackchenwork please find the screenshot below where i added the contents of the unzipped folder as is to the desired location and my VDDK check went through: image

jackchenwork commented 2 years ago

OK I retried it, somehow it worked this time. may there was some other issue caused the verify failure. please close this issue.

MadDogofShimano commented 2 years ago

Apologies for necroing this, but I believe updating may still be necessary because VDDK 6.7.0 is the reported version for use both in documentation and within the Azure Migration appliance configuration manager, and after some testing it seems like the appliance refuses to/cannot recognize 6.7.0. However, I tried the same instructions carefully with VDDK 7.0.0 and it worked out fine.

soramanego commented 1 year ago

This worked for me: To install the package on Windows:

  1. From Vmware website, download VDDK the v7 the Download page, choose the .zip file for Windows and download it to your development system.

  2. unzip VMware-vix-disklib-*.zip

  3. Copy/paste the extracted folders to C:\Program Files\VMware\VMware Virtual Disk Development Kit

  4. Go to the bin subfolder, locate the vstor2install.bat script, and double-click to run it (as Administrator). The batch script should be run in place so that the current directory for execution is the bin subfolder. By running it, you implicitly accept the VMware license terms. a Note: If vstor2 is already installed on a backup proxy, you should first uninstall it with vstor2uninstall.bat (from its corresponding VDDK version) then run the new install script.

  5. Edit the Windows registry with regedit and check for the following key. If this key exists from a previous VDDK install, right-click to delete it. Add a registry entry with the following key:

a. HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\VMware, Inc.\VMware Virtual Disk Development Kit

b. inside of it, add a DWORD key:

i. Name: VerifySSLCertificates ii.Value: 0

  1. Reboot the machine