Deploying an Elastic Cluster on Bare Metal

Detailed information can be found in the ContainerX install and administration guide

We currently support Google Chrome for CX Management UI. Some UI features may not function correctly with other browsers.

Once the CX management server is setup in a specific environment, follow these steps to setup Elastic Containers and Container Pools, and to deploy containers.


First, login to the CX platform with the username admin and password admin.


Quick Wizard

Follow the quick wizard to quickly create an EC with few hosts and container pools in a single workflow.


From the main landing page at management server URL, click Login. No credentials are necessary. If you haven’t created any clusters yet, you will start at quick wizard automatically. Otherwise, click on QUICK WIZARD on top of any page to start the wizard.

Step 1 - Select Elastic Cluster Type.

Choose the EC type based on the environment CX management server is deployed in. Next steps are specific to the environment, Bare Metal, AWS, vSphere Cluster and Azure and are annotated as such in section headers ([METAL],[AWS],[vSphere],[Azure] respectively..

Step 2 - Create Elastic Cluster

Fill in description for the new EC as shown in the example, and click Next.


Step 3 - Provision Hosts

The following procedure must be completed on each bare metal host before adding it to a CX cluster

  1. Logon as root.
  2. Execute as follows:

    sudo apt-get install curl; curl -sSL http://<management host IP>:8081/pkgs/ |sudo sh | tee prepare.log
  • This step prepares the host for orchestration from CX management server later during cluster creation process by adding a ssh key and running CX agents.


  1. Reboot host.
  2. Ensure that:
  1. The kernel OS version is >= 3.16.

    root@bot4:~# uname -r
  2. Docker is not installed.

    root@bot4:~# docker version
    The program 'docker' is currently not installed. You can install it by typing:apt-get install docker

These steps must be re-run after any redeployment of CX management server, as ssh keys required to orchestrate the hosts must be reset.


Add hostname and IP address information for each of the hosts. Please note that host names and IP addresses must be unique across the whole system - same host name or IP address cannot be used across multiple clusters.


Step 4 - Add Persistent Storage (optional)

This step is only applicable to bare metal environment. Add name or IP address of your NFS server setup. You can fill in bogus values if you don’t want to use persistent storage at this point.

The test button will verify if your NFS connection is successful.

Step 5 - Create Container Pools

Fill in the name and limits for container pools and select “NEXT”.. 

Step 6 - Confirm selections


When you hit next, you will see a “CONFIRM SELECTIONS page”. If everything looks good, hit “CONFIRM”. This will show a progress indicator as different entities are setup. If this step is successful, you will be taken to the next step. If this step fails, you can go back, make appropriate fixes, and try again.

Step  7 - Setup Complete

Hit Done to goto the EC details page.

Have more questions? Submit a request


Please sign in to leave a comment.