Using the BOSH Resurrector

Page last updated:

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.

BOSH Resurrector

The following sections describe the BOSH Resurrector and how to enable it.

About BOSH Resurrector

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.

BOSH Resurrector Limitations

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.

Enable BOSH Resurrector

To enable the BOSH Resurrector:

  1. Log into the Ops Manager web interface.

  2. On the Product Dashboard, select BOSH Director.

    Director tile vmware

  3. In the left navigation menu, select Director Config.

    Resurrector

  4. Select Enable VM Resurrector Plugin and click Save.

vSphere HA

The following sections describe vSphere HA, and how to enable it to work along with the BOSH Resurrector.

About vSphere HA

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.

Enable vSphere HA

Follow the steps below to enable vSphere High Availability:

  1. Launch the vSphere Management Console.

  2. Right-click the cluster that contains the Pivotal Cloud Foundry deployment and select Edit Settings.

  3. Select the Turn on vSphere High Availability checkbox.

    Enable ha

  4. Click OK to enable vSphere High Availability on the cluster.