Configuring DHCP on the SecureStacks

FAQ_User — Thu, 12 Dec 2013 22:10:00 GMT

Article ID: 7724

Products
SecureStack C3
Firmware all
SecureStack C2
Firmware 4.00.24 and higher
SecureStack B3
Firmware all
SecureStack B2
Firmware 3.01.16 and higher
SecureStack A2
Firmware 1.03.17 and higher

Goals
Configure DHCP
Sample configuration

Symptoms
'set dhcp'

Cause
As of the firmware versions stated above, the SecureStack product line supports the ability to act as a DHCP Server. This document provides background regarding that feature.

Solution
A total of 16 DHCP address pools, dynamic and/or static, may be configured per stack. All IP addresses must belong to the same IP subnet as is used by the switch host ('set ip address...'); or if routing is enabled, may alternatively belong to the same subnet as that of a local routed interface.

Shown below are the available 'set dhcp' commands. The 'clear dhcp' and 'show dhcp' commands are also available, but for brevity are not listed here.

C2(rw)->set dhcp ?

enable Configure DHCP server parameters.
disable Disable DHCP server. [default]
bootp Enable automatic address allocation for bootp clients.
conflict Enable the conflict logging on DHCP server.
exclude Configure IP addresses that a DHCP server should not
assign to DHCP clients.
ping Configure the number of packets sent by the DHCP
server.
pool Configure DHCP address pool.

C2(rw)->set dhcp enable ?

C2(rw)->set dhcp disable ?

C2(rw)->set dhcp bootp ?

enable Enable automatic address allocation for bootp clients.
disable Disable automatic address allocation for bootp
clients. [default]

C2(rw)->set dhcp bootp enable ?

C2(rw)->set dhcp bootp disable ?

C2(rw)->set dhcp conflict ?

logging Enable the conflict logging on DHCP server. [default]

C2(rw)->set dhcp conflict logging ?

C2(rw)->set dhcp exclude ?

Specify first IP address in an excluded address range.

C2(rw)->set dhcp exclude 1.2.3.1 ?

Specify the last IP address in the excluded address
range.

C2(rw)->set dhcp exclude 1.2.3.1 1.2.3.10 ?

C2(rw)->set dhcp ping ?

packets Configure the number of packets sent by the DHCP
server.

C2(rw)->set dhcp ping packets ?

<0,2-10> Enter a number in the range 2-10 or 0 to disable the
function. [default 2]

C2(rw)->set dhcp ping packets 5 ?

C2(rw)->set dhcp pool ?

Enter pool name up to 31 characters in length.

C2(rw)->set dhcp pool myPool ?

bootfile Configure the default boot image for a BOOTP client.
client-identifier Configure unique identifier of a DHCP client.
client-name Configure name of a DHCP client.
default-router Specify default routers available to the DHCP client.
dns-server Specify DNS servers available to the DHCP client.
domain-name Configure the domain name of a DHCP client.
hardware-address Configure hardware address of a DHCP client.
host Configure IP address and the mask for a manual
binding to a DHCP client.
lease Configure lease time on the DHCP Server.
netbios-name-server Specify the netBIOS name server available to the DHCP
client.
netbios-node-type Configure the netBIOS node type for a DHCP client.
next-server Configure the next server in the boot process of a
DHCP client.
network Configure network number and the mask for the DHCP
address pool.
option Configure DHCP Server options.

C2(rw)->set dhcp pool myPool bootfile ?

Specifies the file name to be used as a boot image.
File name should be up to 128 character long.

C2(rw)->set dhcp pool myPool bootfile myfile ?

C2(rw)->set dhcp pool myPool client-identifier ?

Specify identifier of the client.

C2(rw)->set dhcp pool myPool client-identifier myID ?

C2(rw)->set dhcp pool myPool client-name ?

Specify name of the client up to 31 characters.

C2(rw)->set dhcp pool myPool client-name myName ?

C2(rw)->set dhcp pool myPool default-router ?

Specify address of the default router.

C2(rw)->set dhcp pool myPool default-router 1.2.3.1 1.2.3.2 1.2.3.3 1.2.3.4
1.2.3.5 1.2.3.6 1.2.3.7 1.2.3.8 ?

C2(rw)->set dhcp pool myPool dns-server ?

Specify address of the DNS server.

C2(rw)->set dhcp pool myPool dns-server 1.2.3.1 1.2.3.2 1.2.3.3 1.2.3.4
1.2.3.5 1.2.3.6 1.2.3.7 1.2.3.8 ?

C2(rw)->set dhcp pool myPool domain-name ?

Specifies the domain name of the DHCP client. Domain
name should be up to 255 character long.

C2(rw)->set dhcp pool myPool domain-name myDomain.com ?

C2(rw)->set dhcp pool myPool hardware-address ?

Specify MAC address of the hardware platform of the
client.

C2(rw)->set dhcp pool myPool hardware-address 01-01-01-01-01-01 ?

