Dúvida
Como instalar e configurar o CouchDB.
Ambiente
PEP 2.0.
Solução
- Sobre o CouchDB
Apache CouchDB, comumente referido como CouchDB, é um banco de dados de código-aberto que foca na facilidade de uso e na filosofia de ser "um banco de dados que abrange a Web". É um banco de dados não-relacional (NoSQL) que usa JSON para armazenar os dados, JavaScript como sua linguagem de consulta usando o MapReduce, e HTTP como API. Uma de suas características marcantes é a facilidade na replicação. CouchDB foi lançado em 2005, e em 2008 tornou-se um projeto da Apache Software Foundation.
Ao contrário de um banco de dados relacional, o CouchDB não armazena os dados e relacionamentos em tabelas. Cada banco de dados é uma coleção de documentos independentes, e cada documento mantém seus próprios dados e esquemas. Uma aplicação pode acessar vários bancos de dados, por exemplo, no smartphone do usuário e outro em um servidor. Os metadados do documento contém informações de revisão, possibilitando mesclar quaisquer diferenças que possam ter ocorrido enquanto os bancos de dados estavam desconectados.
CouchDB implementa uma forma de Controle de concorrência multiversão (MVCC), a fim de evitar a necessidade de travar o arquivo de banco de dados durante as gravações. Os conflitos são deixados para a aplicação de resolver. Resolver um conflito geralmente envolve primeira mesclagem de dados em um dos documentos, apagando o antigo.
Outras características são a semântica ACID com consistência eventual, MapReduce, replicação incremental e tolerância a falhas. A administração é suportada com uma aplicação web embutida chamado Futon.
- Instalação
Para a instalação do banco de dados CouchDB, seguir as instruções abaixo:
1. Instale o executável "setup-couchdb-1.5.1_R16B02.exe".
2. Instale como SERVIÇO WINDOWS.
3. Defina o "Tipo de inicialização" como automático.
3. Teste o acesso no endereço local: http://localhost:5984/
A resposta deve ser parecida com:
{"couchdb": "Welcome", "uuid": "###########", "version": "1.5.1", "vendor":{ "name": "The Apache Software Foundation", "version": "1.5.1" }}
Para mais informações, consulte: http://docs.couchdb.org/en/1.5.1/install/windows.html
- Configuração
1. Crie o usuário administrador: Acessar o endereço "http://localhost:5984/_utils/" (preferencialmente o navegador Chrome ou Mozilla Firefox). Admin Party FIX (à direita do rodapé): criar o usuário "admin" e a senha "totvs".
- Corrigir a limitação de acesso:
1. Acesse o endereço "http://localhost:5984/_utils/" e logar como "admin".
2. Menu TOOLS > CONFIGURATION.
3. Chave "bind_address" deve ter o valor -> 0.0.0.0.
Com essa alteração o serviço fica acessível pela rede.
- Corrigir a limitação de MAP/REDUCE
1. Acesse o endereço http://localhost:5984/_utils/ e logar como admin.
2. Menu TOOLS > CONFIGURATION.
3. Chave "reduce_limit" deve ter o valor -> false.
- Ativar a compactação de Databases e Views (importante)
1. Acessar o endereço http://localhost:5984/_utils/ e logar como admin.
2. Menu TOOLS -> CONFIGURATION.
3. Criar nova chave usando o menu "Add a new section".
section -> compactions
option -> _default
value = [{db_fragmentation, "70%"}, {view_fragmentation, "60%"}, {from, "01:00"}, {to, "05:00"}]
- Criação do DATABASE
As seguintes databases devem ser criadas no CouchDB:
- totvs_formbuilder_model_datasourcemodel
- totvs_formbuilder_model_formbuildermodel
- totvs_formbuilder_model_formfinishedmodel
- totvs_formbuilder_model_formresponsemodel
- totvs_formbuilder_model_metadatamodel
Para criar as databases, seguir o processo abaixo:
1. Acessar o endereço http://localhost:5984/_utils/ e logar como admin.
2. Menu CREATE DATABASE.
Importante: lembrando que todas as databases citadas acima devem ser criadas.
- CouchDB Replication
A replicação (replication) é um mecanismo que permite que diversas instâncias de CouchDB se mantenham SINCRONIZADAS. Dessa forma, é possível fazer com que as instâncias sincronizadas sejam conectadas a um serviço de Load Balance, para aumentar a disponibilidade do banco de dados (além de contar com backup em tempo real).
Banco de dados {}replicator_
Quando instalado, o CouchDB já cria uma database chamada {}replicator{_}.
É nesse banco de dados que são configuradas as instruções de sincronização.
Cada instrução de sincronização deve ser registrada como um novo DOCUMENTO (para criar documentos, deve logar como admin, acessar a database {}replicator_ e depois o menu NEW DOCUMENT).
Em cada instrução de sincronização é especificada apenas 1 database + 1 servidor de origem + 1 servidor destino.
O documento deve conter os campos abaixo:
_id: é o identificador do registro (para melhor controle, colocar nome da database + servidor origem + servidor destino).
source: é o nome da database local que será sincronizada.
target: é o endereço completo da database no servidor destino. Deve conter o usuário, senha, endereço do HOST destino, porta e nome da database (o mesmo nome da database local)
create_target: caso a database ainda não exista no servidor destino, será criada automaticamente (sempre conterá o valor true)
continuous: indica que a sincronização é contínua. Caso o serviço seja interrompido, a sincronização é retomada assim que o serviço estiver disponível novamente (sempre conterá o valor true)
Assim que o documento é salvo, a sincronização definida nele já é iniciada automaticamente.
Importante: cada instrução é unidirecional. Isto é: somente sincroniza registros da ORIGEM para o DESTINO especificado no documento. Para sincronização BIDIRECIONAL, deve também ser criado um documento no banco de dados {}replicator_ do servidor DESTINO que define a instrução de sincronização para o servidor ORIGEM.
Caso haja mais de 2 servidores, as instruções devem ser registradas em todos.
Databases que devem ser sincronizadas
As databases que devem ser sincronizadas para o correto funcionamento do TOTVS.FormBuilder são as seguintes:
totvs_formbuilder_model_datasourcemodel
totvs_formbuilder_model_formbuildermodel
totvs_formbuilder_model_formfinishedmodel
totvs_formbuilder_model_formresponsemodel
totvs_formbuilder_model_metadatamodel
Exemplo de sincronização entre 3 servidores
Num cenário de alta disponibilidade, com 3 instâncias de CouchDB atendendo as requisições intermediadas por um serviço de Load Balance, as configurações de sincronização das databases do TOTVS.FormBuilder no CouchDB ficam definidas conforme a matriz abaixo:
Cada um dos itens no modelo acima refere-se a um documento de instrução de sincronização. São ao todo 30 documentos (10 documentos em cada servidor). Esses documentos devem seguir o padrão visto anteriormente.
Abaixo segue um exemplo detalhado de DOCUMENTO de sincronização:
Para mais informações, consulte: http://docs.couchdb.org/en/1.5.1/replication/
- Backup de Arquivos
Caso seja necessário fazer backup de dados, os arquivos de databases do CouchDB estão localizados na seguinte pasta:
Para restaurar um backup, basta sobrescrever estes arquivos com a versão do backup.
Para mais informações, consulte: https://wiki.apache.org/couchdb/How_to_make_filesystem_backups
- Índices do CouchDB
Toda vez que o backup do CouchDB for restaurado em outro ambiente, os índices devem ser deletados.
Sempre que pegarmos arquivos de dados de outras bases do CouchDB, precisamos deletar os índices.
Os arquivos de índices do CouchDB são gerados a partir de um hash MD5 do texto de definição de cada view.
Temos na aplicação do FormBuilder uma rotina que garante que a view esteja com o formato que a aplicação precisa, e toda vez que a aplicação é reiniciada ela salva a definição da view novamente no CouchDB.
Precisamos parar o serviço do Apache CouchDB e depois de deletar os arquivos, depois da deleção pode subir o serviço, que os índices serão recriados corretamente.
Deletar os arquivos (.view{*}) que ficam localizados na seguinte pasta:
"C:\Program Files (x86)\Apache Software Foundation\CouchDB\var\lib\couchdb\.totvs_formbuilder_model_formresponsemodel_design\mrview"
Em caso de dúvidas gerais na execução, instalação, suporte:
http://localhost:5984/_utils/docs/
http://docs.couchdb.org/en/1.5.1/
0 Comentários