Merge branch 'admin-dhcp'
Before Width: | Height: | Size: 87 KiB After Width: | Height: | Size: 102 KiB |
After Width: | Height: | Size: 108 KiB |
Before Width: | Height: | Size: 44 KiB After Width: | Height: | Size: 24 KiB |
Before Width: | Height: | Size: 46 KiB After Width: | Height: | Size: 72 KiB |
After Width: | Height: | Size: 81 KiB |
Before Width: | Height: | Size: 107 KiB After Width: | Height: | Size: 45 KiB |
After Width: | Height: | Size: 58 KiB |
After Width: | Height: | Size: 65 KiB |
|
@ -1,173 +1,95 @@
|
|||
# Módulo DHCP (ogDHCP)
|
||||
|
||||
# Documentación: Ocore y Oggui
|
||||
## ogDHCP – Gestión de Subredes y Clientes DHCP
|
||||
ogDHCP es el componente encargado de gestionar de forma centralizada gestión de subredes y la asignación de direcciones IP de los clientes a dichas subredes, integrándose de forma transparente con el servidor Kea DHCP. Este componente se comunica directamente con el servidor DHCP para realizar operaciones como:
|
||||
|
||||
- Alta, edición y eliminación de subredes.
|
||||
|
||||
## Escenario
|
||||
- Asignación de ordenadores por MAC y dirección IP.
|
||||
|
||||
Queremos dar de alta un ordenador en el sistema y configurarlo para que pueda arrancar mediante PXE en una subred nueva. Este es el escenario:
|
||||
- Sincronización automática con el servicio Kea.
|
||||
|
||||
- **Ordenador**:
|
||||
- MAC Address: `00:50:56:1e:9f:11`
|
||||
- Nombre: `pc11`
|
||||
- Dirección IP: `192.168.3.11`
|
||||
|
||||
- **Subred**:
|
||||
- Dirección: `192.168.3.0`
|
||||
- Máscara de red: `255.255.255.0`
|
||||
## Añadir Subred
|
||||
Desde la vista principal de administración de subredes, es posible crear una nueva subred pulsando el botón **Añadir Subred**.
|
||||
|
||||
- **Servidor de arranque**:
|
||||
- `next-server`: `172.17.8.37` (componente **ogboot** que aloja los ficheros de arranque)
|
||||
- Fichero de arranque: `undionly.kpxe`
|
||||
|
||||
El objetivo es crear la subred `192.168.2.0/24`, añadir el ordenador `pc11` a esta subred con la IP `192.168.3.11` y crear el fichero de arrnque personalizado a `pc11` a partir de la plantilla PXE `ogLive`.
|
||||

|
||||
|
||||
## Dar de alta ordenador
|
||||
|
||||
Se abrirá un formulario donde será necesario completar los siguientes campos:
|
||||
|
||||
### Crear una Unidad Organizativa (Aula)
|
||||
- **Nombre**: identificador libre para distinguir la subred (por ejemplo, Subred-campus-tecnologico).
|
||||
|
||||
1. En la pantalla de **Administrar grupos**, haz clic en **Nueva Unidad Organizativa**.
|
||||
2. En el formulario:
|
||||
- Selecciona el **Tipo** como `Aula`.
|
||||
- Asigna un **Nombre** al aula, como `Aula Test`.
|
||||
- Elige una **Unidad Organizativa Padre**, por ejemplo, `Grupos de aulas 1`.
|
||||
3. Haz clic en el botón **Siguiente**.
|
||||
- **Netmask**: máscara de red (por ejemplo, 255.255.255.0).
|
||||
|
||||

|
||||
- **Dirección IP**: dirección de red (por ejemplo, 192.168.2.0).
|
||||
|
||||

|
||||
### Parámetros avanzados
|
||||
Opcionalmente se pueden definir los siguientes valores, que se trasladarán directamente a la configuración del servidor Kea DHCP:
|
||||
|
||||
- **Next Server**: IP del servidor de arranque (ogboot), usado para PXE.
|
||||
Ejemplo: `192.168.2.1`.
|
||||
|
||||
4. En el siguiente paso del formulario de la Unidad Organizativa, configura los parámetros de red. Estos parámetros serán usados mas adelante como parámetros del Kernel cuando creemos los ficheros de arranque de los PCs que estén en esa aula:
|
||||
- **Máscara de Red**: Configura la máscara de subred, como `255.255.255.0`.
|
||||
- **Router**: Especifica la puerta de enlace predeterminada de la subred (por ejemplo, `192.168.2.1`).
|
||||
5. Haz clic en **Añadir** para crear la unidad organizativa.
|
||||
- **Boot File Name**: nombre del fichero de arranque que se enviará al cliente PXE.
|
||||
Ejemplo: `undionly.kpxe`
|
||||
|
||||

