node list

Lists nodes in the cluster.

You can specify a set of nodes for which to retrieve information in several ways:

  • To list only nodes with raised alarms, set alarmednodes to 1.
  • To list only NFS nodes, set nfsnodes to 1.
  • To window the list, use the start and limit options to select only a portion of the results.
  • To list nodes that match certain criteria, pass a filter to the filter parameter. See the node table for the fields available to filter by. See the Filters page for information on filters.

Using the node list command without the -clientsonly true or the -nfsnodes true option, does not list edge nodes. To include edge nodes, use the -nfsnodes true or the -clientsonly true option.

Syntax

CLI
/opt/mapr/bin/maprcli node list
    [ -alarmednodes 0|1 ]
    [ -cluster <cluster> ]
    [ -clientsonly true|false ]
    [ -columns <columns>|all]
    [ -filter <filter> ]
    [ -limit <limit> ]
    [ -nfsnodes 0|1 ]
    [ -output terse|verbose ]
    [ -sortby <attribute> ]
    [ -sortorder asc|desc ]
    [ -start <offset> ]
    [ -zkconnect <ZooKeeper Connect String> ]
REST
Request Type GET
Request URL
http[s]://<host>:<port>/rest/node/list[?<parameters>] 

Parameters

Parameter

Description

alarmednodes This parameter when set to 1, displays only nodes with raised alarms. You cannot use this parameter if nfsnodes is set.
cluster The cluster on which to run the command.
clientsonly Set this parameter to true to return the list of nodes running unique platinum FUSE-based POSIX clients, and NFSv3, and NFSv4 services. The command returns the following fields: clienttype, clienthealth, hostname, ip, lasthb, id. For more information, see this fields table.

If you set this parameter to false, which is the default value, this parameter returns per node-level information for all the services running on the node.

columns A comma-separated list of fields to return in the query, specified by the short names.

When specifying this option, the ip and hostname columns are always returned in the query.

filter A filter specifying nodes on which to start or stop services. See the Fields table on the node page for the fields available to filter. See the maprcli and REST API Syntax page for information on filters.
limit The number of rows to return, beginning at start. Default: 0
nfsnodes Set this to 1 to display only nodes running NFS. Cannot be used if alarmednodes is set.
output Specifies whether the output should be terse or verbose.
sortby Specifies one of the following attributes by which to sort the list of nodes: nodeid, nodeip, nodehostname, noderackpath, nodeswitchpath, nodestatus, nodeservices, nodefshb, nodejthb, nodedisktotal, nodediskused, nodediskavail, noderpc, noderpcin, noderpcout, nodediskcount, nodediskreadops, nodediskreadkbytes, nodediskwriteops, nodediskwritekbytes, nodecpucount, nodecpuutil, nodememtotal, nodememused, nodefaileddisks, nodevirtualip, nodevirtualipend, nodenetmaskvnodemacaddress, nodegateway, nodebytesreceived, nodebytessent, nodecpuuptime, nodemaprdiskcount, nodestatusdesc, nodeblockmovesout, nodeblockmovesinvnodemaxcontainersthreshold, nodenuminstances, nodenumspsperinstance, nodenfsstate, nodeisposixclient, nodeisloopbacknfs, nodeisloopbacknfsrunning
start The offset from the starting row according to sort. Default: 0
zkconnect ZooKeeper Connect String

Output

Information about the nodes. See the fields for more information.

Sample Output

