Skip to content

restart-esxi-runner

Reinstall and restart the drpy ESXi agent on a host where it has stopped

This workflow reinstalls the drpy (Digital Rebar Python) agent on an ESXi host where the agent has stopped or been removed.

Background

The drpy agent is installed into ESXi memory. If a host reboots the agent is removed — or if the agent process stops for any reason — DRP loses the ability to communicate with that machine.

How to use

Assign this workflow to any ESXi machine whose drpy agent is no longer running and that was originally installed using the no-vib process:

  1. In the DRP UI or via drpcli, set the machine's Workflow to restart-esxi-runner.
  2. The machine will run through esxi-no-vib-check-api, which switches to the esxi-agent-runner Docker context, verifies API connectivity, then SSHs into the host to copy the agent files and start the drpy process.
  3. Upon completion the machine returns to local boot (complete stage).

Prerequisites

  • The ESXi host must already be provisioned via the no-vib workflows and reachable via SSH.
  • The esxi-agent-runner Docker context must be available on the DRP endpoint (it is required by esxi-no-vib-check-api).
  • All parameters required by esxi-no-vib-check-api must be set on the machine or its profiles (same requirements as during initial install).
  • This workflow does not reinstall ESXi — it only reinstalls the drpy agent.

Objects that Reference restart-esxi-runner

Not used in current content packs

Objects used by restart-esxi-runner