Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Using the pattern determined in network planning for the site, this zorctl This scsctl initialization step will build builds a custom configuration file for dhcpd DHCP and restart that service. The configuration file changes will specify the pools restarts the service using the pattern determined in Network Planning for the site. Changes in the configuration file specifies the pool and ranges which DHCP is to manage, as well as other DHCP response data to be used with PXE booting storage nodes.

To configure DHCP, use the following command:

zorctl init dhcp

Info

As a reminder, to see the full list of options use zorctl init dhcp help

Required Parameters

...

The Swarm network requires to have an upper or lower (or both) reserved range defined to configure DHCP. At least one of these parameters must be provided.

--dhcp-reserve-lower DHCP_RESERVE_LOWER

The number of IP addresses to reserve in the lower subnet range (default is 0).

--dhcp-reserve-upper DHCP_RESERVE_UPPER

The number of IP addresses to reserve in the upper subnet range (default is 0)

...

Additional DHCP Parameters

The following optional parameters allow further customization of the DHCP configuration.

.

For example, set the DHCP reserve lower range.

Code Block
languagebash
scsctl init dhcp --dhcp-

...

The default DHCP lease time for storage nodes, in seconds (default is 172800)

--dhcp-lease-max DHCP_LEASE_MAX

The maximum allowed DHCP lease time for storage nodes, in seconds (default is 604800)

--dhcp-transient-percent DHCP_TRANSIENT_PERCENT

The percentage of the DHCP managed range for transient clients (default is 50)

Other Optional Parameters

The following parameters are concerned with other related services and information about those services provided in DHCP responses. The default values come from the initialization wizard as well as the prior configuration scan, but the values may be overridden here.

--dns-domain DNS_DOMAIN

The DNS domain name for the Swarm cluster. This is typically a subdomain of a larger organization DNS domain.

--dns-servers DNS_SERVERS

A comma-delimited list of DNS servers to be used by Swarm. If spaces are included in the list, then the entire list will need to be wrapped in quotes.

--ntp-servers NTP_SERVERS

A comma-delimited list of NTP servers to be used by Swarm. If spaces are included in the list, then the entire list will need to be wrapped in quotes.

Tip
Next, install a Swarm license
reserve-lower 30
Info

Info

  • The configuration values used for DHCP reserve lower or upper range always come from the network planning.

  • If you are re-running scsctl init dhcp after initial install for any reason, it is recommended to check the bash history on the SCS to view the prior scsctl command and its settings. Run the below command on the SCS to view the last DHCP setting command used.

    Code Block
    history | grep "scsctl init dhcp" | tail -1

See https://perifery.atlassian.net/wiki/spaces/public/pages/1223491667/SCS+Administration#Swarm-(Internal)-Network-MTU to configure the MTU value that DHCP serves to storage nodes.

See https://perifery.atlassian.net/wiki/spaces/public/pages/1223491667/SCS+Administration#Swarm-(Internal)-Network-Gateway to configure the network gateway that DHCP serves to storage nodes.

Tip

Next, Install Swarm License.