# /opt/mapr/bin/maprcli node list -json
{
	"timestamp":1555342212112,
	"timeofday":"2019-04-15 08:30:12.112 GMT-0700 AM",
	"status":"OK",
	"total":1,
	"data":[
		{
			"id":"7146221175287263104",
			"ip":[
				"10.10.82.29",
				"172.17.0.1"
			],
			"hostname":"doc29.lab",
			"racktopo":"/data/default-rack/doc29.lab",
			"health":2,
			"healthDesc":"One or more services is down",
			"service":"resourcemanager,fileserver,cldb,nfs4,mastgateway,nodemanager,gateway,hoststats,apiserver,posixclientbasic",
			"configuredservice":"resourcemanager,filemigrate,fileserver,cldb,nfs4,mastgateway,nodemanager,gateway,hoststats,apiserver,posixclientbasic",
			"fs-heartbeat":0,
			"jt-heartbeat":2,
			"dtotal":272,
			"dused":0,
			"davail":272,
			"rpcs":0,
			"rpcin":345,
			"rpcout":652,
			"disks":5,
			"MapRfs disks":3,
			"faileddisks":0,
			"dreads":0,
			"dreadK":0,
			"dwrites":1,
			"dwriteK":8,
			"cpus":8,
			"utilization":25,
			"uptime":"Mon Nov 20 15:03:37 PST 2017",
			"mtotal":23949,
			"mused":11996,
			"ttmapSlots":0,
			"ttmapUsed":0,
			"ttReduceSlots":0,
			"ttReduceUsed":0,
			"bytesReceived":168,
			"bytesSent":180,
			"numResyncSlots":16,
			"blockMovesOut":false,
			"blockMovesIn":false,
			"numInstances":"1",
			"numReportedInstances":"1",
			"spsPerInstance":"0",
			"numPutsInLastTenSeconds":0,
			"numPutsInLastMinute":0,
			"numPutsInLastFiveMinutes":0,
			"numPutsInLastFifteenMinutes":0,
			"numGetsInLastTenSeconds":0,
			"numGetsInLastMinute":0,
			"numGetsInLastFiveMinutes":0,
			"numGetsInLastFifteenMinutes":0,
			"numScansInLastTenSeconds":0,
			"numScansInLastMinute":0,
			"numScansInLastFiveMinutes":0,
			"numScansInLastFifteenMinutes":0,
			"LogLevelAlarm":0,
			"ServiceCLDBDownNotRunningAlarm":0,
			"ServiceFileserverDownNotRunningAlarm":0,
			"ServiceJTDownNotRunningAlarm":0,
			"ServiceTTDownNotRunningAlarm":0,
			"ServiceHBMasterDownNotRunningAlarm":0,
			"ServiceHBRegionDownNotRunningAlarm":0,
			"ServiceNFSDownNotRunningAlarm":0,
			"ServiceNFS4DownNotRunningAlarm":0,
			"ServiceWebserverDownNotRunningAlarm":0,
			"ServiceHoststatsDownNotRunningAlarm":0,
			"DiskFailureAlarm":0,
			"VersionMismatchAlarm":0,
			"TimeSkewAlarm":0,
			"HbProcessingSlow":1554758472188,
			"RootPartitionFullAlarm":0,
			"HomeMapRFullAlarm":0,
			"CorePresentAlarm":0,
			"HighMfsMemoryAlarm":0,
			"PamMisconfiguredAlarm":0,
			"TTLocaldirFullAlarm":0,
			"NodeNoHeartbeatAlarm":0,
			"NodeMaprUserMismatchAlarm":0,
			"NodeDuplicateHostIdAlarm":0,
			"NodeMetricsWriteProblemAlarm":0,
			"NodeTooManyContainersAlarm":0,
			"IncorrectTopologyAlarm":0,
			"ServiceHueDownNotRunningAlarm":0,
			"ServiceHttpfsDownNotRunningAlarm":0,
			"ServiceBeeswaxDownNotRunningAlarm":0,
			"ServiceHiveDownNotRunningAlarm":0,
			"ServiceHs2DownNotRunningAlarm":0,
			"ServiceOozieDownNotRunningAlarm":0,
			"NodeManagerDown":0,
			"InstanceMismatch":0,
			"ResourceManagerDown":0,
			"Insufficient memory for buckets":0,
			"NoDiskAttached":0,
			"MemoryAllocationAlarm":0,
			"FileMigrateServerDown":1555340598576,
			"MemorySwapping":0,
			"ApiServerDown":0
		}
	]
}

Fields

For definitions of the output fields, and short names for use with filters, see the fields table.

Examples

List all nodes:

For neatly formatted results, use the -json option when listing all nodes or a large subset of node information.

