Skip to main content

nodes

This command retrieves inventory data about all managed or unmanaged servers and Flex System storage devices, all servers and storage devices in a specific Flex System chassis, a specific server, or a specific Flex System storage device. This command also system properties for a specific server or Flex System chassis.

Syntax

nodes  -h

nodes -s <managemnt_status> [-v <filter>]

nodes -u <node_UUID> [-v <filter>]

nodes -c <chassis_UUID> [-v <filter>]

nodes -m <properties_JSON> {-u <node_UUID> | -c <chassis_UUID>} [-v <filter>]

Parameters

{-h | --help}
Displays the syntax and brief usage information for this command.
{-c | --chassis} <chassis_UUID>
Specifies the UUID of a managed chassis. This command returns inventory data for all compute nodes in the chassis.
{-m | --modify} <properties_JSON>
Modifies system properties, specified in JSON format, for a specific server or Flex System chassis.
Table 1. Modify node properties.
AttributesRequired / OptionalTypeDescription
cmmDisplayNameOptionalStringChassis name
contactOptionalStringThe chassis contact information
hostnameOptionalStringHostname
ipInterfacesOptionalArrayInformation about the CMM IP addresses
 nameRequiredStringIP Interface name
 IPv4enabledOptionalBooleanIdentifies whether IPv4 is enabled. This can be one of the following values.
  • true. IPv4 is enabled
  • false. IPv4 is disabled
 IPv6enabledOptionalBooleanIdentifies whether IPv6 is enabled. This can be one of the following values.
  • true. IPv6 is enabled
  • false. IPv6 is disabled
 IPv4DHCPmodeOptionalStringIPv4 address assignment method. This can be one of the following values.
  • STATIC_ONLY
  • DHCP_ONLY
  • DHCP_THEN_STATIC
  • UNKNOWN
 IPv6DHCPenabledOptionalBooleanIdentifies whether IPv6 DHCP is enabled. This can be one of the following values.
  • true. IPv6 DHCP is enabled
  • false. IPv6 DHCP is disabled
 IPv6statelessEnabledOptionalBooleanIdentifies whether IPv6 stateless is enabled. This can be one of the following values.
  • true. IPv6 stateless is enabled
  • false. IPv6 stateless is disabled
 IPv6staticEnabledOptionalBooleanIdentifies whether IPv6 static is enabled. This can be one of the following values.
  • true. IPv6 static is enabled
  • false. IPv6 static is disabled
 IPv4assignmentsOptionalArrayInformation about IPv4 assignments
  idRequiredIntegerIPv4 assignment ID
  subnetOptionalStringIPv4 subnet mask
  gatewayOptionalStringIPv4 gateway
  addressOptionalStringIPv4 address
 IPv6assignmentsOptionalArrayInformation about IPv6 assignments
  idRequiredIntegerIPv6 assignment ID
  prefixOptionalIntegerIPv6 prefix
  gatewayOptionalStringIPv6 gateway
  addressOptionalStringIPv6 address
locationOptionalString(Flex System compute nodes only) Location in the chassis
Important
Changes made to the location of the server or storage device using this API method are not reflected in the rack view.
locationOptionalObject(Rack and tower servers only) Information about the location in the rack
Important
Changes made to the location of the server using this API method are not reflected in the rack view.
 locationOptionalStringLocation of the server
 rackOptionalStringRack
 roomOptionalStringRoom
 lowestRackUnitOptionalIntegerLRU
nameOptionalStringServer name
userDescriptionOptionalStringThe server description
The following example modifies the hostname, location, and contact information for the target server
{
"contact": "new contact",
"hostname":"",
"location": {
"location":"new location"
}
}

{-s | --status} <managemnt_status>
Identifies the management status of servers. You can specify one of the following values:
  • manage. Returns information for all managed servers.

  • unmanaged. Returns information for all discovered servers that are not managed by Lenovo XClarity Administrator.

{-u | --uuid} <node_UUID>
Specifies the UUID of a server. If a UUID is not specified, this command returns inventory data for all managed servers unless you also specify the -s unmanaged option.
{-v | --view} <filter>
Identifies the view to use for the returned data. If a filter is not specified, the default view is used.

You can also create custom views (see Creating custom views).

Examples

The following example returns inventory data for all managed compute nodes in a specific chassis.

connect --url https://192.0.2.0 --user ADMIN --noverify
nodes -c AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA