dhcp - Manage the DHCP server
[1] dhcp [range [raz | (add | del) (internal | auxiliary) <ip1> <ip2>]]
[2] dhcp [fixed [raz | add <hostname> (internal | auxiliary) <mac-address> <ip> | del <hostname>]]
[3] dhcp [peer (master | slave) [raz | (add | del) <peer-ip>]]
[4] dhcp report
CacheGuard integrates a built-in DHCP (Dynamic Host Configuration Protocol) server to provide dynamic IP address allocation. The DHCP server operates only on the internal (web in VLAN mode) and the auxiliary networks. This command allows you to configure the DHCP server. See the mode command to activate the DHCP server.
Without any argument, this command displays the DHCP configuration. To display only a specific DHCP configuration use its associated keyword (range, fixed or peer).
The first usage form [1] allows you to add or delete an IP range on a network interface. To add a DHCP IP range, use the keywords range add followed by the network interface, the lowest and highest IP addresses in the range. To delete a DHCP IP range, use the keywords range del followed by the network interface, the lowest and highest IP addresses in the range. To erase all ranges, use the keywords range raz.
Note that the DHCP server supports a limited number of IP address leases. The maximum number of supported leases per network interface is twice the number of users configured during the installation phase.
The second usage form [2] allows you to associate a fixed IP address with a client on a network interface. To associate a fixed IP address with a client, use the keywords fixed add followed by the client host name, the network interface, its MAC address, and the fixed IP address. A valid MAC address is a sequence of 6 hexadecimal values between 00 and FF separated by colon (":") characters (for instance, 00:01:02:03:04:05). To disassociate a fixed IP address from a client, use the keywords fixed del followed by the client host name. To erase the list of fixed IP addresses, use the keywords fixed raz.
The third [3] usage form allows you to define a remote DHCP server as a failover peer for the local DHCP server. When using the DHCP failover feature, two CacheGuards must be configured as DHCP peer server of each other (one must be configured as master and the other as slave).
To define a remote CacheGuard as a DHCP peer server for the local CacheGuard, use the keywords peer add followed by the role and the internal IP address of the remote CacheGuard (when using VLANs, give the IP address configured for the peer VLAN on the remote CacheGuard). The role is defined using the keywords master or slave.
To delete a DHCP peer server use the keywords peer del followed by the role and IP address of the remote CacheGuard. To erase all DHCP peer servers use the keywords peer raz.
The fourth [4] usage form allows you to display a report on active DHCP leases managed by the system.
Note that only one unique DHCP peer server may be configured.
apply(1), mode(1)
CacheGuard Technologies <www.cacheguard.com>
Send bug reports or comments to the above author.
Copyright (C) 2009-2026 CacheGuard Technologies - All rights reserved