# 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)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.linuxcontrolcenter.com.br/setup-install.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.