Quick Start Guide¶
This document will guide you through installing and configuring Digital Rebar. It will also walk through provisioning a guest OS using Digital Rebar. For this guide we are going to show a basic virtual environment where all systems, including the digital rebar instance reside on the same virtual server and network.
TL;DR - From linux prompt as root
We also recommend consulting the video guide of this process. Other helpful videos are available including our advanced features showcase (Uses cookies).
Prerequisites¶
Digital Rebar Platform (DRP) resources (Machines in DRP parlance) can run on physical, virtual, cloud, or container instances. All instances should have at least the following minimum requirements.
This guide will configure Digital Rebar to use systemd to control the service.
This graphic shows the basic layout for the quick start system example:
Hardware¶
- 1 or more CPU cores
- A minimun of 4 GB of memory
- A minimum of 20 GB of space (60 GB is recommended)
Operating Systems¶
- Linux (Centos 8 is recommended)
- MacOS
Software¶
The following packages are needed for installation.
- bash
- curl
- tar
- sha256sum (linux), shasum (MacOS)
Network¶
Most Digital Rebar environments require detailed knowledge of your network and DHCP environments.
Digital Rebar provides dhcp by default on all interfaces where the endpoint is running. It is important that any other service that provides dhcp on the endpoint should be disabled.
All hosts in the subnet should communicate to the DRP instance using the ports listed in the ports link.
Guest VMs¶
- 1 or more virtual CPU cores
- A minimum of 2 GB of memory (4 is recommended)
- A minimum of 10 GB of space
Install Digital Rebar Endpoint¶
Run the following command in a shell or terminal:
The command will download the stable version of Digital Rebar, and
content bundles needed to support Universal workflows. It then
extracts files, verifies prerequisites are installed, and creates the
needed directories and links under /var/lib/dr-provision
.
The install script has many
additional options that are documented in the --help
output and
explored in other install guides. You can output the help text with the
following command:
Once the installation script completes, a Digital Rebar endpoint will be running your local system.
At this point, you should finish configuration and continue post-install setup.