|
||||
|
||||
!!! Warning "Nota"
|
||||
Si no se define, Kea DHCP usará `undionly.kpxe` para BIOS o `ipxe.efi` para UEFI en función de la arquitectura del sistema que haya solicitado DHCP. A no ser que se quiera usar un fichero de arranque en concreto se recomienda dejar este campo vacío
|
||||
|
||||
### Añadir un Nuevo Ordenador
|
||||
- **Router**: puerta de enlace de la subred.
|
||||
|
||||
1. En la pantalla de **Administrar grupos**, haz clic en **Nuevo Cliente**.
|
||||
2. Completa los siguientes campos:
|
||||
- **Padre**: Selecciona la Unidad Organizativa creada anteriormente (por ejemplo, `Aula Test`).
|
||||
- **Nombre**: Nombre del ordenador `pc11`.
|
||||
- **MAC**: Dirección MAC del cliente `00:50:56:1e:8f:11`.
|
||||
- **Dirección IP**: IP en la subred configurada `192.168.2.11`.
|
||||
- **Plantilla PXE**: Selecciona la plantilla PXE asociada `ogLive` para el arranque por Oglive.
|
||||
- **Interfaz de red**: Interfaz de red del cliente (por ejemplo, `Eth0`).
|
||||
- **Controlador de red**: por ejemplo, `Generic`.
|
||||
3. Haz clic en **Añadir** para guardar el ordenador.
|
||||
- **DNS**: servidor DNS para los clientes.
|
||||
|
||||
Una vez completado el formulario, pulsamos **Guardar** para registrar la subred y creará una nueva subred en Kea DHCP.
|
||||
|
||||

|
||||
|
||||
|
||||
## Añadir Ordenadores a una Subred
|
||||
|
||||
## **Crear una Nueva Subred**
|
||||
1. Pulsa el botón de asignación de clientes representado por un monitor en la columna **Acciones** de la subred correspondiente.
|
||||
|
||||
El objetivo es crear una subred en el sistema y sincronizarla con el componente **ogdhcp**, que utiliza Kea DHCP para gestionar las configuraciones de red.
|
||||
2. Se abrirá un diálogo donde seleccionas la **Unidad Organizativa** (grupo o aula) desde la que deseas elegir ordenadores.
|
||||
|
||||
3. Se mostrará una lista con todos los equipos de esa unidad organizativa disponibles para asignar a la subred. Marca los que desees y pulsa **Añadir**.
|
||||
|
||||
### **Crear la Subred**
|
||||

|
||||
|
||||
1. Ve a la sección **Administrar Subredes**.
|
||||
2. Haz clic en el botón **Añadir Subred**.
|
||||
3. En el formulario de creación de subred, completa los siguientes campos:
|
||||
- **Nombre**: Asigna un nombre identificativo `Subred test`.
|
||||
- **Netmask**: Especifica la máscara de subred `255.255.255.0`.
|
||||
- **Dirección IP**: Configura la dirección base de la subred `192.168.3.0`.
|
||||
- **Next Server**: Ingresa la IP del servidor de arranque `172.17.8.37`.
|
||||
- **Boot File Name**: Establece el nombre del archivo de arranque PXE `undionly.kpxe`.
|
||||
4. Click en **Guardar** para crear la subred en la base de datos del sistema.
|
||||
|
||||

|
||||
### Resultado de la operación
|
||||
Una vez procesada la asignación, se mostrará una ventana con el resultado de la operación. Esta ventana indicará si los ordenadores han sido añadidos correctamente al servidor Kea DHCP o si ha ocurrido algún error.
|
||||
|
||||
Una vez creada, la subred aparecerá en la lista con el estado de **No sincronizada**. Esto indica que la subred se ha registrado en la base de datos, pero aún no se ha dado de alta en el servicio Kea DHCP.
|
||||

|
||||
|
||||

|
||||
1. En caso de éxito: se mostrará una lista en verde con los ordenadores correctamente sincronizados.
|
||||
|
||||
---
|
||||
2. En caso de error: se mostrará el motivo del fallo, devuelto directamente por Kea DHCP (por ejemplo, IP fuera de rango, MAC duplicada, etc.).
|
||||
|
||||
### **Sincronizar la Subred con Kea DHCP**
|
||||
!!! note "Nota"
|
||||
La asignación de ordenadores también implica la creación de una reserva DHCP en Kea, por lo que cualquier conflicto o incoherencia se detectará en este punto.
|
||||
|
||||
1. En la lista de subredes, localiza la nueva subred.
|
||||
2. Haz clic en el botón de acciones (icono de menú) y selecciona **Crear en og-dhcp**.
|
||||
3. Esto enviará la configuración de la subred al componente `ogdhcp`, que actualizará el servicio **Kea DHCP**.
|
||||
|
||||