/opt/mapr/bin/maprcli node list -json
{
	"timestamp":1555342212112,
	"timeofday":"2019-04-15 08:30:12.112 GMT-0700 AM",
	"status":"OK",
	"total":1,
	"data":[
		{
			"id":"7146221175287263104",
			"ip":[
				"10.10.82.29",
				"172.17.0.1"
			],
			"hostname":"doc29.lab",
			"racktopo":"/data/default-rack/doc29.lab",
			"health":2,
			"healthDesc":"One or more services is down",
			"service":"resourcemanager,fileserver,cldb,nfs4,mastgateway,nodemanager,gateway,hoststats,apiserver,posixclientbasic",
			"configuredservice":"resourcemanager,filemigrate,fileserver,cldb,nfs4,mastgateway,nodemanager,gateway,hoststats,apiserver,posixclientbasic",
			"fs-heartbeat":0,
			"jt-heartbeat":2,
			"dtotal":272,
			"dused":0,
			"davail":272,
			"rpcs":0,
			"rpcin":345,
			"rpcout":652,
			"disks":5,
			"MapRfs disks":3,
			"faileddisks":0,
			"dreads":0,
			"dreadK":0,
			"dwrites":1,
			"dwriteK":8,
			"cpus":8,
			"utilization":25,
			"uptime":"Mon Nov 20 15:03:37 PST 2017",
			"mtotal":23949,
			"mused":11996,
			"ttmapSlots":0,
			"ttmapUsed":0,
			"ttReduceSlots":0,
			"ttReduceUsed":0,
			"bytesReceived":168,
			"bytesSent":180,
			"numResyncSlots":16,
			"blockMovesOut":false,
			"blockMovesIn":false,
			"numInstances":"1",
			"numReportedInstances":"1",
			"spsPerInstance":"0",
			"numPutsInLastTenSeconds":0,
			"numPutsInLastMinute":0,
			"numPutsInLastFiveMinutes":0,
			"numPutsInLastFifteenMinutes":0,
			"numGetsInLastTenSeconds":0,
			"numGetsInLastMinute":0,
			"numGetsInLastFiveMinutes":0,
			"numGetsInLastFifteenMinutes":0,
			"numScansInLastTenSeconds":0,
			"numScansInLastMinute":0,
			"numScansInLastFiveMinutes":0,
			"numScansInLastFifteenMinutes":0,
			"LogLevelAlarm":0,
			"ServiceCLDBDownNotRunningAlarm":0,
			"ServiceFileserverDownNotRunningAlarm":0,
			"ServiceJTDownNotRunningAlarm":0,
			"ServiceTTDownNotRunningAlarm":0,
			"ServiceHBMasterDownNotRunningAlarm":0,
			"ServiceHBRegionDownNotRunningAlarm":0,
			"ServiceNFSDownNotRunningAlarm":0,
			"ServiceNFS4DownNotRunningAlarm":0,
			"ServiceWebserverDownNotRunningAlarm":0,
			"ServiceHoststatsDownNotRunningAlarm":0,
			"DiskFailureAlarm":0,
			"VersionMismatchAlarm":0,
			"TimeSkewAlarm":0,
			"HbProcessingSlow":1554758472188,
			"RootPartitionFullAlarm":0,
			"HomeMapRFullAlarm":0,
			"CorePresentAlarm":0,
			"HighMfsMemoryAlarm":0,
			"PamMisconfiguredAlarm":0,
			"TTLocaldirFullAlarm":0,
			"NodeNoHeartbeatAlarm":0,
			"NodeMaprUserMismatchAlarm":0,
			"NodeDuplicateHostIdAlarm":0,
			"NodeMetricsWriteProblemAlarm":0,
			"NodeTooManyContainersAlarm":0,
			"IncorrectTopologyAlarm":0,
			"ServiceHueDownNotRunningAlarm":0,
			"ServiceHttpfsDownNotRunningAlarm":0,
			"ServiceBeeswaxDownNotRunningAlarm":0,
			"ServiceHiveDownNotRunningAlarm":0,
			"ServiceHs2DownNotRunningAlarm":0,
			"ServiceOozieDownNotRunningAlarm":0,
			"NodeManagerDown":0,
			"InstanceMismatch":0,
			"ResourceManagerDown":0,
			"Insufficient memory for buckets":0,
			"NoDiskAttached":0,
			"MemoryAllocationAlarm":0,
			"FileMigrateServerDown":1555340598576,
			"MemorySwapping":0,
			"ApiServerDown":0
		}
	]
}
curl -u mapr:mapr -X GET -k "https://host:8443/rest/node/list"

List the health and configuredservice of all nodes:

