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.
Attributes Required / Optional Type Description
cmmDisplayName Optional String Chassis name
contact Optional String The chassis contact information
hostname Optional String Hostname
ipInterfaces Optional Array Information about the CMM IP addresses
  name Required String IP Interface name
  IPv4enabled Optional Boolean Identifies whether IPv4 is enabled. This can be one of the following values.
  • true. IPv4 is enabled
  • false. IPv4 is disabled
  IPv6enabled Optional Boolean Identifies whether IPv6 is enabled. This can be one of the following values.
  • true. IPv6 is enabled
  • false. IPv6 is disabled
  IPv4DHCPmode Optional String IPv4 address assignment method. This can be one of the following values.
  • STATIC_ONLY
  • DHCP_ONLY
  • DHCP_THEN_STATIC
  • UNKNOWN
  IPv6DHCPenabled Optional Boolean Identifies whether IPv6 DHCP is enabled. This can be one of the following values.
  • true. IPv6 DHCP is enabled
  • false. IPv6 DHCP is disabled
  IPv6statelessEnabled Optional Boolean Identifies whether IPv6 stateless is enabled. This can be one of the following values.
  • true. IPv6 stateless is enabled
  • false. IPv6 stateless is disabled
  IPv6staticEnabled Optional Boolean Identifies whether IPv6 static is enabled. This can be one of the following values.
  • true. IPv6 static is enabled
  • false. IPv6 static is disabled
  IPv4assignments Optional Array Information about IPv4 assignments
    id Required Integer IPv4 assignment ID
    subnet Optional String IPv4 subnet mask
    gateway Optional String IPv4 gateway
    address Optional String IPv4 address
  IPv6assignments Optional Array Information about IPv6 assignments
    id Required Integer IPv6 assignment ID
    prefix Optional Integer IPv6 prefix
    gateway Optional String IPv6 gateway
    address Optional String IPv6 address
location Optional String (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.
location Optional Object (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.
  location Optional String Location of the server
  rack Optional String Rack
  room Optional String Room
  lowestRackUnit Optional Integer LRU
name Optional String Server name
userDescription Optional String The 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

Related links