Mergin Maps

Aparência

Resolução de problemas em servidores personalizados ​

Este artigo irá ajudá-lo a depurar e a resolver problemas no seu Mergin Maps CE ou Mergin Maps EE . Se utilizar o Mergin Maps Cloud, esta está sempre atualizada e é gerida pela Mergin Maps equipa, por isso comunique-nos os seus problemas conforme descrito aqui. Leia mais sobre plataformas de servidor no artigo de visão geral.

Para instalar o seu próprio servidor, siga o nosso guia de instalação. A documentação relativa às variáveis de ambiente e a outras opções de configuração encontra-se na secção «Configurar o ambiente».

Mergin Maps suporte e resolução de problemas

Ainda não encontrou uma solução para o seu problema? Consulte as outras opções de resolução de problemas.

Registos de diagnóstico em servidores personalizados

Registos de diagnóstico são, por predefinição, guardados no registos_de_diagnóstico pasta no seu servidor.

Contêm informações detalhadas sobre o funcionamento da aplicação, pelo que podem ajudá-lo a resolver problemas que possa encontrar ao utilizar a aplicação móvel e o plug-in «QGIS » com o seu servidor personalizado.

O servidor não está configurado corretamente ​

Recebeste uma mensagem de erro a indicar que o servidor não está configurado corretamente? Mergin Maps Erro: servidor CE não configurado

  1. Verifique se MERGIN_BASE_URL A variável de ambiente do Docker está definida corretamente. MERGIN_BASE_URL deve conter o URL do seu Mergin Maps CE servidor.

  2. Reinicie o contentor com o MERGIN_BASE_URL variável

Os e-mails não são enviados ​

Se não estiver a receber e-mails, verifique se as seguintes variáveis de ambiente estão definidas corretamente:

  • MAIL_DEFAULT_SENDER tem de ser um endereço de e-mail válido
  • MAIL_SERVER deve ser um URL válido para o servidor SMTP
  • MAIL_PORT A porta do servidor de correio SMTP está definida para 587 por predefinição. Altere-o para o valor correto, caso utilize uma porta diferente.
  • MAIL_SUPPRESS_SEND deve ser definido para false