The following examples show the use of short forms for the column parameter.

/opt/mapr/bin/maprcli node list -columns service,health,configuredservice -json
/opt/mapr/bin/maprcli node list -columns svc,h,csvc -json
{
	"timestamp":1555343115082,
	"timeofday":"2019-04-15 08:45:15.082 GMT-0700 AM",
	"status":"OK",
	"total":1,
	"data":[
		{
			"ip":[
				"10.10.82.29",
				"172.17.0.1"
			],
			"hostname":"doc29.lab",
			"health":2,
			"service":"resourcemanager,fileserver,cldb,nfs4,mastgateway,nodemanager,gateway,hoststats,apiserver,posixclientbasic",
			"configuredservice":"resourcemanager,filemigrate,fileserver,cldb,nfs4,mastgateway,nodemanager,gateway,hoststats,apiserver,posixclientbasic"
		}
	]
}
curl -u mapr:mapr -X GET -k "https://host:8443/rest/node/list?columns=service%2Chealth%2Cconfiguredservice"
curl -u mapr:mapr -X GET -k "https://host:8443/rest/node/list?columns=svc%2Ch%2Ccsvs"
{"timestamp":1555482645387,"timeofday":"2019-04-16 11:30:45.387 GMT-0700 PM","status":"OK","total":1,"data":[{"ip":["10.10.82.29","172.17.0.1"],"hostname":"doc29.lab","health":2,"service":"","configuredservice":""}]}

List the number of slots on all nodes:

/opt/mapr/bin/maprcli node list -columns ip,ttmapSlots,ttmapUsed,ttReduceSlots,ttReduceUsed -json
{
	"timestamp":1555483525095,
	"timeofday":"2019-04-16 11:45:25.095 GMT-0700 PM",
	"status":"OK",
	"total":1,
	"data":[
		{
			"ip":[
				"10.10.82.29",
				"172.17.0.1"
			],
			"hostname":"doc29.lab",
			"ttmapSlots":0,
			"ttmapUsed":0,
			"ttReduceSlots":0,
			"ttReduceUsed":0
		}
	]
}   
curl -u mapr:mapr -X GET -k "https://host:8443/rest/node/list?columns=ip%2CttmapSlots%2CttmapUsed%2CttReduceSlots%2CttReduceUsed"
{"timestamp":1555483675606,"timeofday":"2019-04-16 11:47:55.606 GMT-0700 PM","status":"OK","total":1,"data":[{"ip":["10.10.82.29","172.17.0.1"],"hostname":"doc29.lab","ttmapSlots":0,"ttmapUsed":0,"ttReduceSlots":0,"ttReduceUsed":0}]}

List nodes on a particular subnet:

