LATEST VERSION: v1.2 - RELEASE NOTES
Pivotal Container Service v1.2

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 deployment.

For more information, see Backing up the PKS Control Plane and Restoring the PKS Control Plane.

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 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.

Step 2: Transfer BBR to Your Jumpbox

Perform the following steps to transfer the bbr binary to your jumpbox:

  1. Download the latest BOSH Backup and Restore release from Pivotal Network.

  2. To add executable permissions to the bbr binary file, run chmod a+x bbr:

    $ chmod a+x bbr

  3. 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 instead SSH into your jumpbox and use wget:

    $ ssh JUMPBOX-USER/JUMPBOX-ADDRESS -i YOUR-CERTIFICATE.pem
    $ wget BBR-RELEASE-URL
    $ chmod a+x bbr
    


Please send any feedback you have to pks-feedback@pivotal.io.

Create a pull request or raise an issue on the source for this page in GitHub