Virtual Machine Quick Start

Instructions for installing the Free Edition Edge Delta agent on a Virtual Machine.

  3 minute read  

You can install the Edge Delta Free Edition agent on a Linux virtual machine that contains a Kubernetes cluster.

Create a Kubernetes Cluster on a Virtual Machine

You can create a minikube virtual machine using Multipass to test Edge Delta’s Free Edition. This creates a virtual machine running Ubuntu with a minikube Kubernetes cluster already installed.

Install Multipass

Install Multipass using the instructions for your operating system:

Start the minikube VM

Create a new Multipass virtual machine instance using the image called minikube.

multipass launch minikube

A Linux VM is created and a minikube cluster is started on it.

Install Helm on the VM

  1. Shell into the minikube VM:
multipass shell minikube
  1. Choose the appropriate release binary for your system architecture here.
  2. Download the binary, replacing the URL with your chosen release:
curl -O https://get.helm.sh/helm-v3.10.1-linux-amd64.tar.gz
  1. Unpack the binary file you downloaded:
tar -zxvf helm-v3.10.1-linux-amd64.tar.gz
  1. Locate the helm file and move it to /usr/local/bin/helm
sudo mv linux-amd64/helm /usr/local/bin/helm

Create an Edge Delta Account

Next, create an Edge Delta user account.

  1. Click Login on the edgedelta.com website.
  2. Click Sign up.
  3. Enter your details in the Account Details page and click Register. Alternatively, click Sign up with Google.
  4. Check your email and Activate your account.
  5. If a user with the same domain name as your email address has created an organization you can click it to request to join it and wait for their approval. Otherwise, click Create an Organization.
  6. Enter an Organization name and click Next.

Install the Edge Delta Agent

Next, you install the Edge Delta agent daemonset in your VM’s Kubernetes cluster. This is done by first creating an agent configuration in the Edge Delta web app. Then you shell into the VM and deploy the agent using the customized Helm commands that the web app provides.

multipass shell minikube

You may need to use sudo to run the Helm install command.

After signing up in the web app, the initial set up page opens for deploying an Edge Delta Free Edition agent.

You can also create a new agent configuration manually. Click Admin - Clusters and click Add New Cluster.

  1. Enter a name for the agent tag - usually the same as the name of your cluster and click Continue.
2. Copy the three deploy commands from the web app as they include your agent's secret API key. Run them one at a time in your terminal (the K8s host's shell) to install the Edge Delta agent.

  • The first command downloads the Edge Delta Helm chart.

  • The second command updates all the charts in the local Helm repo.

  • The third command installs the correct version of the agent. It passes in the secret key to connect your agent to the Edge Delta web app, and it creates the edgedelta namespace for the daemonset. The following helm command option shows an example key 123456789 but yours will be specific to your agent.

--set secretApiKey.value=123456
  1. Click I Ran Deploy Commands. The web app checks for an agent hearbeat to confirm that the agent was successfully installed in your cluster and is able to send metrics to the web app.
  2. Click Go to Status Page.

After installing the agent, you can Set Up Alerts.