|
||||
|
||||
---
|
||||
|
||||
### Subred Sincronizada
|
||||
|
||||
Una vez sincronizada, la subred aparecerá con el estado de **Sincronizada** en la lista (tendrá un icono ✔️). Esto indica que la configuración se ha aplicado correctamente en el servicio Kea DHCP.
|
||||
|
||||
|
||||
Puedes ver la configuración que se ha creado en kea dhcp pulsando **Información en servidor ogDHCP** (arriba de todo) y pulsando **Ver informacion**
|
||||
|
||||
|
||||

|
||||
|
||||
|
||||
|
||||
## **Añadir Cliente a una Subred**
|
||||
|
||||
El objetivo es agregar un PC a una subred específica que ya esté registrada y sincronizada con el componente **ogdhcp**.
|
||||
|
||||
|
||||
### **Añadir cliente a la Subred**
|
||||
|
||||
1. En la lista de subredes, busca la subred a la que deseas añadir el cliente `192.168.3.0`.
|
||||
2. Verifica que la subred esté **Sincronizada** (icono de estado con un ✔️). Si no está sincronizada, realiza el proceso de sincronización previamente.
|
||||
|
||||
|
||||
3. Haz clic en el botón de acciones (icono de menú) para la subred seleccionada.
|
||||
4. En el menú desplegable, selecciona **Añadir cliente**.
|
||||
|
||||

|
||||
|
||||
5. En el formulario:
|
||||
- Busca el nombre del cliente `pc11`.
|
||||
- Verifica que el cliente aparece en la lista de **Clientes seleccionados**.
|
||||
6. Click en el botón **Añadir**
|
||||
|
||||

|
||||
|
||||
7. Puedes ver la configuración actualizada de kea con el nuevo cliente en **Información en servidor ogDHCP** (arriba de todo) y pulsando **Ver informacion**
|
||||
|
||||
|
||||

|
||||
|
||||
|
||||
|
||||
## **Crear un Fichero de Arranque PXE**
|
||||
|
||||
El objetivo es generar un fichero de arranque personalizado para el cliente `pc11`, utilizando una plantilla PXE definida, la `OgLive`para que arranque por Oglive.
|
||||
|
||||
|
||||
### **Crear el Fichero de Arranque**
|
||||
|
||||
1. Ve a la sección **Plantillas PXE** en el menú de **Boot**.
|
||||
2. Localiza la plantilla `ogLive`que vamos a usar, asignada previamente cuando creamos al cliente **pc11**.
|
||||
3. Haz clic en el botón del icono de ordenador.
|
||||
|
||||

|
||||
|
||||
4. Busca el cliente **pc11**.
|
||||
|
||||
5. Click al botón de sincronizar datos (las dos flechas circulares)
|
||||
|
||||

|
||||
|
||||
6. Verás que que el icono del ordenador del **pc11** estará en verde. ESo quiere decir que se ha creado el fichero de arranque en **ogboot** correctamente
|
||||
|
||||

|
||||
|
||||
### Gestionar Clientes en una Subred
|
||||
Una vez añadidos los ordenadores a una subred, es posible consultarlos y gestionarlos desde la vista principal de subredes.
|
||||
|
||||
Para acceder, pulsamos el botón **Ver clientes** correspondiente a la subred deseada.
|
||||
|
||||

|
||||
|
||||
En esta vista se muestran los datos principales de cada cliente:
|
||||
|
||||
- **Estado**: icono que indica si el estado actual del cliente (encendido/apagado).
|
||||
- **Nombre**: nombre del ordenador.
|
||||
- **IP**: dirección IP reservada para el cliente.
|
||||
- **MAC**: dirección física del equipo.
|
||||
- **Ruta**: unidad organizativa a la que pertenece el cliente.
|
||||
- **ogLive**: versión de OgLive asignada al cliente.
|
||||
|
||||
### Eliminar cliente
|
||||
Desde esta misma vista es posible eliminar un cliente de la subred, lo que implica borrar su reserva DHCP en Kea. Para ello, pulsamos el icono de papelera rojo en la columna de acciones.
|
||||
|
||||
|
||||
!!! warning "Advertencia"
|
||||
El borrado es inmediato y se sincroniza con Kea DHCP. El equipo ya no tendrá asignación IP en la subred tras esta acción.
|
||||
|
|