Lish Documentation

From LinodeWiki

Jump to: navigation, search


Contents

[edit] Linode Library

Please see the article in the Linode Library on Using the Linode Shell (Lish) for more information and additional resources.

[edit] Description

Lish, the Linode Shell, allows you to perform certain actions without having to log into the LPM. Lish's primary function is to allow you access to your server's console, even if networking is disabled. View the screencast to see it in action.

[edit] Connecting to Lish

 ssh LishUsername@hostXX.linode.com 

Where LishUsername is your Lish username, and hostXX is the host your Linode resides. Both of these can be found on the Console tab of the LPM. Lish also listens on ports 443 and 2200.

Before logging in for the first time, you must either set a Lish password or add your ssh public key, both of which are available from the Console tab as well.

Lish will automatically attach to your Linode's console if your Linode is running.

[edit] Detaching Console and returning to Lish prompt

Lish uses screen(1) to connect to your Console. To disconnect and return to Lish, type Ctrl-a d ("control-a" followed by "d"). Once at the Lish prompt, hit return to reattach to the console.

[edit] Menu

[linode2@host26 lish]# help

 
Lish console <tab> completion, ? for menu

kill            - kill stuck screen sessions
exit            - exit from lish
help            - this menu

[return]        - connect to console
version         - display running kernel version
boot            - boot last used (or the only) config profile
boot N          - boot the specified config profile
shutdown        - shutdown the Linode
reboot          - shutdown, then boot the last used config profile
reboot N        - shutdown, then boot the specified config profile
sysrq X         - send SysRq X to your Linode
destroy         - pulls the plug on a running Linode, no fs sync, no warning

jobs            - view the job queue for your Linode
configs         - view the configuration profiles for your Linode
config N        - view configuration profile details for profile N
status          - view the of your Linode
io_status       - view IO statistics
keysview        - view contents of authorized_keys2
logview         - view contents of console log

[edit] Examples

To reboot your Linode without having to log into the LPM:

 ssh LishUsername@hostXX.linode.com reboot 


To view the last 1000 lines from the previous console log, and the current console log:

 ssh LishUsername@hostXX.linode.com logview
Personal tools