Module configuration parameters

Numbered subnets

  • Range first IP: First IP address of the range (pool) of IPs that we want to assign to DHCP clients.
  • Range last IP: Last IP address of the range (pool) of IPs that we want to assign to DHCP clients.
  • TFTP server: Leave this field empty to use the SOP's TFTP server.
  • Default lease time (seconds): Leave this field empty to keep the standard 6 hour default lease time.
  • Maximum lease time (seconds): Leave this field empty to keep the standard 12 hour maximum lease time.

New in 2.x. DHCPD v3 in order to support DHCP relay agent. This enables a SOP to provide dynamic addresses to different VLANs.

  • Subnet X: Describe a subnet and its DHCP parameters on the format of key-value pairs separated by semi-columns:
    • range: Range IP address that we want to assign to DHCP clients
    • subnet: Subnet of the network interface or the DHCP relay agent
    • netmask: Netmask of the network interface or the DHCP relay agent
    • tftp-server: The tftp server IP to indicate in the DHCP options
    • routers: The default router to be offered to the DHCP client
    • subnet-mask: The netmask to be offered to the DHCP client
    • default-lease: The default-lease time of the offered IP address
    • max-lease: The maximum lease time of the offered IP address

Example: 
Subnet 1: subnet=172.18.64.0;netmask=255.255.255.0;range=172.18.64.100 172.18.64.200;routers=172.18.64.1;subnet-mask=255.255.255.0;tftp-server=172.18.64.10;default-lease=21600;max-lease=43200

Extended subnets

If you need more than 15 subnets, you have to use the extended subnets field. The options (range, subnet, ...) are the same as for numbered subnets but the syntax is different. Each subnet is written on a line and parameters are separated by ';'.

The order of the parameters matters and every parameter must be defined.

  • Subnet X: Describe a subnet and its DHCP parameters
    • range: Range IP address that we want to assign to DHCP clients
    • subnet: Subnet of the network interface or the DHCP relay agent
    • netmask: Netmask of the network interface or the DHCP relay agent
    • tftp-server: The tftp server IP to indicate in the DHCP options
    • routers: The default router to be offered to the DHCP client
    • subnet-mask: The netmask to be offered to the DHCP client
    • default-lease: The default-lease time of the offered IP address
    • max-lease: The maximum lease time of the offered IP address

Domain name: you can configure the DHCP parameter "option domain-name" here. This parameter will be applied to all subnets defined in the module. The default value is "escaux.local".

ALERT!Starting with version 2.3.0 of the module you can also use the same syntax as for normal subnets in the extended subnets parameter.

Before 2.3.0

Example : 
192.168.1.1 192.168.1.254;192.168.1.0;255.255.255.0;10.0.1.1;10.0.1.254;255.255.255.0;64800;125600
192.168.2.1 192.168.2.254;192.168.2.0;255.255.255.0;10.0.1.1;10.0.1.254;255.255.255.0;64800;125600
In this case you have 2 subnets 192.168.1.0 and 192.168.2.0.

After 2.3.0

Example: 
subnet=172.18.64.0;netmask=255.255.255.0;range=172.18.64.100 172.18.64.200;routers=172.18.64.1;subnet-mask=255.255.255.0;tftp-server=172.18.64.10;default-lease=21600;max-lease=43200
subnet=172.18.68.0;netmask=255.255.255.0;range=172.18.68.100 172.18.68.200;routers=172.18.68.1;subnet-mask=255.255.255.0;tftp-server=172.18.68.10;default-lease=21600;max-lease=43200

Provisioning for Polycom Phones

  • Protocol to use for provisioning Polycom phones: you can chose which protocol to use for provisioning Polycom phones. This parameter must be coherent with the parameter set in the Polycom Phone Support module. See Secure Telephony Administrator Guide for the extra steps needed.

Post-install actions

In case this module is installed on a Baseline 1 High Availability SOP that is currently in standby mode, you need to use the shell plugin to deactivate the processes. This is available in the High Availability module version > 2.6.0.

Shell plugin

This module installs a shell plugin.

dhcpserver.PNG

It adds the menu DHCP server into the Subsystems main menu. You can find in this menu :
  • An option to start the DHCP server
  • An option to stop the DHCP server
  • An option to show the DHCP server leases.

Activate/Deactivate

To activate the DHCP server, simply install the module with the setting 'deactivate DHCP server' to 'no'.

There is currently no way to remove the module but you can disable it by setting 'deactivate DHCP server' to 'yes'.

Make DHCP server listen on a specific interface

By default, if the ip address of the SOP isn't in one of the defined subnets, the DHCP server won't listen incoming packet on its interface.

In order to run a DHCP server with DHCP relay without impacting the local subnet where the DHCP is, you can define a numbered subnet with no range. It will make the DHCP server listen on its interface but it won't respond to request coming from the subnet which has an empty definition.

To define a subnet with an empty body you need to define the 'subnet' and the 'netmask' attributes and nothing else.

Example : 
subnet=172.18.64.0;netmask=255.255.255.0

Copyright © Escaux SA