::: {.index} pair: Install Digital Rebar; Labs :::
1000 Install Digital Rebar¶
Overview¶
- Id: 1000
- Time: 15 Minutes
- Enabled: Yes
- Difficulty: introductory
- Tags: core
* Concepts: install .. youtube:: MqUl_Jxuv1Q :privacy_mode: Video Link
Objective¶
Install your own Digital Rebar test server
Business ROI Unlike multi-tenant SaaS, Digital Rebar is user operated software: you'll never have to open your firewall for us, share sensitive information or upload access credentials.
Prerequisites¶
None
Install Digital Rebar¶
Provision a Machine¶
Acquire a machine from your Virtual Machine Manager or Cloud Provider console.
::: {.tabs} ::: {.tab} Cloud or VM via Console
These steps are also found in the cloud install guide.
- Instantiate a Linux machine with a recent version (most major variants are supported)
-
Have access to the Internet
No access? see Air Gap install
-
Provide at least 2 CPUs and 8 GB of RAM for a lab system
-
Make sure it has inbound access to SSH (22) and ports 8090-8092
For example, use
-
Note the public IP address of the new instance
- SSH to your new cloud instance :::
::: {.tab} Terraform
Cloud via Terraform uses steps in the online Cloud install guide
Access to run terraform with working AWS credential and config files are needed to successfully complete this lab.
- Download the cloud appropriate Terraform plan AWS Cloud, Google, Azure, Digital Ocean, or Linode
-
Run the Terraform plan
The plan defaults to using your public key located at
~/.ssh/id_rsa.pub
. You can specify an alternate public key file by appending-var="ssh_pub_key=/path/to/key.pub"
to theterraform apply
command. -
Wait for Terraform to provide the DRP Server URL
- Skip to the Login and Register step :::
::: {.tab} PXE (Bare Metal and Local)
The Quick Start covers local Virtual Machine Manager or bare metal server.
- Instantiate a Linux machine with a recent version (most major variants are supported)
-
Have network with access to the Internet
No access? see Air Gap install
-
Have a DHCP isolated network
For example in Virtualbox, provide a host only network with DHCP disabled.
-
Provide at least 2 CPUs and 8 GB of RAM for a lab system
-
Make sure it has inbound access to SSH (22) and ports 8090-8092
For example, use
-
Note the access IP address of the new instance
- Console or SSH to your new machine ::: :::
Install Digital Rebar¶
Choose the an install method¶
::: {.tabs} ::: {.tab} General
-
Run the following
:::
::: {.tab} AWS
-
Run the following or pass it into the User Data during instance create
:::
::: {.tab} Google
-
Run the following or pass it into the User Data during instance create
:::
::: {.tab} Azure
-
Run the following or pass it into the User Data during instance create
:::
::: {.tab} Digital Ocean
-
Run the following or pass it into the User Data during instance create
:::
::: {.tab} Linode
-
Run the following
:::
::: {.tab} Other Clouds
-
Substitute the [public|access IP address] and run the following
::: :::
Alternative options¶
Common additional install flags include
Argument Description
--version=tip
Sets the install version to the latest instead of the current stable
--drp-user=[user]
Adds a new super user to the endpoint
--drp-password=[pass]
Sets the password for the current user (rocketskates) or the new user if specified.
--remove-rocketskates
Removes the current rocketskates user if different than --drp-user
--drp-id=replaceme
Sets the ID of the DRP Endpoint at install time
Login and Register¶
You can login when you see the Digital Rebar version after
Waiting for dr-provision to start
completes
Visit your server's API url
https://[public|access IP address]:8092
Accept the unsigned certificate
This must be done initially until you install a signed certificate.
Login using the system username and password
Default is
rocketskates
andr0cketsk8ts
Complete the license form to create your license
Or, upload your license if you've already created one.
Explore your system¶
We have a library of interactive labs to continue your journey!
Visit Info and Preferences page to review the System Bootstrapping Wizard
If you are using the default password, follow the "Change Default Password" link in the Wizard
On the Machines page, observe the self-runner machine that was created during the installation to process
If you have loggged in before installation completes, you can observe Digital Rebar completing the bootstrapping process. workflows for your Digital Rebar service.
On the Jobs page, observe the jobs that were run during the universal bootstrap process to setup the machine
On the Catalog page, check out the versions of all the components in use by Digital Rebar
If you used
stable
to install, you can upgrade totip
for the latest code from this page.Visit the License Manager page, to extend your no-obligation trial license for a 30 days