# SmartSense Agent

## Introdução

Este manual descreve o procedimento de instalação do **SmartSense Agent**.

## Preparativos para Instalação

Esta seção abrange as etapas essenciais necessárias para a instalação.

{% hint style="warning" %}
Todas as etapas devem ser executadas com privilégios de root em todos os nós, salvo indicação em contrário.
{% endhint %}

Para instalar o SmartSense, você precisará de:

* Permissão de root no servidor
* Arquivo *.rpm* do SmartSense Agent

{% hint style="info" %}
Caso não tenha o arquivo, entre em contato com a equipe de suporte da Griaule.
{% endhint %}

{% hint style="warning" %}
Certifique-se de que a versão do SmartSense Agent que está sendo instalada é compatível com a versão do GBDS instalada.
{% endhint %}

Então, siga os passos apresentados abaixo.

1. Faça login no servidor como root.
2. [Instale o SmartSense Agent](#instalando-o-smartsense-agent).

## Instalando o SmartSense Agent

Transfira ou faça o download do arquivo `.rpm` no servidor.

Entre no diretório onde o arquivo `.rpm` está localizado e execute o comando:

{% hint style="info" %}
Certifique-se de substituir `<versão>` pela versão do SmartSense Agent que está sendo instalada.
{% endhint %}

```bash
rpm -ivh gbs-smartsense-agent-<versão>.rpm
                              ^^^^^^^^
```

Então, edite o arquivo de configuração do SmartSense Agent:

```bash
vim /etc/griaule/conf/gbs-smartsense-agent/application.properties
```

Dê atenção especial às seguintes propriedades, certificando-se de definir corretamente o nome de host, o nome de usuário e a senha do banco de dados onde indicado:

```properties
gbds.rdb.url=jdbc:mysql://<HOSTNAME>:3306/gbds?useSSL=false
                          ^^^^^^^^^^

gbds.rdb.username=<DB-Username>
                  ^^^^^^^^^^^^^

gbds.rdb.password=<DB-Password>
                  ^^^^^^^^^^^^^
```

Finalmente, inicie o SmartSense Agent:

```bash
/var/lib/griaule/gbs-smartsense-agent/scripts/start-smartsense.sh
```

E acompanhe o log de inicialização:

```bash
/var/lib/griaule/gbs-smartsense-agent/scripts/tail-smartsense.sh
```

### Aliases

Aliases são comandos curtos definidos pelo usuário que servem como substitutos para comandos mais longos ou complexos. Eles são criados para tornar os comandos frequentemente utilizados mais convenientes de executar. Quando um alias é invocado, ele é substituído pelo comando completo que representa antes de ser executado.

Para adicionar os aliases do SmartSense Agent, edite o arquivo `.bashrc` raiz:

```sh
vim /root/.bashrc
```

E adicione os seguintes alises:

```bash
alias agentstart='/var/lib/griaule/gbs-smartsense-agent/scripts/start-smartsense.sh'
alias agentstop='/var/lib/griaule/gbs-smartsense-agent/scripts/stop-smartsense.sh'
alias agentstatus='/var/lib/griaule/gbs-smartsense-agent/scripts/smartsense-status.sh'
alias agenthome='cd /var/lib/griaule/gbs-smartsense-agent/'
alias agentlogt='/var/lib/griaule/gbs-smartsense-agent/scripts/tail-smartsense.sh'
alias agentconf='vim /etc/griaule/conf/gbs-smartsense-agent/application.properties'
```


---

# 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.griaule.com/instalacao-do-gbds/smartsenseagent.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.