refs #449 adds arquitecture of ogboot in documentation

ogboot-api-documentation
Luis Gerardo Romero Garcia 2024-08-22 12:05:22 +02:00
parent 6daff2d32d
commit 2636f0fe4d
1 changed files with 37 additions and 1 deletions

View File

@ -85,7 +85,7 @@ El componente `ogboot` se encarga de la gestión y configuración de archivos de
#### 1.2.1 ogLive
El **ogLive** es un sistema operativo diseñado para iniciarse en PCs y llevar a cabo diversas operaciones indicadas por OpenGnsys, como la creación de particiones y la restauración de sistemas operativos. Este sistema operativo se carga y ejecuta completamente en la RAM y se distribuye a través de la red, lo que le permite realizar una regeneración completa de todos los discos de almacenamiento en un equipo.
El **ogLive** es un sistema operativo diseñado para iniciarse en clientes PCs y llevar a cabo diversas operaciones indicadas por OpenGnsys, como la creación de particiones y la restauración de sistemas operativos. Este sistema operativo se carga y ejecuta completamente en la RAM y se distribuye a través de la red, lo que le permite realizar una regeneración completa de todos los discos de almacenamiento en un equipo.
Desde el punto de vista de su diseño, el ogLive se divide en dos componentes, cada uno con una función específica en el proceso de arranque:
@ -104,6 +104,42 @@ Para aumentar la velocidad de descarga, se utiliza HTTP configurado por Nginx pa
---
### 1.3 Arquitectura General del Sistema
#### Flujo de Comunicación entre el Cliente y el Servidor OgDHCP
El proceso de arranque en red utilizando ogboot sigue un flujo bien definido que comienza con la comunicación entre el cliente y el servidor DHCP, denominado **OgDHCP** en este contexto.
1. **Solicitud de Configuración de Red por Parte del Cliente:**
- Cuando un cliente se inicia, envía una solicitud al servidor OgDHCP para obtener los parámetros necesarios para arrancar en red. Este es el primer paso en el proceso de arranque PXE (Preboot Execution Environment).
2. **Asignación de IP y Parámetros de Arranque por OgDHCP:**
- El servidor OgDHCP responde a la solicitud del cliente asignándole una dirección IP. Además de la dirección IP, OgDHCP proporciona dos parámetros cruciales:
- **Next-server:** Esta es la dirección IP del servidor ogBoot, que se encargará de proporcionar los archivos necesarios para que el cliente pueda arrancar.
- **Boot-file-name:** Este parámetro especifica el archivo que el cliente debe cargar para continuar con el proceso de arranque. El nombre del archivo depende del tipo de firmware del cliente:
- **ipxe-efi:** Se utiliza para sistemas con firmware EFI.
- **undionly.pxe:** Se utiliza para sistemas con BIOS tradicional.
3. **Comunicación del Cliente con el Servidor ogBoot:**
- Con la dirección IP del servidor ogBoot (especificada en el `next-server`) y el nombre del archivo de arranque (`boot-file-name`), el cliente se comunica directamente con el servidor ogBoot.
- El cliente descarga el archivo especificado desde el servidor ogBoot y lo utiliza para continuar con el proceso de arranque, que generalmente incluye la carga del kernel y otros archivos necesarios para arrancar el sistema operativo.
Este flujo de comunicación asegura que el cliente reciba todos los parámetros necesarios para un arranque en red exitoso, permitiendo a ogboot gestionar de manera eficiente el despliegue de sistemas operativos y configuraciones en un entorno de red.
---
### Endpoints del Componente `ogboot`