6.20. UCS-Service

The UCS-Service is an optional Rack-HD service that will enable RackHD to communicate with Cisco UCS Manger. This allows RackHD to discover and manage the hardware under the UCS Manager.

6.20.1. UCS-Service Setup

The UCS-Service configuration can be set in the config.json file. The following options are supported:

Option Description
address IP address the UCS-service will bind to
port TCP port the UCS-service will bind to
httpsEnabled set to “true” to enable https access
certFile Certificate file for https (null for self signed)
keyFile Key file for https (null for self signed)
debug set to “true” to enable debugging

To start the UCS-Service run

$ python app.py

6.20.2. UCS-Service API

The API for the UCS-Service can be accessed via a graphical GUI by directing a browser to https://<RackHD_Host>:7080/ui

6.20.3. UCS-Service Workflows

Default workflows to discover and catalog UCS nodes have been created. There are separate workflows to discover physical UCS nodes, discover logical UCS servers, and to catalog both physical and logical UCS nodes.

6.20.3.1. Discover Nodes

The Graph.Ucs.Discovery workflow will discover and create nodes for all the physical servers being managed by the specified UCS Manager. It will also create a ucs-obm-service for each node. This obm service can then be used to catalog and manage the node. The user must provide the address and login credentials for the UCS manger and the URI for the ucs-service. Below is an example:

{
   "name": "Graph.Ucs.Discovery",
   "options":
       {
           "defaults":
               {
                   "username": "admin",
                   "password": "secret",
                   "ucs": "172.31.128.252",
                   "uri": "http://localhost:7080"
               }
       }
}

The Graph.Ucs.Service.Profile.Discovery workflow will discover and create nodes for all the logical servers being managed by the specified UCS Manager. It will also create a ucs-obm-service for each node. The user must provide the address and login credentials for the UCS manger and the URI for the ucs-service. Below is an example:

{
   "name": "Graph.Ucs.Service.Profile.Discovery",
   "options":
       {
           "defaults":
               {
                   "username": "admin",
                   "password": "secret",
                   "ucs": "172.31.128.252",
                   "uri": "http://localhost:7080"
               }
       }
}

6.20.3.2. Catalog Nodes

Once the UCS nodes have been discovered, the Graph.Ucs.Catalog can be run with the NodeId. This graph will use the ucs-obm-service created by the discovery workflow so no other options are required.