Some operations require the server to boot via PXE. For example, such booting method is needed to install the operating system, to perform diagnostics, or to switch to the recovery mode. These operations cannot be performed if the server is configured to boot from other devices by default. You can change the server boot method in the BIOS settings or using the DCImanager 6 API.

To enable automatic server booting via PXE, execute the command:

curl -X POST 'https://domain.com/api/dci/v3/setting/operation_change_boot_order' -H 'x-xsrf-token: <session_id>' -H 'Cookie: ses6=<session_id>' -H 'isp-box-instance: true' -d '{"value": "true"}'
CODE

domain.com — IP address or domain name of the server with DCImanager 6

<session_id> — session id. Read more in the article API guide

If a connection to the BMC is configured on the server, DCImanager 6 will change the boot method before each operation. The platform actions depend on the type of BMC:

  • IPMI — the platform will execute the command on the server:

    ipmitool chassis bootdev pxe options=efiboot
    CODE
  • Redfish — the platform will perform an HTTP request to the BMC to change the boot order.

To disable automatic server booting via PXE, execute the command:

curl -X POST 'https://domain.com/api/dci/v3/setting/operation_change_boot_order' -H 'x-xsrf-token: <session_id>' -H 'Cookie: ses6=<session_id>' -H 'isp-box-instance: true' -d '{"value": "false"}'
CODE

domain.com — IP address or domain name of the server with DCImanager 6

<session_id> — session id. Read more in the article API guide

Note

For the commands to be executed successfully, a BMC connection must be configured for the server. Read more in Configuring server connections.