6.1. Overview of the CLI

6.1.1. Introduction to the CLI

The Command Line Interface (CLI) is the means used to administer and configure the GCap.

It is therefore necessary to enter commands in text mode following the command prompt.


6.1.2. Overview of the command prompt

[Monitoring DOWN] gcap-name (gcap-cli) 

It includes:

  • the status of the Sigflow detection engine (here Monitoring down)

  • the name of the GCap (here gcap-name)

  • the level information in the tree:

    • here (gcap-cli): means the command prompt is at the root of the commands

    • for example (gcap-cli show): means the command prompt is in the show set


6.1.3. Accessible commands grouped by set

The commands are grouped by set (show, set, etc.)

The detailed list of commands is provided in the CLI section.

The set...

is used to...

show

display the system configuration

set

modify the system configuration

services

manage GCap services

system

manage system operations

These sets are accessible from the root.

Note

The set of commands in the GCap CLI is calculated dynamically.

The list of commands depends on:

  • the current user type

  • the status of the GCap

This information can be found in the documentation.

Note

  • if a command is entered in the wrong set, or

  • if the access level is not the correct one

... then the command is not recognised and the message `Command `X` is not recognised` is displayed.

Note

User type or context elements are specified where necessary.


6.1.4. Directly accessible commands

The commands below are directly accessible:

Use the command...

to...

monitoring engine

manage the detection engine

pairing

pairing the GCap and GCenter

help

to obtain help with the available commands

colour

enable or disable colours for the current CLI session

exit

return to the root of the CLI or exit the CLI


6.1.5. Completion

To complete the name of a command or an argument, it is possible to use the completion, i.e.:

  • start by entering a command, then

  • use the tab key on the keyboard

The system proposes the possible values.

Example: by asking for a completion on the command below, the system displays the supported values of set keymap:

(gcap-cli) set keymap

fr us


6.1.7. Launching a command

A command can be launched in two different ways:

  • Either with only the command name but the command prompt must be at the set level

  • Or from the root but the name of the set must be entered followed by the name of the command


6.1.7.1. Example of launching from the root for the show alerts command

(gcap-cli)

  • Enter the show alerts command then validate.


6.1.7.2. Example of launching the show alerts command from the show set

(gcap-cli show)

  • Enter the alerts command then validate.


6.1.8. Obtaining information on commands via Help

To receive help on the available commands, it is possible to use the ? or help command.

To obtain help with a specific command, it is possible to:

  • Prefix it with help (example help show config-files)

  • Suffix the command with ? (example show config-files ?)

For more information on assistance, see the paragraph on help.


6.1.9. Exit

If the GCap interactive CLI is used, the exit command must be used to return to the root of the command tree.

For more information on the command, see the paragraph on exit.