Installing BOSH Backup and Restore
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 BOSH deployment or BOSH Director.
For more information, see Backing up with BOSH Backup and Restore and Restoring with BOSH Backup and Restore.
Prerequisite
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.
Step 1: Configure Your Jumpbox
Configure your jumpbox to meet the following requirements:
- Your jumpbox must be able to communicate with the network that contains your BOSH deployment.
- 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.
Consult the following table for more information about the network access permissions required by BBR.
VM | Default Port | Description |
---|---|---|
BOSH Director | 25555 | BBR interacts with the BOSH Director API. |
Deployed Instances | 22 | BBR uses SSH to orchestrate the backup on the instances. |
BOSH Director UAA | 8443 | BBR interacts with the UAA API for authentication, if necessary. |
Step 2: Transfer BBR to Your Jumpbox
Perform the following steps to transfer the bbr
binary to your jumpbox:
Download the latest BBR release from the bosh-backup-and-restore GitHub repository.
Extract the
bbr
binary file from the BBR release.To add executable permissions to the
bbr
binary file, runchmod a+x bbr
:$ 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
If your jumpbox has access to the internet, you can also SSH into your jumpbox and use
wget
:$ ssh JUMPBOX-USER/JUMPBOX-ADDRESS -i YOUR-CERTIFICATE.pem $ wget BBR-RELEASE-URL $ chmod a+x bbr