17.3. Networking

This section contains information to the DRP endpoint about all networking settings within the available infrastructure.

17.3.1. Switches

This section lists all LLDP discovered switches.

The blue Refresh button will update the list ensuring you have the latest switch information on the network.

17.3.1.1. Subnets

This section lists all Subnets discovered in the network.

Each Subnet contains the following information:

  • Locked or Unlocked
  • Name
  • Subnet Address
  • Start IP Address Range
  • End IP Address Range
  • Active Time
  • Reserve Time

The top of the page contains a series of blue buttons for additional actions:

  • Refresh - Refresh the list of Subnets should a new Subnet be in the system
  • Filter - Select a specific set of Subnets based on the following options: Active Address, Address Available, Enabled, Key, Name, NextServer, Proxy, ReadOnly, Strategy, Subnet CIDR Address, Valid Subnet
  • Add - Add a new Subnet to the system
  • Clone - Clone a selected Subnet to add to the system
  • Delete - Remove all the selected Subnets

17.3.1.2. Configure Subnets

Configuring Subnets is a critical first step in Digital Rebar Provision operation. The basic UI will show all configured subnets and provide an easy way to add broadcast subnets based on the known interfaces.

To edit or delete a subnet, click on the name of the subnet to populate the editing area below the list. To create a relay subnet, click on the add subnet link. To create a broadcast subnet, click on the link provided after the name of the unassigned interfaces.

There are two primary types of subnets: broadcast and relay:

  • Broadcast subnets are associated with the addresses provided by the Digital Rebar Provision host system. Digital Rebar Provision can have multiple DHCP ranges; however, only one subnet can be assigned per interface _and_ the subnet CIDR must include the IP of the interface (the range should NOT). By convention, subnets associated with an interface will be named as the interface.
  • Relay subnets answer requests forwarded from DHCP relays such as those provided by switches. These can be any suitable IP range. Since the Relay subnets are not broadcast, they do not conflict with existing DHCP servers in the environment.

Digital Rebar Provision can operate in a permissive reservation mode or require users to whitelist systems before they are serviced. The OnlyReservations flag will operate as a reservations required (whitelist) mode when true; otherwise, Digital Rebar Provision permissive reservation mode will give out addresses to any valid DHCP request.

In additional to serving IPs, DHCP servers provide critical configuration (aka DHCP Options) information to the clients. Setting Option 67, Next Boot, is essential for Digital Rebar Provision to operate as a Provisioner. This information includes next boot (67), gateway (3), domain name (15), DNS (6) and other important information. It is encoded in the responses according to IETF RFC 2132

Consult the Godocs for more details about the specific fields.

17.3.1.3. Leases

Leases show individual links between tokens and addresses, created through reservation or subnet strategies. Leases remain valid for short periods of time, and cannot be edited. The expiration time of each lease is visible through the UI. Once a lease has expired, it may be removed.

This page shows a list of Leases available in the system.

17.3.1.4. Reservations

Reservations link tokens to specific IP addresses. This view shows a list of existing reservations along with tokens and strategies associated with each. Currently, MAC is the only available strategy. Reservations may contain options to be applied to connected servers, which are also visible through the UI.

This page shows a list of Reservations available in the system.