Purpose
Use the 01Layer command-line interface, 01sh, to operate the appliance from a
serial console, SSH session, or non-interactive shell command. The CLI exposes
the same workflow-backed system operations used by the web UI, plus local
diagnostic commands and selected model-specific debug tools.
When To Use This Manual
Use this manual when you need to:
- Discover available CLI commands and parameters.
- Change appliance configuration from a console or SSH session.
- Inspect system, interface, NextIO, Device Center, or vfabric state.
- Run operational commands such as reboot, firmware operations, configuration backup, or NextIO service start and stop.
- Use diagnostics when web access is unavailable or hardware validation is in progress.
Executable Name
The preferred executable name is:
01sh
The runtime also provides compatibility aliases:
l01sh
01lsh
Use 01sh in new procedures. The aliases are provided because the letter l
and the digit 1 are easy to confuse in field use.
Command Modes
The command tree is organized into these top-level modes:
| Mode | Purpose |
|---|---|
config |
Change appliance configuration or open local editor functions. |
show |
Display current runtime or configured state. |
exec |
Run operational workflows or command actions. |
diag |
Run diagnostics and development/service debug commands. |
help |
Display command tree, search help, or show command details. |
history |
Display command history for the local CLI user. |
clear |
Clear the terminal screen. |
logout |
Log out from the interactive CLI session. |
Interactive Mode
Run 01sh without -exec to open an interactive shell:
01sh
The normal prompt is:
01sh>
When you enter a command node, the prompt reflects the current path. Use exit
or .. to move up one command level. At the top-level prompt, use logout to
leave 01sh.
Non-Interactive Mode
Use -exec to run one or more CLI commands and exit:
01sh -exec "show system status"
01sh -exec "show interface P3"
01sh -exec "config interface P3 speed 400G fec RS544"
The -exec flag supports semicolon and newline separated commands:
01sh -exec "show system status; show system version"
Use explicit login when running from automation that does not have a local session:
L01SH_LOGIN_PASSWORD='admin' 01sh -u admin -exec "show system status"
The preferred password input mechanisms are:
| Method | Use |
|---|---|
-login-password-env <name> |
Read the password from an environment variable. Defaults to L01SH_LOGIN_PASSWORD. |
-login-password-stdin |
Read the password from standard input. |
Startup Behavior
By default, 01sh checks aggregate 01Layer startup state before contacting the backend. If the system is still starting, non-admin users wait for startup or fall back after the configured timeout.
When the local login user is admin and startup is still in progress, 01sh can
enter an admin diagnostic CLI immediately:
System startup is still in progress. Entering admin diagnostic CLI. Backend commands may be unavailable until system is ready.
In that state, local commands may work, but backend-backed config, show,
exec, and diag commands may be unavailable until services are ready.
Built-In Help
Use ? at any point to display valid next tokens:
01sh> config ?
01sh> config system ?
01sh> config interface P3 ?
Use help tree for the full generated command tree:
01sh> help tree
Use help detail to inspect a command's syntax, handler, and parameters:
01sh> help detail config interface
01sh> help detail exec ping
Use help search to search command and parameter help text:
01sh> help search port