KoboToolbox
O KoboToolbox é um conjunto de ferramentas de código aberto para coleta de dados em campo. As equipes criam formulários, coletam respostas online e offline em dispositivos móveis, e gerenciam e exportam os conjuntos de dados resultantes. É muito usado no trabalho humanitário e de desenvolvimento.
O KoboToolbox é licenciado sob AGPL-3.0. Execução gratuita — não é cobrado.
O que é instalado
Seção intitulada “O que é instalado”- KPI: o aplicativo web do KoboToolbox, onde você cria formulários, gerencia projetos e consulta e exporta dados.
- KoboCAT: o serviço que recebe os envios de formulários.
- Um pequeno proxy que serve o endereço
kc.do KoboToolbox. - Enketo: exibe os seus formulários como formulários web, para que as pessoas possam preenchê-los em um navegador.
- PostgreSQL (com PostGIS): o banco de dados de formulários, projetos e contas.
- MongoDB: armazena os envios.
- Redis: duas instâncias, para tarefas em segundo plano e sessões.
Todos esses componentes são usados somente por esta instalação.
Endereços web
Seção intitulada “Endereços web”Com um domínio, o KoboToolbox usa três endereços web e precisa dos três:
- o endereço principal, como
lakeside-kobo.scolah.com, para o próprio KoboToolbox; kc.antes dele, o endereço do servidor que você informa no KoboCollect em celulares e tablets;enketo.antes dele, para os formulários web do Enketo.
Um Subdomínio Scolah cria os três para você. Com o seu próprio domínio, digite os três nomes de host ao adicioná-lo, mantendo os prefixos kc. e enketo. que o formulário sugere: o KoboToolbox deduz os outros dois endereços a partir do principal, então um nome diferente não é usado. Adicionar ou alterar um domínio reinicia o KoboToolbox para que ele passe a usar os novos endereços.
Você também pode acessar o KoboToolbox pelo endereço IP do servidor e pela porta da instalação. Isso basta para entrar, gerenciar contas e criar formulários, mas os formulários web e o KoboCollect só funcionam depois que a instalação tem um domínio.
Antes de instalar
Seção intitulada “Antes de instalar”-
Processador: as imagens do KoboToolbox são compiladas somente para processadores x86-64 (amd64). A verificação Adequação do servidor do assistente avisa você se o seu servidor tiver outra arquitetura.
-
Deployment size (tamanho da implantação): define quantas requisições o KoboToolbox atende simultaneamente e quanta memória cada serviço pode usar. A Adequação do servidor indica se o seu servidor é grande o suficiente.
Tamanho KoboToolbox e KoboCAT Bancos de dados Limite de memória, todos os serviços small2 workers cada caches menores cerca de 5 GiB medium(padrão)4 workers cada caches maiores cerca de 10 GiB Use
mediumpara coleta de dados de verdade. Você pode alterar o tamanho mais tarde com Redimensionar; os serviços reiniciam com os novos limites.
A primeira inicialização configura vários bancos de dados e pode demorar bastante. A plataforma espera até 25 minutos para que todos os serviços fiquem operacionais antes de sinalizar um problema.
| Campo | O que faz |
|---|---|
| Superuser username (nome de usuário do superusuário) | O nome de usuário do administrador do KoboToolbox criado na primeira inicialização. Por padrão, super_admin. |
| Deployment size | small ou medium, como descrito acima. |
Em Segredos:
| Campo | O que faz |
|---|---|
| Enketo encryption key (chave de criptografia do Enketo) | Opcional. A chave que o Enketo usa para criptografar os envios de formulários. Clique em Gerar para obter um valor aleatório forte. Se você deixar em branco, a instalação usa a própria chave secreta gerada. É selada e nunca mais é exibida. |
Avançado contém a opção de usar servidores PostgreSQL, MongoDB ou Redis que você já executa em vez dos incluídos. Consulte serviços externos.
Os endereços web, e se eles usam HTTPS, vêm do domínio da instalação, então não há nada para definir aqui. O contato de suporte do Enketo é o endereço de e-mail do administrador da organização que criou a instalação.
Primeiro login
Seção intitulada “Primeiro login”Na primeira inicialização, o KoboToolbox cria uma conta de administrador (superusuário):
- Nome de usuário: o que você informou em Superuser username (
super_admin, a menos que você o tenha alterado). - Senha: gerada pela plataforma.
Quando você clica em Criar, o portal mostra a senha uma única vez, em Credenciais de primeiro acesso, com o rótulo Senha de superusuário do Kobo. Copie-a antes de sair da página: ela não pode ser exibida novamente.
Abra o endereço principal da instalação e entre com esse nome de usuário e essa senha. Quando um formulário exige um usuário logado, o Enketo mostra a própria página de login: use o mesmo nome de usuário e a mesma senha do KoboToolbox.
As senhas do banco de dados, do MongoDB e do Redis e as outras chaves internas também são geradas pela plataforma e seladas. Você nunca precisa digitá-las.
Conexões
Seção intitulada “Conexões”O KoboToolbox pode disponibilizar a outra instalação no mesmo servidor:
- KoboToolbox form data (read-only) (dados de formulários do KoboToolbox, somente leitura): acesso somente leitura aos bancos de dados PostgreSQL de formulários e projetos. As contas de usuário, as sessões e os tokens de login ficam de fora.
- KoboToolbox submissions (read-only) (envios do KoboToolbox, somente leitura): acesso somente leitura aos envios armazenados no MongoDB.
O Metabase pode usar qualquer uma delas como Analytics data source (fonte de dados de análise) para criar painéis sobre os dados das suas pesquisas.
O KoboToolbox não usa nada de outras instalações.
Consulte conexões.