Using the BOSH Resurrector
Page last updated:
Warning: Pivotal Cloud Foundry (PCF) v2.5 is no longer supported because it has reached the End of General Support (EOGS) phase as defined by the Support Lifecycle Policy. To stay up to date with the latest software and security updates, upgrade to a supported version.
This topic describes the BOSH Resurrector, which monitors VMs and re-creates VMs that become unavailable. It also describes how to enable the BOSH Resurrector, to ensure high availability (HA) for your PCF deployment.
For vSphere users, this topic explains how to enable vSphere HA to work along with the BOSH Resurrector.
- vSphere HA restarts unreachable VMs at the IaaS level, below the BOSH layer where the BOSH Resurrector operates.
- Pivotal recommends enabling the vSphere HA, the BOSH Resurrector, and a highly-available storage solution to protect the VMs in your deployment.
For more information about the BOSH Resurrector, see the Auto-healing Capabilities section of the BOSH documentation.
The following sections describe the BOSH Resurrector and how to enable it.
The BOSH Resurrector increases PCF availability in the following ways:
- Reacts to hardware failure and network disruptions by recreating virtual machines on active, stable hosts
- Detects operating system failures by continuously monitoring virtual machines and recreating them as required
- Continuously monitors the BOSH Agent running on each virtual machine and recreates the VMs as required
The BOSH Resurrector continuously monitors the status of all virtual machines in an PCF deployment. The Resurrector also monitors the BOSH Agent on each VM. If either the VM or the BOSH Agent fail, the Resurrector recreates the virtual machine on another active host.
The following limitations apply to using the BOSH Resurrector:
- The Resurrector does not monitor or protect the Ops Manager VM or the BOSH Director VM.
- The Resurrector might not be able to resolve issues caused by the loss of an entire host.
- The Resurrector does not monitor or protect data storage.
To mitigate these limitations, Pivotal recommends vSphere HA. For more information, see vSphere HA below.
To enable the BOSH Resurrector:
Log into the Ops Manager web interface.
On the Product Dashboard, select BOSH Director.
In the left navigation menu, select Director Config.
Select Enable VM Resurrector Plugin and click Save.
The following sections describe vSphere HA, and how to enable it to work along with the BOSH Resurrector.
In the event of a host failure, vSphere HA restarts but does not recreate VMs on alternate ESXi hosts in the same cluster. A host failure could result from a sudden power off, crash due to hardware fault, or the vSphere host becoming disconnected from the network. BOSH Resurrector cannot recover from a host failure.
For more information, see vSphere High Availability in the BOSH documentation.
Follow the steps below to enable vSphere High Availability:
Launch the vSphere Management Console.
Right-click the cluster that contains the Pivotal Cloud Foundry deployment and select Edit Settings.
Select the Turn on vSphere High Availability checkbox.
Click OK to enable vSphere High Availability on the cluster.