DOCUMENTAÇÃO

1.Instalação #

1.1.Pré-requisitos #

É possível você ter o Gaio rodando em alguns minutos, mas para isso é preciso ter alguns programas instalados na máquina onde o Gaio irá rodar.

Oracle VirtualBox (usuários Windows e Mac).

O Gaio foi desenvolvido para funcionar em máquinas Linux, contudo é possível usa-lo em outros sistemas operacional usando uma máquina virtual Linux. O Oracle VirtualBox faz exatamente isso, ele cria uma máquina virtual Linux dentro da sua máquina, seja ela Windows ou Mac.

Docker ToolBox

Após a instalação do Oracle VirtualBox, você precisa instalar o Docker ToolBox, pois o download da imagem Gaio é feito através do Docker. Nesse box vêm o Kitematic, ferramenta que permite a instalação visual do Gaio, caso você prefira usar esse meio ao invés de usar linhas de comando (falaremos a seguir).

Yes No

1.2.Processo de Instalação #

Dentro do Kitematic você precisa seguir os seguintes passos:

Fase 1 Gaio

  • Abrir o Kitematic
  • Clique em New
  • Busque por Gaio e clique em create
  • Clique em Settings
  • Clique em Ports
  • Definir porta de origem 30009 e destino 30009 e clique em SAVE
  • Clique em start.

Fase 2 (MySQL)

  • No Kitematic, Busque por MySQL e clique em create
  • Clique em Settings
  • Criar variável de ambiente MYSQL_ROOT_PASSWORD
  • Defina um valor para essa variável, que será a senha do usuário ROOT do MySQL e clique em SAVE

Linhas de Comando

Você também pode escolher instalar o Gaio através de linhas de comando.

docker pull gaioplatform/gaio

Agora, crie o container do Gaio com a imagem abaixo:

docker run -p 30009:30009 --name gaio gaioplatform/gaio

 

Pontos de Atenção

  • Firewall: avalie se está bloqueando o acesso, assim como o Antivirus
  • Permissões: verifique se o usuário MySQL escolhido tem acesso de qualquer máquina ( host: % )
  • Privileges: verifique se o usuário utilizado no MySQL privilégios totais
  • Atualização: verifique se a versão do Gaio instalada é a v0.8.6. Caso contrário baixe novamente a imagem e rode novo container do Gaio via Docker
Caso ainda não consiga acessar o banco de dados, uma alternativa é instalar um container docker com o MySQL. Isso pode ser feito através da interface visual do Kitematic. Após instalado, defina uma variável de ambiente no Kitematic como MYSQL_ROOT_PASSWORD que receberá uma senha definida por você (Settings).

A plataforma Gaio é completamente administrada e acessada pelo navegador (apenas Chrome). Nesse ponto, você já pode acessar o Gaio pelo navegador, usando o IP da sua máquina e a porta determinada pelo Docker (eg. 192.168.0.1:30009). Para ver a porta, digite docker ps.

Agora é a hora de configurar o Gaio para a sua organização:

Para que os dados sejam armazenados de forma permanente, é necessário definir um servidor MySQL para armazenar a estrutura do Gaio e um outro servidor MySQL para armazenar todos os dados que os usuários irão trazer para o Gaio, provenientes de diversas fontes de dados para construirem análises e dashboards. Pode ser somente um servidor para ambos objetivos.

O Gaio cria um banco de dados com tabelas necessárias para o seu funcionamento. Ao mesmo tempo, ele necessita de um servidor para criar alto volume de bancos de dados, a medida que os usuários constroem aplicações analíticas.

Finalmente, cadastre o primeiro usuário e opcionalmente defina uma chave secreta (secret key) para que o token de autenticação seja único para sua empresa.

Para ver os dashboards em ação, depois de realizar o login, acesse o ambiente Portal.

Yes No