Performing Tasks on the Amazon EC2 Local Console - Amazon Storage Gateway
Logging In to Your EC2 Gateway Local ConsoleConfiguring an HTTP proxyTesting your your gateway's network connectivityViewing your gateway system resource statusRunning Storage Gateway commands on the local console
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Amazon S3 File Gateway documentation has been moved to What is Amazon S3 File Gateway?

Amazon FSx File Gateway documentation has been moved to What is Amazon FSx File Gateway?

Tape Gateway documentation has been moved to What is Tape Gateway?

Performing Tasks on the Amazon EC2 Local Console

Some maintenance tasks require that you log in to the local console when running a gateway deployed on an Amazon EC2 instance. This section describes how to log in to the local console and perform maintenance tasks.

Logging In to Your Amazon EC2 Gateway Local Console

You can connect to your Amazon EC2 instance by using a Secure Shell (SSH) client. For detailed information, see Connect to Your Instance in the Amazon EC2 User Guide. To connect this way, you will need the SSH key pair you specified when you launched the instance. For information about Amazon EC2 key pairs, see Amazon EC2 Key Pairs in the Amazon EC2 User Guide.

To log in to the gateway local console

  1. Log in to your local console. If you are connecting to your EC2 instance from a Windows computer, log in as admin.

  2. After you log in, you see the Amazon Storage Gateway - Configuration main menu, from which you can perform various tasks.

    To Learn About This Task See This Topic
    Configure a SOCKS proxy for your gateway Routing your gateway deployed on EC2 through an HTTP proxy
    Test network connectivity Testing your gateway's network connectivity
    Run Storage Gateway console commands Running Storage Gateway commands on the local console
    View a system resource check Viewing your gateway system resource status.

To shut down the gateway, enter 0.

To exit the configuration session, enter X.

Routing your gateway deployed on EC2 through an HTTP proxy

Storage Gateway supports the configuration of a Socket Secure version 5 (SOCKS5) proxy between your gateway deployed on Amazon EC2 and Amazon.

If your gateway must use a proxy server to communicate to the internet, then you need to configure the HTTP proxy settings for your gateway. You do this by specifying an IP address and port number for the host running your proxy. After you do so, Storage Gateway routes all Amazon endpoint traffic through your proxy server. Communications between the gateway and endpoints is encrypted, even when using the HTTP proxy.

To route your gateway internet traffic through a local proxy server

  1. Log in to your gateway's local console. For instructions, see Logging In to Your Amazon EC2 Gateway Local Console.

  2. From the Amazon Appliance Activation - Configuration main menu, enter the corresponding numeral to select Configure HTTP Proxy.

  3. From the Amazon Appliance Activation HTTP Proxy Configuration menu, enter the corresponding numeral for the task you want to perform:

    • Configure HTTP proxy - You will need to supply a host name and port to complete configuration.

    • View current HTTP proxy configuration - If an HTTP proxy is not configured, the message HTTP Proxy not configured is displayed. If an HTTP proxy is configured, the host name and port of the proxy are displayed.

    • Remove an HTTP proxy configuration - The message HTTP Proxy Configuration Removed is displayed.

Testing your gateway's network connectivity

You can use your gateway's local console to test your network connectivity. This test can be useful when you are troubleshooting network issues with your gateway.

To test your gateway's connectivity

  1. Log in to your gateway's local console. For instructions, see Logging In to Your Amazon EC2 Gateway Local Console.

  2. From the Amazon Appliance Activation - Configuration main menu, enter the corresponding numeral to select Test Network Connectivity.

    If your gateway has already been activated, the connectivity test begins immediately. For gateways that have not yet been activated, you must specify the endpoint type and Amazon Web Services Region as described in the following steps.

  3. If your gateway is not yet activated, enter the corresponding numeral to select the endpoint type for your gateway.

  4. If you selected the public endpoint type, enter the corresponding numeral to select the Amazon Web Services Region that you want to test. For supported Amazon Web Services Regions and a list of Amazon service endpoints you can use with Storage Gateway, see Amazon Storage Gateway endpoints and quotas in the Amazon Web Services General Reference.

As the test progresses, each endpoint displays either [PASSED] or [FAILED], indicating the status of the connection as follows:

Message Description
[PASSED] Storage Gateway has network connectivity.
[FAILED] Storage Gateway does not have network connectivity.

Viewing your gateway system resource status

When your gateway starts, it checks its virtual CPU cores, root volume size, and RAM. It then determines whether these system resources are sufficient for your gateway to function properly. You can view the results of this check on the gateway's local console.

To view the status of a system resource check

  1. Log in to your gateway's local console. For instructions, see Logging In to Your Amazon EC2 Gateway Local Console.

  2. From the Amazon Appliance Activation - Configuration main menu, enter the corresponding numeral to select View System Resource Check.

    Each resource displays [OK], [WARNING], or [FAIL], indicating the status of the resource as follows:

    Message Description
    [OK] The resource has passed the system resource check.
    [WARNING] The resource doesn't meet the recommended requirements, but your gateway can continue to function. Storage Gateway displays a message that describes the results of the resource check.
    [FAIL] The resource doesn't meet the minimum requirements. Your gateway might not function properly. Storage Gateway displays a message that describes the results of the resource check.

    The console also displays the number of errors and warnings next to the resource check menu option.

Running Storage Gateway commands on the local console

The Amazon Storage Gateway console helps provide a secure environment for configuring and diagnosing issues with your gateway. Using the console commands, you can perform maintenance tasks such as saving routing tables or connecting to Amazon Web Services Support.

To run a configuration or diagnostic command

  1. Log in to your gateway's local console. For instructions, see Logging In to Your Amazon EC2 Gateway Local Console.

  2. From the Amazon Appliance Activation - Configuration main menu, enter the corresponding numeral to select Gateway Console.

  3. From the gateway console command prompt, enter h.

    The console displays the AVAILABLE COMMANDS menu, which lists the available commands:

    Command Function
    dig Collect output from dig for DNS troubleshooting.
    exit Return to Configuration menu.
    h Display available command list.
    ifconfig View or configure network interfaces.
    Note

    We recommend configuring network or IP settings using the Storage Gateway console or the dedicated local console menu option.
    ip Show / manipulate routing, devices, and tunnels.
    Note

    We recommend configuring network or IP settings using the Storage Gateway console or the dedicated local console menu option.
    iptables Administration tool for IPv4 packet filtering and NAT.
    ncport Test connectivity to a specific TCP port on a network.
    nping Collect output from nping for network troubleshooting.
    open-support-channel Connect to Amazon Support.
    save-iptables Persist IP tables.
    save-routing-table Save newly added routing table entry.
    sslcheck Check SSL validity for network troubleshooting.
    tcptraceroute Collect traceroute output on TCP traffic to a destination.

  4. From the gateway console command prompt, enter the corresponding command for the function you want to use, and follow the instructions.

To learn about a command, enter the command name followed by the -h option, for example: sslcheck -h.