Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: add DHCP sever parameter table

...

Note

IP addresses assigned statically are not probed!

Parameters

Properties

PropertyDescription
address
add-arp (
IP
yes | no; Default: 
)Specify the IP address (or IP pool) for static lease
no)Whether to add dynamic ARP entry. If set to
 0.0.0.0 - pool from the server will be usedaddress-list (string; Default: )Address list to which address will be added if a lease is bound.allow-dual-stack-queue (yes | no; Default: yes)
no either ARP mode should be enabled on that interface or static ARP entries should be administratively defined in /ip arp submenu.
address-pool (string | static-only; Default: static-only)IP pool, from which to take IP addresses for the clients. If set to static-only, then only the clients that have a static lease (added in lease submenu) will be allowed.
allow-dual-stack-queue (yes | no; Default: yes)Creates a single simple queue entry for both IPv4 and IPv6 addresses, uses the MAC address and DUID for identification. Requires IPv6 DHCP Server to have this option enabled as well to work properly.
always-broadcast (yes | no; Default: no)
Send all
Always send replies as broadcasts
block-access (
even if the destination IP is known. Will add additional load on L2 network.
authoritative (after-10sec-delay | after-2sec-delay | yes | no; Default: 
no
yes)
Block access for a client with static leaseclient-id (string; Default: )If specified, must match DHCP 'client identifier' option of the requestdhcp-option (string; Default: )Add additional DHCP options from option list.dhcp-option-set (string; Default: )Add additional set of DHCP options.insert-queue-before (bottom | first | name;; Default: )Specify where to place dynamic simple queue entries for static DCHP leases with rate-limit parameter set.lease-time (time; Default: 0s)A time that the client may use the address. If set to 0s lease will never expire.mac-address (MAC; Default: 00:00:00:00:00:00)If specified, must match the MAC address of the clientrate-limit (integer[/integer] [integer[/integer] [integer[/integer] [integer[/integer]]]];; Default: )Adds a dynamic simple queue to limit IP's bandwidth to a specified rate. Requires the lease to be static. Format is: rx-rate[/tx-rate] [rx-burst-rate[/tx-burst-rate] [rx-burst-threshold[/tx-burst-threshold] [rx-burst-time[/tx-burst-time]]]]. All rates should be numbers with optional 'k' (1,000s) or 'M' (1,000,000s). If tx-rate is not specified, rx-rate is as tx-rate too. Same goes for tx-burst-rate and tx-burst-threshold and tx-burst-time. If both rx-burst-threshold and tx-burst-threshold are not specified (but burst-rate is specified), rx-rate and tx-rate is used as burst thresholds. If both rx-burst-time and tx-burst-time are not specified, 1s is used as default.server (string)Server name which serves this clientuse-src-mac (yes | no; Default: no)When this option is set server uses the source MAC address instead of the received CHADDR to assign an address
Option changes the way how a server responds to DHCP requests:
  • yes - replies to clients request for an address that is not available from this server, DHCP server will send a negative acknowledgment (DHCPNAK);
  • no - DHCP server ignores clients requests for addresses that are not available from this server;
  • after-10sec-delay - requests with "secs < 10" will be processed as in "no" setting case and requests with "secs >= 10" will be processed as in "yes" case;
  • after-2sec-delay - requests with "secs < 2" will be processed as in "no" setting case and requests with "secs >= 2" will be processed as in "yes" case;


If all requests with "secs < x" should be ignored, then delay-threshold=x setting should be used.
bootp-lease-time (forever | lease-time | time; Default: )Accepts two predefined options or time value:
  • forever - lease never expires
  • lease-time - use time from lease-time parameter
bootp-support (none | static | dynamic; Default: static)Support for BOOTP clients:
  • none - do not respond to BOOTP requests
  • static - offer only static leases to BOOTP clients
  • dynamic - offer static and dynamic leases for BOOTP clients
client-mac-limit (integer | unlimited; Default: unlimited)Specifies whether to limit a specific number of clients per single MAC address or leave unlimited. Note that this setting should not be used in relay setups.
conflict-detection (yes | no; Default: )Allows disabling/enable conflict detection. If the option is enabled, then whenever the server tries to assign a lease it will send ICMP and ARP messages to detect whether such address in the network already exists. If any of the above get reply address is considered already used. Conflict detection must be disabled when any kind of DHCP client limitation per port or per mac is used.
delay-threshold (time | none; Default: none)If the sec's field in the DHCP packet is smaller than the delay threshold, then this packet is ignored. If set to none - there is no threshold (all DHCP packets are processed)
dhcp-option-set (name | none; Default: )Use a custom set of DHCP options defined in the option sets menu.
insert-queue-before (bottom | first | name; Default: )Specify where to place dynamic simple queue entries for static DCHP leases with a rate-limit parameter set.
interface (string; Default: )The interface on which server will be running.
lease-script (string; Default: "")A script that will be executed after a lease is assigned or de-assigned. Internal "global" variables that can be used in the script:
  • leaseBound - set to "1" if bound, otherwise set to "0"
  • leaseServerName - DHCP server name
  • leaseActMAC - active mac address
  • leaseActIP - active IP address
  • lease-hostname - client hostname
  • lease-options - an array of received options
lease-time (time; Default: 10m)The time that a client may use the assigned address. The client will try to renew this address after half of this time and will request a new address after the time limit expires.
name (string; Default: )Reference name
parent-queue (string | none; Default: none)
relay (IP; Default: 0.0.0.0)The IP address of the relay this DHCP server should process requests from:
  • 0.0.0.0 - the DHCP server will be used only for direct requests from clients (no DHCP relay allowed)
  • 255.255.255.255 - the DHCP server should be used for any incoming request from a DHCP relay except for those, which are processed by another DHCP server that exists in the /ip dhcp-server submenu.
src-address (IP; Default: 0.0.0.0)The address to which the DHCP client must send requests in order to renew an IP address lease. If there is only one static address on the DHCP server interface and the source address is left as 0.0.0.0, then the static address will be used. If there are multiple addresses on the interface, an address in the same subnet as the range of given addresses should be used.
use-framed-as-classless (yes | no; Default: yes)Forward RADIUS Framed-Route as a DHCP Classless-Static-Route to DHCP-client. Whenever both Framed-Route and Classless-Static-Route are received Classless-Static-Route is preferred.
use-radius (yes | no | accounting; Default: no)Whether to use RADIUS server:
  • no - do not use RADIUS;
  • yes - use RADIUS for accounting and lease;
  • accounting - use RADIUS for accounting only.

Network

Code Block
languageros
/ip dhcp-server network

...