Menu
AWS Storage Gateway
User Guide (API Version 2013-06-30)

Troubleshooting On-Premises Gateway Issues

The following table lists typical issues that you might encounter working with your on-premises gateways.

Issue Action to Take
You cannot find the IP address of your gateway.

Use the hypervisor client to connect to your host to find the gateway IP address.

  • For VMware ESXi, the VM's IP address can be found in the vSphere client on the Summary tab. For more information, see Activating Your Gateway.

  • For Microsoft Hyper-V, the VM's IP address can be found by logging into the local console. For more information, see Activating Your Gateway.

If you are still having trouble finding the gateway IP address:

  • Check that the VM is turned on. Only when the VM is turned on does an IP address get assigned to your gateway.

  • Wait for the VM to finish startup. If you just turned on your VM, then it might take several minutes for the gateway to finish its boot sequence.

You're having network or firewall problems.

  • Allow the appropriate ports for your gateway.

  • If you use a firewall or router to filter or limit network traffic, you must configure your firewall and router to allow these service endpoints for outbound communication to AWS. For more information about network and firewall requirements, see Network and Firewall Requirements.

Your gateway's activation fails when you click the Proceed to Activation button in the AWS Storage Gateway console.
  • Check that the gateway VM can be accessed by pinging the VM from your client.

  • Check that your VM has network connectivity to the Internet. Otherwise, you'll need to configure a SOCKS proxy. For more information on doing so, see Routing Your On-Premises Gateway Through a Proxy.

  • Check that the host has the correct time, that the host is configured to synchronize its time automatically to a Network Time Protocol (NTP) server, and that the gateway VM has the correct time. For information about synchronizing the time of hypervisor hosts and VMs, see Synchronizing Your Gateway VM Time.

  • After performing these steps, you can retry the gateway deployment using the AWS Storage Gateway console and the Setup and Activate Gateway wizard. 

  • Check that your VM has at least 7.5 GB of RAM. Gateway allocation fails if there is less than 7.5 GB of RAM. For more information, see Requirements.

You need to remove a disk allocated as upload buffer space. For example, you might want to reduce the amount of upload buffer space for a gateway, or you might need to replace a disk used as an upload buffer that has failed.

For instructions about removing a disk allocated as upload buffer space, see Removing Upload Buffer Capacity

You need to improve bandwidth between your gateway and AWS.

You can improve the bandwidth from your gateway to AWS by setting up your Internet connection to AWS on a network adapter (NIC) separate from that connecting your applications and the gateway VM. Taking this approach is useful if you have a high-bandwidth connection to AWS and you want to avoid bandwidth contention, especially during a snapshot restore. For high-throughput workload needs, you can use AWS Direct Connect to establish a dedicated network connection between your on-premises gateway and AWS. To measure the bandwidth of the connection from your gateway to AWS, use the CloudBytesDownloaded and CloudBytesUploaded metrics of the gateway. For more on this subject, see Measuring Performance Between Your Gateway and AWS. Improving your Internet connectivity helps to ensure that your upload buffer does not fill up.

Throughput to or from your gateway drops to zero.
  • On the Gateway tab of the AWS Storage Gateway console, verify that the IP addresses for your gateway VM are the same that you see using your hypervisor client software (that is, the VMware Vsphere client or Microsoft Hyper-V Manager). If you find a mismatch, restart your gateway from the AWS Storage Gateway console, as shown in Shutting Down Your Gateway VM. After the restart, the addresses in the IP Addresses list in the AWS Storage Gateway console's Gateway tab should match the IP addresses for your gateway, which you determine from the hypervisor client.

    • For VMware ESXi, the VM's IP address can be found in the vSphere client on the Summary tab. For more information, see Activating Your Gateway.

    • For Microsoft Hyper-V, the VM's IP address can be found by logging into the local console. For more information, see Activating Your Gateway.

  • Check your gateway's connectivity to AWS as described in Testing Your Gateway Connection to the Internet.

  • Check your gateway's network adapter configuration, and ensure that all the interfaces you intended to be enabled for the gateway are enabled. To view the network adapter configuration for your gateway, follow the instructions in Configuring Your Gateway Network and select the option for viewing your gateway's network configuration.

You can view the throughput to and from your gateway from the Amazon CloudWatch console. For more information about measuring throughput to and from your gateway to AWS, see Measuring Performance Between Your Gateway and AWS.

You are having trouble importing (deploying) AWS Storage Gateway on Microsoft Hyper-V.

See Troubleshooting Your Microsoft Hyper-V Setup, which discusses some of the common issues of deploying a gateway on Microsoft Hyper-V.

Enabling AWS Support To Help Troubleshoot Your Gateway Hosted On-Premises

AWS Storage Gateway provides a local console you can use to perform several maintenance tasks, including enabling AWS Support to access your gateway to assist you with troubleshooting gateway issues. By default, AWS Support access to your gateway is disabled. You enable this access through the host's local console. To give AWS Support access to your gateway, you first log in to the local console for the host, navigate to the storage gateway's console, and then connect to the support server.

To enable AWS Support access to your gateway

  1. Log in to your host's local console.

    The local console looks like the following.

  2. At the prompt, type 5 to open the AWS Storage Gateway console.

  3. Type h to open the AVAILABLE COMMANDS window.

  4. In the AVAILABLE COMMANDS window, type open-support-channel to connect to customer support for AWS Storage Gateway. You must allow TCP port 22 to initiate a support channel to AWS. When you connect to customer support, Storage Gateway assigns you a support number. Make a note of your support number.

    Note

    The channel number is not a Transmission Control Protocol/User Datagram Protocol (TCP/UDP) port number. Instead, the gateway makes a Secure Shell (SSH) (TCP 22) connection to Storage Gateway servers and provides the support channel for the connection.

  5. Once the support channel is established, provide your support service number to AWS Support so AWS Support can provide troubleshooting assistance.

  6. When the support session is completed, type q to end it.

  7. Type exit to log out of the AWS Storage Gateway console.

  8. Follow the prompts to exit the local console.