1.3. Cloud & VM Install (Non-PXE environments)

This Cloud install guide provides a multi-cloud management focused installation process that runs DRP inside a Cloud Provider using Resource Brokers.

Other installation paths:

Unlike other environments which requires careful setup up of your network environment and consideration with regard to competing DHCP services, this setup does not use DHCP or PXE provisioning.

You must install Digital Rebar to use it, there is no SaaS version. Why do I have to install Digital Rebar locally?

1.3.1. Preparation

Acquire a Linux Cloud or Virtual instance. It should have at least 4 Gb or RAM and 20 Gb of storage available for a long term system. Short term trials can use as little as 1 CPU and 1 Gb of RAM.

You must provide access to TCP/8092, TCP/8091 and TCP/8090 (default ports) to access Digital Rebar. Openning ports varies depending on the provider.

1.3.2. Install

To begin, execute the following commands in an SSH session or during instance cloud-init process:

The example is for AWS clouds because using it’s API to get the public IP address for Digital Rebar. For other clouds, replace the API call with the one for that platform or manually provide the public IP.

#!/usr/bin/env bash
# AWS specific API call
value=$(curl -sfL http://169.254.169.254/latest/meta-data/public-ipv4)
# Google: value=$(curl -sfL -H "Metadata-Flavor: Google" http://metadata/computeMetadata/v1/instance/network-interfaces/0/access-configs/0/external-ip)
# Azure: value=$(curl -H Metadata:true --noproxy "*" "http://169.254.169.254/metadata/instance/network/interface/0/ipv4/ipAddress/0/publicIpAddress?api-version=2021-05-01&format=text")
# Digital Ocean: value=$(curl -sfL curl http://169.254.169.254/metadata/v1/interfaces/public/0/ipv4/address)
curl -fsSL get.rebar.digital/stable | sudo bash -s -- install --universal --version=tip --ipaddr=$value

The command will download the tip Digital Rebar (the systemctl service name is dr-provision) bundle and checksum from github, extract the files, verify prerequisites are installed, and create needed directories and links under /var/lib/dr-provision. The --systemd and --version flags included for clarity, they are not required for this install.

The install script used by our installs has many additional options including remove that are documented in its help and explored in other install guides.

Once the installation script completes, a Digital Rebar endpoint will be running your instance!

Follow the steps in UX System Bootstrap Wizard to registered your Digital Rebar endpoint.

1.3.3. Clusters and Brokers

These instructions apply to v4.8 and later.

Universal installation automatically build the correct container infratructure for cloud clusters and brokers.

Create a resource broker using one of the cloud resource profiles. The UX wizard will assist you in selecting a cloud resource profile and adding the required configuration parameters.

Create a cluster via the UX cluster wizard and select your broker. The system will automatically create the machines to back the cluster using a generated Terraform plan based on your broker inputs.

1.3.4. Clean Up

Once you are finished exploring Digital Rebar Provision in the cloud, cleanup any clusters that you created (that will remove the created VMs) and then remove the instance.