Cloud agnostic cloudSwXtch VM Install

WHAT TO EXPECT

In this article, you will learn how to install a cloudSwXtch instance on an existing Linux Ubuntu 20.04 virtual machine. This install process can be used on any cloud but requires a license file from swXtch.io. For more information about VM prerequisites, please see the cloudSwXtch System Requirements.

Pre-Installation Step: Create VM

Before installing cloudSwXtch, you will need to create an Ubuntu 20.04 virtual machine on your desired cloud with connection to the internet. In addition, it should encompass all the prerequisites outlined in the cloudSwXtch System Requirements

Step One: Install cloudSwXtch

In this step, users will execute commands in their VMs to manually install a cloudSwXtch instance.

Run your freshly created virtual machine using your desired tool.

Enter the following command to download the cloudSwXtch installer script:

ShellShell

token="si=RDONLY&spr=https&sv=2021-06-08&sr=c&sig=xyPF7SyI1cagUAEIZViqCHz7RroFTy2Fkltn2wwvMzc%3D"
curl -X GET -H "x-ms-date: $(date -u)"  "https://sdmcdevstorage.blob.core.windows.net/imagebuilder/image_install.sh?$token" -o image_install.sh
chmod +x image_install.sh

Use the following command to get the latest version of cloudSwXtch. The latest release is 3.2.0.
ShellShell
```
ver="v3.2.0"
```

Enter the following to download that version.

ShellShell

curl -X GET -H "x-ms-date: $(date -u)"  "https://sdmcdevstorage.blob.core.windows.net/imagebuilder/install-${ver}.tar.gz?$token" -o install-${ver}.tar.gz

Execute the installer.
ShellShell
```
sudo ./image_install.sh ${ver}
```
1. Precision Time Protocol (PTP) is not installed at default. Users can install with the argument --ptp true with the installer script. This should only be done if they plan to deploy a PTP configuration with their endpoints. For guidance on how to enable PTP for the xNIC, see Windows and Linux installation guides.
  With both files on the VM (and in the same directory), run the installer as follows:
```
sudo ./image_install.sh ${ver} --ptp true
sudo reboot now
```

This will automatically reboot the machine.

Step Two: Contact swXtch.io for a license

Users will need to contact swXtch.io for a license file. For more information, see How to License a cloudSwXtch.

NEXT STEPS

The cloudSwXtch is ready to use. The next step is to install the xNIC on each client expected to get traffic from the cloudSwXtch. See Installing xNIC for more information on preparing clients.