Differences

This shows you the differences between two versions of the page.

--- docs_in_draft:autoshutdown [2025/12/31 17:18] – created chente
+++ docs_in_draft:autoshutdown [2025/12/31 18:08] (current) – chente
@@ Line 49: / Line 49: @@
 ===== AutoShutdown Plugin para OpenMediaVault =====
-El complemento AutoShutdown permite apagar y arrancar automáticamente el servidor basado en distintos criterios de uso, carga y horario. Es útil para servidores de respaldo o sistemas que no necesitan estar activos permanentemente, ayudando a ahorrar energía y reducir el desgaste del hardware.
+El complemento AutoShutdown permite apagar automáticamente el sistema cuando no hay actividad y, opcionalmente, programar el siguiente arranque mediante una alarma RTC.
-=== Instalación ===
+Está pensado principalmente para servidores que no necesitan estar encendidos permanentemente (servidores de respaldo, NAS domésticos, servidores de pruebas, etc.), ayudando a reducir consumo eléctrico y desgaste del hardware.
-Instalar desde OMV-Extras → Plugins → openmediavault-autoshutdown.
+Nota: AutoShutdown no es un gestor de energía completo. El arranque automático solo se programa en el momento del apagado y depende del soporte RTC del hardware.
-Activar el plugin desde Servicios → Apagado Automático.
+==== Instalación ====
-Opcional: revisar el archivo de configuración base:
+Instalar el plugin desde OMV-Extras → Plugins → openmediavault-autoshutdown
-/etc/autoshutdown.default (enlace: autoshutdown.default
-)
-=== Funciones principales ===
+Activar el servicio desde Servicios → Apagado Automático
-Ciclos y Segundos
+(Opcional) Revisar el archivo de configuración base del plugin: /etc/autoshutdown.default
-Ciclos: número de iteraciones sin actividad antes de iniciar el apagado.
+Este archivo contiene todas las opciones reales, comentarios explicativos y ejemplos. La GUI no expone todas las posibilidades.
-Segundos: intervalo entre ciclos.
+==== Conceptos básicos ====
-Apagar
+AutoShutdown funciona en ciclos periódicos:
-Comando de apagado del sistema (por defecto shutdown -h now).
+Cada X segundos, el plugin comprueba distintos indicadores de actividad.
-Tiempo en funcionamiento
+Si ningún criterio bloquea el apagado, se incrementa el contador de ciclos.
-Define la ventana de tiempo durante la cual el servidor puede encenderse y apagarse automáticamente.
+Cuando se alcanza el número máximo de ciclos sin actividad, el sistema se apaga.
+Si está configurada una alarma de despertado, se programa el RTC justo antes del apagado.
+Si en cualquier ciclo se detecta actividad, el contador se reinicia.
+==== Opciones principales ====
+=== Ciclos ===
+Ciclos: Número de ciclos consecutivos sin actividad antes de apagar
+Segundos: Intervalo de tiempo entre cada ciclo
+Ejemplo: Ciclos = 6, Segundos = 300 → el sistema se apagará tras 30 minutos sin actividad.
+=== Comando de apagado ===
+Apagar: Comando que se ejecuta para apagar el sistema
+Valor típico: shutdown -h now
+Puede personalizarse si se requiere lógica adicional.
+==== Tiempo en funcionamiento (ventana horaria) ====
+Permite limitar el funcionamiento del servidor a una franja horaria concreta.
 Hora de inicio / Minuto de inicio
@@ Line 81: / Line 105: @@
 Hora fin / Minuto fin
