Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

header-navigation

Solutions

Featured solutions AI Campus and branch Data center WAN Security Service provider Cloud operator Industries
Campus and Branch

Welcome to the NOW Way to Wi-Fi

Take your networking performance to new heights with a modern, cloud-native, AI-Native architecture. Only Juniper can help you unleash the full potential of Wi-Fi 7 with our AI-Native platform for innovation.
Prepare for liftoff
Business intelligence analyst dashboard on virtual screen. Big data Graphs Charts.

AI Data Center Networking

Juniper’s AI data center solution is a quick way to deploy high performing AI training and inference networks that are the most flexible to design and easiest to manage with limited IT resources.
Find out more
Enterprise AI-Native Networking

Enterprise AI‑Native Routing

Juniper's Ai-Native routing solution delivers robust 400GbE and 800GbE capabilities for unmatched performance, reliability, and sustainability at scale.
Explore enterprise routing
Zero trust security

Ops4AI Lab

Visit our lab in Sunnyvale, CA and see our AI data center solution for yourself. You can try out your own model’s functionality and performance, too.
Visit the lab
Enterprise AI-Native Networking

Enterprise AI‑Native Routing

Juniper's Ai-Native routing solution delivers robust 400GbE and 800GbE capabilities for unmatched performance, reliability, and sustainability at scale.
Explore enterprise routing
Higher Education

Shaping Student Experiences: The NOW Way to Build Higher Education Networks

Juniper Networks CIO Sharon Mandell and a virtual summit of C-level IT leaders from prestigious institutions discuss ongoing efforts to support digital transformation on campus.
Watch now
Hand on tablet with healthcare overlay of graphics

Security in healthcare

In this IDC Spotlight report, discover how AI networking can automate and strengthen a healthcare ecosystem to defeat criminals and prevent loss. 
Gain insights into ecosystem security
Retail

The Future of In-Store Technologies

Retail experts Kevin McCartan, Senior IT Service Delivery Engineer at Musgrave; Jack Stratten of Insider Trends; and Christian Gilby, Senior Director of Product Marketing at Juniper Networks, discuss customer experiences.
See the future

Products

Wireless access Wired access SD-WAN / SASE Routing and switching Security Mist AI™ Management software Network operating system Blueprint for AI-Native Acceleration Optics
  • Operations
ACX7020 router

Juniper ACX7020 Cloud Metro Access Router

Legacy networks simply cannot meet the demands of today’s rapidly evolving metro landscape. Unlock a new generation of highly scalable architectures and automated operations with the Juniper ACX7020. 
Learn more
EX4000 Ethernet Switch

Next-gen AI-Native EX4000 line of switches

Lack of AI innovation from your current networking vendor slowing you down? Embrace Juniper’s cloud-native, AI-Native access switches that support every level and layer, across nearly every deployment.
Discover how
The Q and AI text with an image of Bob Friday and Kedar Dhuru.

The Q&AI Podcast

Delivering practical solutions and enriching discussions, this podcast series is a vital resource for those seeking an in-depth exploration of AI's transformative potential.
Catch the latest episode

Services

Services
Services AI Care

Juniper AI Care Services Revolutionize Your Service Experience

Our industry-first AI-Native services couple AIOps with our deep expertise across the full network life cycle. You can move from reactive response to proactive insight and action.
Explore AI Care Services
Services AI Data Center

Juniper AI Data Center Deployment Services Optimize Your AI Model Runs

We use our expertise and validated designs to help design, deploy, validate and tune networks, including GPUs and storage, to get the most from your AI infrastructure operation.
Learn about AI Data Center Deployment Services

Partners

Partners

Support and Documentation

Support and Documentation

Learn

About Juniper Training Events The Feed Resources Technology learning topics Thought leadership and insights
Audience raising hands up while businessman is speaking in training at the office.

Juniper certification and training news

See the latest
Ringing of the bell

All global events

See the latest
AI-native-now

AI-Native NOW event series

Explore events
AINN AI Innovation Impact Virtual Event

AI-Native NOW: AI Innovation and Impact

Register NOW
Juniper's Christina Hendrix at the head of a conference table. With the text "The NOW Way to Network" overlayed, with "NOW" emphasizing the "O" in green color.

The NOW Way to Network

Watch the video series
AI Native Now

Executive insights

Dive deep with leading experts and thought leaders on all the topics that matter most to your business, from AI to network security to driving rapid, relevant transformation for your business.
Learn more
A keynote speaker giving a presentation at a conference. There are dozens of people sitting around them. The presentation is displayed via projector on all the walls in the room.

