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 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

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

If a connection to the BMC is configured on the server, DCImanager will change the boot method using the ipmitool utility before each operation. To do this, the platform will run the following command on the server: 

ipmitool chassis bootdev pxe options=efiboot
CODE

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

<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.