-Alarma para despertarse
+Fuera de esta ventana, el sistema podrá apagarse automáticamente.
+Nota: Esta opción es obligatoria para poder usar la alarma de despertado.
+==== Alarma para despertarse (RTC wake-up) ====
+Permite definir una hora de encendido automático usando el reloj RTC del sistema.
+Hora
+Minutos
+Condiciones importantes:
+Solo se programa cuando AutoShutdown apaga el sistema
+Si el sistema no llega a apagarse, la alarma no se programa
+Requiere soporte de RTC wake-up en la BIOS/UEFI
+Advertencia: Esta función no sustituye completamente al plugin Scheduled Alarms
+==== Configuración de supervisión ====
+Estos criterios determinan si el sistema se considera activo.
+=== Supervisión de red ===
+Rango de IPs: Lista de direcciones IP, rangos o FQDN que se escanean para detectar actividad
+Soporta:
+Rangos IPv4
+Direcciones IPv4 individuales
+Rangos IPv6
+Direcciones IPv6 individuales
+FQDN
+Advertencia: En IPv4 asegúrese de excluir 1 y 255 del rango
+Socket: Puerto TCP/UDP a comprobar para actividad
+Tráfico de red (kB/s): Si el tráfico medio supera este valor, NO se apaga
+=== Supervisión de discos ===
+E/S de HDD (kB/s): Si el valor medio de I/O del disco supera este umbral, NO se apaga
+Útil para evitar apagados durante copias o procesos intensivos.
+=== Carga del sistema ===
+Carga media: Valor basado en load average
+Ejemplos:
+→ carga 0.50
+→ carga 2.20
+Si la carga supera este valor, el sistema se considera activo.
+=== Procesos ===
+Procesos con carga: Procesos que bloquean el apagado si están activos
+Procesos temporales: Procesos que solo se revisan cuando están en ejecución
+Use - para deshabilitar una lista.
+=== Otros checks ===
+Clientes SMB conectados
+Usuarios conectados al sistema
-Permite definir una alarma de inicio mediante el RTC del sistema.
+Tests S.M.A.R.T. activos
-Requiere habilitar Tiempo en funcionamiento.
+Plugins definidos por el usuario
-Hora / Minutos
+==== Plugins definidos por el usuario ====
-Configuración de supervisión
+AutoShutdown permite añadir checks personalizados definidos por el usuario.
-Escaneo de IPs: rango de direcciones IP que se deben revisar para actividad antes de apagar.
+Se describen en: /etc/autoshutdown.default
-IPv4 / IPv6 / FQDN
+Ejemplos:
-Tráfico de red: kB/s promedio de actividad de red para evitar apagar.
+No apagar si existe /tmp/backup.lock
-Carga de disco: kB/s promedio de I/O del HDD.
+No apagar si hay un rsync activo
-Carga media: carga promedio del servidor (ej: 50 = 0.50, 220 = 2.20).
+Integración con scripts externos o contenedores
-Procesos activos: nombres de procesos que evitan el apagado si están en ejecución.
+Esto convierte AutoShutdown en un framework extensible, no solo un plugin básico.
-Procesos temporales: procesos que solo se revisan cuando arrancan.
+==== Syslog y depuración ====
-Estado SMB: revisa si hay clientes conectados.
+Escribir en Syslog: Registra información en los logs del sistema
-S.M.A.R.T. Tests: evita apagar si hay tests activos.
+Modo de información ampliada: Muestra detalles adicionales sobre cada ciclo
-Plugins de usuario: permite añadir verificaciones personalizadas mediante autoshutdown.default.
+Modo prueba/test: No apaga el sistema. Solo informa de qué criterio bloquea el apagado
-Syslog y modos de prueba
+Nota: Muy recomendado durante la configuración inicial
-Registrar información en logs del sistema.
+==== Ejemplos prácticos ====
-Modo de información ampliada y modo prueba/test para depuración.
+=== Servidor de respaldo ===
-Opciones Extras
+Arranque automático: 06:00
-Revisar el archivo de configuración base /etc/autoshutdown.default para ajustes avanzados.
+Ventana de funcionamiento: 06:00 – 08:00
-=== Configuración de arranque automático ===
+Apagado tras 30 min sin actividad
-Habilitar Tiempo en funcionamiento.
+Supervisión de: tráfico de red y carga de disco
-Definir la Hora de inicio y la Alarma de inicio.
+=== NAS doméstico ===
-Esto permite que el servidor se encienda automáticamente a una hora determinada sin intervención manual.
-Verificar compatibilidad de la placa base con la función RTC/Wake-on-RTC.
+Apagado nocturno automático
-=== Ejemplos de uso ===
+No apagar si hay clientes SMB conectados
-Servidor de respaldo
+No apagar si hay usuarios activos
-Apagar si no hay actividad de red ni carga de disco durante 30 minutos.
+==== Limitaciones conocidas ====
-Encender automáticamente a las 06:00 para iniciar backups programados.
+El wake-up RTC depende del hardware
-Servidor doméstico
+En SBC (Raspberry Pi, algunos ARM) puede no funcionar
-Apagar automáticamente por la noche si no hay usuarios conectados.
+Si el sistema no se apaga, no se programa el siguiente arranque
-Activar modo prueba para ajustar correctamente los rangos de IP y procesos supervisados.
+==== Enlaces útiles ====
-=== Notas y recomendaciones ===
+Repositorio del plugin AutoShutdown
-Algunos sistemas pueden requerir activar Wake-on-LAN o funciones RTC en la BIOS.
+Archivo de configuración por defecto (autoshutdown.default)
-Revisar que los rangos de IP excluyan 1 y 255 en IPv4.
+Debian man pages: rtcwake, shutdown, wakeonlan
-Para personalizaciones avanzadas, editar autoshutdown.default y reiniciar el plugin.
+==== Recomendaciones finales ====
-Para depuración, activar el modo test y revisar los registros de syslog.
+Use siempre modo test antes de activar el apagado real
-=== Enlaces útiles ===
+Documente cualquier personalización en autoshutdown.default
-Repositorio GitHub del plugin AutoShutdown
+Para escenarios complejos o críticos, considere usar Scheduled Alarms junto con AutoShutdown
-Archivo de configuración por defecto
-Debian man pages relevantes: rtcwake, wakeonlan, shutdown