Manual de Instalación e Configuración de Epoptes

Por /

Este documento detalla o procedemento para configurar Epoptes nunha aula de informática utilizando resolución de nomes mDNS (Avahi). Este método permite a interconexión entre equipos en redes con direccionamento IP dinámico (DHCP), eliminando a necesidade de configurar IPs fixas.

Esquema de Funcionamento

  1. Servidor (Neste exemplo imos supoñer que terá este nome: tux0): Actúa como controlador central e anúnciase na rede mediante Avahi.
  2. Resolución de nomes: Os equipos localízanse mediante o sufixo .local (tux0.local).
  3. Clientes: Conéctanse ao nome do servidor, validan o certificado de seguridade e inician o servizo automaticamente en cada arranque.

Xestión do Nome de Equipo (Hostname)

Dado que a IP é dinámica e pode cambiar, o nome do equipo é o único identificador fiable na rede. Para que o sistema funcione, o servidor debe ter un nome único e coñecido.

Procedemento para cambiar o nome do equipo

Se o teu servidor ou clientes non teñen o nome correcto, debes modificalo nos seguintes ficheiros:

  1. Ficheiro /etc/hostname: Este ficheiro contén só o nome do equipo. sudo nano /etc/hostname (Borra o nome actual e escribe tux0)
  2. Ficheiro /etc/hosts: Debes actualizar a liña asociada ao bucle local para que coincida co novo nome. sudo nano /etc/hosts Modifica a liña: 127.0.1.1 nome_antigo por 127.0.1.1 tux0
  3. Aplicar sen reiniciar: sudo hostnamectl set-hostname tux0

PASO 1: Configuración do Servidor

O servidor é a estación dende a que se exerce o control da aula.

  1. Identificar a interface de rede: Para verificar o estado da rede, utiliza o comando: ip a
  2. Script de instalación e configuración: Crea o ficheiro server_setup.sh e execútao con permisos de superusuario:
#!/bin/bash
if [ "$EUID" -ne 0 ]; then echo "Erro: executa con sudo"; exit 1; fi

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

# Asegurar o nome do host
hostnamectl set-hostname tux0

# Xestión de permisos de usuario
# Engade o usuario que lanzou o script ao grupo epoptes
USUARIO_REAL=${SUDO_USER:-$USER}
gpasswd -a "$USUARIO_REAL" epoptes

echo "Configuración do servidor finalizada. Reinicie o equipo."

PASO 2: Configuración dos Clientes

Debe executarse en cada posto de alumno.

  1. Corrección de rutas do sistema: Se o sistema non localiza os binarios en /sbin, engádeos ao PATH do usuario: echo 'export PATH=$PATH:/usr/local/sbin:/usr/sbin:/sbin' >> ~/.bashrc && source ~/.bashrc
  2. Script de configuración do cliente: Crea o ficheiro client_setup.sh co seguinte contido: 
    
#!/bin/bash

# Definición do nome do servidor mDNS
SERVER_NAME="tux0.local"

# 1. Verificar se se executa como root
if [ "$EUID" -ne 0 ]; then 
  echo "Erro: Por favor, executa o script con sudo (sudo ./config_cliente_nome.sh)"
  exit 1
fi

# Engadimos as rutas de administración ao PATH da sesión actual do script
export PATH=$PATH:/usr/local/sbin:/usr/sbin:/sbin

echo "--- Iniciando configuración automática do cliente Epoptes ---"

# 2. Actualización de repositorios e instalación
# Instalamos avahi-daemon para que o cliente poida resolver o nome .local
echo "[1/5] Instalando paquetes necesarios (epoptes-client, avahi, net-tools)..."
apt update && apt install -y epoptes-client avahi-daemon net-tools

# 3. Configuración do ficheiro /etc/hosts (Opcional con Avahi, pero recomendable por seguridade)
# Nota: Co uso de .local, o sistema buscará automaticamente na rede sen necesidade de IP fixa
echo "[2/5] Limpando configuracións previas de hosts..."
sed -i '/tux0/d' /etc/hosts
sed -i '/server/d' /etc/hosts

# 4. Configuración do ficheiro por defecto de Epoptes
echo "[3/5] Axustando configuración para conectar a $SERVER_NAME..."
if [ -f /etc/default/epoptes-client ]; then
    # Substituímos calquera configuración previa polo nome do noso servidor
    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

# 5. Descarga do certificado dende o servidor
# O servidor debe estar acendido e coa aplicación Epoptes aberta
echo "[4/5] Descargando certificado de seguridade dende $SERVER_NAME..."
/usr/sbin/epoptes-client -c

# 6. Activación e arranque do servizo
echo "[5/5] Activando o servizo para o arranque automático..."
systemctl enable epoptes-client
systemctl restart epoptes-client

echo "---"
echo "PROCESO FINALIZADO CON ÉXITO."
echo "O cliente xa debería aparecer na consola do servidor ($SERVER_NAME)."
echo "Se o certificado fallou, asegúrate de que o servidor se chama 'tux0'."

    PASO 3: Verificación da Conexión

  1. No Servidor: Inicie a interface gráfica executando epoptes ou buscando a aplicación no menú de Educación.
  2. No Cliente: Comprobe que o servizo está correndo co comando systemctl status epoptes-client.
  3. Resolución de problemas: Se o cliente non aparece, verifique a conectividade mDNS mediante un ping: ping tux0.local Se responde pero non conecta, repita a descarga do certificado: sudo epoptes-client -c.
Scroll ao inicio