Specify protocol of the hardware platform. Enter 1
for Ethernet or 6 for IEEE 802.

C2(rw)->set dhcp pool myPool hardware-address 01-01-01-01-01-01 1 ?

C2(rw)->set dhcp pool myPool host ?

Specify IP address for the DHCP client.

C2(rw)->set dhcp pool myPool host 1.2.3.1 ?

Specify network mask for the DHCP client.
Specify Prefix Length for the DHCP client.

C2(rw)->set dhcp pool myPool host 1.2.3.1 255.0.0.0 ?

C2(rw)->set dhcp pool myPool host 1.2.3.1 8 ?

C2(rw)->set dhcp pool myPool lease ?

<0-59> Specify days for which the lease is valid.
infinite Configure lease time to be infinite.

C2(rw)->set dhcp pool myPool lease 1 ?

<0-1439> Specify hours for which the lease is valid.

C2(rw)->set dhcp pool myPool lease 1 0 ?

<0-86399> Specify minutes for which the lease is valid.

C2(rw)->set dhcp pool myPool lease 1 0 0 ?

C2(rw)->set dhcp pool myPool netbios-name-server ?

Specify the address of the netBIOS name server.

C2(rw)->set dhcp pool myPool netbios-name-server 1.2.3.1 1.2.3.2 1.2.3.3
1.2.3.4 1.2.3.5 1.2.3.6 1.2.3.7 1.2.3.8 ?

C2(rw)->set dhcp pool myPool netbios-node-type ?

b-node Specify the netBIOS node type to b-node.
h-node Specify the netBIOS node type to h-node.
m-node Specify the netBIOS node type to m-node.
p-node Specify the netBIOS node type to p-node.

C2(rw)->set dhcp pool myPool netbios-node-type b-node ?

C2(rw)->set dhcp pool myPool netbios-node-type h-node ?

C2(rw)->set dhcp pool myPool netbios-node-type m-node ?

C2(rw)->set dhcp pool myPool netbios-node-type p-node ?

C2(rw)->set dhcp pool myPool next-server ?

Specify address for the next server.

C2(rw)->set dhcp pool myPool next-server 1.2.3.1 ?

C2(rw)->set dhcp pool myPool network ?

Specify DHCP address pool network number.

C2(rw)->set dhcp pool myPool network 10.20.0.0 ?

Specify DHCP address pool subnet mask.
Specify DHCP address pool prefix length.

C2(rw)->set dhcp pool myPool network 10.20.0.0 255.255.0.0 ?

C2(rw)->set dhcp pool myPool network 10.20.0.0 16 ?

C2(rw)->set dhcp pool myPool option ?

<1-254> Specify the DHCP option code.

C2(rw)->set dhcp pool myPool option 1 ?

ascii Specify the data in ASCII format.
hex Specify the data in HEX format.
ip Specify the data in IP format.

C2(rw)->set dhcp pool myPool option 1 ascii ?

Specify option string.

C2(rw)->set dhcp pool myPool option 1 ascii "myString" ?

C2(rw)->set dhcp pool myPool option 1 hex ?

Specify option string.

C2(rw)->set dhcp pool myPool option 1 hex "myString" ?

C2(rw)->set dhcp pool myPool option 1 ip ?

Specify option string.

C2(rw)->set dhcp pool myPool option 1 ip 1.2.3.1 ?

C2(rw)->
Here is an example of two dynamic pools and one static pool defined on a SecureStack C2 with routing enabled. Make sure you enable DHCP!

C2(rw)->set dhcp enable

C2(rw)->set dhcp pool Dynamic1 lease 1 0 0
C2(rw)->set dhcp pool Dynamic1 dns-server 10.15.25.65 20.31.6.34 20.31.6.35
C2(rw)->set dhcp pool Dynamic1 default-router 10.3.0.1
C2(rw)->set dhcp pool Dynamic1 network 10.3.0.0 255.255.0.0
C2(rw)->set dhcp pool Dynamic1 domain-name myDomain.com

C2(rw)->set dhcp pool andAnother
C2(rw)->set dhcp pool andAnother network 10.4.0.0 255.255.0.0

C2(rw)->set dhcp pool Static3 hardware-address 0011.2233.4455
C2(rw)->set dhcp pool Static3 lease 7 0 0
C2(rw)->set dhcp pool Static3 host 10.5.0.200 255.255.0.0
C2(rw)->set dhcp pool Static3 dns-server 10.15.25.65 20.31.6.34 20.31.6.35
C2(rw)->set dhcp pool Static3 default-router 10.5.0.1
C2(rw)->set dhcp pool Static3 domain-name myDomain.com

C2(rw)->
For additional background regarding the many configuration options, please refer to the relevant C3, C2, B3, B2, or A2 Configuration Guide.

topic Configuring DHCP on the SecureStacks in FAQs

Configuring DHCP on the SecureStacks