CouchDB - Instalação

Este capítulo ensina como instalar o CouchDB em sistemas Windows e Linux.

Instalando CouchDB no Windows

Baixar CouchDB

O site oficial do CouchDB é https://couchdb.apache.org. Se você clicar no link fornecido, poderá obter a página inicial do site oficial do CouchDB conforme mostrado abaixo.

Se você clicar no botão de download, isso levará a uma página onde são fornecidos links de download do CouchDB em vários formatos. O instantâneo a seguir ilustra o mesmo.

Escolha o link de download para sistemas Windows e selecione um dos mirrors fornecidos para iniciar o download.

Instalando CouchDB

O CouchDB será baixado para o seu sistema na forma de arquivo de configuração denominado setup-couchdb-1.6.1_R16B02.exe. Execute o arquivo de instalação e prossiga com a instalação.

Após a instalação, abra a interface da web integrada do CouchDB visitando o seguinte link: http://127.0.0.1:5984/. Se tudo correr bem, você verá uma página da web com a seguinte saída.

{
   "couchdb":"Welcome","uuid":"c8d48ac61bb497f4692b346e0f400d60",
   "version":"1.6.1",
   "vendor":{
      "version":"1.6.1","name":"The Apache Software Foundation"
   }
}

Você pode interagir com a interface da web do CouchDB usando o seguinte url -

http://127.0.0.1:5984/_utils/

Isso mostra a página de índice do Futon, que é a interface da web do CouchDB.

Instalando o CouchDB em sistemas Linux

Para muitos dos sistemas com sabor do Linux, eles fornecem o CouchDB internamente. Para instalar este CouchDB, siga as instruções.

No Ubuntu e Debian, você pode usar -

sudo aptitude install couchdb

No Gentoo Linux, há um ebuild do CouchDB disponível -

sudo emerge couchdb

Se o seu sistema Linux não tiver CouchDB, siga a próxima seção para instalar o CouchDB e suas dependências.

Instalando dependências do CouchDB

A seguir está a lista de dependências que devem ser instaladas para obter o CouchDB em seu sistema−

  • Erlang OTP
  • ICU
  • OpenSSL
  • Mozilla SpiderMonkey
  • GNU Make
  • Coleção de compiladores GNU
  • libcurl
  • help2man
  • Python para documentos
  • Esfinge Python

Para instalar essas dependências, digite os seguintes comandos no terminal. Aqui estamos usando o Centos 6.5 e os seguintes comandos irão instalar os softwares necessários compatíveis com o Centos 6.5.

$sudo yum install autoconf
$sudo yum install autoconf-archive
$sudo yum install automake
$sudo yum install curl-devel
$sudo yum install erlang-asn1
$sudo yum install erlang-erts
$sudo yum install erlang-eunit
$sudo yum install erlang-os_mon
$sudo yum install erlang-xmerl
$sudo yum install help2man
$sudo yum install js-devel
$sudo yum install libicu-devel
$sudo yum install libtool
$sudo yum install perl-Test-Harness

Note −Para todos esses comandos, você precisa usar o sudo. O procedimento a seguir converte um usuário normal em um sudoer.

  • Faça login como root no usuário administrador

  • Abrir sudo arquivo usando o seguinte comando -

visudo
  • Em seguida, edite como mostrado abaixo para dar ao seu usuário existente os privilégios sudoer -
Hadoop All=(All) All , and press esc : x to write the changes to the file.

Depois de fazer download de todas as dependências em seu sistema, faça download do CouchDB seguindo as instruções fornecidas.

Baixando CouchDB

O Apache software Foundation não fornecerá o arquivo .tar completo para CouchDB, então você deve instalá-lo a partir da fonte.

Crie um novo diretório para instalar o CouchDB, navegue até esse diretório criado e baixe o código-fonte do CouchDB executando os seguintes comandos -

$ cd
$ mkdir CouchDB
$ cd CouchDB/
$ wget
http://www.google.com/url?q=http%3A%2F%2Fwww.apache.org%2Fdist%2Fcouchdb%2Fsource%2F1.6.1%2Fapache-couchdb-1.6.1.tar.gz

Isso fará o download do arquivo de origem CouchDB em seu sistema. Agora descompacte oapache-couchdb-1.6.1.tar.gz como mostrado abaixo.

$ tar zxvf apache-couchdb-1.6.1.tar.gz

Configurando CouchDB

Para configurar o CouchDB, faça o seguinte -

  • Navegue até a pasta inicial do CouchDB.
  • Faça login como superusuário.
  • Configure usando o prompt ./configure conforme mostrado abaixo -
$ cd apache-couchdb-1.6.1
$ su
Password:
# ./configure --with-erlang=/usr/lib64/erlang/usr/include/

Ele fornece a seguinte saída semelhante à mostrada abaixo com uma linha de conclusão dizendo - You have configured Apache CouchDB, time to relax.

# ./configure --with-erlang=/usr/lib64/erlang/usr/include/

checking for a BSD-compatible install... /usr/bin/install -c
checking whether build environment is sane... yes
checking for a thread-safe mkdir -p... /bin/mkdir -p
checking for gawk... gawk
checking whether make sets $(MAKE)... yes
checking how to create a ustar tar archive... gnutar
………………………………………………………..
……………………….
config.status: creating var/Makefile
config.status: creating config.h
config.status: config.h is unchanged
config.status: creating src/snappy/google-snappy/config.h
config.status: src/snappy/google-snappy/config.h is unchanged
config.status: executing depfiles commands
config.status: executing libtool commands

You have configured Apache CouchDB, time to relax.

Run `make && sudo make install' to install.

Instalando CouchDB

Agora digite o seguinte comando para instalar o CouchDB em seu sistema.

# make && sudo make install

Ele instala o CouchDB em seu sistema com uma linha de conclusão dizendo - You have installed Apache CouchDB, time to relax.

Iniciando CouchDB

Para iniciar o CouchDB, navegue até a pasta inicial do CouchDB e use o seguinte comando -

$ cd apache-couchdb-1.6.1
$ cd etc
$ couchdb start

Ele inicia o CouchDB fornecendo a seguinte saída: -

Apache CouchDB 1.6.1 (LogLevel=info) is starting.
Apache CouchDB has started. Time to relax.
[info] [lt;0.31.0gt;] Apache CouchDB has started on http://127.0.0.1:5984/
[info] [lt;0.112.0gt;] 127.0.0.1 - - GET / 200
[info] [lt;0.112.0gt;] 127.0.0.1 - - GET /favicon.ico 200

Verificação

Como o CouchDB é uma interface da web, tente digitar o seguinte url da página inicial no navegador.

http://127.0.0.1:5984/

Ele produz a seguinte saída -

{
   "couchdb":"Welcome",
   "uuid":"8f0d59acd0e179f5e9f0075fa1f5e804",
   "version":"1.6.1",
   "vendor":{
      "name":"The Apache Software Foundation",
      "version":"1.6.1"
   }
}