.. meta::
   :description: Adding DHCP servers (Microsoft DNS, ISC DHCP, Kea, Cisco) to Micetro
   :keywords: DHCP, Micetro, Microsoft DHCP, ISC DHCP, Kea, Cisco DHCP

.. _adding-dhcp:

Adding DHCP Service
===================

DHCP servers require :ref:`install-controllers` and need to be added using their fully qualified names (such as ``dns1.europe.ad.mmdemo.local``).

.. note::
  Servers in Microsoft Active Directory environments can be added without installing an agent. See :ref:`agent-free-dns-dhcp`.

.. note::
  ISC DHCP servers require a DHCP agent to be installed on each DHCP server. Kea servers require *only one* DHCP agent installed in the system, either on the machine running Kea, or a machine that can connect to the :ref:`kea-control-agent` through the network.

The following table demonstrates the different options when adding a DHCP Server.



+----------------------------+----------------------------------------------------------------------------------------+
| Server type                | Description                                                                            |
+============================+========================================================================================+
| Microsoft Agent-Free [1]   | The DHCP agent has been installed on the machine running the Micetro      |
| (Use proxy not checked)    | Central Component and that machine will be used as a proxy. Micetro is not able to     |
|                            | track lease history data.                                                              | 
+----------------------------+----------------------------------------------------------------------------------------+
| Microsoft Agent-Free [1]   | The DHCP agent has been installed on the machine identified in the         |
| (Use proxy checked)        | **Use proxy server** field and that machine will be used as a proxy. Micetro is not    |
|                            | able to track lease history data.                                                      |
+----------------------------+----------------------------------------------------------------------------------------+
| Microsoft                  | The DHCP Server Controller has been installed on the remote DHCP server.               |
| with Agent Installed       | Micetro is able to track lease history data.                                           |
+----------------------------+----------------------------------------------------------------------------------------+
| ISC DHCP                   | Either a Unix server running the ISC DHCPD or a Micetro Appliance with the ``mm-dhcpd``|
|                            | package installed                                                                      |
+----------------------------+----------------------------------------------------------------------------------------+
| ISC Kea                    | A server running ISC Kea with the :ref:`kea-control-agent` installed and accessible    |
| Server Controller.         | for the DHCP.                                                                          |
| (Agent-free) [1]           |                                                                                        |
+----------------------------+----------------------------------------------------------------------------------------+
| ISC Kea [2]                | A server running ISC Kea with a DHCP agent and Control Agent installed.                |
+----------------------------+----------------------------------------------------------------------------------------+
| Cisco                      | The DHCP agent has been installed on the machine running the Micetro                 | 
| (Use proxy not checked)    | Central and that machine will be used as a proxy.                                      |
+----------------------------+----------------------------------------------------------------------------------------+
| Cisco                      | The DHCP agent has been installed on the machine identified in the **Use               |
| (Use proxy checked)        | proxy server** field, and that machine will be used as a proxy.                        |
+----------------------------+----------------------------------------------------------------------------------------+

.. [1] See :ref:`agent-free-dns-dhcp`.

.. [2] Alternatively, you can configure a socket for communication in ``kea-dhcp4.conf``.

.. important::
  To add Kea servers to Micetro, they need to be configured with the ``libdhcp_lease_cmds.so`` library. See :ref:`add-kea-hooks` for details.

Services are managed on the **Admin** page in the :guilabel:`Service Management` section. There you select :guilabel:`Add Service` to add a new server.

For further details, see :ref:`adding-service` in the Admin Guide.