Home > Blogs > VMware vCenter Orchestrator Blog

Sample scenario for the Cisco UCS Manager plug-in

We announced some days ago the general availability of the vCenter Orchestrator plug-in for Cisco UCS Manager. As we said, this plug-in provides a complete set of workflows, actions and scripting objects that cover pretty much all the most common tasks from the Cisco UCS Manager administration point of view. And it is capable to manage multiple Cisco UCS Managers at the same time.

Now, to start getting familiar with the plug-in and its possibilities, let’s define a typical scenario inside the Cisco UCS Manager context and let’s see how we can cover it with the Cisco UCS Manager plug-in. In order to do that we will compose our own workflow with some of the workflows that the new plug-in provides.

Consider the sample scenario “Create and configure a Service Profile and attach it to a Blade”. What do we want to do exactly?

  1. Create a simple Service Profile
  2. Edit the Service Profile
    1. Add a vNIC
    2. Add a vHBA
    3. Assign a Boot Policy
  3. Assign the Service Profile to a Blade
  4. Wait for the association to be completed (the Blade will be booted)
  5. Do something else after that depending on the result (e.g. send a notification to somebody)

So, let’s build our own workflow step by step. We will call the workflow “Install New Service Profile”.

1) Create a simple Service Profile
The plug-in provides a workflow called “Create Basic Service Profile” that does exactly what we need. It creates a simple Service Profile by setting the parent Organization, a name and an optional description.

2) Edit the Service Profile
Here the plug-in provides a complete set of actions and workflows for creating and configuring practically all the Service Profile attributes, including vHBAs, vNICs, vSANs, profiles (IPMI, Placement…), policies (Boot, Fibre Channel Adaptor, Local Disk Configuration, Serial over LAN…), etc.
In our example we just want to create a vHBA for the Service Profile, to create a vNIC for the Service Profile and to attach a predefined Boot Policy to the Service Profile. To do that, we can use the following workflows provided by the plug-in:

  • “Create vHBA”
  • “Create vNIC”
  • “Attach Boot Policy to Service Profile”

Here just to comment that the workflows “Create vHBA” and “Create vNIC” have a big set of input parameters, but in our example (as we will see later) we will consider that the user of our “Install New Service Profile” workflow has to worry only about the vHBA and vNIC names because all the other parameters will be preconfigured for him/her (they will be defined as workflow attributes instead of workflow input parameters).

3) Assign the Service Profile to a Blade
Here again the plug-in provides a workflow that does exactly what we need. The workflow is called “Assign Service Profile to Blade” and it triggers the association between the specified Service Profile and Blade.

4) Wait for the association of the Service Profile with the Blade to be completed

Here the plug-in provides a workflow that is more flexible than what we need, because we can use it not just for monitoring the association of the Service Profile but also the disassociation, the assignment / unassignment, etc. This workflow is called “Wait For Event On Service Profile” and basically it blocks the main workflow execution until the plug-in receives an event from the Cisco UCS Manager notifying that the specified operation has finished.

In our example it’s clear that the association is the operation that we want to monitor, so we won’t ask the user to provide the type of operation but only to provide a timeout in case the association takes too much time. Operations like that can take a few minutes on a real Cisco environment, and this time is something that the user of the workflow has to keep in mind.

5) Do something else after the association has finished depending on the result
Here we can continue invoking UCS Manager plug-in operations or we can also invoke any other operation from vCO, including any operation from any of the plug-ins that we have installed.

In our example we just check the result of the association between the Service Profile and the Blade and then we run simple different tasks (success tasks or error tasks) depending on it.
But some more complex examples of these success and error tasks could be:

  • Send a confirmation e-mail to the System Administrator
  • Register the result of the process on an external log file
  • Start installing an Operating System on the new running Blade
  • Process the next Blade (if any)

Finally, this would be the full picture of the workflow:

And this could be our presentation of the workflow:

As we expect from the previous steps, the information that the user has to provide to the workflow is just:

  • Organization where the Service Profile will be created
  • Name of the Service Profile
  • Description of the Service Profile (optional)
  • Name of the vHBA to create and assign to the Service Profile
  • Name of the vNIC to create and assign to the Service Profile
  • Boot Policy to assign to the Service Profile
  • Blade which the Service Profile will be assigned to
  • Timeout to control the association operation between the Service Profile and the Blade

So, it’s time to run the workflow!

…and the workflow finishes.

The first thing we can see is if the workflow has finished successfully from the vCO Client.

Also, we can check the UCS Manager plug-in inventory and see that we have the new Service Profile created and that it contains the new vHBA and the new vNIC.

Finally, we can check the Cisco UCS Manager console and see that our workflow has finished successfully because all the elements that we created and configured are there.

And this is just the beginning!