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 ImportantChanges 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 ImportantChanges 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
Give documentation feedback