Retrieval

After creation of a new cluster, DISCO returns the UUID of the new cluster instance as Location. With this location, all access information about the cluster's master node can be retrieved with following command:

curl -v -X GET http://<DISCO IP>:8888/disco/<UUID>\
-H 'Category: disco; scheme="http://schemas.cloudcomplab.ch/occi/sm#"; class="kind";' \
-H 'Content-type: text/occi' \
-H 'X-Tenant-Name: <tenantname>' \
-H 'X-Auth-Token: <token>'

In the reply, not only the given parameters are returned but also a few other informations such as:

• external_ip - the assigned externally accessible IP address of the master node (see below)
• ssh_key_name - OpenStack's name of the newly created SSH key for accessing the master node
• ssh_public_key - the newly created SSH public key
• ssh_private_key - the SSH private key for accessing the cluster (see below)
• stack_status - the "OpenStack" status of the created stack (see below)

---

The master node can be accessed over SSH the following way: Within the returned SSH private key, the new line characters are replaced with \n. These have to be exchanged for the actual line break character and saved in a file, e.g. master.id_rsa. The connection to the master node is performed with the following command: ssh -i <ssh private key> ubuntu@<external IP>

If SSH complains about the access rights of the private key file, please change it the following way: chmod 600 <ssh private key>.

So what is the OpenStack status now? The following states can occur:

• CREATE_IN_PROGRESS - right after deployment, this message will be returned
• CREATE_COMPLETE - this is the state after a successful deployment
• CREATE_FAILED - if the deployment was not successful, a failed message is returned
• DELETE_IN_PROGRESS - is actually the state after deletion has been initialised, but this state will never be shown as at this time, the cluster is already deleted from DISCO's resources

Find lost UUID

What can be done if the UUID is not known though? with the following command, every deployed cluster can be retrieved from DISCO:

curl -v -X GET http://<DISCO IP>:8888/disco/ \
-H 'Category: disco; scheme="http://schemas.cloudcomplab.ch/occi/sm#"; class="kind";' \
-H 'Content-type: text/occi' \
-H 'X-Tenant-Name: <tenantname>' \
-H 'X-Auth-Token: <token>'