Instalação - SaltStack

Escrito por HIT

Pré-requisitos

É necessário que haja comunicação com as portas e DNS identificados abaixo.

·        DNS: s.hit.com.vc

·        IP: 177.190.194.170

·        Portas TCP: 50506, 50505, 40506, 40505


Instalação via Script

Para realizar a instalação automática, siga os passos baixo.

Passo 1: Faça o download do script

# sudo wget -P /tmp https://app.hit.com.vc/automacao/saltinstallv2.sh --no-check-certificate && sudo chmod +x /tmp/saltinstallv2.sh

Passo 2: Execute o script

# sudo sh /tmp/saltinstallv2.sh


Validação da instalação via Script

Verifique o “id” do Minion

Execute o comando

# cat /etc/salt/minion



Para consultar o nome exato do id do Minion, basta verificar a URL na barra de navegação.

Imagem de exemplo:



Verifique os logs.

Caminho do Log do script:

# sudo cat /tmp/saltlog.txt

A saída do comando deverá ser como a esperada em:



Caminho do Log do serviço:

# tail -f /var/log/salt/minion

A saída do comando deverá ser como a esperada em:

Mensagem do log: “Minion received a SIGTERM. Exiting”.



A mensagem do log acima significa um sucesso na instalação e comunicação do serviço.


Correção de erros

Valide o log

# tail -f /var/log/salt/minion


Caso 1:

Se encontrar o erro “The Salt Master has cached the public key for this note”, siga os passos abaixo



Solução:

Para resolver esse problema, remova a chave anterior, executando o comando abaixo:

# sudo rm -f /etc/salt/pki/minion/minion_master.pub

Após remover, reinicie o serviço:

# sudo salt-minion restart

Verifique novamente o log:

# tail -f /var/log/salt/minion

Se tudo der certo, você verá a seguinte mensagem: “Minion received a SIGTERM. Exiting”.


Caso 2:

Se encontrar um erro diferente, valide as comunicações (consulte o item Pré-Requisitos).

Validações de Network (pré-requisitos):

telnet s.hit.com.vc 50505

telnet s.hit.com.vc 50506




Instalação Manual

Para realizar a instalação de forma manual, siga os passos abaixo.

Obs: a instalação manual é necessária apenas nos casos em que houver erro na instalação via script.

Passo 1: Verifique a distribuição do Linux.

# cat /etc/*-release

Exemplo:



Passo 2: Com base no retorno do comando acima (obtém a distribuição), execute os comandos abaixo. Veja que no exemplo abaixo, estamos adicionando o repositório do CentOS 7.

Para localizar demais repositórios, basta acessar a URL: https://repo.saltproject.io/py3/redhat/

Após realizar o acesso, basta selecionar a versão desejada da distribuição Linux. Utilize a versão 3005 da aplicação Salt.

Exemplo:

# sudo rpm --import https://repo.saltproject.io/py3/redhat/7/x86_64/3005/SALTSTACK-GPG-KEY.pub

# curl -fsSL https://repo.saltproject.io/py3/redhat/7/x86_64/3005.repo | sudo tee /etc/yum.repos.d/salt.repo

Passo 3: Execute os comandos abaixo, para realizar a instalação.

# sudo yum clean expire-cache -y

# sudo yum install salt-master -y

# sudo yum install salt-minion -y

Passo 4: Habilite os serviços

# sudo systemctl enable salt-master && sudo systemctl start salt-master

# sudo systemctl enable salt-minion && sudo systemctl start salt-minion

Passo 5: Configure o serviço Master

# vi /etc/salt/master:

interface: IP_DO_PROXY

master_port: 40506

publish_port: 40505

Obs: substitua o texto “IP_DO_PROXY”, pelo IP interno do proxy.

Passo 6: Configure o serviço Minion

# vi /etc/salt/minion:

id: ORGCODE

master: s.hit.com.vc

master_port: 50506

publish_port: 50505

Obs: substitua o texto “ORGCODE” pelo nome da Organização.

Exemplo:

id: VisualSystemsService

Importante: o id deverá ser exatamente igual ao PSK identity configurado no Zabbix Proxy e também na interface do Zabbix.

Para consultar o nome exato do id do Minion, basta verificar a URL de navegação do portal do HIT.

Imagem de exemplo:



Passo 7: Reinicie os serviços

# service salt-master restart

# service salt-minion restart


?Passo 8: Valide a instalação