Knowledge Base

The VMware Knowledge Base provides support solutions, error messages and troubleshooting guides
 
Search the VMware Knowledge Base (KB)   View by Article ID
 

Using ESXi Shell in ESXi 5.x (2004746)

Purpose

This article provides guidance on the recommended use of ESXi Shell for VMware ESXi 5.0, 5.1 and 5.5.

Resolution



The ESXi Shell (formerly known as Tech Support Mode) provides essential maintenance commands. It can be used in exceptional cases that cannot be handled through standard remote management or CLI tools. The ESXi Shell is primarily intended for use in break-fix scenarios.

Enabling ESXi Shell access using the vSphere Client

Use the vSphere Client to enable local and remote access to the ESXi Shell:
  1. Log into a vCenter Server system using the vSphere Client.
  2. Select the host in the inventory panel.
  3. Click the Configuration tab and click Security Profile.
  4. In the Services section, click Properties.
  5. Select ESXi Shell from this list:

    ESXi Shell
    SSH
    Direct Console UI


  6. Click Options and select Start and stop manually.

    Note: When you select Start and stop manually, the service does not start when you reboot the host. If you want the service to start when you reboot the host, select Start and stop with host.

  7. Click Start to enable the service.
  8. Click OK.

Enabling ESXi Shell access using the Direct Console User Interface

Use the direct console user interface to enable the ESXi Shell:
  1. From the Direct Console User Interface, press F2 to access the System Customization menu.
  2. Select Troubleshooting Options and press Enter.
  3. From the Troubleshooting Mode Options menu, select Enable ESXi Shell.

    Enable ESXi Shell
    Enable SSH


  4. Press Enter to enable the service.

Configuring the timeout for the ESXi Shell

By default, the timeout setting for the ESXi Shell is 0 (disabled). The timeout setting is the number of minutes that can elapse before you must log in after the ESXi Shell is enabled. After the timeout period, if you have not logged in, the shell is disabled.

Note: If you are logged in when the timeout period elapses, your session persists. However, the ESXi Shell is disabled and it prevents other users from logging in.
  • To set the ESXi Shell timeout from the Direct Console User Interface:

    1. From the Direct Console User Interface, press F2 to access the System Customization menu.
    2. Click Troubleshooting Mode Options.
    3. Modify ESXi Shell and SSH timeouts and press Enter.
    4. Enter the timeout in minutes.
    5. Press Enter.
    6. Press Esc until you return to the main menu of the Direct Console User Interface.

  • To set the ESXi Shell timeout from vSphere Client:

    1. Log into a vCenter Server system using the vSphere Client.
    2. Select the host in the inventory panel and click Configuration tab.
    3. Under Software, click Advanced Settings.
    4. In the left panel, click UserVars.
    5. In the UserVars.ESXiShellTimeOut field, enter the timeout setting in seconds.
    6. Click OK.

Note: If ESXi Shell and SSH are enabled, the option to modify the timeout value is grayed out. To change the timeout value, ensure both ESXi Shell and SSH are disabled. This is by design and is intended to indicate when the timeout values would take effect.

Accessing the local ESXi Shell

  1. If you have direct access to the host, press Alt+F1 to open the log in page on the machine's physical console.
  2. Provide credentials when prompted.

Accessing the remote ESXi Shell

  1. Open an SSH client.
  2. Specify the IP address or domain name of the ESXi host.

    Notes:
    • Steps may vary depending on the SSH client you are using. For more information, consult the client documentation and support.
    • By default, SSH works on TCP port 22.

  3. Provide credentials when prompted.

Additional Information

Tags

enabling-tech-support-mode  tech-support-esxi  esxi-shell-5.0

See Also

Update History

01/15/2013 - Added link in additional information to vSphere Command-Line Interface Concepts and Examples for version 5.1 03/20/2012 - Added link in additional information regarding Command line management

Request a Product Feature

To request a new product feature or to provide feedback on a VMware product, please visit the Request a Product Feature page.

Feedback

  • 23 Ratings

Did this article help you?
This article resolved my issue.
This article did not resolve my issue.
This article helped but additional information was required to resolve my issue.
What can we do to improve this information? (4000 or fewer characters)
  • 23 Ratings
Actions
KB: