Kraken DHCP

Kraken DHCP provides group based dynamic host configuration functionality.

Author

•  xeraph@nchovy.com

Install

kraken> pkg.install kraken-dhcp

Commands

IP Group Management

• Create group
  • dhcp.createGroup [group name] [ip from] [ip to]
  • Required parameters will be configured

    kraken> dhcp.createGroup test 192.168.1.100 192.168.1.200
    Server IP? 192.168.1.100
    Subnet Mask? 255.255.255.0
    Router IP? 192.168.1.1
    DNS IP? 8.8.8.8
    Lease Duration (secs)? 3600
    created group
    created required options
    

• Update group
  • dhcp.updateGroup [group name] [ip from] [ip to]

    kraken> dhcp.updateGroup test 192.168.1.101 192.168.1.201
    updated
    

• Remove group
  • dhcp.removeGroup [group name]

    kraken> dhcp.removeGroup test
    removed
    

• List all groups
  • dhcp.groups

    kraken> dhcp.groups
    IP Groups
    ------------
    name=test, range=[192.168.1.100~192.168.1.200], description=null
    

DHCP Configuration

• List all available DHCP options
  • dhcp.options

    kraken> dhcp.options
    DHCP Option Codes
    -------------------
    (0) Pad
    (1) SubnetMask: InetAddress
    (2) TimeOffset: Integer
    (3) Router: InetAddress[]
    (4) TimeServer: InetAddress[]
    (5) NameServer: InetAddress[]
    (6) DomainNameServer: InetAddress[]
    (7) LogServer: InetAddress[]
    (8) QuoteServer: InetAddress[]
    (9) LprServer: InetAddress[]
    ...omitted...
    

• List all DHCP options
  • dhcp.groupConfigs [group name]

    kraken> dhcp.groupConfigs test
    DHCP Options
    --------------
    [6] SubnetMask: 255.255.255.0
    [7] ServerIdentifier: 192.168.1.100
    [8] Router: 192.168.1.1
    [9] DomainNameServer: 8.8.8.8
    [10] IpAddressLeaseTime: 3600
    

• Add DHCP option to group
  • dhcp.createGroupConfig [group name] [DHCP option code] [value]

    kraken> dhcp.createGroupConfig test 26 1500
    added
    

• Remove DHCP option from group
  • dhcp.removeGroupConfig [ID]

    kraken> dhcp.groupConfigs test
    DHCP Options
    --------------
    [6] SubnetMask: 255.255.255.0
    [7] ServerIdentifier: 192.168.1.100
    [8] Router: 192.168.1.1
    [9] DomainNameServer: 8.8.8.8
    [10] IpAddressLeaseTime: 3600
    [12] InterfaceMtu: 1500
    kraken> dhcp.removeGroupConfig 12
    removed
    

IP Reservation

• Reserve IP
  • dhcp.reserve [group name] [ip] [mac] [host name]

    kraken> dhcp.reserve test 192.168.1.123 F8:1E:DF:00:00:00 xeraph-iPhone
    ip reserved
    

• Unreserve IP
  • dhcp.unreserve [IP]

    kraken> dhcp.unreserve test 192.168.1.123
    

• List all IP reservations
  • dhcp.reservations [group name]

    kraken> dhcp.reservations test
    IP Reservations
    ------------------
    ip=192.168.1.123, mac=F8:1E:DF:00:00:00, host=xeraph-iPhone
    

Live Status

• List all IP Offers
  • Show all latest DHCP offers

    kraken> dhcp.offers
    IP Offers
    ------------
    00:08:9F:00:00:00, 192.168.1.103, created=2011-04-10 01:44:47
    

• List all IP Leases
  • dhcp.leases

    kraken> dhcp.leases
    IP Leases
    -----------
    test
     * ip=192.168.1.101, mac=F8:1E:DF:00:00:00, name=xeraph-iPhone, expire=2011-05-06 12:47:46
    

MAC Filter

You can block ip configuration for specific MAC.

• Block MAC
  • dhcp.block [MAC] [description]

    kraken> dhcp.block 00:08:9F:00:00:00
    blocked
    

• Unblock MAC
  • dhcp.unblock [MAC]

    kraken> dhcp.unblock 00:08:9F:00:00:00
    unblocked
    

• List all filters

  kraken> dhcp.filters
  Allowed Hosts
  --------------
  
  Blocked Hosts
  --------------
  00:08:9F:00:00:00
  

See Also

• Kraken IP Manager

Release

• 0.5.0 development version