Updated doc

pull/1/head
Nicolas Arenas 2025-04-03 10:53:31 +02:00
parent e88f97faaf
commit 1becf86e79
11 changed files with 56 additions and 22 deletions

View File

@ -35,11 +35,11 @@ Hacemos login en la máquina que vamos a instalar como usuario root.
Ejecutamos los siguientes comandos:
```bash
curl -q -k https://ognproject.evlt.uma.es/gitea/api/v1/repos/opengnsys/oginstaller/raw/non_graf_installer/python-installer/opengnsys_installer.sh?ref=main -o opengnsys_installer.sh
curl -q -k https://ognproject.evlt.uma.es/gitea/api/v1/repos/opengnsys/oginstaller/raw/non_graf_installer/python-installer/opengnsys_installer-v2.sh?ref=main -o opengnsys_installer.sh
chmod 755 opengnsys_installer.sh
./opengnsys_installer.sh
./opengnsys_installer.sh devel
```
![Imagen2.png](./imagenes/Imagen2.png)
@ -61,28 +61,30 @@ Para el servicio ogCore los datos que se requieren son:
### ogGui
Para el servicio de Interfaz gráfica, los datos que se piden son:
URL de Conexión al servidor de ogCore: Valor por defecto https://127.0.0.1:8443
- URL de Conexión al servidor de ogCore: Valor por defecto https://\<ip del interfaz asociada a la ruta por defecto>:8443
- URL de Conexion a Mercure: Valor por defecto https://\<ip del interfaz asociada a la ruta por defecto>:3000/.well-known/mercure
![Imagen5.png](./imagenes/Imagen5.png)
### ogDHCP
- Para el servicio de DHCP los parámetros que se piden son:
- IP del servidor de ogBoot
- IP del propio servidor de DHCP
- Directorio donde se instalará el dhcp
- Interfaces de red por las que se servirá el servicio de DHCP
Para el servicio de DHCP los parámetros que se piden son:
- Interfaces de red por las que se servirá el servicio de DHCP. Se muestra una lista con los interfaces de red disponibles para la instalación y se introducen como una lista separada por comas en el campo de selección.
- IP del servidor de ogBoot (Valor por defecto la IP de la interfaz asociada a la ruta por defecto)
- IP del propio servidor de DHCP (Valor por defecto la IP de la interfaz asociada a la ruta por defecto)
![Imagen6.png](./imagenes/Imagen6.png)
### ogBoot (PXE)
### ogBoot (PXE)
Los parámetros que se requieren son:
Los parámetros que se requieren son:
- IP del servidor de ogCore
- IP del propis servidor de ogBoot
- Directorio de ogBoot
- Oglive a instalar en el servidor de boot. La lista se obtiene de los ogLives disponibles en el directorio de descargas de ogLives.
- IP del propis servidor de ogBoot (Valor por defecto la IP de la interfaz asociada a la ruta por defecto)
- Puerto donde va a escuchar el ogBoot (Por defecto 8082)
- URL ogCore (Valor por defecto la IP de la interfaz asociada a la ruta por defecto).
- Usuario para realizar los exports de SAMBA (¡cuidado, este parámetro está embebido en los ogLive, por lo que no es conveniente cambiarlo a no ser que se haya creado un ogLive con la configuración para ello!)
- Password del usuario de Samba (¡cuidado, este parámetro está embebido en los ogLive, por lo que no es conveniente cambiarlo a no ser que se haya creado un ogLive con la configuración para ello!)
@ -93,29 +95,49 @@ Los parámetros que se requieren son:
Los parámetros que se requieren son
- IP del servicio de ogrepository
- IP del servicio de ogrepository (Valor por defecto la IP de la interfaz asociada a la ruta por defecto)
- IP del servicio de ogCore (Valor por defecto la IP de la interfaz asociada a la ruta por defecto)
- Usuario para realizar los exports de SAMBA (¡cuidado, este parámetro está embebido en los ogLive, por lo que no es conveniente cambiarlo a no ser que se haya creado un ogLive con la configuración para ello!)
- Password del usuario de Samba (¡cuidado, este parámetro está embebido en los ogLive, por lo que no es conveniente cambiarlo a no ser que se haya creado un ogLive con la configuración para ello!)
![Imagen8.png](./imagenes/Imagen8.png)
## Instalación
## Chequeo de los servicios
Una vez que se rellenen todos los formularios, el proceso de instalación comienza, aparece una pantalla donde se puede seguir el avance del proceso.
Una vez que la instalación se ha completado, podemos comprobar que los servicios se han instalado correctamente y ha funcionado según lo esperado.
![Imagen30.png](./imagenes/Imagen30.png)
Una vez que el proceso de instalación termina se muestra un resumen del proceso de instalación.
![Imagen31.png](./imagenes/Imagen31.png)
Se crea el archivo /opt/opengnsys/release con la versión instalada de Opengnsys
```sh
(og) root@install:~# cat /opt/opengnsys/release
Versión instalada: opengnsys-1.6.0-beta
```
## Chequeo de los servicios
Una vez que la instalación se ha completado, podemos comprobar que los servicios se han instalado correctamente y ha funcionado según lo esperado.
### Permisos de los usuarios
Todos los componentes se han debido instalar en /opt/opengnsys/<carpeta servicio> , donde carpeta servicio es:
Todos los componentes se han debido instalar en /opt/opengnsys/<carpeta servicio> , donde carpeta servicio es:
- ogboot
- ogdhcp
- ogdhcp
- ogrepository
- ogCore
- ogGui
- ogcore
- oggui
- ogclient
Las carpetas ogboot, ogdhcp, ogrepository, deben pertenecer al usuario opengnsys, las carpetas ogCore y ogGui deben pertenecer al usuario root.
Actualmente existe una carpeta llamada ogclient_log que se usa para montarse en los clientes y donde dejan sus logs. En proximas versiones esta carpeta va a desaparecer.
Todas los directorios pertenecen al usuario opengnsys grupo www-data excepto los directorios ogclient y ogclient_log que pertenecen al grupo opengnsys.
![Imagen9a.png](./imagenes/Imagen9a.png)
@ -137,7 +159,19 @@ Todos los servicios funcionan bajo una API (cada servicio con la suya propia) y
#### Descripción
Es un servicio compuesto por 3 contenedores definidos en el archivo /opt/opengnsys/ogCore/etc/docker-compose-deploy.yml . Se gestiona como un único servicio mediante systemd.
El servicio ogCore está compuesto por tres componentes componentes:
- API
- BBDD
- Mercure
Tanto la API como Mercure se sirven detrás de u proxy inverso de nginx.
El esquema de ogCore se representaría en este grafico.
![ogcore-schema](imagenes/opengsys-ogcore.png)
#### Parada y arranque de los servicios

Binary file not shown.

Before

Width:  |  Height:  |  Size: 63 KiB

After

Width:  |  Height:  |  Size: 81 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 72 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 130 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 25 KiB

After

Width:  |  Height:  |  Size: 57 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 40 KiB

After

Width:  |  Height:  |  Size: 70 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 62 KiB

After

Width:  |  Height:  |  Size: 109 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 36 KiB

After

Width:  |  Height:  |  Size: 61 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 93 KiB

After

Width:  |  Height:  |  Size: 80 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 99 KiB

After

Width:  |  Height:  |  Size: 93 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 48 KiB