/opt/mapr/bin/maprcli node list -filter '[ip==10.*]' -json
{
	"timestamp":1555483749837,
	"timeofday":"2019-04-16 11:49:09.837 GMT-0700 PM",
	"status":"OK",
	"total":1,
	"data":[
		{
			"id":"1470287842321938805",
			"ip":[
				"10.10.82.29",
				"172.17.0.1"
			],
			"hostname":"doc29.lab",
			"racktopo":"/data/default-rack/doc29.lab",
			"health":2,
			"healthDesc":"One or more services is down",
			"service":"resourcemanager,fileserver,cldb,nfs4,mastgateway,nodemanager,hoststats,gateway,apiserver",
			"configuredservice":"resourcemanager,fileserver,cldb,nfs4,mastgateway,nodemanager,hoststats,gateway,apiserver",
			"fs-heartbeat":0,
			"jt-heartbeat":2,
			"dtotal":272,
			"dused":0,
			"davail":272,
			"rpcs":0,
			"rpcin":489,
			"rpcout":940,
			"disks":5,
			"MapRfs disks":3,
			"faileddisks":0,
			"dreads":0,
			"dreadK":0,
			"dwrites":0,
			"dwriteK":0,
			"cpus":8,
			"utilization":27,
			"uptime":"Tue Apr 16 04:00:39 PDT 2019",
			"mtotal":23947,
			"mused":10646,
			"ttmapSlots":0,
			"ttmapUsed":0,
			"ttReduceSlots":0,
			"ttReduceUsed":0,
			"bytesReceived":0,
			"bytesSent":0,
			"numResyncSlots":16,
			"blockMovesOut":false,
			"blockMovesIn":false,
			"numInstances":"1",
			"numReportedInstances":"1",
			"spsPerInstance":"0",
			"numPutsInLastTenSeconds":0,
			"numPutsInLastMinute":0,
			"numPutsInLastFiveMinutes":0,
			"numPutsInLastFifteenMinutes":0,
			"numGetsInLastTenSeconds":0,
			"numGetsInLastMinute":0,
			"numGetsInLastFiveMinutes":0,
			"numGetsInLastFifteenMinutes":0,
			"numScansInLastTenSeconds":0,
			"numScansInLastMinute":0,
			"numScansInLastFiveMinutes":0,
			"numScansInLastFifteenMinutes":0,
			"LogLevelAlarm":0,
			"ServiceCLDBDownNotRunningAlarm":0,
			"ServiceFileserverDownNotRunningAlarm":0,
			"ServiceJTDownNotRunningAlarm":0,
			"ServiceTTDownNotRunningAlarm":0,
			"ServiceHBMasterDownNotRunningAlarm":0,
			"ServiceHBRegionDownNotRunningAlarm":0,
			"ServiceNFSDownNotRunningAlarm":0,
			"ServiceNFS4DownNotRunningAlarm":0,
			"ServiceWebserverDownNotRunningAlarm":0,
			"ServiceHoststatsDownNotRunningAlarm":0,
			"DiskFailureAlarm":0,
			"VersionMismatchAlarm":0,
			"TimeSkewAlarm":0,
			"HbProcessingSlow":0,
			"RootPartitionFullAlarm":0,
			"HomeMapRFullAlarm":0,
			"CorePresentAlarm":0,
			"HighMfsMemoryAlarm":0,
			"PamMisconfiguredAlarm":0,
			"TTLocaldirFullAlarm":0,
			"NodeNoHeartbeatAlarm":0,
			"NodeMaprUserMismatchAlarm":0,
			"NodeDuplicateHostIdAlarm":0,
			"NodeMetricsWriteProblemAlarm":0,
			"NodeTooManyContainersAlarm":0,
			"IncorrectTopologyAlarm":0,
			"ServiceHueDownNotRunningAlarm":0,
			"ServiceHttpfsDownNotRunningAlarm":0,
			"ServiceBeeswaxDownNotRunningAlarm":0,
			"ServiceHiveDownNotRunningAlarm":0,
			"ServiceHs2DownNotRunningAlarm":0,
			"ServiceOozieDownNotRunningAlarm":0,
			"NodeManagerDown":0,
			"GatewayServiceDown":0,
			"InstanceMismatch":0,
			"ResourceManagerDown":0,
			"Insufficient memory for buckets":0,
			"NoDiskAttached":0,
			"MemoryAllocationAlarm":0,
			"FileMigrateServerDown":1555482296140,
			"MemorySwapping":0,
			"ApiServerDown":0
		}
	]
}
curl -u mapr:mapr -X GET -k "https://host:8443/rest/node/list?filter=%5Bip%3D%3D10.*%5D"
{"timestamp":1555483809698,"timeofday":"2019-04-16 11:50:09.698 GMT-0700 PM","status":"OK","total":1,"data":[{"id":"1470287842321938805","ip":["10.10.82.29","172.17.0.1"],"hostname":"doc29.lab","racktopo":"/data/default-rack/doc29.lab","health":2,"healthDesc":"One or more services is down","service":"","configuredservice":"","fs-heartbeat":0,"jt-heartbeat":2,"dtotal":272,"dused":0,"davail":272,"rpcs":0,"rpcin":489,"rpcout":942,"disks":5,"MapRfs disks":3,"faileddisks":0,"dreads":0,"dreadK":0,"dwrites":0,"dwriteK":0,"cpus":8,"utilization":1,"uptime":"Tue Apr 16 04:00:39 PDT 2019","mtotal":23947,"mused":10560,"ttmapSlots":0,"ttmapUsed":0,"ttReduceSlots":0,"ttReduceUsed":0,"bytesReceived":672,"bytesSent":792,"numResyncSlots":16,"blockMovesOut":false,"blockMovesIn":false,"numInstances":"1","numReportedInstances":"1","spsPerInstance":"0","numPutsInLastTenSeconds":0,"numPutsInLastMinute":0,"numPutsInLastFiveMinutes":0,"numPutsInLastFifteenMinutes":0,"numGetsInLastTenSeconds":0,"numGetsInLastMinute":0,"numGetsInLastFiveMinutes":0,"numGetsInLastFifteenMinutes":0,"numScansInLastTenSeconds":0,"numScansInLastMinute":0,"numScansInLastFiveMinutes":0,"numScansInLastFifteenMinutes":0,"LogLevelAlarm":0,"ServiceCLDBDownNotRunningAlarm":0,"ServiceFileserverDownNotRunningAlarm":0,"ServiceJTDownNotRunningAlarm":0,"ServiceTTDownNotRunningAlarm":0,"ServiceHBMasterDownNotRunningAlarm":0,"ServiceHBRegionDownNotRunningAlarm":0,"ServiceNFSDownNotRunningAlarm":0,"ServiceNFS4DownNotRunningAlarm":0,"ServiceWebserverDownNotRunningAlarm":0,"ServiceHoststatsDownNotRunningAlarm":0,"DiskFailureAlarm":0,"VersionMismatchAlarm":0,"TimeSkewAlarm":0,"HbProcessingSlow":0,"RootPartitionFullAlarm":0,"HomeMapRFullAlarm":0,"CorePresentAlarm":0,"HighMfsMemoryAlarm":0,"PamMisconfiguredAlarm":0,"TTLocaldirFullAlarm":0,"NodeNoHeartbeatAlarm":0,"NodeMaprUserMismatchAlarm":0,"NodeDuplicateHostIdAlarm":0,"NodeMetricsWriteProblemAlarm":0,"NodeTooManyContainersAlarm":0,"IncorrectTopologyAlarm":0,"ServiceHueDownNotRunningAlarm":0,"ServiceHttpfsDownNotRunningAlarm":0,"ServiceBeeswaxDownNotRunningAlarm":0,"ServiceHiveDownNotRunningAlarm":0,"ServiceHs2DownNotRunningAlarm":0,"ServiceOozieDownNotRunningAlarm":0,"NodeManagerDown":0,"GatewayServiceDown":0,"InstanceMismatch":0,"ResourceManagerDown":0,"Insufficient memory for buckets":0,"NoDiskAttached":0,"MemoryAllocationAlarm":0,"FileMigrateServerDown":1555482296140,"MemorySwapping":0,"ApiServerDown":0}]}

