dhcp-server external-storage

Syntax

dhcp-server external-storage <VOLUME-NAME> file <LEASE-FILENAME> [delay <DELAY>]

no dhcp-server external-storage <VOLUME-NAME> file <LEASE-FILENAME> [delay <DELAY>]

Description

Configures the external storage file location for DHCPv4 server lease information. This file provides persistent storage, enabling DHCPv4 server settings to be restored when the switch is restarted. Lease information is stored in a flat file on the configured external device.

If external storage is not configured, then after a failure or reboot, all existing lease information is lost.

Lease information is saved to external storage each time the delay timer expires, which by default is every 300 seconds.

Lease information is not restored when issuing the command dhcp-server enable.

The no form of this command removes external storage support for the DHCPv4 server.

Command context

config

Parameters

<VOLUME-NAME>

Specifies the external storage volume name. Range: 1 to 64 printable ASCII characters.

file <LEASE-FILENAME>

Specifies the external storage filename. Range: 1 to 255 printable ASCII characters.

delay <DELAY>

Specifies the interval in seconds between updates to the external storage file. Range: 15 to 86400. Default: 300.

Authority

Administrators or local user group members with execution rights for this command.

Example

Stores the lease file on external storage volume Storage1 in file LeaseFile at an interval of 600 seconds.

switch(config)# dhcp-server external-storage Storage1 file LeaseFile delay 600

Disables storage of the lease file on external storage volume Storage1 in file LeaseFile.

switch(config)# no dhcp-server external-storage Storage1 file LeaseFile delay 600