|Documentação

Gestão das instâncias

Implementar uma instância

Uma instância é o seu portal cartográfico: um site Lizmap em seu nome, com o seu servidor QGIS, a sua base de dados PostgreSQL/PostGIS e o seu espaço de ficheiros. Cria-a num minuto; nós instalamo-la, supervisionamo-la e mantemo-la atualizada.

A página Instâncias: um cartão por instância, com o seu estado, o seu endereço, o seu plano, a sua versão do QGIS e o espaço ocupado.
  1. Abra Instâncias e clique em Implementar uma instância. Enquanto não tiver nenhuma instância, a página propõe Lançar a minha instância.
  2. Dê-lhe um nome: letras minúsculas, algarismos e hífenes. O nome passa a ser o endereço do seu portal, apresentado por baixo do campo: https://votre-nom.lizpack.com.
  3. Deixe Versões (opcionais) fechado para usar as versões marcadas Recomendado, ou escolha aí uma versão do QGIS Server e do Lizmap Web Client. As duas listas só propõem versões compatíveis entre si.
  4. Clique em Implementar.
A janela de implementação: o nome escolhido, o endereço que dele resultará e as versões, recolhidas por predefinição.

Conte com cerca de quatro minutos. A janela de acompanhamento apresenta a etapa em curso. Não tem de esperar: Continuar em segundo plano fecha-a, uma faixa na página Instâncias acompanha a implementação e um e-mail avisa-o no fim. Quando a instância estiver pronta, Ver a minha instância abre a sua ficha.

Quando a implementação é recusada

Verificamos a sua subscrição antes de criar o que quer que seja. Se o seu plano tiver atingido o seu número de instâncias, abre-se a janela Número máximo de instâncias atingido, com Fazer upgrade para mudar de plano. Se a sua utilização já ultrapassar os limites do seu plano, a implementação aguarda que liberte espaço: consulte as quotas.

O nome já não pode ser alterado após a implementação. Um nome já utilizado, mesmo por uma instância entretanto eliminada, é recusado; para recuperar um nome antigo, escreva ao suporte.

O estado de uma instância

Cada cartão da página Instâncias tem um indicador que mostra a situação da instância. O filtro colocado ao lado da pesquisa só apresenta as instâncias num determinado estado.

IndicadorO que significaO que pode fazer
AtivaO portal está online.Pará-la, atualizá-la, eliminá-la.
InativaA instância está parada. Os seus projetos, os seus ficheiros e a sua base de dados são conservados.Reiniciá-la com Ativar, ou eliminá-la.
ImplementaçãoA instalação está em curso.Aguardar: um e-mail anuncia o fim.
Falha ou ErroA implementação ou um serviço não foi concluído com êxito.Escrever ao suporte, ou eliminar a instância e recomeçar.
Quota excedidaA sua utilização ultrapassa os limites do seu plano; os serviços da instância estão parados. Ao passar o cursor, a etiqueta indica qual o limite em causa: número de instâncias, armazenamento de ficheiros ou de bases de dados.Libertar espaço ou mudar de plano (consulte as quotas, mais abaixo).
Subscrição expiradaA sua subscrição já não está ativa; a instância está parada.Renovar a subscrição a partir de Subscrições.
SuspensaA instância foi suspensa pela nossa equipa.Escrever ao suporte.

Durante uma ação, o indicador mostra o seu nome: A iniciar…, A parar… ou A eliminar…. Volta ao estado normal assim que a ação termina.

Iniciar, parar, eliminar

As operações habituais fazem-se a partir do cartão da instância, na página Instâncias. Gerir abre a sua ficha; o menu dos três pontos propõe o resto.

  • Desativar para a instância: o portal fica offline, nada é apagado.
  • Ativar reinicia-a.
  • Eliminar apaga-a, após confirmação.

Na ficha da instância aparece um só botão, conforme o estado: Iniciar tudo quando a instância está parada, Parar tudo quando está em funcionamento. Para reiniciar uma instância numa só operação, utilize o botão Reiniciar da lista As minhas instâncias, no painel. Estas ações são executadas sem pedir confirmação, e um e-mail informa-o delas.

Eliminar uma instância

Eliminar pede a palavra-passe da sua conta e, em seguida, Eliminar definitivamente. A instância, os seus projetos QGIS, os seus ficheiros e a sua base de dados são apagados, e o seu nome não poderá voltar a ser utilizado. O acompanhamento dura cerca de um minuto; as suas quotas são recalculadas no fim.

Uma eliminação não pode ser anulada. Recupere primeiro os seus projetos e os seus dados, a partir de Ficheiros e da base de dados.

A ficha de uma instância

