Outdated Version
You are viewing an older version of this section. View current production version.
list-nodes
List MemSQL Nodes on the local machine.
Usage
List MemSQL Nodes on the local machine
Usage:
memsqlctl list-nodes [flags]
Flags:
--availability-group int Filter for online leaf nodes in the provided availability group
-h, --help Help for list-nodes
-p, --process-state {running, stopped, unknown} Show only nodes with the given process state (default Unspecified)
-q, --quiet Only output matching MemSQL IDs
-r, --role {master, aggregator, leaf, unknown} Show only nodes with the given role (default Unspecified)
Global Flags:
-c, --config FILE_PATH Path to the memsqctl config file
--default-install-dir DIRECTORY_PATH Path to the default install directory
-j, --json Print output in JSON format
--node-metadata-file FILE_PATH Path to the node metadata file
--parallelism POSITIVE_INTEGER Maximum amount of operations to be run in parallel
--ssl-ca FILE_PATH Path to the CA certificate file in PEM format to authenticate the MemSQL server certificate
--timeout duration Maximum time for operation to complete (e.g., 30s, 10m, 1.5h)
-v, --verbosity count Increase logging verbosity
-y, --yes Enable non-interactive mode and assume the user would like to move forward with the proposed actions by default
Remarks
Nodes can optionally be filtered by process state and role.
Info
To view nodes across the cluster, run show-leaves or show-aggregators from the host with a running master aggregator node.
This command is interactive unless you use either the --yes
or --json
flags to override interactive behavior.
The memsqlctl list-nodes
command is equivalent to the memsql-admin list-nodes command.
Output
The following is the standard output for the list-nodes
command.
$ sudo memsqlctl list-nodes
+------------+------------+------+---------------+--------------+---------+----------------+--------------------+
| MemSQL ID | Role | Port | Process State | Connectable? | Version | Recovery State | Availability Group |
+------------+------------+------+---------------+--------------+---------+----------------+--------------------+
| 994274A024 | Leaf | 3307 | Running | True | 6.5.10 | Online | 1 |
| E289BBDF58 | Aggregator | 3306 | Running | True | 6.5.10 | Online | |
+------------+------------+------+---------------+--------------+---------+----------------+--------------------+