This topic describes how to install BOSH Backup and Restore (BBR).
To install BBR, first validate that your jumpbox VM is a valid BOSH backup host, then copy the
bbr executable to the jumpbox and configure BBR.
For more information, see Install and Configure BOSH Backup and Restore below.
After installing BBR, you can run
bbr commands to back up and restore your Tanzu Kubernetes Grid Integrated Edition deployment.
For more information about using BOSH Backup and Restore, see:
Using BBR requires the following:
The OpenBSD version of netcat must be installed on the jumpbox host.
bbr executable file. You must have the correct BBR executable version for your TKGI installation.
Note: BBR does not support SSH gateways.
To install and configure BBR:
Your jumpbox must meet or exceed minimum BBR requirements. You can use the Ops Manager VM as your jumpbox if it can be configured to meet all of the requirements below.
To configure your jumpbox to meet BBR requirements:
Ensure the jumpbox can communicate with the network containing your Tanzu Kubernetes Grid Integrated Edition deployment.
BBR uses SSH to orchestrate the backup of your Tanzu Kubernetes Grid Integrated Edition instances using port 22 by default.
Configure the jumpbox to be in the same network as the deployed VMs.
BBR connects to the deployed VMs at their private IP addresses.
Ensure there is minimal network latency between the jumpbox and the source VMs BBR backs up.
To install the
bbr executable to your jumpbox:
To add executable permissions to the
bbr binary file, run the following command:
chmod a+x bbr
To securely copy the
bbr binary file to your jumpbox, run the following command:
scp LOCAL-PATH-TO-BBR/bbr JUMPBOX-USER@JUMPBOX-ADDRESS:
LOCAL-PATH-TO-BBRis the path to the
bbrbinary you downloaded from VMware Tanzu Network.
JUMPBOX-USERis the ssh username for connecting to the jumpbox.
JUMPBOX-ADDRESSis the IP address, or hostname, of the jumpbox.
To verify that BBR is installed:
Run the following command:
Verify the returned BBR version.
BBR writes backup and restore logs to the current directory in a file named
By default BBR writes errors associated with stack traces to the log file.
BBR also reports default information about the backup and restore run:
To troubleshoot a failed BBR run, enable verbose logging. When executed in verbose mode, BBR reports the following additional information:
To enable verbose logging, use the optional