.. SPDX-FileCopyrightText: 2021-2025 Univention GmbH
..
.. SPDX-License-Identifier: AGPL-3.0-only

.. _nubus-domain-network-management:

***************
Networks module
***************

Nubus offers the *Networks* management module
to manage the assignment of available IP addresses to computers.
The *Networks* management module appears in installations for Kubernetes and UCS.
However, administrators mostly use it in the context of Nubus for UCS
with its network management capabilities.
The *DHCP Service* automatically assigns the next available address to the computer
during IP address assignment.
:numref:`nubus-domain-network-management-overview-fig`
shows the *Networks* management module.

This section provides a reference for the fields used in the *Networks* management module.
You find the *Networks* management module in the *Domain* category in the *Management UI*.

.. _nubus-domain-network-management-overview-fig:

.. figure:: /images/create-network.*
   :alt: Creating a network object
   :width: 871px

   Creating a network object

.. _nubus-domain-network-management-example:

Example
=======

For example, you can define a network object *Workstation network*
that encompasses the IP addresses from ``192.0.2.0`` to ``192.0.2.254``.
If you create a Windows computer object
and assign this network object,
Nubus runs an internal validation for already assigned IP addresses
and selects the next available IP address for the computer object.
The procedure saves the administrator time
to choose the next available IP address manually.
If you remove the computer object,
Nubus automatically releases the IP address.
The IP address becomes available for reassignment.

.. _nubus-domain-network-management-reference:

Reference for Networks management module
========================================

.. TODO: Replace the reference to UMC modules as soon as all the content is moved to the Nubus Manual.

You can manage network objects in the *Network* management module.
For more information about the *Management UI*,
see :external+uv-ucs-manual:ref:`central-user-interface`.

This section describes the fields of the *Networks* management module.
To create a network object,
open the *Networks* management module
and click :guilabel:`Add`.

.. dropdown:: Packaged service — only available for Nubus for UCS
   :color: info
   :icon: package-dependents
   :open:

   A packaged service using the information from network object
   is only available for Nubus for UCS.
   You can manage the information in the Kubernetes deployment, as well.

Name
   The name of the network object
   under which the network also appears in the :ref:`nubus-computer-management`.

Network
   The network address in dot-decimal form,
   for example ``192.0.2.0``.

Netmask
   The network mask in network prefix or dot-decimal form.
   If you provide the network mask in dot-decimal form,
   Nubus subsequently converts it into the corresponding network prefix
   and also shows it that way.

IP address range
   You can configure one or more IP ranges.
   If you assign a host to this network,
   Nubus automatically assigns the next available IP address from the IP range
   that you provide here.

   If you don't provide an IP range,
   the system automatically uses the range
   resulting from the network and the network mask.

   You can select forward lookup zones and reverse lookup zones
   in the *DNS preferences* section.
   If you assign a host to this network,
   Nubus automatically creates a host record in the forward lookup zone
   and a pointer record in the reverse lookup zone.

   If you don't select a DNS zone,
   Nubus doesn't create DNS records during computer object assignment.
   However, you can set DNS entries manually.

   .. TODO: Replace reference as soon as DNS management module is part of the manual.

   To administer DNS zones,
   use the *DNS* management module.
   For information, see :ref:`nubus-domain-dns-forwardzone`.

DNS forward lookup zone
   The forward lookup zone for hosts in the network.
   The *DNS* performs the computer name resolution to an IP address through DNS zones.

DNS reverse lookup zone
   The reverse lookup zone for hosts in the network.
   The *DNS* performs the reverse resolution of the IP address
   back to a computer name through DNS zones.

DHCP Service
   You can assign a *DHCP Service* to the network
   in the *DHCP preferences* section.
   If you assign a host to the network,
   Nubus automatically creates a *DHCP Host* entry with a fixed IP address
   in the selected *DHCP Service*.

   If you don't select a *DHCP Service*,
   Nubus doesn't create a *DHCP Host* entry during computer object assignment.
   However, you can assign a *DHCP Host* entry manually.

   To administer *DHCP Services*
   use the *DHCP* management module.
   For information, see :ref:`nubus-domain-dhcp`.

.. spelling:word-list::

   Netmask