# ogGui - Interfaz de Administración OpenGnsys ## Introducción 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: - 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 ![Consola Web OpenGnsys](../assets/images/screenshots/ogintro-webconsole.png) ## 1. Acceso al Sistema Para comenzar a utilizar OpenGnsys: 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" ## 2. Interfaz Principal Una vez dentro, encontrarás: - **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 ## 3. Configuración Inicial ### 3.1 Gestión de Usuarios La gestión de usuarios te permite controlar quién tiene acceso al sistema y qué puede hacer. ![Menú de configuración](../assets/images/screenshots/oggui-config_menu.png) #### 3.1.1 Visualizar Usuarios Existentes Accede al menú **Administración > Usuarios** para ver la lista de usuarios actuales del sistema. ![Lista de usuarios](../assets/images/screenshots/oggui-config_usuarios.png) #### 3.1.2 Añadir un Nuevo Usuario 1. En la pantalla de usuarios, haz clic en el botón "Añadir Usuarios" 2. Completa el formulario con los siguientes datos: ![Añadir usuario](../assets/images/screenshots/oggui-administracion-usuarios-anadir_usuario.png) - **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 3. Haz clic en "Guardar" para crear el nuevo usuario #### 3.1.3 Editar un Usuario Existente 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 #### 3.1.4 Eliminar un Usuario 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 ### 3.2 Configuración de Roles Los roles definen los permisos de los usuarios en la plataforma. OpenGnsys incluye cuatro niveles predefinidos: - **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 Para configurar roles: 1. Accede a **Configuración > Roles** 2. Desde aquí podrás ver, editar o crear nuevos roles según necesites ### 3.3 Variables de Entorno Las variables de entorno definen la configuración básica de conexión con los diferentes componentes: 1. Accede a **Configuración > Variables de Entorno** 2. Configura las siguientes variables según tu infraestructura: - **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.