...
Connects to a cluster. This is a REPL-only command.
command spec | description |
---|---|
connect [--cluster-url] | Create a session for the cluster, i.e. subsequent commands do not require the cluster URL anymore |
Disconnects the current session. This is a REPL-only command.
command spec | description |
---|---|
disconnect | Disconnect the current session |
Initializes cluster in a way described in IEP-77.
REPL mode
command spec | description |
---|---|
cluster init [--cluster-url]<--meta-storage-node>[--cmg-node]<--cluster-name> | Initialize the connected cluster |
non-REPL mode
command spec | description |
---|---|
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.
Show the detailed status of the cluster including name, topology, etc.
...
command spec | description |
---|---|
ignite cluster status | Show the status of the cluster |
Has to be rendered in HOCON format.
REPL mode
command spec | description |
---|---|
cluster config show [--cluster-url][--selector] | Show connected cluster configuration |
non-REPL mode
command spec | description |
---|---|
ignite cluster config show [--cluster-url][--selector] | Show connected cluster configuration |
REPL mode
command spec | description |
---|---|
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 spec | description |
---|---|
ignite cluster config update [--cluster-url] <config in HOCON format or path to file> | Update the cluster configuration with provided HOCON configuration |
Start the Ignite 3 node.
REPL mode
command spec | description |
---|---|
node start [--config] <nodeName> | Start node with the default configuration or reads the config from --config option |
non-REPL mode
command spec | description |
---|---|
ignite node start [--config] <nodeName> | Start node with the default configuration or reads the config from --config option |
Stop the Ignite 3 node.
REPL mode
command spec | description |
---|---|
node stop <nodeName> | Stop node |
non-REPL mode
command spec | description |
---|---|
ignite node stop <nodeName> | Stop node |
Shows the status of the node. Could be starting, started, stopping, and recovering.
REPL mode
command spec | description |
---|---|
node status [--node-url] | Shows the node status |
non-REPL mode
command spec | description |
---|---|
ignite node status [--node-url] | Shows the node status |
Has to be rendered in HOCON format.
REPL mode
command spec | description |
---|---|
node config show [--node-url][--selector] | Read the local node configuration |
non-REPL mode
command spec | description |
---|---|
ignite node config show [--node-url][--selector] | Read the local node configuration |
REPL mode
command spec | description |
---|---|
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 spec | description |
---|---|
ignite node config update [--node-url] <config in HOCON format or path to file> | Update the local node configuration with provided HOCON configuration |
REPL mode
command spec | description |
---|---|
node list | Show the list of nodes running locally |
non-REPL mode
command spec | description |
---|---|
ignite node list | Show the list of nodes running locally |
REPL mode
command spec | description |
---|---|
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 spec | description |
---|---|
ignite sql [--cluster-url][--script-file] <query> | Execute sql query and print the result |
REPL mode
command spec | alias | description |
---|---|---|
version | Show the version of the CLI Tool |
non-REPL mode
command spec | alias | description |
---|---|---|
ignite version | ignite --version | Show the version of the CLI Tool |
REPL mode
command spec | alias | description |
---|---|---|
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 spec | alias | description |
---|---|---|
ignite cli config get <config key> [--profile-name -p] | ignite cli configs | Show the default config value for the CLI Tool. Displays all default configs if called without parameter. Show config value of profile with provided name. |
REPL mode
command spec | description |
---|---|
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 spec | description |
---|---|
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. |
...
REPL mode
command spec | description |
---|---|
cli config profile show | Show current default profile of CLI Tool |
non-REPL mode
command spec | description |
---|---|
ignite cli config show | Show current default profile |
REPL mode
command spec | description |
---|---|
cli config profile use <profileName> | Activate profile as default for CLI Tool |
non-REPL mode
command spec | description |
---|---|
ignite cli config profile use <profileName> | Activate profile as default for CLI Tool |
REPL mode
command spec | description |
---|---|
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 spec | description |
---|---|
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 |
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 spec | description |
---|---|
topology | Show the topology of the connected cluster |
non-REPL mode
command spec | description |
---|---|
ignite topology [--cluster-url] | Show the topology of the cluster |
...