Appendix D: API
265
Firmware Operations
Software Versions
To retrieve some informations about the firmware versions, send a GET request
to the /maintenance/firmware URL. The resulting object contains the versions
of the installed firmware, the underlying operating system and the Linux kernel
version.
Example
curl -c cookies.txt -b cookies.txt -H "Content-Type: application/json"
https://192.168.3.175:8443/api/v1/maintenance/firmware
{"firmware_version":"4.4.0.5.85.20210323123034","base_os_version":"CentOS
Linux release 7.9.2009 (Core)","kernel_version":"Linux
3.10.0-1160.6.1.el7.x86_64"}
Firmware Update
To perform a software upgrade, use a POST request to the /firmware/upgrade
URL. This request has one parameter: the URI of the firmware file. The User
Station will download this firmware upgrade file and apply it, if it is a valid
update image. This call returns a boolean result, whether the update was
initiated successfully or not. In case of an error, an error string is also returned.
Note: Importing the firmware upgrade is done synchronously. Especially the
download, but also the unpacking, will take some seconds to complete. Also,
this API call just initiates the upgrade. Once the import is complete and the
upgrade file is valid, this API function returns and the actual upgrade is done in
background. API users have no control over the actual upgrade process. When
the upgrade process is done, the User Station will automatically reboot.
Example
curl -c cookies.txt -b cookies.txt -H "Content-Type: application/json" -d
'{ "uri":"https://192.168.2.101/KXUST_4.4.0.1.50_update.bin" }'
https://192.168.3.175:8443/api/v1/maintenance/firmware/upgrade
{"result":false,"error":"The provided software version is too old! It must be
equal or newer than the current version."}
curl -c cookies.txt -b cookies.txt -H "Content-Type: application/json" -d
'{ "uri":"https://192.168.2.101/KXUST_4.4.0.1.98_update.bin" }'
https://192.168.3.175:8443/api/v1/maintenance/firmware/upgrade
{"result":true}
Summary of Contents for Raritan Dominion User Station
Page 10: ......
Page 63: ...Appendix A Managing Targets and Access Methods 53 VNC Access Settings...
Page 64: ...Appendix A Managing Targets and Access Methods 54 SSH Access Settings...
Page 65: ...Appendix A Managing Targets and Access Methods 55 WEB Access Settings...
Page 159: ...Appendix A Administration Features 149 5 Enter the bind credentials in the Bind section...
Page 204: ...Appendix A Administration Features 194 9 Click Save...
Page 211: ...Appendix A Maintenance Features 201 6 Click OK in the confirmation dialog...
Page 269: ...Appendix D API 259...
Page 280: ......
