HP Insight Control Server Provisioning 7.3 Update 1 Administrator Guide

-d {\"type\":\"OSDIlo\",\"username\":\"<iLO-administrator-user>\”,
\”password\”:\”<iLO-administrator-password>\”,
\”port\”:443,\”ipAddress\”:\”<iLO-IP-address>\”}
Response on success:
HTTP/1.1 202 Accepted
Date: Wed, 20 Feb 2013 17:33:30 GMT
Content-Type: application/json
Via: 1.1 cic.dns.hp
cache-control: no-cache
Transfer-Encoding: chunked
This response is accompanied by returned job URI.
Below is an example script that logs into the appliance, adds the server via iLO and logs out. This
script uses cURL.
#!/bin/sh
# login
AUTH=`curl -k -X POST -H "accept:application/json" -H "content-type: application/json"
https://<appliance-hostname-or-address>/rest/login-sessions?action=login
-d '{"userName":"<administrator-name>","password":<administrator-password>"}' ' | perl -e 'while (<>)
{/{"sessionID":"(.*)"}/ && print $1;}'`
# This script invokes a job to add iLO-managed server.
curl -i -k -X POST -H "auth:${AUTH}" -H "content-type:application/json"
-H "accept:application/json" -H "accept-language:en-us"
https://<appliance-hostname-or-address>/rest/os-deployment-ilos/?addstyle=old
-d '{"type":"OSDIlo","username":"<iLO-administrator-user>","password":"<iLOadministrator-password>",
"port":443,"ipaddress":"<iLO-IP-address>"}'
# logout
curl -k -i -X DELETE -H "auth:${AUTH}"
https://<appliance-hostname-or-address>/rest/login-sessions?action=logout
Once the registration process starts, a user will see two iLO related jobs in the left side column of
the Jobs page. First job — “Registers IloManagerService” will contain the job details of adding a
server through iLO. Second job — “Add iLO-managed Server” will contain job details booting a
server into default service OS, usually Linux PE.
Common errors from registering a server via its iLO:
500 — Internal Server Error
Resolution: Create a support dump
403 — Request Forbidden
Cause: Failed to login a user with provided credentials
Resolution: Try logging in again with valid credentials
409 — Conflict
Cause: iLO IP Address that user provided was already used to register and iLO
Resolution: Delete the server with duplicate iLO and try again or use different iLO address
404 — Not Found
Cause: The server cannot be found
Resolution: Verify that server exists, or not deleted
400 — Bad Request
Cause: When making a REST call one of the supplied parameters could be missing, malformed
or invalid.
Resolution: Verify that parameters are in correct form.
REST API to create and download a support dump
In addition to being able to download a support dump from your Insight Control server provisioning
appliance via the UI (on the Settings page select Actions→Create support dump), you can also
REST API to create and download a support dump 103