bootstrap-network

Creates a critical alert if a bootstrap Task failure occurs.

Used (primarily) during the DRP Endpoint bootstrap configuration process to install Subnets (DHCP "pools") and Reservations (static DHCP assignments).

It uses the bootstrap-network-subnets and bootstrap-network-reservations Params to specify the appropriate objects to install during the boostrap stages.

If a Profile named bootstrap-network exists on the system, the values in it are used. The Profile must exaclty match this name. The Subnet and Reservations objects added in via the Profile must be valid Object types with appropriate required values (eg Reservations require Strategy: MAC).

This is often/typically used during DRP installation time with an installer command example like (NOTE that bootstrap-network.yaml is a Content Pack!!):

# you must create a Content Pack which should contain a valid Profile object
# which carries the network bootstrapping configuration data. The below
# example assumes the Content Pack has been bundled up and named "bootstrap-networ.yaml".
curl -fsSL get.rebar.digital/stable | bash -s -- install --universal --initial-contents="./bootstrap-network.yaml"

An example of the bootstrap-network.yaml Content Pack in the above command might look like the following (see the individual Params documentation for more details on use of them):

# NOTE - this is a DRP Content Pack, and is applied to the system
#        with 'drpcli contents update ./bootstrap-network.yaml'
# YAML example Subnets and Reservations for bootstrap-network task
---
meta:
  Name: bootstrap-network
  Version: v1.0.0
sections:
  profiles:
    bootstrap-network:

      Name: bootstrap-network
      Description: Profile for network bootstrap of subnets and reservations.
      Documentation: |
        Uses the bootstrap-network task for DRP Endpoint configuration.

        Installs 2 Subnets and 2 Reservations during DRP Endpoint bootstrap.

      Meta:
        color: blue
        icon: sitemap
        title: Digital Rebar Provision
      Params:
        bootstrap-network-reservations:
          - Addr: 192.168.124.222
            Token: "01:02:03:04:05:00"
            Strategy: MAC
          - Addr: 192.168.124.223
            Token: "01:02:03:04:05:01"
            Strategy: MAC
        bootstrap-network-subnets:
          - ActiveEnd: 10.10.10.254
            ActiveStart: 10.10.10.10
            Name: subnet-10
            OnlyReservations: false
            Options:
            - Code: 1
              Description: Netmask
              Value: 255.255.255.0
            - Code: 3
              Description: DefaultGW
              Value: 10.10.10.1
            - Code: 6
              Description: DNS Server
              Value: 1.1.1.1
            - Code: 15
              Description: Domain
              Value: example.com
            Subnet: 10.10.10.1/24
          - ActiveEnd: 10.10.20.254
            ActiveStart: 10.10.20.10
            Name: subnet-20
            OnlyReservations: false
            Options:
            - Code: 1
              Description: Netmask
              Value: 255.255.255.0
            - Code: 3
              Description: DefaultGW
              Value: 10.10.20.1
            - Code: 6
              Description: DNS Server
              Value: 1.1.1.1
            - Code: 15
              Description: Domain
              Value: example.com
            Subnet: 10.10.20.1/24

Note

This can be generated using the drpcli contents bundle operation. Simply create a minimal content pack on disk, with profiles/bootstrap-network.yaml Object containing the appropriate Param definition.