Leadership voices

Juniper Networks’ leaders operate on the front lines of creating the network of the future. Take a look around to see what’s on their minds.
Watch now
Bob Friday and Jessica Garrison speaking

Bob Friday Talks

Join Bob as he ventures into all the knowns -- and -- unknowns -- of AI.
Catch the latest episode
Documentation
Menu
License Guide
Quick Starts
Validated Designs
Home Documentation Juniper Apstra Juniper Apstra 5.0.1 / 5.0.0 User Guide Devices Apstra ZTP

Juniper Apstra 5.0.1 / 5.0.0 User Guide

keyboard_arrow_up
close
keyboard_arrow_left
Juniper Apstra 5.0.1 / 5.0.0 User Guide
Table of Contents Expand all
list Table of Contents
file_download PDF
{ "lLangCode": "en", "lName": "English", "lCountryCode": "us", "transcode": "en_US" }
English
ON THIS PAGE
keyboard_arrow_right

Configure DHCP Server for Apstra ZTP

Release: Juniper Apstra 5.0
{}
Change Release
date_range 04-Nov-24
arrow_backward
arrow_forward

When a device connects to a network, Dynamic Host Configuration Protocol (DHCP) automatically assigns an available IP address to it. Apstra, by default, uses a Kea DHCP server for device management (as of Apstra version 5.0.0, previously it was ISC). If you set up a different DHCP server, you’re responsible for configuring the same details as described here.

DHCP Parameters

The DHCP file includes the following details:

Table 1: DHCP Basic Setup Parameters

Field Name

Description

Domain Search (domain-search)

Option to configure multiple search domains

(Example entry: dc1.yourdatacenter.com) To specify more than one value, separate them with a comma (,). For the parsing of the file to succeed, each line must end with a semicolon (;)

Domain Name (domain-name)

Option to indicate the domain name to use

(Example entry: dc1.yourdatacenter.com)

Domain Name Servers (domain-name-servers)

Option to list all of the DNS IP addresses. To specify more than one value, separate them with a comma (,). For the parsing of the file to succeed, each line must end with a semicolon (;)

TFTP Server IP (tftp-server-name)

IP address of the TFTP server

Subnet / subnet subnet

CIDR notation of IPv4 subnet (Example entry: 10.28.180.4/24)

Subnet / IP Pools / IP Range Start

The first address of the IP subnet available for dynamic assignment

Subnet / IP Pools / IP Range End

The last address of the IP subnet available for dynamic assignment

Subnet / Router

The default gateway IP address

Reservation Mode

Defines the reservation modes to use for this subnet

Host Reservations / Hardware Address

The host MAC address

Host Reservations / Fixed IP Address

The fixed IP address allocted for the host

Reservation Mode Default

All, Global, Out of Pool, or Disabled

Global Host Reservations / Hardware Address

The host MAC address

Global Host Reservations / Fixed IP Address

The fixed IP address allocted for the host

Table 2: Configurator Parameters

Field Name

Description

valid-lifetime (valid-lifetime)

Defines the default IP lease validity duration

max-valid-lifetime (max-valid-lifetime)

Defines the maximum IP lease duration

match-client-id (match-client-id)

To indicate if server will use client id for lease lookups

interfaces-config / interfaces (interfaces)

The interfaces on which the DHCP server would listen for DHCP messages

lease-database / type (type)

Defines the lease-database type

lease-database / name (name)

The file path inside DHCPD container where lease information would be stored

lease-database / lfc-interval (lfc-interval)

The intervals at which DHCP will initiate lease file cleanup

subnet / id (id)

subnet (subnet)

CIDR notation of IPv4 subnet

option-date / name

The standard DHCPv4 option name

option-date / code

The standard DHCPv4 option code

option-date / space

space

option-date / data

The value passed to the specified option

option-def /name (name)

The standard DHCPv4 option name

option-def / code (code)

The standard DHCPv4 option code

option-def / space (space)

 space

option-def / type (type)

The value passed to the specified option

client-classes / name (name)

"arista", "cisco", "sonic"

client-classes / test (test)

test

control-socket / socket-name (socket-name)

The location of UNIX socket file used to communicate with control agent

control-socket / socket-type (socket-type)

The DHCP socket type

loggers / name (name)

name

loggers / severity (severity)

Defines the logging severity level

loggers / debuglevel (debuglevel)

