How-to: UDM - create dhcp shared network/subnet/pool/leasetime

How to:

In UCS, you can create shared networks, subnets, pools and policies for setting the lease time for DHCP. The following steps are a small guideline to make this with the command line tool udm.

Hint:

Each object can also be created directly from the UMC in the web browser.


Step 1. Create the Shared Network

udm dhcp/shared create --position "cn=mejneschool2,cn=dhcp,ou=mejneschool2,dc=ucs5schoolhejne,dc=intranet" --set name=Mirac-Test
Object created: cn=Mirac-Test,cn=mejneschool2,cn=dhcp,ou=mejneschool2,dc=ucs5schoolhejne,dc=intranet
udm dhcp/shared list
DN: cn=Mirac-Test,cn=mejneschool2,cn=dhcp,ou=mejneschool2,dc=ucs5schoolhejne,dc=intranet
  name: Mirac-Test

Step 2. Create the Shared Subnet

udm dhcp/sharedsubnet create --position "cn=Mirac-Test,cn=mejneschool2,cn=dhcp,ou=mejneschool2,dc=ucs5schoolhejne,dc=intranet" \
--set subnet=192.168.178.0 \
--set subnetmask=24 --set broadcastaddress=192.168.178.255 \
--set "range=192.168.178.2 192.168.178.254"
Object created: cn=192.168.178.0,cn=Mirac-Test,cn=mejneschool2,cn=dhcp,ou=mejneschool2,dc=ucs5schoolhejne,dc=intranet
udm dhcp/sharedsubnet list
DN: cn=192.168.178.0,cn=Mirac-Test,cn=mejneschool2,cn=dhcp,ou=mejneschool2,dc=ucs5schoolhejne,dc=intranet
  broadcastaddress: 192.168.178.255
  range: 192.168.178.2 192.168.178.254
  subnet: 192.168.178.0
  subnetmask: 24

Step 3. Create a DHCP pool with IP ranges for the Shared Subnet

This is useful for scenarios where multiple locations or VLANs are used and a main administration point is required.

udm dhcp/pool create --position "cn=192.168.178.0,cn=Mirac-Test,cn=mejneschool2,cn=dhcp,ou=mejneschool2,dc=ucs5schoolhejne,dc=intranet" \
--set "name=Mirac-Pool" \
--set "range=192.168.178.100 192.168.178.200"
Object created: cn=Mirac-Pool,cn=192.168.178.0,cn=Mirac-Test,cn=mejneschool2,cn=dhcp,ou=mejneschool2,dc=ucs5schoolhejne,dc=intranet
udm dhcp/pool list --filter cn=Mirac-Pool
cn=Mirac-Pool
DN: cn=Mirac-Pool,cn=192.168.178.0,cn=Mirac-Test,cn=mejneschool2,cn=dhcp,ou=mejneschool2,dc=ucs5schoolhejne,dc=intranet
  all_clients: None
  dynamic_bootp_clients: None
  failover_peer: None
  known_clients: None
  name: Mirac-Pool
  range: 192.168.178.100 192.168.178.200
  unknown_clients: None

Step 4. Create policies for lease time settings and add them to a shared network

udm policies/dhcp_leasetime create --position cn=policies,ou=mejneschool2,dc=ucs5schoolhejne,dc=intranet \
--set name=Mejneschool2-Test \
--set "lease_time_default=1 hours" \
--set "lease_time_max=8 hours" \
--set "lease_time_min=5 minutes"
udm dhcp/shared modify --dn "cn=Mirac-Test,cn=mejneschool2,cn=dhcp,ou=mejneschool2,dc=ucs5schoolhejne,dc=intranet" \
--policy-reference "cn=Mejneschool2-Test,cn=policies,ou=mejneschool2,dc=ucs5schoolhejne,dc=intranet"
Object modifed: "cn=Mirac-Test,cn=mejneschool2,cn=dhcp,ou=mejneschool2,dc=ucs5schoolhejne,dc=intranet"
udm dhcp/shared list
DN: cn=Mirac-Test,cn=mejneschool2,cn=dhcp,ou=mejneschool2,dc=ucs5schoolhejne,dc=intranet
  name: Mirac-Test
  univentionPolicyReference: cn=Mejneschool2-LeaseTime,cn=policies,ou=mejneschool2,dc=ucs5schoolhejne,dc=intranet
  univentionPolicyReference: cn=Mejneschool2-Test,cn=policies,ou=mejneschool2,dc=ucs5schoolhejne,dc=intranet


There are also more option settings for the several dhcp shared objects. You can list them with –help.

For example:

udm dhcp/
dhcp/dhcp          dhcp/host          dhcp/pool          dhcp/server        dhcp/service       dhcp/shared        dhcp/sharedsubnet  dhcp/subnet
udm dhcp/shared --help

dhcp/shared options:
  default                          DHCP: Shared network
  options                          Allow custom DHCP options

dhcp/shared variables:
  General:
        DHCP shared network description
                name (cmr)                               Shared network name
  Low-level DHCP configuration:
                option (options,[])                      DHCP options
                statements (options,[])                  DHCP Statements

dhcp/service variables:
  General:
        DHCP service description
                service (cmr)                            Service name
  Low-level DHCP configuration:
                option (options,[])                      DHCP options
                statements (options,[])                  DHCP Statements

See also: