Purpose
This article provides guidance on the recommended use of ESXi Shell for VMware ESXi 5.x.
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 with the vSphere Client
Use the vSphere Client to enable local and remote access to the ESXi Shell:
- Log in to a vCenter Server system using the vSphere Client.
- Select the host in the inventory panel.
- Click the Configuration tab and click Security Profile.
- In the Services section, click Properties.
- Select ESXi Shell from this list:
ESXi Shell
SSH
Direct Console UI - 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. - Select Start to enable the service.
- Click OK.
Enabling ESXi Shell Access with the Direct Console User Interface
Use the direct console user interface to enable the ESXi Shell:
- From the direct console user interface, press
F2to access the System Customization menu. - Select Troubleshooting Options and press Enter.
- From this Troubleshooting Mode Options menu, select Enable ESXi Shell.
Enable ESXi Shell
Enable SSH - 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:
- From the direct console user interface, press F2 to access the System Customization menu.
- Click Troubleshooting Mode Options.
- Modify ESXi Shell and SSH timeouts and press Enter.
- Enter the timeout in minutes.
- Press Enter.
- Press Esc until you return to the main menu of the Direct Console User Interface
- To set the ESXi Shell timeout from vSphere Client:
- Log in to a vCenter Server system using the vSphere Client.
- Select the host in the inventory panel and click Configuration tab.
- Under Software, select Advanced Settings.
- In the left panel, select UserVars.
- In the UserVars.ESXiShellTimeOut field, enter the timeout setting.
- 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
- If you have direct access to the host, press Alt+F1 to open the log in page on the machine's physical console.
- Provide credentials when prompted.
Accessing the remote TSM
- Open an SSH client.
- Specify the IP address or domain name of the ESX host.
Notes:- Directions may vary depending on what SSH client you are using. For more information, consult vendor documentation and support.
- By default, SSH works on TCP port 22.
- Provide credentials when prompted.
