Instalando e configurando ArangoDB

03/02/2016

Fala, galera. Dando prosseguimento a série de artigos sobre o arangoDB, hoje falarei sobre o processo de instalação e configuração. Segue aí!

Atualmente o arangodb está na versão estável 2.8. Apesar de eu trabalhar com macBook, nesse artigo utilizarei um ambiente com servidor ubuntu 12.04. Há algum tempo utilizo o vagrant para gerenciar máquinas virtuais com as mesmas configurações dos servidores em produção. Se você ainda não conhece, nem usa o vagrant, encorajo fortemente (ou o docker. Falaremos mais sobre isso em outra oportunidade).

Na página de download do arangodb há uma lista de ambientes suportados. Nele encontramos pacotes para diversas distros, executável do windows, macOs e instruções para pacote de instalação pronta para o amazon aws e windows azure.

Em meu caso, instalei através do gerenciador de pacotes do ubuntu. O primeiro passo é adicionar a chave do pacote no apt:

1
2
wget https://www.arangodb.com/repositories/arangodb2/xUbuntu_12.04/Release.key
apt-key add - < Release.key

Agora vamos adicionar o endereço do repositório:

1
echo 'deb https://www.arangodb.com/repositories/arangodb2/xUbuntu_12.04/ /' | sudo tee /etc/apt/sources.list.d/arangodb.list

Instale uma dependência:

1
sudo apt-get install apt-transport-https

Atualize e instale:

1
2
sudo apt-get update 
sudo apt-get install arangodb=2.8.1

Você pode especificar a versão que deseja instalar. Do contrário, ele instalará a última versão estável.

Pronto! O banco está devidamente instalado na porta 8529. Agora iremos realizar algumas configurações básicas.

Configurações básicas

Por padrão, o arangodb vem configurado para acesso apenas local. Assim, precisaremos editar o endpoint no arquivo de configuração para que possamos acessar a interface administrativa ou o banco remotamente. Utilize algum editor (estou usando o nano):

1
sudo nano /etc/arangodb/arangod.conf

Localize o atributo endpoint e altere para:

1
endpoint = tcp://0.0.0.0:8529

Reinicie o banco (sudo service arangodb restart) e acesse http://localhost:8529

Arangodb Web Interface

ArangoDB Web Interface

Dica: Lembre de verificar se há algum firewall ativo e então liberar a porta.

Perceba que ao acessar a interface não foi exigido nenhuma senha. Entretanto, podemos configurar para que o seja necessário autenticação. Edite novamente o arquivo arangod.conf e atualize o atributo abaixo:

1
disable-authentication = no

Reinicie novamente. Agora ao acessar a web interface será solicitado autenticação:

Agora entre com username root e senha vazia. Após logado, você pode acessar a página User Profile e trocar a senha.

Enjoy! Bem simples tanto a instalação, como a configuração. No próximo artigo falarei sobre os drivers e mostrarei alguns exemplos com php.

Mais: Installing ArangoDB (inglês)