Introduced in KOTS v1.33.0
The steps described on this page are only necessary if you wish to configure a Network File System (NFS) as your KOTS Snapshots storage destination.
Important notes before you begin:
nfs-common
package is a very common package used on Ubuntu.Embedded clusters set up using installers that include the Velero addon are configured by default to store snapshots internally in the cluster. There are two ways to change this configuration to use NFS:
First, head to the “Snapshots” tab. From there, head to the “Settings and Schedule” tab and choose the “Network File System (NFS)” dropdown option.
Enter the NFS server hostname or IP Address, and the path that is exported by the NFS server and click “Update storage settings”. This step might take a couple of minutes so please be patient.
Note: If Velero is already installed in the cluster, you can follow the same instructions mentioned in the Embedded Clusters section.
If Velero is not yet installed in the cluster, then the first step would be to set up and deploy the necessary components that are going to be used to install and set up Velero with NFS. This can be done in two ways:
The velero configure-nfs CLI command can be used to configure NFS for either online or airgapped installations. After this command has run and completed successfully, it will detect if Velero is not installed and print out specific instructions on how to install and set up Velero.
Online Installations
kubectl kots velero configure-nfs --nfs-server <hostname-or-ip> --nfs-path /path/to/directory --namespace <namespace>
Airgapped Installations
kubectl kots velero configure-nfs \
--nfs-server <hostname-or-ip> \
--nfs-path /path/to/directory \
--namespace <namespace> \
--kotsadm-registry private.registry.host \
--kotsadm-namespace application-name \
--registry-username ro-username \
--registry-password ro-password
First, head to the “Snapshots” tab. From there, head to the “Settings and Schedule” tab. Then, you’ll be presented with a dialog which contains instructions for setting up Velero with different providers. Click on the “NFS” provider option (check screenshot below).
Then, you’ll be presented with another dialog for configuring NFS. Enter the NFS server hostname or IP Address, and the path that is exported by the NFS server and click “Configure” (check screenshot below).
This step might take a few minutes, so please be patient. Once the configuration is successful, you’ll be presented with a different dialog which contains a CLI command that will print out instructions on how to set up Velero with the deployed NFS configuration/components (check screenshot below).
After following the instructions from the above CLI command, and Velero has been installed successfully, you can go back to the Admin Console and either click on the “Check for Velero” button to retry detecting Velero, or simply refresh the page.