List the nodes running the clients:

/opt/mapr/bin/maprcli node list -clientsonly true -json
clienttype           clienthealth  hostname           ip                       lasthb  id
posixclientgold      Active        atsqa4-119.qa.lab  10.10.88.119,172.17.0.1  28      5412384279424088014
NFS_V3               Active        qa108-181.qa.lab   10.10.108.181            1       711699521447755347
posixclientbasic     Active        qa108-182.qa.lab   10.10.108.182            5       5689202715616988402
posixclientplatinum  Active        qa108-183.qa.lab   10.10.108.183            15      5679519305469912939
LOOPBACK_NFS         Active        qa108-184.qa.lab   10.10.108.184            1       723686691202793155
NFS_V4               Active        qa108-185.qa.lab   10.10.108.185            1       7808496860582738296
posixclientbasic     Active        qa108-186.qa.lab   10.10.108.186            25      2792316733179447508
posixclientplatinum  Active        qa108-187.qa.lab   10.10.108.187            11      5678398615695393161
LOOPBACK_NFS         Active        qa108-188.qa.lab   10.10.108.188            1       5524477677754836725
NFS_V3               Active        qa108-189.qa.lab   10.10.108.189            1       3396225116726542411
NFS_V4               Active        qa108-190.qa.lab   10.10.108.190            2       1203052391917747224
curl -u mapr:mapr -X GET -k "https://host:8443/rest/node/list?clientsonly=true"
{"timestamp":1531171868890,"timeofday":"2018-07-09 02:31:08.890 GMT-0700 PM","status":"OK","total":1,"data":[{"id":"5412384279424088014","hostname":"atsqa4-119.qa.lab","ip":"10.10.88.119,172.17.0.1","clienttype":"posixclientgold","clienthealth":"Active","lasthb":28}]}