Specifies the level of debug message when severity is set to debug

loggers / output

output

reservation-mode (reservation-mode)

Types of reservations allowed (none, all, global, out of pool, disabled)

reservations-global (reservations-global)

Indicates if the server should look up global reservations

reservations-in-subnet (reservations-in-subnet)

Indicate if the server should look up in-subnet reservations

reservations-out-of-pool (reservations-out-of-pool)

Specify if the server can assume that all reserved addresses are out-of-pool. It can be ignored if "reservation-in-subnet" is false

reservations / Hardware Address

Used to list global reservations

reservations / Fixed IP Address

The fixed IP address allocated for the host

Use GUI Configurator to Configure DHCP

You can set up optional parameters that the DHCP services will send to every device that asks for DHCP services. You have the option of configuring these parameters at a later time via configlets. (If you define these parameters in the DHCP service, don't try to set them up again via Apstra; the device OS may return an error.)

If in doubt, don't enter random parameters; it may result in timeouts as a service tries to resolve IP addresses.

  1. If you're using the wizard, step 2 is to configure DHCP. (You can skip this step for now and come back later to complete this configuration.) If you're not using the wizard, then from the left navigation menu of the Apstra ZTP GUI, click Dhcp4, then click Basic Setup.
    The Basic Setup screen appears.
  2. Enter basic setup details, as applicable. See DHCP Parameters above for details. To cancel your entries, you can click Load Last Used Data at the bottom of the screen (new in Apstra version 5.0.0).
  3. Click Configurator (to the right of the Basic Setup tab).
    The Configurator screen appears.
  4. Enter details, as applicable. If you've entered details and want to start over, you can click Load Defaults (bottom left of screen) (new in Apstra version 5.0.0).
  5. Click Save to save the new configuration.

Use GUI Code Editor to Configure DHCP

  1. From the left navigation menu of the Apstra ZTP GUI, click Dhcp4, then click Code Editor.
    The Code Editor screen opens.
  2. Update the file, as appropriate. If you've entered details and want to start over, you can click Load Defaults (bottom left of screen) (new in Apstra version 5.0.0).
  3. Click Save to save the new configuration.

Use Text Editor to Configure DHCP

We recommend that you use the Apstra ZTP GUI Configurator to configure DHCP, but you have the option of configuring the file directly with a text editor, such as vi or nano.
Note:

All configuration files are owned by root. You must use sudo to run commands as root using the sudo command or after becoming root with the sudo -s command.

  1. Open a terminal and SSH into the Apstra ZTP server.
    ssh admin@<apstra-ztp-server-ip> where <apstra-ztp-server-ip> is the IP address of the Apstra ZTP server.
  2. To see DHCP files on the Apstra ZTP VM, navigate to the /containers_data/dhcp directory.
    admin@apstra-ztp:~$ sudo ls -l /containers_data/dhcp
    content_copy zoom_out_map
    admin@apstra-ztp:~$ sudo ls -l /containers_data/dhcp
total 36
drwxrwxrwx 2 root  root  4096 May  9 18:54 control_socket
-rwxrwxrwx 1 root  root  5838 May  9 18:53 dhcpd.conf
-rwxrwxrwx 1 admin admin 5836 May  7 17:38 dhcpd.conf.template
-rw-r--r-- 1 root  root     0 May  9 23:22 dhcpd.cong
-rwxrwxrwx 1 admin admin  198 May  7 17:38 Dockerfile
-rwxrwxrwx 1 admin admin 3074 May  7 17:38 init.sh
-rwxrwxrwx 1 admin admin 1830 May  7 17:38 README
-rwxrwxrwx 1 admin admin 1821 May  7 17:38 rsyslog.conf
admin@apstra-ztp:~$
  3. Open the dhcpd.conf file in a text editor, such as vi or nano and update the file, as appropriate.
    admin@apstra-ztp:~$ sudo vi /containers_data/dhcp/dhcpd.conf
  4. After modifying any DHCP configuration, restart the Apstra ZTP DHCP process with the sudo docker restart dhcpd command. This forces it to read the new file values.
    content_copy zoom_out_map
    admin@apstra-ztp:~$ docker restart dhcpd
dhcpd
admin@apstra-ztp:~$
arrow_backward PREVIOUS Configure Apstra Server Connection Details
NEXT arrow_forward ztp.json Keys
footer-navigation

© 1999 - 2025 Juniper Networks, Inc. All rights reserved.

Scroll to top