Sistema de Reinicialização Unix

• Tipo de Tarefa: ssh_rebootsystem

Descrição

A Tarefa Unix Reboot System permite executar o reinício do sistema operativo numa máquina local (modo Padrão) ou num servidor remoto através de SSH, enviando um comando de reinicialização.

É utilizada para automatizar tarefas de manutenção, aplicar atualizações que exijam reinicialização ou restaurar o sistema de forma controlada.

Configuração

A configuração define o modo de execução (local ou remoto), os parâmetros de reinicialização e a eventual mensagem de notificação para os utilizadores. Os campos de configuração da Tarefa podem ser preenchidos manualmente ou através de parâmetros e variáveis do fluxo de trabalho.

Conexão ao Servidor

• Modo de conexão: define a origem das credenciais e o tipo de execução. Pode assumir três modos operacionais:
• Padrão: Os comandos são executados na máquina local, sem conexão SSH.
• Manual: Permite o preenchimento manual dos parâmetros de conexão SSH.
• Ambiente: Utiliza um ambiente de conexão pré-configurado. Neste modo, é exibido um menu que lista as conexões disponíveis com base no papel associado ao Workflow.
• Endereço IP: Endereço IP do servidor remoto.
• Hostname: Nome de host do servidor remoto.
• Utilizador: Nome de utilizador usado para estabelecer a conexão SSH.
• Palavra-passe: Palavra-passe associada ao utilizador de conexão.
• Porta: Porta utilizada para a conexão SSH (o valor padrão é 22).

Executar comando como outro utilizador

Ao ativar esta caixa de seleção, é possível executar a pesquisa com um utilizador diferente daquele usado para a conexão SSH.

• Utilizador: Nome do utilizador com quem o comando será executado.
• Palavra-passe: Palavra-passe do utilizador usado para a execução do comando.

Detalhes da Reinicialização

• Timeout (Minutos): Especifica quantos minutos após a execução da Tarefa o servidor será efetivamente reiniciado. Este não é um timeout de conexão, mas sim o tempo de espera antes da reinicialização.
• Mensagem: A mensagem de notificação que será enviada a todos os utilizadores atualmente conectados ao servidor através do terminal para os avisar da iminente reinicialização.

Parâmetros de Saída

Ao final da pesquisa, a Tarefa expõe os seguintes parâmetros de saída:

• result: Contém uma mensagem de texto que descreve o resultado da operação ou uma mensagem de erro (ex: “Missing server address”).
• resultJson: Representa o resultado da execução da tarefa em formato JSON, incluindo informações gerais, configurações e detalhes da execução.
• exitStatus: Retorna o código de saída do comando de reinicialização. Um valor de 0 indica que o comando foi agendado com sucesso.

Exemplo de parâmetro resultJson

{
  "run_info": {
    "status": "Completed",
    "run_result": "Success"
  },
  "output_parameters": {
    "exitStatus": "0"
  }
}

Notas Importantes

A tarefa estabelece uma conexão SSH com o servidor remoto e executa o comando de reinicialização do servidor conforme configurado. Se for utilizada autenticação por chaves SSH, é necessário que a chave pública esteja registada no servidor remoto. Se a opção "Executar comando como outro utilizador" estiver ativada, o comando será executado com um utilizador diferente da conexão SSH principal.