From c48981a82683ecbca542bff1bc9ec0776940b123 Mon Sep 17 00:00:00 2001 From: arantuna Date: Mon, 19 May 2025 22:14:33 -0600 Subject: [PATCH] =?UTF-8?q?Se=20modifica=20la=20gu=C3=ADa=20de=20consola,?= =?UTF-8?q?=20preparada=20para=20crear=20los=20flujos=20propios.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- i18n-docu/docs/es/administration/oggui.md | 238 +++++++++++++++------- 1 file changed, 163 insertions(+), 75 deletions(-) diff --git a/i18n-docu/docs/es/administration/oggui.md b/i18n-docu/docs/es/administration/oggui.md index 3585a13..2d9331c 100644 --- a/i18n-docu/docs/es/administration/oggui.md +++ b/i18n-docu/docs/es/administration/oggui.md @@ -1,114 +1,202 @@ -# Interfaz de Administración +# ogGui - Interfaz de Administración OpenGnsys -La consola Web, supone el mayor avance de OpenGnsys en esta nueva versión, con las caractersíticas principales de: +## Introducción -- Desarrollada con un lenguaje actual y moderno, Angular 18 -- Web Responsiva, funcionando tanto en entorno de PC como Móvil -- Multilingüe, contando con traducción a inglés +Bienvenido a la nueva interfaz de administración de OpenGnsys. Este manual te guiará en tus primeros pasos para configurar y utilizar eficientemente la plataforma. La nueva consola web representa un salto cualitativo con las siguientes características principales: -![ogintro-webconsole.png](../assets/images/screenshots/ogintro-webconsole.png) +- Desarrollada con Angular 18, un framework moderno y actual +- Diseño web responsivo que funciona tanto en entornos de PC como en dispositivos móviles +- Soporte multilingüe con traducción al inglés -## Configuración +![Consola Web OpenGnsys](../assets/images/screenshots/ogintro-webconsole.png) -La nueva interfaz de administración de OpenGnsys, cuenta con las siguientes características para su Configuración +## 1. Acceso al Sistema -![oggui-config_menu.png](../assets/images/screenshots/oggui-config_menu.png){ align=center width=20% } +Para comenzar a utilizar OpenGnsys: -### Usuarios +1. Abre tu navegador web preferido +2. Introduce la dirección URL del servidor OpenGnsys +3. En la pantalla de inicio de sesión, introduce tus credenciales (nombre de usuario y contraseña) +4. Haz clic en "Iniciar sesión" -Se permite crear, editar y eliminar Usuarios +## 2. Interfaz Principal -![oggui-config_usuarios.png](../assets/images/screenshots/oggui-config_usuarios.png){ align=center } +Una vez dentro, encontrarás: -#### Añadir Usuario +- **Panel de navegación lateral**: Acceso a todos los módulos y funcionalidades +- **Barra superior**: Información del usuario, notificaciones y acceso rápido a configuraciones +- **Área de trabajo central**: Donde se visualiza y gestiona la información seleccionada -![oggui-administracion-usuarios-anadir_usuario.png](../assets/images/screenshots/oggui-administracion-usuarios-anadir_usuario.png){ align=right width=40% } Habrá que definir el *usuario*, *contraseña*, *rol*, *unidad organizativa* y *vista*. +## 3. Configuración Inicial -- **Nombre de Usuario**: se usará para le inicio de sesión +### 3.1 Gestión de Usuarios -- **Contraseña**: la contraseña se define aquí por un administrador. El usuario no podrá cambiar la contraseña, si no tiene acceso al panel de administración de usuarios. +La gestión de usuarios te permite controlar quién tiene acceso al sistema y qué puede hacer. -- **Rol**: permite asignar uno o varios roles al usuario. Los roles permiten una mayor granularidad a la hora de administrar los permisos que tendrá cada usuario para administrar la plataforma. +![Menú de configuración](../assets/images/screenshots/oggui-config_menu.png) -- **Unidad Organizativa**: permite definir sobre qué grupo de aulas o equipos podrá administrar el usuario. Este campo permite elegir uno o varios grupos sobre los que el usuario podrá interactuar. +#### 3.1.1 Visualizar Usuarios Existentes -
+Accede al menú **Administración > Usuarios** para ver la lista de usuarios actuales del sistema. -#### Editar usuario +![Lista de usuarios](../assets/images/screenshots/oggui-config_usuarios.png) -Esta ventana permite editar todos los campos que se han definido en la creación del mismo. +#### 3.1.2 Añadir un Nuevo Usuario -#### Eliminar Usuario +1. En la pantalla de usuarios, haz clic en el botón "Añadir Usuarios" +2. Completa el formulario con los siguientes datos: -Permite eliminar un usuario. +![Añadir usuario](../assets/images/screenshots/oggui-administracion-usuarios-anadir_usuario.png) -### Roles +- **Nombre de Usuario**: Identificador único para iniciar sesión +- **Contraseña**: Clave de acceso (nota: solo los administradores pueden cambiar contraseñas) +- **Rol**: Selecciona uno o varios roles que definirán los permisos del usuario +- **Unidad Organizativa**: Define sobre qué grupos de aulas o equipos podrá administrar el usuario -Los roles permiten gestionar los permisos de acceso que tienen los usuarios para adminsitrar la plataforma. Actualmente se cuenta con 4 niveles de administración según los roles: +3. Haz clic en "Guardar" para crear el nuevo usuario -- Super Admin: permite control total de la plataforma, sin restricciones. -- Admin de Unidad Organizativa: permite al usuario realizar todas las actividades existentes, sobre la unidad organizativa. -- Operador de Unidad Organizativa: -- Usuario +#### 3.1.3 Editar un Usuario Existente -### Variables de Entorno +1. En la lista de usuarios, localiza el usuario que deseas modificar +2. Haz clic en el icono de edición (lápiz) +3. Actualiza los campos necesarios +4. Guarda los cambios -En este menú se definen, principalmente, las IP y puerto de las API de los diferentes componentes +#### 3.1.4 Eliminar un Usuario -- OG_CORE_IP -- OG_DHCP_API_URL -- OG_BOOT_API_URL -- OG_LOG_IP -- REMOTEPC_AUTH_LOGIN -- REMOTEPC_AUTH_USERNAME -- REMOTEPC_AUTH_PASSWORD -- REMOTEPC_URL +1. En la lista de usuarios, localiza el usuario que deseas eliminar +2. Haz clic en el icono de eliminación (papelera) +3. Confirma la acción cuando se te solicite -## Navegación por los Menús +### 3.2 Configuración de Roles -En el panel izquierdo, contamos con los menús que nos dan acceso a las características de OpenGnsys que tengamos actualmente activas y funcionando. -!!! note "Nota" - Es posible que OpenGnsys no cuente con algunos módulos, porque son consumidos de infraestructuras externas, el ejemplo más clásico es DHCP. En este caso, al acceder a dicho menú se nos mostrará una advertenca de que este módulo no está habilitado. +Los roles definen los permisos de los usuarios en la plataforma. OpenGnsys incluye cuatro niveles predefinidos: -## Administrar Grupos +- **Super Admin**: Control total de la plataforma, sin restricciones +- **Admin de Unidad Organizativa**: Control completo sobre la unidad organizativa asignada +- **Operador de Unidad Organizativa**: Permisos limitados para operar equipos en la unidad asignada +- **Usuario**: Acceso básico a la plataforma -![oggui-grupos_crear.png](../assets/images/screenshots/oggui-grupos_crear.png){align=right width=50%}Las características principales de los grupos son: +Para configurar roles: -- Herencia - - Red y servicio DHCP - - Boot Server - - Versión de ogLive - - Plantilla PXE - - Servidor NTP - - Repositorio de Imágenes - - Configuración de los valores de P2P (modo, tiempo) - - Configuración de los valores de Multicast (velocidad, puerto, modo) - - Menú - - Perfil de Hardware +1. Accede a **Configuración > Roles** +2. Desde aquí podrás ver, editar o crear nuevos roles según necesites -Los grupos de elementos, son un sistema jerárquico que permite agrupación de elementos. Los más clásicos son Campus, Centros, Aulas y Clientes. +### 3.3 Variables de Entorno -```mermaid -flowchart TB - subgraph c1 [" Campus"] - subgraph c2 [" Centro"] - subgraph c3 [" Aula"] - c4[" Cliente"] - end - end - end +Las variables de entorno definen la configuración básica de conexión con los diferentes componentes: - classDef campusStyle fill:#f9d5e5,stroke:#333,stroke-width:3px - classDef centroStyle fill:#eeeeee,stroke:#333,stroke-width:2px - classDef aulaStyle fill:#b5ead7,stroke:#333,stroke-width:1px - classDef clienteStyle fill:#c7ceea,stroke:#333,stroke-width:1px +1. Accede a **Configuración > Variables de Entorno** +2. Configura las siguientes variables según tu infraestructura: - class c1 campusStyle - class c2 centroStyle - class c3 aulaStyle - class c4 clienteStyle +- **OG_CORE_IP**: Dirección IP del servidor principal +- **OG_DHCP_API_URL**: URL de la API del servicio DHCP +- **OG_BOOT_API_URL**: URL de la API del servidor de arranque +- **OG_LOG_IP**: Dirección IP del servidor de logs +- **REMOTEPC_AUTH_LOGIN**: URL de autenticación para RemotePC +- **REMOTEPC_AUTH_USERNAME**: Usuario para RemotePC +- **REMOTEPC_AUTH_PASSWORD**: Contraseña para RemotePC +- **REMOTEPC_URL**: URL base del servicio RemotePC + +## 4. Estructura Jerárquica + +OpenGnsys organiza los equipos en una estructura jerárquica que facilita su administración. Aunque en esta versión trasciende los conceptos de OU->Aula->Cliente y todos son grupos que se pueden anidar en una estructura jerárquica, para el caso de uso más habitual, el docente, seguiría esta estructura: +``` +Campus > Centro > Aula > Cliente ``` -
+![Estructura jerárquica](../assets/images/screenshots/oggui-grupos_crear.png) +### 4.1 Creación de Grupos + +Para crear un nuevo grupo: + +1. Accede al menú de **Grupos** +2. Selecciona "Nueva Unidad Organizativa" +3. Define el tipo de grupo (Centro, Grupo de Aulas, Aula, Grupo de ClientesCentro, Grupo de Aulas, Aula, Grupo de Clientes) +4. Completa la información requerida +5. Guarda los cambios + +### 4.2 Características de los Grupos + +Los grupos permiten la herencia de configuración, lo que significa que los ajustes aplicados a un grupo superior se heredan automáticamente en los grupos inferiores. Esto incluye: + +- Red y servicio DHCP +- Configuración del Boot Server + - Versión de ogLive + - Plantilla PXE +- Servidor NTP +- Repositorio de imágenes + - Configuración P2P (modo, tiempo) + - Configuración Multicast (velocidad, puerto, modo) +- Menú de arranque +- Perfil de hardware + +## 5. Navegación por los Menús + +El panel lateral izquierdo contiene todos los menús disponibles según tu rol y los módulos activos: + +- **Grupos**: Administración de los grupos +- **Acciones**: El módulo de gestión de Acciones, Comandos y Tareas. +- **Subredes**: El módulo de gestión del servicio de DHCP. +- **Boot**: El módulo de gestión de los servicios de arranque ogLive y PXE. +- **Calendarios**: Módulo para la gestión de disponibilidad de equipos en el servicio RemotePC +- **Repositorios**: Módulo para la gestión de repositorios y las imágenes asociadas a cada uno. +- **Menús**: Permite administrar los menús que se mostarán al iniciar ogLive en un equipo cliente. + +!!! note "Nota" + Es posible que algunos módulos no estén disponibles si dependen de servicios externos no configurados. Por ejemplo, si el servicio DHCP se gestiona externamente, al acceder a dicho menú se mostrará un aviso indicando que el módulo no está habilitado. + +## 6. Operaciones Básicas + +### 6.1 Gestión de Grupos + +Para administrar equipos: + +1. Accede al menú **Equipos** +2. Utiliza los filtros para localizar equipos específicos +3. Selecciona uno o varios equipos para realizar acciones como: + - Encender/Apagar + - Restaurar imagen + - Clonar disco + - Realizar mantenimiento + +### 6.2 Gestión de Acciones + +Para trabajar con Acciones: + +1. Accede al menú **Acciones** +2. Desde aquí podrás: + + - Adminisrar los Comandos + - Ejecutar Grupos de Comandos + - Ejecutar Tareas + +## 7. Solución de Problemas Comunes + +### 7.1 Problemas de Acceso + +Si no puedes acceder al sistema: + +- Verifica que las credenciales sean correctas +- Comprueba la conectividad con el servidor +- Contacta con el administrador para verificar tus permisos + +### 7.2 Módulos No Disponibles + +Si un módulo aparece como no disponible: + +- Verifica que el servicio correspondiente esté activo +- Comprueba las variables de entorno relacionadas +- Consulta los logs del sistema para identificar posibles errores + +## 8. Recursos Adicionales + +[Foro de la Comunidad][foro-url]{target=\_blank} +[foro-url]: https://foro.opengnsys.es +[Repositorio Git de Desarrollo][git-url]{target=\_blank} +[git-url]: https://dev.opengnsys.es/gitea +--- + +Este manual te ha proporcionado los conocimientos básicos para comenzar a utilizar la interfaz de administración de OpenGnsys. Para información más detallada sobre funcionalidades específicas, consulta la documentación completa o contacta con el soporte técnico.