Gerir abre a ficha da instância. No topo, o seu nome, o seu endereço e os seus botões; por baixo, separadores: Visão geral, Componentes, Módulos, Cópias de segurança, Ficheiros, que abre o gestor de ficheiros, e Definições, que define as proteções, os e-mails, o endereço e a manutenção da instância. Cada separador tem o seu próprio endereço: pode partilhá-lo ou voltar a ele com o botão de retrocesso do navegador. O Visão geral apresenta três contadores, o número de Projetos, o espaço ocupado pelos seus ficheiros (Armazenamento) e o da sua Base de dados, os valores que comparamos com os limites do seu plano; depois, o número de Componentes ativos e as versões do Lizmap e do QGIS Server.

A ficha de uma instância: o seu nome e os seus botões, os seus separadores e, em seguida, a visão geral e os seus valores.

Os botões do cabeçalho: Atualizar quando existe uma versão mais recente e, depois, Iniciar tudo ou Parar tudo conforme o estado da instância. Os ficheiros abrem-se no separador Ficheiros. Por baixo dos contadores do separador Visão geral, o bloco Ligações indica o endereço do portal e da sua administração e, para cada projeto publicado no Lizmap, o endereço do mapa e os dos serviços WMS, WFS e WMTS, a copiar para o QGIS ou outro cliente. Um projeto aparece logo que a pasta for um repositório Lizmap e tiver a configuração Lizmap (.qgs.cfg); a lista atualiza-se com as medições da instância, cerca de cinco em cinco minutos.

Um cartão por serviço

O separador Componentes apresenta um cartão por serviço da instância, com a sua versão e o seu estado: Ativo, Inativo ou Degradado. Clique num cartão para o expandir.

CartãoO que contém depois de expandido
Portal cartográficoO endereço público dos seus mapas e, em Acesso de administrador, a ligação Abrir para a administração do Lizmap, com o seu identificador e a sua Palavra-passe inicial.
Lizmap Web ClientO número de projetos ativos.
PostgreSQL / PostGISO espaço ocupado e, em Informações de ligação, a base de dados, o utilizador, a palavra-passe, o anfitrião e a porta a introduzir no QGIS. Estes parâmetros estão reservados ao plano Pro e superiores.
QGIS ServerO endereço do serviço e os protocolos servidos: WMS, WFS, WMTS, WCS.
Cache RedisA cache que acelera a apresentação dos mosaicos e as sessões.

As palavras-passe estão ocultas: o olho mostra-as, o ícone ao lado copia-as. Um serviço Inativo ou Degradado quando a instância está iniciada deve ser-nos comunicado: a avaria é do nosso lado.

Módulos

O separador Módulos acrescenta funcionalidades ao seu portal Lizmap. Ativar instala um módulo em menos de um minuto, sem interromper o portal; Desativar remove-o. A instância tem de estar iniciada.

Altere a palavra-passe de administração do Lizmap logo no primeiro início de sessão: a que é apresentada inicialmente é a mesma para todas as instâncias.

Os parâmetros de uma instância

O separador Definições da ficha reúne o que define por si numa instância. As definições estão reservadas ao proprietário e aos membros da equipa com permissão para implementar e eliminar instâncias.

O separador Definições: as proteções, o servidor de envio dos e-mails do Lizmap e a manutenção em autosserviço.

Proteções

  • Proteção contra a eliminação: enquanto estiver ativa, a instância não pode ser eliminada nem desinstalada, e nenhum dos seus ficheiros ou pastas pode ser eliminado, renomeado ou movido, nem a partir do gestor de ficheiros nem a partir da extensão QGIS. Enviá-los, substituí-los e copiá-los continua possível. Retire-a primeiro para eliminar a instância ou arrumar os seus ficheiros.
  • Proteger os projetos QGIS: os ficheiros .qgs e .qgz deixam de se poder transferir, para todos, sozinhos ou num arquivo. Contêm as palavras-passe das bases. Enviá-los e publicá-los continua possível. No gestor de ficheiros, mostram então um cadeado e a menção Protegido, e Transferir fica desativado com o motivo; o cabeçalho da ficha mostra Projetos QGIS protegidos.

E-mails do Lizmap

O seu portal Lizmap envia e-mails: palavra-passe esquecida, criação de conta, formulários. Escolha Servidor da LizPack (predefinido): os e-mails saem do nosso servidor, sem nada a configurar. Ou O meu servidor: indique o servidor de envio do seu correio (servidor SMTP, porta, segurança, conta e palavra-passe, endereço e nome do remetente). Clique depois em Guardar e aplicar. O Lizmap reinicia alguns segundos para aplicar a definição. Desligar retira-a.

A palavra-passe nunca volta a ser mostrada: deixe o campo vazio para manter a guardada.

