ANEXO E
MANUAL DE USUARIO
1. USUARIOS DEL SISTEMA
Existen dos principales tipos de usuario en el sistema, docente y administrador, los dos siguen un proceso similar para registrarse en el sistema que comienza con el diligenciamiento de un formulario, la opción para registrarse se encuentra en la parte superior derecha de la pantalla en la aplicación principal como en la parte superior izquierda en el manual de usuario dentro de la aplicación.
Figura 1 Menú de iniciar sesión. Fuente Autores
1.1. REGISTRO Y APROBACIÓN
Figura 2 Formulario de registro de un usuario. Fuente Autores
El color del campo de contraseña cambia de rojo oscuro a verde oscuro indicando la seguridad de la contraseña, en el camino pasa por el naranja y el amarillo.
Figura 3 Aceptar registro de docente. Fuente Autores
En caso de rechazar la petición del usuario se preguntará al administrador si desea rechazar la petición del usuario y se le advierte que de continuar se eliminará el registro de la base de datos:
Figura 4 Rechazo registro de un usuario. Fuente Autores
Cuando no existan docentes cuyo registro esté pendiente por aceptar aparecerá un mensaje indicándolo así.
1.2. ROLES
Como se explicó al inicio de este documento existen dos roles en la aplicación, los docentes y un administrador, los dos pueden ejecutar tareas sobre equipos, el docente puede hacerlo siempre y cuando las máquinas se encuentren dentro de un curso que le haya sido asignado y el administrador sobre cualquier máquina registrada en el sistema, un detalle de la diferencia entre los roles puede observarse en la tabla 81.
ADMINISTRADOR DOCENTE
Aprobar docente X
Registrar cursos X Registrar máquinas X Registrar grupos X Administrar cursos y grupos
Consultar historial de tareas
X X
Consultar máquinas por curso
X X
Ejecutar tareas en equipos
X X
El administrador puede hacer muchas cosas que los docentes no, aun así, éstos con las pocas funciones que tienen pueden hacer gran cantidad de cosas, la habilidad para ejecutar tareas tiene muchas opciones como reiniciar las máquinas, instalar paquetes, administrar los servicios en ejecución y muchos más.
2. CONFIGURACIÓN DEL SISTEMA
Antes de que los docentes puedan usar el aplicativo deben realizarse algunas configuraciones básicas, si éstas no se hacen el docente no podrá hacer absolutamente nada ya que no tendrá máquinas que administrar y no estará registrado en ningún grupo, a continuación se explicarán las configuraciones en su orden respectivo ya que no será posible por ejemplo registrar una máquina sin que exista un curso al cuál será asignada.
Se puede acceder a las configuraciones de máquinas, cursos y grupos desde la opción 'registrar' del menú del administrador:
Figura 6 Menú de registro. Fuente Autores
Figura 7 Información el base de datos. Fuente Autores
2.1. REGISTRAR CURSOS Y GRUPOS
Una vez se hace clic sobre la opción para registrar curso aparece un formulario igual al que se muestra en la figura 84
Figura 8 Formulario registro curso. Fuente Autores
rellenado con datos usados para Cóndor, por citar un ejemplo y no tendría que ser llenado de manera completamente manual.
Tras hacer clic en enviar se creará el registro del curso (materia) y podrá asignársele grupos y máquinas.
Para crear un grupo el formulario es un poco diferente ya que los grupos no tienen nombre, se les asigna un docente, un curso y un semestre en el que será impartida la materia, esto último dado que no siempre existirán la misma cantidad de grupos ni serán dictados por los mismos docentes.
Figura 9 Registro grupo. Fuente Autores
2.2. REGISTRAR MÁQUINAS
De nada servirá registrar cursos y grupos si no se asigna alguna máquina a cada curso, para ello se debe diligenciar el formulario que se muestra a continuación:
Figura 10 Formulario registrar máquina. Fuente Autores
Los campos Curso, Sistema Operativo, memoria RAM y procesador son una lista de valores predeterminados o cargados de la base de datos, lamentablemente más allá de la dirección IP, el curso y el sistema operativo estos campos realmente no harán nada son, por el momento, meramente informativos y deberían reflejar las configuraciones de las máquinas virtuales creadas con el gestor usado en la Universidad Distrital.
Figura 11 Instalación VNC en la nueva máquina. Fuente Autores
La ejecución de ésta tarea es obligatoria para que pueda funcionar la aplicación y si por alguna razón no se completaron todas las tareas sin errores siempre es posible enviar la tarea desde la categoría sistema, en la opción SSH y VNC, HABILITAR ACCESO SSH E INSTALAR VNC.
Una vez completados éstos pasos un docente puede empezar a usar la aplicación.
3. ADMINISTRACIÓN DE BASES DE DATOS
Ésta función está disponible sólo para el administrador del sistema y permite editar algunos datos de la aplicación como lo son los cursos y los grupos, los datos de los docentes y las máquinas. Es posible acceder a estas configuraciones en la opción BDD en la barra de navegación:
Cursos y grupos: Presenta una lista de todos los cursos registrados en el sistema, con la posibilidad de revisar los datos del curso, modificarlos y si es necesario eliminar el curso del sistema.
Figura 13 Cursos y grupos registrados. Fuente Autores
A la derecha aparece en color verde la frase 'Grupos del curso' y al hacer clic sobre ella se listarán los grupos del curso en todos los semestres tal como se muestra en la figura 90:
Figura 14 Listado de docentes registrados. Fuente Autores
Al igual que en la lista de cursos es posible revisar los datos completos del grupo, editarlos y si es necesario eliminarlo.
Figura 15 Listado de cursos registrados. Fuente Autores
En éste formulario la opción para listar todos los grupos es remplazada por una opción que permite observar las máquinas asociadas al curso deseado 'Equipos', al hacer clic en ella se podrán modificar o eliminar de ser requerido por el administrador del sistema.
Figura 16 Listado de máquinas registradas. Fuente Autores
Docentes: Ésta última opción permite administrar los docentes registrados en el sistema y permite modificar sus datos o eliminarlos, puede ser conveniente en caso de que por equivocación se aceptó al usuario o por alguna razón no se necesita el usuario en el sistema.
4. REGISTROS
4.1 ARCHIVOS SUBIDOS
En la sección de comandos existe la opción de enviar un archivo a una máquina, el archivo puede ser de cualquier extensión y éste es almacenado en el servidor para que el usuario pueda después reenviarlo o sencillamente consultar el contenido del archivo:
Figura 17 Listado de archivos subidos. Fuente Autores
También es posible reenviar algún archivo previamente subido a una máquina, en este caso el proceso será similar al proceso para enviar un nuevo archivo que se explica en la sección de tareas de archivo.
5. TAREAS ANTERIORES
consultar el estado final de cada una de ellas, la lista de tareas luce como se muestra en la figura 94:
Figura 18 Listado de tareas ejecutadas. Fuente Autores
Como se puede observar aparece una pista del tipo de tarea que se ejecutó, esto es de manera general, al entrar al resumen de la tarea se podrá observar la descripción completa de la tarea incluyendo variables y resumen de tareas por equipo.
Cabe destacar que ésta información sólo está disponible para el usuario que ejecutó las tareas, si otro usuario trata de por ejemplo de acceder al resumen de una tarea que él no ejecutó le aparecerá un mensaje igual al mostrado en la figura 95.
Cuando se abre el resumen de una tarea aparecerán 3 secciones, la primera es un resumen general de la tarea que incluye estado, hora de creación y hora a la que será ejecutada.
Figura 19 Resultado de una tarea. Fuente Autores
OK: El número de pasos completados con éxito pero que no generaron cambios en el sistema.
Changed: El número de pasos completados y que generaron cambios en el sistema, en caso de que se ejecute una tarea en repetidas ocasiones la aplicación sabrá si se hicieron cambios o el sistema continúa igual, en dado caso el paso se marcará como OK.
encuentra correctamente configurada se debe contactar con el web master para que encienda la máquina ya que el prototipo no permite encender las máquinas de manera remota.
Failed: En caso de que algunos de los pasos fallen aquí se encontrará dicho error, la aplicación detendrá la ejecución apenas encuentre un error, en esa situación debe comunicarse con el web master para que corrija el error.
No se muestra la descripción de todos los pasos para completar una tarea ya que son aspectos técnicos que no deberían ser de importancia para el usuario.
Un caso especial de tarea es la consulta de servicios y puertos abiertos en el sistema, ésta tarea tiene una sección extra al final que muestra los resultados de la consulta en una tabla como se muestra en las figuras 96 y 97.
6. TAREAS
Figura 20 Listado de servicios activos. Fuente Autores
7. ESTADOS
Una tarea puede tener diferentes estados a lo largo de su vida en el sistema, dichos estados son los mismos que usa el planificador de tareas del framework Web2py usado para desarrollar la aplicación, los posibles cambios de estado se muestran en la figura 98.
Figura 22 Estados del planificador. Fuente
ESTADO SIGNIFICADO varios, en la aplicación únicamente se está usando uno por lo tanto las tareas se ejecutan de manera lineal.
EXPIRED Si ha a una tarea se le configura un
tiempo de vida y ésta no es ejecutada dentro de ese tiempo la tarea expira, en la aplicación ninguna tarea tiene tiempo de expiración así que todas se ejecutarán tarde o temprano.
RUNNING La tarea se encuentra en ejecución.
TIMEOUT Las tareas tienen un tiempo de
este tiempo la tarea no se completa Tabla 1 Descripción estados del planificador. Fuente Autores
En el resumen de las tareas si una tarea no ha llegado a un estado final como TIMEOUT, FAILED o COMPLETED la página se recargará cada 10 segundos.
8. TAREAS DE USUARIO
Éstas permiten manejar aspectos básicos de los usuarios en las máquinas, permiten crear usuarios normales o con permisos de superusuario, eliminar usuarios y modificar su clave.
Los tres formularios son bastante similares y no tienen mayor complejidad, por ejemplo el de crear usuarios se presenta en la figura 99:
Las contraseñas deben coincidir o no será posible enviar el formulario, además las contraseñas no tienen restricciones respecto a mayúsculas, minúsculas, caracteres especiales o números.
La opción Admin permite crear el usuario con permisos de superusuario, funciona en los sistemas de la familia RedHat y Debian.
« Ingrese los usuarios separados por coma, se puede usar expresiones como:
Usuario 1-3 y esto se transformará a Usuario1, Usuario2, Usuario3.
También puedes mezclar los dos tipos de expresiones:
Usuario 1-3, nuevusuario, otrousuario 1-3«
Figura 23 Formulario creación de usuarios. Fuente Autores
Esto aplica para los 3 módulos de creación de usuarios.
9. TAREAS DE SISTEMA
subcategorías con varias tareas asociadas, la lista completa de las tareas disponibles en este tipo de tareas se encuentra disponible en la tabla 51.
Subcategoría Tareas disponibles Explicación
Comandos básicos Reiniciar Sistema Permiten que el sistema se inicie de nuevo por
instalar VNC, Habilitar VNC aplicaciones, agregar y eliminar repositorios.
Administración de servicios
Consultar servicios en ejecución, iniciar, comandos similares a 'systemctl opción
Permite consultar qué aplicaciones están funcionando sobre algún puerto y permite abrir o cerrar puertos con firewalld.
Si ninguna aplicación funciona sobre un puerto recién abierto no se observara cambio en la consulta de puertos activos.
Tareas Crontab Programar actualización de paquetes del sistema, crear tarea personalizada y eliminar tareas por nombre.
Utiliza el servicio crontab para programar tareas en el sistema, permite programar por ejemplo copias de seguridad de una base de datos. Tabla 2 Tareas del Sistema. Fuente Autores
Figura 24 Notas importantes. Fuentes Autores
NOTA: Las tareas de gestión de aplicaciones/paquetes, servicios y puertos, permiten ingresar los parámetros de la tarea separados por comas.
10. TAREAS DE ARCHIVOS
Éstas permiten enviar archivos a una máquina a la vez, eligiendo a qué usuarios se les enviará el archivo, dichos usuarios serán únicamente los que se hayan creado con la aplicación. Si existe ya algún usuario en el sistema puede enviarse la tarea para crear usuarios con el nombre del usuario que ya existe y se podrán usar las tareas para dicho usuario.
Figura 25 Subir un archivo. Fuente Autores
En este ejemplo se seleccionó un archivo llamado luces.sh y en la zona inferior se puede elegir a qué usuarios enviar el archivo, éstos como se mencionó anteriormente, fueron creados con la aplicación.
Figura 26 Validación copia del archivo. Fuente Autores
El archivo es enviado a la carpeta de documentos de los usuarios objetivo y almacenado en la lista de archivos del usuario en el servidor.
Figura 27 Tarea de limpieza máquinas. Fuente Autores
Y por supuesto para corroborar los cambios en el sistema usamos el terminal como se muestra en la figura 104.
