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"
   }
}