Troubleshooting: Microsoft Hyper-V setup - AWS Storage Gateway

Troubleshooting: Microsoft Hyper-V setup

The following table lists typical issues that you might encounter when deploying Storage Gateway on the Microsoft Hyper-V platform.

Issue Action to Take

You try to import a gateway and receive the following error message:

"A server error occurred while attempting to import the virtual machine. Import failed. Unable to find virtual machine import files under location [...]. You can import a virtual machine only if you used Hyper-V to create and export it."

This error can occur for the following reasons:

  • If you are not pointing to the root of the unzipped gateway source files. The last part of the location you specify in the Import Virtual Machine dialog box should be AWS-Storage-Gateway. For example:

    C:\prod-gateway\unzippedSourceVM\AWS-Storage-Gateway\.

  • If you have already deployed a gateway and you did not select the Copy the virtual machine option and check the Duplicate all files option in the Import Virtual Machine dialog box, then the VM was created in the location where you have the unzipped gateway files and you cannot import from this location again. To fix this problem, get a fresh copy of the unzipped gateway source files and copy to a new location. Use the new location as the source of the import.

    If you plan on creating multiple gateways from one unzipped source files location, you must select Copy the virtual machine and check the Duplicate all files box in the Import Virtual Machine dialog box.

You try to import a gateway and receive the following error message:

"A server error occurred while attempting to import the virtual machine. Import failed. Import task failed to copy file from [...]: The file exists. (0x80070050)"

If you have already deployed a gateway and you try to reuse the default folders that store the virtual hard disk files and virtual machine configuration files, then this error will occur. To fix this problem, specify new locations under Server in the panel on the left side of the Hyper-V Settings dialog box.

You try to import a gateway and receive the following error message:

"A server error occurred while attempting to import the virtual machine. Import failed. Import failed because the virtual machine must have a new identifier. Select a new identifier and try the import again."

When you import the gateway make sure you select Copy the virtual machine and check the Duplicate all files box in the Import Virtual Machine dialog box to create a new unique ID for the VM.

You try to start a gateway VM and receive the following error message:

"An error occurred while attempting to start the selected virtual machine(s). The child partition processor setting is incompatible with parent partition. 'AWS-Storage-Gateway' could not initialize. (Virtual machine ID [...])"

This error is likely caused by a CPU discrepancy between the required CPUs for the gateway and the available CPUs on the host. Ensure that the VM CPU count is supported by the underlying hypervisor.

For more information about the requirements for Storage Gateway, see File Gateway setup requirements.

You try to start a gateway VM and receive the following error message:

"An error occurred while attempting to start the selected virtual machine(s). 'AWS-Storage-Gateway' could not initialize. (Virtual machine ID [...]) Failed to create partition: Insufficient system resources exist to complete the requested service. (0x800705AA)"

This error is likely caused by a RAM discrepancy between the required RAM for the gateway and the available RAM on the host.

For more information about the requirements for Storage Gateway, see File Gateway setup requirements.

Your snapshots and gateway software updates are occurring at slightly different times than expected.

The gateway VM's clock might be offset from the actual time, known as clock drift. Check and correct the VM's time using local gateway console's time synchronization option. For more information, see Configuring a Network Time Protocol (NTP) server for your gateway.

You need to put the unzipped Microsoft Hyper-V Storage Gateway files on the host file system.

Access the host as you do a typical Microsoft Windows server. For example, if the hypervisor host is name hyperv-server, then you can use the following UNC path \\hyperv-server\c$, which assumes that the name hyperv-server can be resolved or is defined in your local hosts file.

You are prompted for credentials when connecting to hypervisor.

Add your user credentials as a local administrator for the hypervisor host by using the Sconfig.cmd tool.

You may notice poor network performance if you turn on virtual machine queue (VMQ) for a Hyper-V host that's using a Broadcom network adapter.

For information about a workaround, see the Microsoft documentation, see Poor network performance on virtual machines on a Windows Server 2012 Hyper-V host if VMQ is turned on.