Skip to content

Part 1: Setup

What Will You Do

This is Part 1 of a multi-part, self-paced quick start exercise. In this part, you will perform a few "one-time" tasks required for cluster provisioning.

Step 1: Download RCTL

The RCTL CLI allows you to programmatically interact with the controller enabling users to construct sophisticated automation workflows.

  • Login into your Org
  • Navigate to My Tools to download both the RCTL CLI and the "CLI Config" file
  • Initialize RCTL using the step-by-step instructions
  • Ensure you update your OS's Path environment variable for RCTL

Step 2: Download Cluster Kubeconfig

The ZTKA Kubeconfig file allows users to securely access clusters they are authorized to access using the KubeCTL CLI.

  • Login into your Org
  • In your project, select Infrastructure -> Clusters
  • On your cluster, click the gear icon on the cluster card
  • Select Download Kube Config
  • Use this file in your KubeCTL CLI

Step 3: Download KubeVirt's virtctl CLI

The virtctl CLI is needed for the use of advanced features to interact with virtual machines

  • On your machine, run the following commands
VERSION=$(kubectl get -n kubevirt -o=jsonpath="{.status.observedKubeVirtVersion}")
ARCH=$(uname -s | tr A-Z a-z)-$(uname -m | sed 's/x86_64/amd64/') || windows-amd64.exe
echo ${ARCH}
curl -L -o virtctl${VERSION}/virtctl-${VERSION}-${ARCH}
chmod +x virtctl
sudo install virtctl /usr/local/bin

Step 4: Clone Git Repo

Declarative specification files for the resources in this guide are available in a Git repository

  • Clone the Git repository to your laptop using the command below.
git clone
  • Once complete, you should see a folder called "kubevirt" which contains the specification files needed for this exercise.


At this point, you have everything setup and configured to install KubeVirt and a virtual machine.