Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

connect

Connects to a cluster. This is a REPL-only command.

command specdescription
connect [--cluster-url]Create a session for the cluster, i.e. subsequent commands do not require the cluster URL anymore

disconnect

Disconnects the current session. This is a REPL-only command.

command specdescription
disconnectDisconnect the current session

sql

REPL mode

command specdescription
sql <query>

If executed without parameters, create a SQL connection session within the REPL. From this point, it provides functionality similar to a command-line JDBC tool (e.g., sqlline)  

non-REPL mode

command specdescription
ignite sql [--cluster-url][--script-file] <query>

Execute sql query and print the result

topology

According to the join protocol, we are going to have two types of node topologies: "physical" (a.k.a. network) topology and "logical" topology. It may be convenient for the user to know which nodes have passed validation and have joined the logical topology, therefore it is suggested to implement a CLI command for this purpose.

Response example:

consistent ID, ID, address, status

node 1, e2d4988a-b836-4e7e-a888-2639e6f79ef0, 127.0.0.1, RUNNING

node 2, 5cb561fc-1963-4f95-98f8-deb407669a86, 127.0.0.2, RECOVERY

REPL mode

command specdescription
topologyShow the topology of the connected cluster

non-REPL mode

command specdescription
ignite topology [--cluster-url]Show the topology of the cluster

version

REPL mode

command specaliasdescription
version
Show the version of the CLI Tool

non-REPL mode

command specaliasdescription
ignite versionignite --versionShow the version of the CLI Tool

cluster

cluster init

Initializes cluster in a way described in IEP-77.

REPL mode

command specdescription
cluster init [--cluster-url]<--meta-storage-node>[--cmg-node]<--cluster-name>

Initialize the connected cluster

non-REPL mode

command specdescription
ignite cluster init [--cluster-url]<--meta-storage-node>[--cmg-node]<--cluster-name>

Initialize the cluster

meta-storage-node is a list with a minimum 1 argument, cmg-node is a list but could be empty.

...

Has to be rendered in HOCON format.

REPL mode

command specdescription
cluster config show [--cluster-url][--selector]

Show connected cluster configuration

non-REPL mode

command specdescription
ignite cluster config show [--cluster-url][--selector]

Show connected cluster configuration

cluster config update

REPL mode

command specdescription
cluster config update [--cluster-url] <config in HOCON format or path to file>

Update the connected cluster configuration with provided HOCON configuration 

non-REPL mode

command specdescription
ignite cluster config update [--cluster-url] <config in HOCON format or path to file>

Update the cluster configuration with provided HOCON configuration

node

node start

Start the Ignite 3 node.

REPL mode

command specdescription
node start [--config] <nodeName>

Start node with the default configuration or reads the config from --config option 

non-REPL mode

command specdescription
ignite node start [--config] <nodeName>

Start node with the default configuration or reads the config from --config option

node stop

Stop the Ignite 3 node.

REPL mode

command specdescription
node stop <nodeName>

Stop node

non-REPL mode

command specdescription
ignite node stop <nodeName>

Stop node

node status

Shows the status of the node. Could be starting, started, stopping, and recovering.

REPL mode

command specdescription
node status [--node-url]

Shows the node status 

non-REPL mode

command specdescription
ignite node status [--node-url]

Shows the node status

node config show

Has to be rendered in HOCON format.

REPL mode

command specdescription
node config show [--node-url][--selector]

Read the local node configuration 

non-REPL mode

command specdescription
ignite node config show [--node-url][--selector]

Read the local node configuration

node config update

REPL mode

command specdescription
node config update [--node-url] <config in HOCON format or path to file>

Update the connected local node configuration with provided HOCON configuration 

non-REPL mode

command specdescription
ignite node config update [--node-url] <config in HOCON format or path to file>

Update the local node configuration with provided HOCON configuration

node list

REPL mode

command specdescription
node list

Show the list of nodes running locally 

non-REPL mode

command specdescription
ignite node list

Show the list of nodes running locally

sql

REPL mode

command specdescriptionsql <query>

If executed without parameters, create a SQL connection session within the REPL. From this point, it provides functionality similar to a command-line JDBC tool (e.g., sqlline)  

non-REPL mode

command specdescriptionignite sql [--cluster-url][--script-file] <query>

Execute sql query and print the result

version

REPL mode

command specaliasdescriptionversionShow the version of the CLI Tool

non-REPL mode

command specaliasdescriptionignite versionignite --versionShow the version of the CLI Tool

cli config get

REPL mode

command specaliasdescription
cli config get <config key> [--profile-name -p] cli configs (~ default get without parameters)Show the default config value for the CLI Tool. Displays all default configs if called without parameter. Show property of profile with provided name.

non-REPL mode

command specaliasdescription
ignite cli config get <config key> [--profile-name -p]ignite cli configsShow the default config value for the CLI Tool. Displays all default configs if called without parameter. Show config value of profile with provided name.

cli config set

REPL mode

command specdescription
cli config set <config key-value> [--profile-name -p] Set the default config value for the CLI Tool. Set the config value for profile with provided name.

non-REPL mode

command specdescription
ignite cli config set <config key-value> [--profile-name -p]Set the default config value for the CLI Tool.  Set the config value for profile with provided name.

cli config profile

cli config profile

...

show REPL mode


command specdescription
cli config profile show  Show current default profile of CLI Tool

non-REPL mode

command specdescription
ignite cli config show Show current default profile

cli config profile use

REPL mode

command specdescription
cli config profile use <profileName> Activate profile as default for CLI Tool

non-REPL mode

command specdescription
ignite cli config profile use <profileName> Activate profile as default for CLI Tool


cli config profile create

REPL mode

command specdescription
cli config profile create [-–name -n] [--copy-from -c] [–-activate -a]  Create new profile and optionally copy content from another profile and optionally activate new profile as default for CLI Tool

non-REPL mode

command specdescription
ignite cli config profile create [-–name -n] [--copy-from -c] [–-activate -a]Create new profile and optionally copy content from another profile and optionally activate new profile as default for CLI Tooll

topology

According to the join protocol, we are going to have two types of node topologies: "physical" (a.k.a. network) topology and "logical" topology. It may be convenient for the user to know which nodes have passed validation and have joined the logical topology, therefore it is suggested to implement a CLI command for this purpose.

Response example:

consistent ID, ID, address, status

node 1, e2d4988a-b836-4e7e-a888-2639e6f79ef0, 127.0.0.1, RUNNING

node 2, 5cb561fc-1963-4f95-98f8-deb407669a86, 127.0.0.2, RECOVERY

REPL mode

command specdescription
topologyShow the topology of the connected cluster

non-REPL mode

command specdescriptionignite topology [--cluster-url]Show the topology of the cluster



Opened tickets

Jira
serverASF JIRA
jqlQueryproject = Ignite AND status = Open AND ("Epic Name" = IEP-88 OR "Epic Link" = IGNITE-16970)
serverId5aa69414-a9e9-3523-82ec-879b028fb15b

Closed tickets

Jira
serverASF JIRA
jqlQueryproject = Ignite AND status = Closed AND ("Epic Name" = IEP-88 OR "Epic Link" = IGNITE-16970)
serverId5aa69414-a9e9-3523-82ec-879b028fb15b