> For the complete documentation index, see [llms.txt](https://docs.linuxcontrolcenter.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.linuxcontrolcenter.com.br/setup-install.md).

# Setup e Instalação

## Requisitos

Requisitos de Server e Client <https://docs.linuxcontrolcenter.com.br/requirements>\
Licença da versão Community solicitada no link <https://start.linuxcontrolcenter.com.br>

* A licença Community é gratuita e inclui todas as funcionalidades habilitadas, sendo limitada apenas à gestão de até 25 hosts.

Para organizações que demandam suporte a um número maior de dispositivos, recomendamos a aquisição da licença Enterprise. Entre em contato conosco pelo link <https://linuxcontrolcenter.com.br/contato/> para obter mais informações e descobrir como expandir suas operações de forma eficiente e escalável.

## Overview

A instalação do Linux Control Center é feita por meio de um script Bash, toda a instalação será automatizada, sendo necessário realizar apenas a configuração de apenas algumas variáveis.

## Objetivo

Este manual tem como objetivo demonstrar o passo a passo de instalação do LCC por meio do script de instalação.

## Instalação do LCC

### Script de Instalação

{% hint style="warning" %}
**Observação:** Não é necessário instalar previamente nenhum requisito de software. O script de instalação do LCC se encarrega de instalar todas as dependências automaticamente.
{% endhint %}

1. Copie o script abaixo no botão **Copy**.

```
#!/bin/bash
address=""
db_name=""
db_user=""
db_pass=""
redis_pass=""
license_uuid=""
license_password=""
tag_version="stable"

#download lcc-cli

rm -rf lcc-cli-*.tar.gz 2> /dev/null

wget https://download.linuxcontrolcenter.com.br/repository/public/lcc-cli-stable.tar.gz

# untar lcc-cli
tar -xzvf lcc-cli-stable.tar.gz

# make /opt/lcc/bin directory
mkdir -p /opt/lcc/{bin,etc}

# move lcc-cli to /opt/lcc/bin
mv lcc-cli-stable /opt/lcc/bin/lcc-cli

# make lcc-cli executable
chmod +x /opt/lcc/bin/lcc-cli

rm -rf /usr/local/bin/lcc-cli 2> /dev/null

ln -s /opt/lcc/bin/lcc-cli /usr/local/bin/lcc-cli

cat > /opt/lcc/etc/database.yml <<EOF
db_name: ${db_name}
db_user: ${db_user}
db_pass: ${db_pass}

EOF

cat > /opt/lcc/etc/console.yml <<EOF
balancer_url: https://${address}
site_url: https://${address}
node_url: https://${address}
node_sequence: 1
db_name: ${db_name}
db_user: ${db_user}
db_pass: ${db_pass}
db_host: ${address}
db_port: 5432
threads: 10
redis_pass: ${redis_pass}

EOF

cat > /opt/lcc/etc/worker.yml <<EOF
console_url: https://${address}
console_uuid_server: ${license_uuid}
node_url: https://127.0.0.1
work_threads: 10
self_threads: 3

EOF

cat > /opt/lcc/etc/alert_report.yml <<EOF
db_name: ${db_name}
db_user: ${db_user}
db_pass: ${db_pass}
db_host: ${address}
db_port: 5432
redis_pass: ${redis_pass}
threads: 3

EOF

cat > /opt/lcc/etc/license.yml <<EOF
license_uuid: ${license_uuid}
license_password: ${license_password}

EOF

cat > /opt/lcc/etc/version.yml <<EOF
tag_version: $tag_version

EOF

lcc-cli database --install
lcc-cli console --install
lcc-cli worker --install
lcc-cli alert-report --install

exit 0
```

### Configuração do Script de Instalação

1. Acesse o Host em que será feita a instalação do LCC com o usuário root no terminal
2. Crie um arquivo com a extensão .sh com o conteúdo do script.

   Exemplo: `nano script-install.sh`
3. Configure as variáveis conforme as orientações abaixo;

   **address=" "** Domínio(fqdn) ou endereço IPv4 do host que será usado para acesso a console.\
   **db\_name="lcc"** Matenha o nome do banco de dados padrão para melhor manuseio\
   **db\_user=" "** Insira um usuário para o banco de dados\
   **db\_pass=" "** Insira uma senha para o banco de dados\
   **redis\_pass=" "** Insira uma senha para o Redis**license\_uuid=" "** Insira o uuid da licença\
   **license\_password=" "** Insira a senha da licença\
   **tag\_version="stable"** Matenha a tag stable para instalar a versão estável mais recente do LCC<br>
4. Veja o exemplo na imagem abaixo;

   ![](/files/Gjgb5dO5PdZsa7dCvboP)
5. Salve as alterações do script

   Atalho no teclado para salvar (nano): `ctrl + o`

   Atalho no teclado para sair (nano): `ctrl + x`

### Permissões e Execução do Script

1. Adicione permissão de execução para o script com o comando abaixo;

   Comando: `chmod +x script-install.sh`

   ![](/files/rRDqySqBxIeuJkHspnTl)
2. Em seguida, execute o script e escolha o idioma digitando o número correspondente para leitura da EULA.

   Comando: `./script-install.sh`

   ![](/files/ctVpr9FRw6EsBb0N6omZ)
3. Leia a EULA e concorde pressionando **Enter**
4. Confirme o aceite da EULA digitando **yes** e pressionando **Enter** e em seguida digite **y** para iniciar a instalação do LCC.

   ![](/files/eUcdrc30S2uVrgcFYNbn)
5. O terminal ficará disponível quando a instalação estiver concluída.

   ![](/files/7uYGavDX4Y0hdFfqMtIP)

### Primeiro login no LCC

1. Acesse a URL do LCC no seguinte formato;

   https\:// ip-address ou Hostname/console/
2. Insira a credencial padrão e cliqe em **LOG IN**

   * *Usuário: 7dev*
   * *Senha: 7dev*

   ![](/files/X80kUMatkkAWyiGAJvrT)
3. Aceite os Termos de Uso e faça Login

   ![](/files/ky4xLqtbZm0suFxv885q)

### Confiança entre a Console e o Worker

1. Logo após a instalação, é necessário realizar a confiança entre a Console e o Worker para que as de Actions sejam executadas.
2. Clique em **Config**

   ![](/files/4heznfBgQaN8MUrCsjp1)
3. Clique em **Worker**

   ![](/files/mVIENuODC2fcUrtpNU45)
4. Clique em **Actions** e depois em **Trust**

   ![](/files/QkXNUy61jSG8ctit7q7i)
5. Veja que o status ficará **Accepted** indicando que o LCC está pronto para o uso !

   ![](/files/YRa58qw54nwQyPG5A8Gq)