Em algumas implementações, poderá haver servidores SMTP que não suportam autenticação nem TLS. Nesse caso, pode desativar a autenticação ao não definir as variáveis MAIL_USERNAME e MAIL_PASSWORD (que estão definidas para Nenhum (por predefinição).

Se o seu servidor SMTP não for compatível com TLS ou SSL, pode desativar a encriptação definindo MAIL_USE_TLS e MAIL_USE_SSL para false. No entanto, recomenda-se a utilização de autenticação e encriptação TLS.

NOTA

Se o seu servidor SMTP não suportar TLS, deve definir MAIL_USE_TLS para false (verdadeiro(por predefinição)

O servidor está a enviar e-mails através de um worker do Celery. Se não estiver a receber e-mails, verifique se o worker do Celery está a funcionar. Verifique os registos relativos ao envio de e-mails no trabalhador do aipo recipiente:

concha
$ docker logs celery-worker

Os registos devem conter informações sobre o envio de e-mails relacionados com tarefas mergin.celery.send_email_async com o estado «bem-sucedido»:

concha
[2024-12-09 10:37:16,265: INFO/ForkPoolWorker-2] A tarefa mergin.celery.send_email_async[3e50df69-90c1-49be-b31c-78f1fb417500] foi concluída com sucesso em 0,11469305199989321 s: Nenhuma

Permissões ​

Pode verificar se Erro de permissão erros relacionados utilizando uma linha de comandos integrada fornecida por Mergin Maps. Basta iniciar sessão na página principal servidor contêiner e execute o seguinte:

concha
   docker exec merginmaps-server flask servidor permissões

A linha de comandos também aceita um caminho específico indicado pelo utilizador (o valor predefinido é /dados):

concha
   docker exec merginmaps-server flask servidor permissões --caminho /o/meu/caminho

Se tiver Erro de permissão Se ocorrerem erros relacionados, repita os seguintes passos no seu Mergin Maps instalação:

Edição comunitária
concha
  export MERGIN_DIR=/path/to/your/projects
  sudo mkdir -p $MERGIN_DIR
  sudo find $MERGIN_DIR -type f -exec sudo chmod 640 {} \;
  sudo find $MERGIN_DIR -type d -exec sudo chmod 750 {} \;
  sudo find $MERGIN_DIR -type d -exec sudo chmod g+s {} \;
  sudo chown -R 901:999 $MERGIN_DIR

Para Mergin Maps EE é necessário dar um passo complementar para o visões gerais pasta montada que permite Webmaps na plataforma.

Edição Empresarial
concha
  export MERGIN_DIR=/path/to/your/overviews
  sudo mkdir -p $MERGIN_DIR
  sudo find $MERGIN_DIR -type f -exec sudo chmod 640 {} \;
  sudo find $MERGIN_DIR -type d -exec sudo chmod 750 {} \;
  sudo find $MERGIN_DIR -type d -exec sudo chmod g+s {} \;
  sudo chown -R 901:999 $MERGIN_DIR

Definições do Celery ​

O aipo desempenha um papel importante na Mergin Maps daí a necessidade de diagnosticar rapidamente o seu funcionamento.

  • Certifique-se de que BROKER_URL está correto!
  • Certifique-se de que aipo-beterraba e trabalhador do aipo os contentores estão a funcionar

Se efetuar uma docker compose logs -tf celery-worker deverá ver nos registos uma linha semelhante a esta:

concha
  trabalhador do aipo  | 2025-03-04T10:40:16.718182375Z [2025-03-04 10:40:16,718: INFO/MainProcess] Ligado ao redis://merginmaps-redis:6379/0

Isto significa que trabalhador do aipo está a funcionar e a comunicar com redis

  • Certifique-se de que redis já está a funcionar e a receber trabalhador do aipo tarefas

Se efetuar uma docker compose exec redis redis-cli monitor deverá ver as informações apresentadas relativas a tarefas e batimento cardíaco do trabalhador do aiponó.

concha
  1741085464.139904 [0 172.18.0.8:38054] "BRPOP" "celery" "celery\x06\x163" "celery\x06\x166" "celery\x06\x169" "1"
  1741085464.578928 [0 172.18.0.8:38124] "PUBLISH" "/0.celeryev/worker.heartbeat" "{\"body\": \"eyJob3N0bmFtZSI6ICJjZWxlcnlAMmE2NTRiMzNiMzBjIiwgInV0Y29mZnNldCI6IDAsICJwaWQiOiA3LCAiY2xvY2siOiA2NDYsICJmcmVxIjogMi4wLCAiYWN0aXZlIjogMCwgInByb2Nlc3NlZCI6IDAsICJsb2FkYXZnIjogWzAuNzYsIDAuNzEsIDAuNzddLCAic3dfaWRlbnQiOiAicHktY2VsZXJ5IiwgInN3X3ZlciI6ICI1LjQuMCIsICJzd19zeXMiOiAiTGludXgiLCAidGltZXN0YW1wIjogMTc0MTA4NTQ2NC41NzgxMTUyLCAidHlwZSI6ICJ3b3JrZXItaGVhcnRiZWF0In0=\", \"content-encoding\": \"utf-8\", \"content-type\": \"application/json\", \"headers\": {\"hostname\": \"celery@2a654b33b30c\"}, \"properties\": {\"delivery_mode\": 1, \"delivery_info\": {\"exchange\": \"celeryev\", \"routing_key\": \"worker.heartbeat\"}, \"priority\": 0, \"body_encoding\": \"base64\", \"delivery_tag\": \"78d09f4f-5d84-498b-8b91-8823106df572\"}}"
  1741085465.148149 [0 172.18.0.8:38054] "BRPOP" "celery" "celery\x06\x163" "celery\x06\x166" "celery\x06\x169" "1"
  1741085466.158419 [0 172.18.0.8:38054] "BRPOP" "celery" "celery\x06\x163" "celery\x06\x166" "celery\x06\x169" "1"

Não consigo ver o mapa de fundo nos mapas online ​

Se o mapa de fundo não estiver a ser apresentado nos mapas web do seu servidor Enterprise auto-hospedado, verifique o seguinte: