PUT /osdeployment/hostSettings

Use the PUT method to modify the network and storage settings for one or more specific servers.

Note: This API requires Lenovo XClarity Administrator v2.4.0 or later.

Authentication

Authentication with user name and password is required.

Request URL

PUT https://<management_server_IP>/osdeployment/hostSettings

Query parameters

None

Request body

Attributes Required / Optional Type Description
networkSettings Optional Object Information about network settings
  dns1 Optional String Preferred DNS server for the host server to be used after the operating system is deployed
  dns2 Optional String Alternative DNS server for the host server to be used after the operating system is deployed
  gateway Optional String Gateway of the host server to be used after the operating system is deployed. This is used when the network setting is set to static in the Global OS deployment settings.
Tip: To determine the IP mode, use GET /osdeployment/globalSettings.
  hostname Optional String Hostname for the host server. If a hostname is not specified, a default hostname is assigned.
  ipAddress Optional String IP address of the host server to be used after the operating system is deployed. This is used when the network setting is set to static in the Global OS deployment settings.
  mtu Optional Long Maximum transmission unit for the host to be used after the operating system is deployed
  prefixLength Optional String Prefix length of the host IP address to be used after the operating system is deployed. This is used when the network setting is set to static IPv6 in the Global OS deployment settings.
  selectedMAC Optional String MAC address of the host server to which the IP address is to be bound

The MAC address is set to AUTO by default. This setting automatically detects the Ethernet ports that can be configured and used for deployment. The first MAC address (port) that is detected is used by default. If connectivity is detected on a different MAC address, the XClarity Administrator host is automatically restarted to use the newly detected MAC address for deployment, and selectedMAC is set to the newly detected MAC address.

VLAN mode is supported only for servers that have MAC addresses in their inventory. If AUTO is the only the MAC address that is available for a server, then VLANs cannot be used to deploy operating systems to that server.

Tip: To obtain the MAC address, use the macaddress.value attribute in GET /hostPlatforms.
  subnetMask Optional String Subnet mask of the host server to be used after the operating system is deployed. This is used when the network setting is set to static in the Global OS deployment settings.
Tip: To determine the IP mode, use GET /osdeployment/globalSettings.
  vlanId Optional String VLAN ID for operating-system VLAN tagging

This attribute is valid only if in VLAN mode is enabled (see GET /osdeployment/globalSettings).

Important: Only specify a VLAN ID when a VLAN tag is required to function on the network. Using VLAN tags can affect the network routability between the host operating system and the Lenovo XClarity Administrator.
selectedImage Optional String Name of the selected OS image to be deployed
storageSettings Optional Object Preferred storage location on which you want to deploy operating-system images
  targetDevice Optional String Target device. This can be one of the following values.
  • localdisk. Local disk drive. The first enumerated local disk drive in the managed server is used.
  • M.2drive. M.2 drive. The first enumerated M.2 drive in the managed server is used.
  • usbdisk. Embedded USB Hypervisor. This location is applicable only when a VMware ESXi image is being deployed to managed servers. If two hypervisor keys are installed on the managed server, the VMware installer selects the first enumerated key for deployment.
  • lunpluswwn=LUN@WWN. SAN storage (for example, lunpluswwn=2@50:05:07:68:05:0c:09:bb)
Note: For ThinkServer servers, this value is always "localdisk."
uuid Required String UUID of the host platform

Request example

[{
   "networkSettings": {
      "dns1": "",
      "dns2": "",
      "gateway": "",
      "hostname": "",
      "ipAddress": "",
      "mtu": 1500,
      "prefixLength": 0,
      "selectedMAC": "AUTO",
      "subnetMask": "",
      "vlanId": "2"
   },
   "storageSettings": {
      "targetDevice": "localdisk"
   },
   "uuid": "69BDF8912E5211E4998B40F2E99033F0"
}]

Response codes

Code Description
200 OK
409 Conflict
500 Internal server error

Response body

Attributes Type Description
result String Result of the request. This can be one of the following values.
  • Success. The request was successful.
  • Failed. The request failed.
messages Array Information about the message that is related to the result of the request
  explanation String Additional information to clarify the reason for the message
  id String Message identifier of a returned message
  message String Message text associated with the message identifier
  recovery Array Recovery information
    text String User actions that can be taken to recover from the event
    URL String Link to the help system for more information, if available

Response example

{
   "result": "success",
   "messages": []
}