Installing BOSH Backup and Restore
Page last updated:
This topic describes how to install BOSH Backup and Restore (BBR).
To install BBR, you copy the
bbr executable to a jumpbox.
Once installed on your jumpbox, you can run
bbr commands to back up and restore your PKS
You must have a jumpbox before you can install BBR to the jumpbox. A jumpbox is a separate, hardened server on your network that provides a controlled means of access to the VMs other computers on your network.
See the jumpbox-deployment GitHub repository for an example jumpbox deployment.
Configure your jumpbox to meet the following requirements:
- Your jumpbox must be able to communicate with the network that contains your PKS deployment. You can use the Ops Manager VM as your jumpbox.
- Your jumpbox must have sufficient space for the backup.
- Your jumpbox must be in the same network as the deployed VMs because BBR connects to the VMs at their private IP addresses. BBR does not support SSH gateways.
- BBR copies the backed-up data from the VMs to the jumpbox, so you should have minimal network latency between the VMs and the jumpbox to reduce transfer times.
Note: BBR uses SSH to orchestrate the backup of your PKS instances using port 22 by default.
Perform the following steps to transfer the
bbr binary to your jumpbox:
Download the latest BOSH Backup and Restore release from Pivotal Network.
To add executable permissions to the
bbrbinary file, run
chmod a+x bbr:
$ chmod a+x bbr
To securely copy the
bbrbinary file to your jumpbox, run the following command:
scp LOCAL-PATH-TO-BBR/bbr JUMPBOX-USER/JUMPBOX-ADDRESS
If your jumpbox has access to the internet, you can instead SSH into your jumpbox and use
$ ssh JUMPBOX-USER/JUMPBOX-ADDRESS -i YOUR-CERTIFICATE.pem $ wget BBR-RELEASE-URL $ chmod a+x bbr
Please send any feedback you have to firstname.lastname@example.org.