Skip to content

Tutorial: Manually Joining a Machine to Digital Rebar Provision (DRP)

This tutorial will guide you through the process of manually joining an existing machine (Linux, Windows, or ESXi) to a DRP endpoint using the join-up scripts. By the end, your machine will be registered in DRP and ready for management—without requiring PXE booting.

Prerequisites

  • You have access to a running DRP endpoint (with API and files service enabled)
  • You have administrator/root access on the machine you want to join
  • The machine has network connectivity to the DRP endpoint

Step 1: Obtain the Join-Up Script

For Linux

Open a terminal on the target machine and run:

curl -kfsSL https://<drp-endpoint>:8092/machines/join-up.sh | bash
  • Replace <drp-endpoint> with the hostname or IP address of your DRP server.
  • The script will register the machine with DRP and collect hardware, network and OS information.

For Windows

Open a cmd.exe promtp as Administrator and run:

curl.exe --insecure -fsSLo C:\Windows\Temp\join-up.ps1 https://<drp-endpoint>:8092/machines/join-up.ps1 & powershell.exe -ExecutionPolicy Bypass -File C:\Windows\Temp\join-up.ps1
  • Replace <drp-endpoint> with the hostname or IP address of your DRP server.
  • The script will register the machine with DRP and collect hardware, network and OS information.

For ESXi

TBD

Step 2: Confirm Registration in DRP

  • Log in to your DRP UI or use drpcli machines list to verify the new machine appears.
  • The machine will have the created-by-join-up metadata set, and will be assigned the workflow from the defaultJoinUpWorkflow preference or the defaultWorflow if not set.
  • The boot environment will be set to local to avoid rebooting into discovery.

What Next?

  • You can assign additional profiles, parameters as needed from the DRP UI or CLI.
  • The machine will be ready to follow new workflows for hardware lifecycle management or OS maintenance.