Manutenção

  • Reparar a ligação: se os mapas deixarem de aparecer (erro 504) com a instância em funcionamento, os seus serviços são reconstruídos numa rede nova. Um a dois minutos de interrupção; mapas, projetos e base são conservados.
  • Reimplementar: a instância é reconstruída de raiz (serviços, configuração, encaminhamento). Alguns minutos de interrupção; os seus dados são conservados.

Ambas as operações pedem confirmação, só se lançam numa instância em funcionamento e não duas vezes em dez minutos. O separador mostra a operação em curso e depois o resultado da última, entre as que lançou ou a sua equipa lançou; as intervenções do nosso suporte não aparecem.

O endereço de uma instância

No separador Definições da ficha, a secção Endereço da instância mostra o endereço em que a sua instância responde e permite substituí-lo por um domínio seu, por exemplo carto.mairie.bj em vez de agoe.lizpack.com. A alteração é paga, uma vez por alteração; voltar ao endereço original é gratuito. Está reservada ao proprietário e aos membros da equipa autorizados a implementar e eliminar instâncias, e a instância tem de estar iniciada. A secção só aparece quando a opção está disponível.

Preparar o domínio

  • Para um subdomínio (carto.mairie.bj): no seu fornecedor de domínio, crie um registo CNAME para o valor indicado no separador.
  • Para um domínio sem subdomínio (mairie.bj): crie um registo A para o endereço IP indicado.
  • Desative qualquer proxy neste registo: o domínio deve apontar diretamente para o nosso servidor.

A propagação pode demorar de alguns minutos a algumas horas. Os valores a introduzir copiam-se com um clique a partir do separador.

Verificar, pagar, aplicar

Escreva o domínio em Novo endereço e clique em Verificar: nada é pago enquanto o domínio não apontar para a sua instância. Depois de verificado o domínio, o separador mostra o preço; escolha Cartão bancário ou Mobile Money e depois Pagar e aplicar. A alteração demora alguns minutos e o separador atualiza-se sozinho. Se a aplicação falhar, o seu pagamento mantém-se: Tentar novamente retoma-a sem pagar outra vez.

Endereços anteriores e projetos

Após uma alteração, o endereço anterior redireciona para o novo durante um tempo limitado, indicado em Endereços anteriores redirecionados; Parar o redirecionamento termina-o mais cedo. Os projetos QGIS que ainda referem o endereço anterior aparecem em Projetos a corrigir: funcionam enquanto o redirecionamento durar, atualize-os antes do fim. Voltar ao endereço original repõe gratuitamente o endereço lizpack.com.

Atualizar uma instância

O botão Atualizar, ao lado do nome da instância na sua ficha, fica ativo assim que esteja disponível uma versão mais recente do QGIS Server ou do Lizmap Web Client.

  1. Clique em Atualizar. A janela recorda as versões atuais.
  2. Escolha a nova versão de cada componente, ou mantenha a versão atual. A versão aconselhada tem a indicação Recomendado.
  3. Clique em Iniciar a atualização.

A atualização demora cerca de dois minutos. Os seus projetos, os seus ficheiros e a sua base de dados não são afetados: só o software muda. Os serviços atualizados reiniciam, pelo que o portal fica brevemente indisponível. Se algo falhar, a instância volta automaticamente às versões anteriores. Um e-mail comunica-lhe o resultado.

A atualização está incluída nos planos Pro e Enterprise. Nos outros planos, custa 10 USD por componente atualizado, pagos na mesma janela por cartão bancário, por Mobile Money ou com uma Chave de atualização.

Quotas: o que acontece em caso de excesso

O seu plano fixa três limites: o espaço dos seus ficheiros, o tamanho das suas bases de dados e o número de instâncias. Medimos a sua utilização após cada implementação ou carregamento de ficheiros, e voltamos a verificá-la regularmente.

Se os seus ficheiros ou as suas bases de dados ultrapassarem o limite, os serviços web das suas instâncias param (portal, QGIS Server, cache) e o seu indicador passa a Quota excedida. A base de dados continua acessível, tal como Ficheiros: o suficiente para libertar espaço. Até lá, implementar, iniciar e atualizar ficam bloqueados.

Se tiver mais instâncias do que o seu plano permite, só as mais recentes em excesso são paradas, por completo, incluindo a base de dados. As outras continuam a funcionar. Eliminar uma instância continua sempre possível.

Assim que a sua utilização voltar a ficar abaixo dos limites, tudo reinicia automaticamente, em poucos minutos. Para levantar o bloqueio de imediato, mude de plano a partir de Subscrições.

Não acrescente ficheiros nem dados enquanto a quota estiver ultrapassada: o acesso a Ficheiros e à base de dados seria por sua vez bloqueado, e só restaria a eliminação de instâncias.