diff --git a/i18n-docu/docs/assets/images/screenshots/oggui-dhcp-administrar-anadir_cli.png b/i18n-docu/docs/assets/images/screenshots/oggui-dhcp-administrar-anadir_cli.png index e265589..78e71c0 100644 Binary files a/i18n-docu/docs/assets/images/screenshots/oggui-dhcp-administrar-anadir_cli.png and b/i18n-docu/docs/assets/images/screenshots/oggui-dhcp-administrar-anadir_cli.png differ diff --git a/i18n-docu/docs/assets/images/screenshots/oggui-dhcp-administrar-anadir_cli_success.png b/i18n-docu/docs/assets/images/screenshots/oggui-dhcp-administrar-anadir_cli_success.png new file mode 100644 index 0000000..2787fa2 Binary files /dev/null and b/i18n-docu/docs/assets/images/screenshots/oggui-dhcp-administrar-anadir_cli_success.png differ diff --git a/i18n-docu/docs/assets/images/screenshots/oggui-dhcp-administrar-anadir_sub.png b/i18n-docu/docs/assets/images/screenshots/oggui-dhcp-administrar-anadir_sub.png index f0250f0..34ffe38 100644 Binary files a/i18n-docu/docs/assets/images/screenshots/oggui-dhcp-administrar-anadir_sub.png and b/i18n-docu/docs/assets/images/screenshots/oggui-dhcp-administrar-anadir_sub.png differ diff --git a/i18n-docu/docs/assets/images/screenshots/oggui-dhcp-administrar-editar_sub.png b/i18n-docu/docs/assets/images/screenshots/oggui-dhcp-administrar-editar_sub.png index eb83293..e64c23e 100644 Binary files a/i18n-docu/docs/assets/images/screenshots/oggui-dhcp-administrar-editar_sub.png and b/i18n-docu/docs/assets/images/screenshots/oggui-dhcp-administrar-editar_sub.png differ diff --git a/i18n-docu/docs/assets/images/screenshots/oggui-dhcp-administrar-gestionar_cli.png b/i18n-docu/docs/assets/images/screenshots/oggui-dhcp-administrar-gestionar_cli.png new file mode 100644 index 0000000..75302f2 Binary files /dev/null and b/i18n-docu/docs/assets/images/screenshots/oggui-dhcp-administrar-gestionar_cli.png differ diff --git a/i18n-docu/docs/assets/images/screenshots/oggui-dhcp-administrar.png b/i18n-docu/docs/assets/images/screenshots/oggui-dhcp-administrar.png index d02597d..496684c 100644 Binary files a/i18n-docu/docs/assets/images/screenshots/oggui-dhcp-administrar.png and b/i18n-docu/docs/assets/images/screenshots/oggui-dhcp-administrar.png differ diff --git a/i18n-docu/docs/assets/images/screenshots/oggui-ogboot-status.png b/i18n-docu/docs/assets/images/screenshots/oggui-ogboot-status.png new file mode 100644 index 0000000..7ede8cc Binary files /dev/null and b/i18n-docu/docs/assets/images/screenshots/oggui-ogboot-status.png differ diff --git a/i18n-docu/docs/es/administration/ogdhcp.md b/i18n-docu/docs/es/administration/ogdhcp.md index 4a819b7..4e391c7 100644 --- a/i18n-docu/docs/es/administration/ogdhcp.md +++ b/i18n-docu/docs/es/administration/ogdhcp.md @@ -2,167 +2,99 @@ # Documentación: Ocore y Oggui -## Escenario +## Ogdhcp – Gestión de Subredes y Clientes DHCP +Oghcp 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: -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: +- Alta, edición y eliminación de subredes. -- **Ordenador**: - - MAC Address: `00:50:56:1e:9f:11` - - Nombre: `pc11` - - Dirección IP: `192.168.3.11` +- Asignación de ordenadores por MAC y dirección IP. -- **Subred**: - - Dirección: `192.168.3.0` - - Máscara de red: `255.255.255.0` +- Sincronización automática con el servicio Kea. -- **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`. +## 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**. -## Dar de alta ordenador +![oggui-dhcp-administrar-anadir_sub.png](../assets/images/screenshots/oggui-dhcp-administrar-anadir_sub.png) -### Crear una Unidad Organizativa (Aula) -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**. +Se abrirá un formulario donde será necesario completar los siguientes campos: -![Menú de centros](../../assets/images/screenshots/menu_centers.png "Menú de centros") +- **Nombre**: identificador libre para distinguir la subred (por ejemplo, Subred-campus-tecnologico). -![Crear aula](../../assets/images/screenshots/create-classroom.png "Crear aula") +- **Netmask**: máscara de red (por ejemplo, 255.255.255.0). +- **Dirección IP**: dirección de red (por ejemplo, 192.168.2.0). -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. +### Parámetros avanzados +Opcionalmente se pueden definir los siguientes valores, que se trasladarán directamente a la configuración del servidor Kea DHCP: -![Configuración de red del aula](../../assets/images/screenshots/create-classroom-network-configuration.png "Configuración de red del aula") +- **Next Server**: IP del servidor de arranque (ogboot), usado para PXE. + Ejemplo: `192.168.2.1`. +- **Boot File Name**: nombre del fichero de arranque que se enviará al cliente PXE. + Ejemplo: `undionly.kpxe` -### Añadir un Nuevo Ordenador -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. +!!! note "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 +- **Router**: puerta de enlace de la subred. -![Crear un ordenador](../../assets/images/screenshots/create_pc.png "Crear un 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. -## **Crear una Nueva Subred** -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. +## Añadir Ordenadores a una Subred +1. Pulsa el botón de asignación de clientes representado por un monitor en la columna **Acciones** de la subred correspondiente. -### **Crear la Subred** +2. Se abrirá un diálogo donde seleccionas la **Unidad Organizativa** (grupo o aula) desde la que deseas elegir ordenadores. -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. +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 una subred](../../assets/images/screenshots/create_subnet.png "Crear una subred") +![oggui-dhcp-administrar-anadir_cli.png](../assets/images/screenshots/oggui-dhcp-administrar-anadir_cli.png) -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. -![Subred creada sin sincronizar](../../assets/images/screenshots/created_subnet_no_sync.png "Subred creada sin sincronizar") +### 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. ---- +![oggui-dhcp-administrar-anadir_cli_success.png](../assets/images/screenshots/oggui-dhcp-administrar-anadir_cli_success.png) -### **Sincronizar la Subred con Kea DHCP** +1. En caso de éxito: se mostrará una lista en verde con los ordenadores correctamente sincronizados. -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**. +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 subred](../../assets/images/screenshots/sync_subnet.png "Sincronizar subred") +!!! 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. ---- -### 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. +### 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. -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** +![oggui-dhcp-administrar-gestionar_cli.png](../assets/images/screenshots/oggui-dhcp-administrar-gestionar_cli.png) +En esta vista se muestran los datos principales de cada cliente: -![Subred KEA](../../assets/images/screenshots/subnet_kea.png "Subred KEA") +- **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. -## **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**. - -![Subred sincronizada](../../assets/images/screenshots/synced_subnet.png "Subred sincronizada") - -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** - -![Añadir cliente a la subred](../../assets/images/screenshots/add_client_to_subnet.png "Añadir cliente a la subred") - -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** - - -![Cliente KEA](../../assets/images/screenshots/client_kea.png "Cliente KEA") - - - -## **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. - -![Plantillas PXE](../../assets/images/screenshots/pxe_templates.menu.png "Plantillas PXE") - -4. Busca el cliente **pc11**. - -5. Click al botón de sincronizar datos (las dos flechas circulares) - -![Netboot avanzado](../../assets/images/screenshots/create_pxe_file.png "Netboot avanzado") - -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 - -![Fichero PXE creado](../../assets/images/screenshots/created_pxe_file.png "Fichero PXE creado") +!!! warning "Cuidado" + 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.