hostcontrold

hostcontrold

Daemon de controle do host. Daemon, que monitora outros hosts com solicitações de ping (ICMP) e controla alguns deles com pacotes WOL (Wake on LAN).

Características

O objetivo principal é controlar um/vários hosts Linux (por exemplo, servidor SMB) por algum host do Central Linux. Isso é para economizar energia, fechando os servidores não necessários automaticamente.

O host central onde hostcontrold está em execução monitora não apenas o host para controlar (servidor), mas também os clientes deste servidor. Se um dos hosts cliente configurado for detectado por um ping, o controlador central inicia o host do servidor usando um pacote Magic Wol. Isso permite executar apenas servidores se alguns clientes estiverem em funcionamento. Se todos os clientes desligarem o servidor também será interrompido após um período de tempo limite especificado.

Todos os recursos:

• Essencial:
  • Monitoramento de hosts de cliente/servidor com solicitações de ping ICMP.
  • Todo host que pode ser pingado pode funcionar como cliente (Windows, Linux, OSX).
  • Os servidores são iniciados pelo WOL e desligado via SSH.
  • Somente os hosts do servidor Linux são suportados.
• Integração do sistema:
  • Arquivo JSON único para configurar o daemon.
  • Arquivo de unidade preparada para integração do SystemD.
  • Controle vários servidores com dependências para vários clientes.
• Diretórios de servidores:
  • O estado de cada servidor pode ser observado por arquivos simples em um diretório de controle.
  • Os servidores também podem ser controlados manualmente criando alguns arquivos simples no diretório de controle.

Guia de início rápido

Instalação

• Clone o repositório no seu host Linux Central Control.

• Instale dependências de construção com:

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

• Construir e instalar:

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

Configuração

O arquivo de configuração está localizado em /etc/hostcontrold.conf . Se você iniciar o daemon sem um arquivo de configuração criado, um padrão será gerado. Você pode adicionar mais blocos arbitrários e clientes arbitrários por servidor.

Prepare hosts clientes

• Tornar o hospedeiro pingável.
  • O Linux já deve responder às solicitações do ICMP.
  • No Windows, o firewall deve ser configurado para permitir solicitações de eco ICMP IPv4.

Você pode testar se um host respostas às solicitações do ICMP usando o ping:

 ping 192.168.0.6

Prepare hosts do servidor

• Deixe iniciar o pacote WOL.
  • Configure o BIOS/UEFI e, se necessário, o sistema operacional.
  • Verifique se a placa de rede possui fornecimento de energia em espera.
  • O WOL funciona apenas quando o host foi inicializado pelo menos uma vez após a perda completa de energia.
• Permitir que o host de controle central desligar o host do servidor.
  • O host de controle precisa ser capaz de SSH para o host do servidor sem usar uma senha. Portanto, o usuário que executa o aplicativo precisa de uma tecla SSH correta para conectar o host do servidor.
  • Verifique se o usuário usado está configurado corretamente no host do servidor.
  • O usuário precisa ser capaz de chamar sudo. Isso é usado para chamar o comando de desligamento.

Um exemplo de comandos que o usuário do aplicativo poderia usar para preparar um host do servidor onde o clang do usuário deve ser usado para fazer login via SSH:

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

Você pode testar se está tudo bem se o comando a seguir funcionar sem qualquer entrada do usuário:

 ssh [email protected]

Inicie o daemon

Informe o Systemd o novo daemon, ative o AutoStart na inicialização do sistema e inicie o daemon.

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

Use sudo systemctl restart hostcontrold após alterar a configuração.

Para visualizar o registro do uso de daemon:

 journalctl -e -u hostcontrold

Uso / Diretório de Controle

Após a instalação e inicialização, o daemon será executado e monitorará todos os hosts configurados constantemente. Você pode ver o estado de um host de servidor visualizado pelo arquivo on / off no Director de Controle Configurado. Ao criar arquivos simples no diretório, você pode forçar algum comportamento específico:

Nome do arquivo	contente	recurso
force_on	vazio	manterá o servidor ligado
force_off	vazio	manterá o servidor desligado

Desenvolvimento

Consulte as etapas Installation na seção Quick start guide para obter informações sobre como criar.

O código em si é organizado como um projeto puro de cmake com código C ++ 14. O IDE preferido para trabalhar no código é Clion.

Docker

Todas as etapas de desenvolvimento também podem ser feitas no recipiente preparado do Docker. Eles são usados principalmente para construir e testar o código com o fluxo de trabalho de ação do GitHub em diferentes distribuições/cadeias de ferramentas, mas também pode ser usado para o desenvolvimento local. O Ubuntu com GCC é usado por padrão.

 # 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

Teste de unidade

Para testes de unidade, a estrutura googletest é usada. Isso é instalado automaticamente nos recipientes do Docker. Para instalar diretamente no host, o script fornecido pode ser usado.

 sudo development/install_gtest.sh

O binário de teste de unidade é criado pelo CMake Target hostcontrold_test . Para executar o teste, execute diretamente o binário hostcontrold/unittest/hostcontrold_test ou construa o test de destino cmake que usa a estrutura ctest .

Características futuras

• Estenda o tempo limite de desligamento por arquivo em diretório de controle.
• Automatize a instalação de dependências de construção. Talvez use Conan ou Ansible.
• Usuário que executou o comando Shutdown pode não precisar de sudo . Deixe configurar isso.
• Talvez permita configurar todo o comando de desligamento. Isso permitiria usar servidores não-Linux. E algum manuseio especial de desligamento pode ser executado.

Licença

Mit

Versão

Não existe números de versão, liberações, tags ou ramificações. O mestre deve ser considerado a versão estável atual. Todos os outros ramos existentes são ramos de características/desenvolvimento e são considerados instáveis.

Informações do autor

Christian Lang [email protected]