hostcontrold

hostcontrold

Daemon de control del host. Daemon que monitorea a otros hosts con solicitudes de ping (ICMP) y controla algunos de ellos con paquetes Wol (Wake On LAN).

Características

El objetivo principal es controlar uno/múltiples hosts de Linux (por ejemplo, servidor SMB) por algún host de Linux Central. Esto es para ahorrar energía al cerrar los servidores no necesarios automáticamente.

El host central donde hostcontrold se ejecuta monitorea no solo el host para controlar (servidor) sino también los clientes de este servidor. Si uno de los hosts de cliente configurados es detectado por un ping, el controlador central inicia el host del servidor utilizando un paquete Magic Wol. Esto solo permite ejecutar servidores si algunos clientes están en funcionamiento. Si todos los clientes apagan, el servidor también cerrará después de un período de tiempo de espera especificado.

Todas las características:

• Centro:
  • Monitoreo de hosts de cliente/servidor con solicitudes de ping ICMP.
  • Cada host que se puede hacer ping puede funcionar como un cliente (Windows, Linux, OSX).
  • Los servidores son iniciados por WOL y apagado a través de SSH.
  • Solo son compatibles con los hosts del servidor de Linux.
• Integración del sistema:
  • Archivo JSON único para configurar el demonio.
  • Archivo de unidad preparado para la integración de Systemd.
  • Controle múltiples servidores con dependencias a múltiples clientes.
• Directorios de servidor:
  • El estado de cada servidor se puede observar mediante archivos simples en un directorio de control.
  • Los servidores también se pueden controlar manualmente creando algunos archivos simples en el control-directorio.

Guía de inicio rápido

Instalación

• Clone el repositorio en su host de Linux de control central.

• Instale dependencias de compilación con:

   sudo apt install make cmake g++ pkg-config libtool
  

• Construir e instalar:

   cd hostcontrold && mkdir build && cd build
  cmake ..
  sudo make -j4 install
  

Configuración

El archivo de configuración se encuentra en /etc/hostcontrold.conf . Si inicia el demonio sin un archivo de configuración creado, se generará un predeterminado. Puede agregar más bloques de servidor arbitrarios y clientes arbitrarios por servidor.

Prepare los hosts del cliente

• Haga que el anfitrión sea pingable.
  • Linux ya debería responder a las solicitudes ICMP.
  • En Windows, el firewall debe configurarse para permitir solicitudes entrantes de eco IPv4 ICMP.

Puede probar si un host responde a las solicitudes ICMP usando ping:

 ping 192.168.0.6

Preparar hosts del servidor

• Deje iniciar desde el paquete WOL.
  • Configure BIOS/UEFI y si es necesario el sistema operativo.
  • Asegúrese de que la tarjeta de red tenga suministro de potencia de espera.
  • WOL funciona solo cuando el host se inició al menos una vez después de la pérdida de energía completa.
• Permita que el host del host de control central al host del servidor de cierre.
  • Control Host debe poder SSH al host del servidor sin usar una contraseña. Por lo tanto, el usuario que ejecuta la aplicación necesita una clave SSH correcta para conectar el host del servidor.
  • Asegúrese de que el usuario usado esté configurado correctamente en el host del servidor.
  • El usuario debe poder llamar a sudo. Esto se usa para llamar al comando de cierre.

Un ejemplo de comandos que el usuario de la aplicación podría usar para preparar un host del servidor donde el clang del usuario debe usarse para iniciar sesión a través de SSH:

 ssh-keygen
ssh-copy-id [email protected]

Puede probar si todo está bien si el siguiente comando funciona sin ninguna entrada del usuario:

 ssh [email protected]

Inicio Daemon

Deje que Systemd conozca el nuevo demonio, habilite AutoStart en el inicio del sistema e inicie el demonio.

 sudo systemctl daemon-reload
sudo systemctl enable hostcontrold
sudo systemctl start hostcontrold

Use sudo systemctl restart hostcontrold después de cambiar la configuración.

Para ver el registro del uso del demonio:

 journalctl -e -u hostcontrold

Uso / directorio de control

Después de la instalación y el inicio, el demonio ejecutará y monitoreará todos los hosts configurados constantemente. Puede ver el estado de un host del servidor visualizado por el archivo de on / off en el directorio de control configurado. Al crear archivos simples en el directorio, puede forzar algún comportamiento específico:

Nombre del archivo	contenido	característica
force_on	vacío	mantendrá el servidor encendido
force_off	vacío	mantendrá el servidor apagado

Desarrollo

Consulte los pasos Installation en la sección Quick start guide para obtener información sobre cómo construir.

El código en sí está organizado como el proyecto CMake puro con código C ++ 14. El IDE preferido para trabajar en el código es Clion.

Estibador

Todos los pasos de desarrollo también se pueden hacer en el contenedor de Docker preparado. Esos se utilizan principalmente para construir y probar el código con el flujo de trabajo de acción GitHub en diferentes distribuciones/cadenas de herramientas, pero también se puede utilizar para el desarrollo local. Ubuntu con GCC se usa de forma predeterminada.

 # Build the docker image.
./development/1_create.sh

# Create docker container and run it with the correct mounted volumes.
./development/2_run.sh

# Connect into the container.
./development/3_connect.sh

# Now you are logged-in the docker container.

cd /tmp/hostcontrold/

# Now you are in the source directory where you can compile and run tests e.g.
mkdir build
cd build
cmake ..
make -j4

# Leave the container with the following command when you are finished developing/testing.
exit

# Remove all signs of the docker container.
./development/5_remove.sh

Prueba unitaria

Para las pruebas unitarias se utiliza el marco googletest . Esto se instala automáticamente en los contenedores Docker. Para instalar directamente en el host se puede usar el script proporcionado.

 sudo development/install_gtest.sh

El binario de prueba unitario es creado por el objetivo CMAKE hostcontrold_test . Para ejecutar la prueba, ejecute directamente el binario hostcontrold/unittest/hostcontrold_test o cree la test de destino CMake que usa el marco ctest .

Características futuras

• Extienda el tiempo de espera de cierre por archivo en control-directory.
• Automatizar la instalación de dependencias de compilación. Tal vez use Conan o Ansible.
• El usuario que ejecutó el comando de cierre puede no necesitar sudo . Dejar configurar esto.
• Tal vez permita configurar el comando de cierre completo. Esto permitiría usar servidores no linux. Y se podría ejecutar un manejo especial de cierre.

Licencia

MIT

Versiones

No existe números de versión, lanzamientos, etiquetas o ramas. El maestro debe considerarse la liberación estable actual. Todas las demás ramas existentes son ramas de características/desarrollo y se consideran inestables.

Información del autor

Christian Lang [email protected]