Se modifica la guía de consola, preparada para crear los flujos propios.
parent
4ef4769c22
commit
c48981a826
|
|
@ -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:
|
||||
|
||||
|
||||
- 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
|
||||
|
||||
|
||||
La nueva interfaz de administración de OpenGnsys, cuenta con las siguientes características para su Configuración
|
||||
## 1. Acceso al Sistema
|
||||
|
||||
{ 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
|
||||
|
||||
{ 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
|
||||
|
||||
{ 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.
|
||||
|
||||
|
||||
- **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
|
||||
|
||||
<div style="clear: both;"></div>
|
||||
Accede al menú **Administración > Usuarios** para ver la lista de usuarios actuales del sistema.
|
||||
|
||||
#### Editar usuario
|
||||
|
||||
|
||||
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.
|
||||
|
||||
|
||||
### 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
|
||||
|
||||
{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
|
||||
```
|
||||
|
||||
<div style="clear: both;"></div>
|
||||
|
||||
|
||||
### 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.
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue