Over the last few months I’ve been writing posts about a simplified manner in which we can automate solutions on UCS called KUBAM.  Everything we’ve done has been open and available on Github to solicit feedback and let the community know what we are doing.  We haven’t been super vocal about it though as the velocity of how it works has been changing extremely fast.  We are, however, now to a point where the groundwork is laid and we can begin to broadcast the awesomeness of KUBAM.  Please note that the documentation on the KUBAM website hasn’t been updated yet to reflect this.  This is a work in progress.  If you have questions, want to get involved in helping, or get stuck testing, please leave a comment on this post or hit me up on twitter.


KUBAM aims to let your data center dance.  We want the process of deploying solutions to UCS to be as simple and painless as possible.  We want to remove any friction you may have with deploying a UCS solution.  We can do this because of the following:

  • UCS has the most complete API of any server platform.  With this obscene power, we can automate all aspects of it.
  • Container technologies have become more advanced to allow simple software provisioning and packaging.  This means you can install complicated software using containers that work instantly.  Dependency trenching  is not for you.  That’s for the past.

All solutions on UCS start with deploying an operating system.  You might use VMware ESXi, Microsoft Windows, or your favorite distribution of Linux.  This is the first problem we need to make painless.  Up until now it hasn’t been that awesome.  It’s not just UCS, its every bare metal server on the planet.  You rationalize it though, by saying:  “Well, we only do it once”.  But we think it should be different.

When you provision a machine instance on a cloud or virtual environment the process of installing an operating system is painless.  It’s built in.  You go to the cloud providers website or use an API to accomplish this.  For many people even this step is becoming unnecessary.  As the industry move towards serverless architectures, deploying code on a runtime is the only thing you really care about.   This is what we want to accomplish with KUBAM.  A seamless experiences using advanced software to make these solutions possible.  We’re starting with the Operating System.


In the beginning of October 2017 we finished the first docker compose file that includes a front end web interface and an API.  As of this blog post, you can download that, plug it into your environment and deploy CentOS 7.3 or ESXi 6.0/6.5 with lots more coming.

Here are the requirements to get started:

  1. You have an existing UCS environment that has Fabric Interconnects that is connected to either blades or rack mount servers
  2. You have a VM or machine running somewhere that has docker installed as well as docker-compose that can access the UCS.  This can either run on UCS or be stand alone somewhere else in the data center.  This will be the KUBAM node.
  3. You have an ISO image of the required Operating system (CentOS Linux, etc) that is required for your solution.

That’s basically it.  We wanted to make the requirements and the friction as easy as possible.  Now what do you do next to get running?

You simply run:

# curl https://raw.githubusercontent.com/CiscoUcs/KUBaM/master/docker-compose.yml --output docker-compose.yml
# docker-compose up -d

At that point you point your web browser to the IP address of the server you ran the docker compose command on.  (You could even run this on your laptop!).  The picture below is what KUBAM looks like at first glance:

As you can see the first thing it asks you is for the credentials and IP address of your UCS environment.  Today KUBAM only handles one UCS domain.  Once this is entered there are a few more easy steps.

Network Information

KUBAM asks for the UCS VLAN that you wish to install over.  This is the VLAN the servers will network boot from.  This VLAN can have a DHCP server or other services running on it. KUBAM doesn’t care.  It won’t interfere with any of these settings since KUBAM doesn’t use DHCP nor mapped MAC addresses to deploy the solutions.  KUBAM is a ninja.  These networks can even be in production.  KUBAM could care less.

In this menu KUBAM wants to know what network settings the newly provisioned operating systems will need.  Netmask, DNS, and router information.  We recommend DNS point to OpenDNS name servers  In this way you get even more security built in!

Server Instances

When all the network settings appear to be in place KUBAM wants to know which servers you would like to be provisioned.  Here you select the UCS servers to place in the KUBAM pool.  You are then instructed to give each server an IP address, operating system, and role of what solution should be installed on this server.  KUBAM knows you hate typing IP addresses and sequential hostnames, so it tries to be intuitive by auto populating hostnames and IP addresses for you.  Giddy Up!

Operating System and Deployment

Once the Operating system is extracted and boot images are created, you simply press “Deploy” and KUBAM goes to work.  It creates service profiles automatically and maps the installation media using the automated vMedia policies.  After waiting several minutes, your machines are ready to carry out your inner most desires.  Want to run an app that controls drones?  Create an ICO? Invent something entirely new?  KUBAM is ok with that.  It doesn’t give it a single thought.  It just does what you want and stays out of the way.

At present time KUBAM is pretty slow.  The entire process can take about 25 minutes, including the time taken to download the docker images and deploy.  KUBAM knows you don’t like to wait.  Fortunately for you there’s no extra steps.  You just hang out, grab coffee, or see if your crypto currency is increasing in value while it does it all for you.  Once you press that “Deploy” button you do nothing else but wait.  Soon, whether it be an automated ESX VSAN cluster or a brand new Kubernetes cluster it will be ready for you.  It is the most simple way you could ever deploy a solution like this in your own datacenter.  It is also a process we are constantly looking to further simplify and make life easier for UCS customers.

Under the Hood

KUBAM aims to inject so much lubrication into your data center that you will think you need to strap down your racks to the cage.   KUBAM doesn’t want you to even care about how it works but just know that it works, and works well.  However, KUBAM understands that you are searching for answers and that you can handle the truth.  That is one reason KUBAM is open source.  KUBAM will give you the truth and not tell you to “stay tuned” nor wait any longer.

KUBAM is built with two containers.  One container (the front end) is a simple React-Redux application written in node (javascript, lots of javascript)  This is your easy button view to the world.  By itself the front end container is powerless but sexy.  It gets its power by making calls to the KUBAM api container.  Since you are curious to know, the API container is written in python and uses the UCSM SDK.  It also uses tricks to mount ISO images and make them run.  Things that are not obvious how to do in containers.  You may be interested in learning how to do this yourself, and KUBAM has answers for you there as well.  Go ahead and visit KUBAM’s friend, the UCS Programmable Infrastructure page on DEVNET where you could learn about sample code, learning labs, and sandboxes.

State for KUBAM is kept inside a mounted volume in the ~/kubam directory on the server where the containers run.  A kubam.yaml file is automatically updated when the API server is called with certain POST requests.  In this way, the KUBAM architecture could fit easily into a solution like Cisco Cloud Center, UCS Director, or Cisco Intersight.  KUBAM aims to play nice with its fellow Cisco products.


KUBAM is an open source tool made to allow UCS systems to dance.  KUBAM only supports UCS because only UCS has the APIs that are powerful enough to automate end to end datacenter solutions.  KUBAM will expand to other operating systems as well as other roles.  At present KUBAM is working on simplifying Kubernetes, Docker Data Center as well as ESXi with VSAN.  ACI integration is on the roadmap as well.  While these solutions are currently used by many of our customers today, KUBAM is also looking to deploy more forward looking solutions that might give a public cloud experience in your own UCS datacenter.  KUBAM would love your input.  Version one is rough and raw. KUBAM is scrappy, but is reacting and responding quickly.

We’d love to hear what you think. Ask a question or leave a comment below.
And stay connected with Cisco DevNet on social!

Twitter @CiscoDevNet | Facebook | LinkedIn

Visit the new Developer Video Channel


Vallard Benincosa

Technical Solutions Architect

WW Data Center and Virtualization