Manual de Instalación y Configuración de Epoptes

Por /

Este documento detalla el procedimiento para configurar Epoptes en un aula de informática utilizando resolución de nombres mDNS (Avahi). Este método permite la interconexión entre equipos en redes con direccionamiento IP dinámico (DHCP), eliminando la necesidad de configurar IPs fijas.

 

Esquema de Funcionamiento

  1. Servidor (En este ejemplo vamos a suponer que tendrá este nombre: tux0): Actúa como controlador central y se anuncia en la red mediante Avahi.
  2. Resolución de nombres: Los equipos se localizan mediante el sufijo .local (tux0.local).
  3. Clientes: Se conectan al nombre del servidor, validan el certificado de seguridad e inician el servicio automáticamente en cada arranque.

Gestión del Nombre de Equipo (Hostname)

Dado que la IP es dinámica y puede cambiar, el nombre del equipo es el único identificador fiable en la red. Para que el sistema funcione, el servidor debe tener un nombre único y conocido.

Procedimiento para cambiar el nombre del equipo

Si tu servidor o clientes no tienen el nombre correcto, debes modificarlo en los siguientes archivos:

  1. Archivo /etc/hostname: Este archivo contiene solo el nombre del equipo. sudo nano /etc/hostname (Borra el nombre actual y escribe tux0)
  2. Archivo /etc/hosts: Debes actualizar la línea asociada al bucle local para que coincida con el nuevo nombre. sudo nano /etc/hosts Modifica la línea: 127.0.1.1 nombre_antiguo por 127.0.1.1 tux0
  3. Aplicar sin reiniciar: sudo hostnamectl set-hostname tux0

PASO 1: Configuración del Servidor

El servidor es la estación desde la que se ejerce el control del aula.

  1. Identificar la interfaz de red: Para verificar el estado de la red, utiliza el comando: ip a
  2. Script de instalación y configuración: Crea el archivo server_setup.sh y ejecútalo con permisos de superusuario:
#!/bin/bash
if [ "$EUID" -ne 0 ]; then echo "Error: ejecuta con sudo"; exit 1; fi

# Instalación de paquetes
apt update && apt install -y epoptes avahi-daemon

# Asegurar el nombre del host
hostnamectl set-hostname tux0

# Gestión de permisos de usuario
# Añade el usuario que lanzó el script al grupo epoptes
USUARIO_REAL=${SUDO_USER:-$USER}
gpasswd -a "$USUARIO_REAL" epoptes

echo "Configuración del servidor finalizada. Reinicie el equipo."

PASO 2: Configuración de los Clientes

Debe ejecutarse en cada puesto de alumno.

  1. Corrección de rutas del sistema: Si el sistema no localiza los binarios en /sbin, añádelos al PATH del usuario: echo 'export PATH=$PATH:/usr/local/sbin:/usr/sbin:/sbin' >> ~/.bashrc && source ~/.bashrc
  2. Script de configuración del cliente: Crea el archivo client_setup.sh con el siguiente contenido:
#!/bin/bash
if [ "$EUID" -ne 0 ]; then echo "Error: ejecuta con sudo"; exit 1; fi

# El cliente buscará el servidor por su nombre mDNS
SERVER_NAME="tux0.local"

# Instalación de dependencias
apt update && apt install -y epoptes-client avahi-daemon

# Configuración del archivo de cliente
# Establece la variable SERVER para apuntar al hostname del servidor
if [ -f /etc/default/epoptes-client ]; then
    sed -i "s/^#SERVER=.*/SERVER=$SERVER_NAME/" /etc/default/epoptes-client
    sed -i "s/^SERVER=.*/SERVER=$SERVER_NAME/" /etc/default/epoptes-client
else
    echo "SERVER=$SERVER_NAME" > /etc/default/epoptes-client
fi

# Descarga del certificado de seguridad (Requiere que el servidor esté activo)
echo "Obteniendo certificado desde $SERVER_NAME..."
epoptes-client -c

# Persistencia del servicio
systemctl enable epoptes-client
systemctl restart epoptes-client

echo "Configuración del cliente finalizada."

PASO 3: Verificación de la Conexión

  1. En el Servidor: Inicia la interfaz gráfica ejecutando epoptes o buscando la aplicación en el menú de Educación.
  2. En el Cliente: Comprueba que el servicio está corriendo con el comando systemctl status epoptes-client.
  3. Resolución de problemas: Si el cliente no aparece, verifica la conectividad mDNS mediante un ping: ping tux0.local Si responde pero no conecta, repite la descarga del certificado: sudo epoptes-client -c.
Scroll al inicio