The CLI: General and Base Commands

When you enter CLI at the bash prompt, this puts you at the base level of the CLI. You can also jump directly to a specific level or even run a command directly without entering the interactive mode of the CLI. You do this by providing the full path to what you are trying to access. For example, to show the current network configuration for interface eth0 you could run the command cli system show eth0 directly from the bash prompt.

Command Flags

Note: Any unknown or invalid flags passed are ignored.

Special Characters–-When passing a value to the CLI that contains special characters you should wrap the value in quotes. You should also do this for any value or argument that contains spaces. For example if you are setting the the engine.server_name parameter in config and you want the value to be Microsoft IIS, run the following command: cli config set engine.server_name "Microsoft IIS" If you do not quote the value the example, then the parameter would be incorrectly set to the value Microsoft.

The following sections provide lists of commands you can reference when using the CLI.

Table 6: General CLI Commands

Command

Syntax

Description

color

color

Changes the display of color in the CLI. By default, only the default terminal foreground color is used for all output. If enabled then output of certain commands is syntax highlighted to make it easier to distinguish certain types of information.

Example:

> color

Color Enabled

> color

Color Disabled

echo

echo [string]

Echos the string passed to it back to the screen. The main purpose of this command is to give you the ability to provide a status message when writing automated scripts against the CLI.

Example:

> echo Hello, World!

Hello, World!

exit

exit

Exits the current level of the CLI and returns you to the entry point of that level.

Example:

> system

system> exit

> _

help

help [topic]

Displays help information about the various levels and command available within the CLI.

Example:

> help echo

Summary: echo the given string back to the terminal

Syntax: echo [string]

This is a simple implementation of a echo command.

pager

pager

Toggles use of the screen pager for output longer than your current screen size. When enabled, the output of commands are paginated according to the size of your current terminal window. When disabled, the pagination will not take affect which can make it difficult to view long output from some commands.

Example:

> pager

Pager Disabled

> pager

Pager Enabled

tee

tee

Toggles teeing of output to a log file. When enabled, all output displayed inside the CLI is also logged to a file in the user's home directory.

Example:

> tee

Output logging to /home/mykonos/2014-04-03-19:06:59.697271.log

> tee

Output logging stopped

Table 7: Base Level CLI Commands

Command

Syntax

Description

config

config [subcommand]

Enter the configuration level of the CLI. From here you can manage the various configuration settings used by WebApp Secure. System specific settings such as network configuration, or settings that only affect a limited number of nodes in a cluster/install are not handled through the configuration level. For system specific configuration settings please see the system level of the CLI.

Example:

> config show engine.enabled

true

Refer to The CLI: Configuration Level Commands for details.

system

system [subcommand]

Enter the system level of the CLI. The system level is where all local system configuration is done and where local system actions can be performed. This level is also where HA actions/configuration is located.

Example:

> system services status

mykonos-security-engine mykonos-security-engine (pid 9150) is running...

Refer to The CLI: System Level Commands for details.

support

support [subcommand]

Enter the support level of the CLI. This level provides support features meant for troubleshooting system problems.

Example:

> support bundle

The support bundle has been successfully sent to the support staff.

Related Documentation