Page last updated:
This topic lists common troubleshooting scenarios and their solutions when using BOSH Backup and Restore (BBR) to back up and restore Pivotal Cloud Foundry (PCF).
BBR expects a backup script that doesn’t exist.
The Elastic Runtime backup fails with the following error:
The mysql restore script expects a backup script which produces mysql-artifact artifact which is not present in the deployment.
To back up MySQL in Elastic Runtime, BBR needs the backup prepare node to be enabled.
Follow the procedures in the Step 4: Enable Backup Prepare Node section of the Backing Up Pivotal Cloud Foundry with BBR topic and re-run the BBR backup command.
The restore fails with a MySQL monit start timeout.
While running the BBR restore command, restoring the job
mysql-restore fails with the following error:
1 error occurred: * restore script for job mysql-restore failed on mysql/0. ... Monit start failed: Timed out waiting for monit: 2m0s
This happens when
mariadb fails to start within the timeout period. It will end up in an “Execution Failed” state and
monit will never try to start it again.
Ensure that your MySQL Server cluster has only one instance. If there are more than one instances of MySQL Server, the restore will fail with a
monit start timeout. Scale down to one instance and retry.
If your MySQL Server cluster is already scaled down to one node, it may have taken longer than normal to restart the cluster. Follow the procedure below to manually verify and retry.
- List the VMs in your deployment:
$ bosh -e DIRECTOR_IP --ca-cert /var/tempest/workspaces/default/root_ca_certificate \ -d DEPLOYMENT_NAME \ ssh
- Select the
mysqlVM to SSH into.
- From the
mysqlVM, run the following command to check that the
mariadbprocess is running:
$ ps aux | grep mariadb
- Run the following command to check that
mariadb_ctrlis in an “Execution Failed” state:
$ sudo monit summary
- If so, run the following command from the
mysqlVM to disable monitoring:
$ monit unmonitor
- Run the following command to enable monitoring:
$ monit monitor
- After a few minutes, run the following command:
$ monit summaryThe command should report that all the processes are running.
- Re-attempt the restore with BBR.
The deployment does not match the structure of the backup.
The following error displays:
Deployment 'deployment-name' does not match the structure of the provided backup
The instance groups with the restore scripts in the destination environment don’t match the backup metadata. For example, they may have the wrong number of instances of a particular instance group, or the metadata names an instance group that doesn’t exist in the destination environment.
BBR only supports restoring to an environment that matches your original environment. Pivotal recommends altering the destination environment to match the structure of the backup.
BBR displays an error message containing “SSH Dial Error” or another connection error.
The jumpbox and the VMs in the deployment are experiencing connection problems.
Perform the following steps:
- Ensure your deployment is healthy by running
bbr deployment backup-cleanupin order to clean up the data from the failed backup on the instances. Otherwise, further BBR commands will fail.
- Repeat the BBR operation.