Merydion 1.9

Guia do administrador

Os guias da instalação, da consola e da organização num só documento para ler offline ou imprimir, no seu idioma.

Gerado a partir dos guias do portal, Merydion 1.9.

Para quem instala o Merydion

Instalação e atualização

Todo o Merydion — o portal, as seis aplicações e os serviços que as suportam — funciona numa só máquina. A build prepara-o na máquina de desenvolvimento numa de duas formas: uma imagem para Docker num servidor Linux acessível pelo seu próprio domínio, ou uma pasta que funciona no Windows 11 sem instalar nada. A máquina que o executa não precisa de compilador.

Este guia segue os dois caminhos até ao início de sessão do primeiro administrador e depois cobre o que mantém a instalação saudável: atualizações, cópias de segurança, o interruptor do coming soon e a política de segurança do portal. Os comandos são os da pasta deploy do repositório.

Antes de começar

Os dois caminhos para instalar a suite, e o ficheiro que nomeia os seus administradores.

Escolher o caminho

A build corre na máquina de desenvolvimento, com o repositório e as suas ferramentas, e entrega apenas o que a máquina de destino precisa para funcionar — nunca o código-fonte. Existe em duas formas, com os mesmos serviços e as mesmas aplicações.

  1. A imagem para Docker serve para um servidor Linux com Docker Engine e domínio próprio: o Caddy, dentro do contentor, obtém o certificado da Let's Encrypt, por isso o domínio tem de apontar para a máquina e as portas 80 e 443 têm de estar acessíveis.
  2. A pasta serve para um computador Windows 11 x64 sem Docker: contém os serviços como programas, o Caddy e as páginas web, e serve HTTPS na porta 8080 com um certificado próprio.
  3. Ambas arrancam com um conjunto de dados vazio e ficam utilizáveis com o primeiro administrador: veja O primeiro administrador.
  4. Seja qual for o caminho, mantenha o repositório na máquina de desenvolvimento: as atualizações constroem-se lá.

Sugestão A imagem é o caminho para um servidor aberto à Internet; a pasta serve para um teste ou para um computador da rede local.

O ficheiro dos administradores

A consola da instalação abre-se apenas às contas indicadas num ficheiro de texto chamado ADMINISTRATORS. Ser proprietário de uma organização não chega: o ficheiro é a única lista.

  1. Escreva um e-mail de início de sessão por linha; uma linha que começa por # é um comentário, e maiúsculas e minúsculas não contam.
  2. Com a imagem, o ficheiro é ADMINISTRATORS na raiz do repositório no servidor, montado apenas para leitura no contentor.
  3. Com a pasta, é ADMINISTRATORS ao lado de SERVER_CONFIGURATION.json; a variável MERYDION_ADMINISTRATORS_FILE pode indicar outro caminho.
  4. O ficheiro é relido em cada verificação: acrescentar ou retirar uma linha vale de imediato, sem reiniciar nada.

Sugestão Um ficheiro ausente ou vazio significa nenhum administrador: a consola recusa então todos.

A imagem num servidor Linux

Construa a imagem, prepare o servidor e inicie o contentor no seu domínio.

Construir a imagem

A imagem constrói-se na máquina de desenvolvimento, com o Docker Desktop em modo de contentores Linux, e chega ao servidor como ficheiro: o servidor não precisa de registo nem de código-fonte.

  1. Na raiz do repositório, execute .\rebuild_container_release.ps1 -NoSeedData: constrói a imagem, verifica que não contém fontes e que tem cada parte compilada, inicia-a para teste e guarda-a como deploy\docker\merydion-allinone.tar com a sua impressão digital.
  2. Copie a imagem e a sua impressão digital para o servidor, por exemplo com scp deploy/docker/merydion-allinone.tar* admin@merydion.example.com:/tmp/.
  3. No servidor, verifique a impressão digital e carregue a imagem: cd /tmp && sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.

Sugestão Sem -NoSeedData, a build empacota também merydion-data.tar.gz com os dados da máquina de desenvolvimento — dados pessoais e chave privada do serviço de início de sessão incluídos: não é para uma instalação nova.

Preparar o servidor

No servidor, mantenha a disposição do repositório: o ficheiro compose encontra os seus vizinhos por caminho relativo. Os ficheiros abaixo pertencem ao servidor, nunca à imagem.

  1. Faça o registo DNS do seu domínio apontar para o servidor e abra as portas 80 e 443 para a Internet.
  2. Em deploy/prod-allinone/Caddyfile, escreva um e-mail real no bloco global: a Let's Encrypt escreve para lá antes de um certificado expirar.
  3. Crie deploy/prod-allinone/.env com MERYDION_DOMAIN=merydion.example.com e, para que os e-mails de verificação saiam, MERYDION_AUTH_SMTP_PASSWORD= seguido da palavra-passe da caixa de correio.
  4. Crie SERVER_SECRETS.json na raiz do repositório, legível apenas por si (chmod 600): os outros segredos dos serviços vão para lá, e sem nenhum contém { "services": {} } — sem o ficheiro, o contentor não arranca.
  5. Escreva o seu e-mail em ADMINISTRATORS, na raiz do repositório.

Sugestão Um segredo nunca vai para SERVER_CONFIGURATION.json, que é versionado e mantém vazios os campos secretos; a variável de um campo prevalece sobre SERVER_SECRETS.json.

Iniciar o contentor

O contentor contém o gateway, os serviços, o portal e as aplicações. Arranca a partir da imagem carregada, sem construir nada no servidor.

  1. Na raiz do repositório: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d.
  2. Verifique que está a funcionar: docker compose -f deploy/prod-allinone/docker-compose.yml ps tem de indicar running, não restarting.
  3. Na primeira visita o Caddy obtém o certificado, o que demora até um minuto: depois curl -sS https://merydion.example.com/health responde ok.
  4. Se o contentor reiniciar sem parar, um serviço parou e arrastou os outros: leia o motivo com docker compose -f deploy/prod-allinone/docker-compose.yml logs --tail=80.

Sugestão As videochamadas neste servidor precisam também da porta UDP do serviço de multimédia e de um relay TURN: o runbook de nó único no repositório descreve as definições adicionais.

A pasta no Windows

Construa a pasta de copiar e executar e inicie-a num computador Windows.

Construir a pasta

A pasta constrói-se na máquina de desenvolvimento e copia-se tal como está: o computador Windows que a executa não instala nada — nem Rust, nem Node, nem Docker.

  1. Na raiz do repositório, execute .\rebuild_bare_release.ps1 -NoSeedData: monta deploy\bare\out\ com os serviços como programas, o Caddy, o portal e as aplicações, a configuração e os scripts de arranque e paragem.
  2. Se existir SERVER_SECRETS.json na raiz do repositório, viaja na pasta, que então tem de ser mantida reservada; caso contrário, escreva o ficheiro na máquina de destino ou defina as variáveis dos segredos antes de iniciar.
  3. Copie a pasta out para o computador Windows 11 x64, onde preferir.

Sugestão Com -NoSeedData, a pasta contém um conjunto de dados vazio; sem ele, uma cópia dos dados da máquina de desenvolvimento, dados pessoais incluídos.

Iniciar a pasta

Dois scripts iniciam e param tudo. As portas escolhem-se em cada arranque: numa máquina limpa o gateway fica com a 8080 e os serviços com as portas a partir da 9001.

  1. No PowerShell, na pasta, execute .\start.ps1: inicia os serviços e o Caddy em segundo plano, abre na firewall as portas que o gateway não cobre e espera até o início de sessão responder.
  2. .\start.ps1 --list mostra o que iniciaria e em que portas, sem iniciar nada.
  3. Abra https://localhost:8080/ no próprio computador, ou o seu endereço na porta 8080 a partir da rede local.
  4. O certificado é do próprio computador: o navegador avisa uma vez — aceite o aviso, ou execute o arranque como administrador para que o Caddy instale a sua autoridade de certificação.
  5. .\stop.ps1 para tudo, nas portas que o arranque ocupou de facto.

Sugestão Se outro programa ocupar uma porta, só essa função passa para a porta livre seguinte, e o arranque indica-o no ecrã.

Primeiro início de sessão e operação

O primeiro administrador, as atualizações, as cópias de segurança, o coming soon e a política de segurança.

O primeiro administrador

O registo só está aberto a quem tem um código de convite, e os códigos geram-se na consola — que ainda ninguém pode abrir. O primeiro código gera-se na própria máquina.

  1. Imagem: no servidor, na raiz do repositório, docker compose -f deploy/prod-allinone/docker-compose.yml exec -e MERYDION_DATA_ROOT=/var/lib/merydion/data merydion merydion-auth invite-code.
  2. Pasta: no PowerShell, na pasta, $env:MERYDION_DATA_ROOT = (Resolve-Path .\data).Path; .\bin\merydion-auth.exe invite-code.
  3. O comando mostra um código no formato XXXX-XXXX-XXXX; invite-code 5 mostra cinco.
  4. No portal, clique em Entrar e depois em Criar conta: introduza o código, registe-se com o e-mail escrito em ADMINISTRATORS e confirme-o com o código do e-mail de verificação.
  5. Inicie sessão: Diagnóstico, no fundo de cada página, abre a consola, onde se geram os restantes códigos de convite.

Sugestão Se o e-mail de verificação não chegar, verifique a palavra-passe da caixa de correio: o serviço de início de sessão indica no arranque quando falta.

Atualizar

Uma atualização substitui a imagem e mantém os dados: estão no volume do contentor, que pertence ao projeto e não à imagem.

  1. Na máquina de desenvolvimento, com o repositório atualizado, construa a nova imagem: .\rebuild_container_release.ps1 -NoSeedData.
  2. Copie-a para o servidor, verifique-a e carregue-a como da primeira vez: sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.
  3. Inicie com o mesmo comando da primeira vez: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d deteta a nova imagem e recria o contentor, com uma interrupção de poucos segundos.
  4. Abra a consola no separador Atualização: onde uma linha indicar Atualização disponível, clique em Executar atualização — até lá, as funções de dados desse serviço ficam desligadas.

Sugestão Antes de cada atualização, confirme no diagnóstico que as cópias das bases de dados estão em ordem (o cartão «Cópias das bases de dados») e copie os ficheiros: a atualização das bases de dados trabalha sobre uma cópia e mantém o original até a cópia ser verificada, mas as cópias são o seu próprio caminho de regresso.

Cópias e restauro

Cada serviço mantém uma cópia contínua das bases de dados que gere — contas, índices dos documentos, correio, conversas — com um atraso máximo de cerca de um segundo, e pode restaurá-las tal como estavam em qualquer instante dos últimos sete dias. Os ficheiros propriamente ditos — documentos, anexos, pré-visualizações — são escritos uma vez e nunca mudam: são copiados à parte, ou guardados num bucket S3.

  1. Leve as cópias das bases de dados para fora da máquina: registe um destino da classe backups num bucket S3 ou noutro disco, e ative-o.
  2. Imagem: copie os ficheiros, sem as bases de dados, enquanto está em execução: docker run --rm -v merydion-prod-allinone_merydion_state:/d:ro -v "$PWD/files":/b alpine sh -c 'tar czf /b/files-$(date +%F).tgz -C /d --exclude="*.db" --exclude="*.db-*" --exclude=./backups --exclude=./restores .' escreve um arquivo datado na pasta files.
  3. Pasta: pare-a com .\stop.ps1, copie inteira a pasta data e volte a iniciá-la.
  4. Se um administrador registou outro destino para os ficheiros, copie a sua pasta na mesma ronda: os ficheiros criados depois da sua ativação só estão lá.
  5. Guarde as cópias longe da máquina que protegem.

Sugestão Para repor uma base de dados ou a instalação inteira tal como estava num dado instante, pare a instalação e execute merydion-storage copies restore (o procedimento «Cópias e restauro» do runbook): o comando escreve as bases de dados restauradas numa pasta nova, que depois ocupa o lugar da antiga.

Pôr o site em coming soon

O coming soon mostra a cada visitante apenas uma página de pré-visualização enquanto a instalação se prepara: o portal, as aplicações, o Palatys e a consola esperam por trás dela, também para os administradores.

  1. Inicie sessão como administrador e abra https://merydion.example.com/coming-soon.html?enabled=true: a página confirma e o site fica em coming soon.
  2. Para voltar a ligar o site, abra https://merydion.example.com/coming-soon.html?enabled=false: depois da confirmação a página leva-o à página inicial.
  3. Se não tiver sessão iniciada, a página pede-a primeiro; a uma conta que não é de administrador diz-lho, e nada muda.
  4. O estado é o ficheiro site/coming-soon na pasta de dados: retirá-lo volta a ligar o site mesmo sem a página.

Sugestão A página do coming soon existe em inglês e em italiano; a um visitante de outro idioma chega a inglesa.

Ligar as estatísticas de visitas

O site pode contar as suas visitas com o Google Analytics 4, pedindo primeiro o consentimento a cada visitante: enquanto um visitante não aceitar, nada da Google é carregado. As estatísticas ficam desligadas até a instalação indicar o seu ID de medição, e a consola de administração nunca as tem.

  1. No Google Analytics, crie uma propriedade e um stream de dados Web para o endereço do site, e copie o respetivo ID de medição (começa por G-).
  2. Imagem: no ficheiro .env junto a docker-compose.yml acrescente MERYDION_GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX e recrie o contentor com docker compose up -d. Pasta: exporte a mesma variável na sessão antes de start.ps1.
  3. Abra o site numa janela privada: em baixo à esquerda aparece o aviso sobre as estatísticas de visitas, e no fundo de cada página aparece «Preferências de cookies».
  4. Para desligar as estatísticas, esvazie a variável e recrie o contentor: o aviso desaparece, e os navegadores de quem tinha aceitado deixam de carregar o Google Analytics.

Sugestão A política de privacidade e a política de cookies já descrevem as estatísticas, em todos os idiomas, para a instalação que as liga. Na propriedade, defina a retenção de dados que pretende — a Google guarda os dados de uma visita no máximo 14 meses — e deixe os sinais Google desligados: o site também os desliga do seu lado.

Abrir o site aos motores de pesquisa

Cada instalação diz aos motores de pesquisa que não a indexem enquanto não ligar a indexação: uma cópia do site que não é a oficial — uma instalação de teste, a de uma organização — nunca lhe faz concorrência nos resultados. Os endereços que as páginas, as pré-visualizações e os mapas do site declaram são os do site oficial, https://merydion.eu, e as páginas da conta, a consola e a página de um endereço que não existe nunca entram num índice.

  1. Apenas na instalação que serve o site oficial. Imagem: no ficheiro .env junto a docker-compose.yml acrescente MERYDION_SITE_INDEXING=1 e recrie o contentor com docker compose up -d. Pasta: exporte a mesma variável na sessão antes de start.ps1.
  2. Confirme: curl -I https://merydion.eu/ já não mostra o cabeçalho X-Robots-Tag: noindex, e https://merydion.eu/robots.txt aponta para https://merydion.eu/sitemap.xml.
  3. No Google Search Console e no Bing Webmaster Tools, verifique o domínio com um registo DNS e envie https://merydion.eu/sitemap.xml.
  4. Para tirar novamente o site dos motores de pesquisa, esvazie a variável e recrie o contentor: cada resposta volta a dizer noindex, e os motores retiram as páginas na visita seguinte.

Sugestão Um portal gerado para outro endereço define MERYDION_SITE_ORIGIN (por exemplo https://www.example.com) quando é gerado: os endereços canónicos, as variantes de idioma, as pré-visualizações e os mapas do site passam então a indicar esse endereço. A página de um endereço que não existe responde no idioma da sua pasta, com o estado 404.

A Content-Security-Policy do portal

As páginas do portal funcionam sob uma Content-Security-Policy estrita enviada pelo gateway: uma página só pode usar os próprios ficheiros, pedidos à própria origem, imagens também de data: e blob:, e nenhuma moldura de outro site. É o que impede um fragmento de marcação intruso de executar código. A única exceção são as estatísticas de visitas: as páginas que podem contar visitas admitem também o gtag.js da Google, apenas no seu caminho, e a recolha do Google Analytics, que só são carregados depois de um visitante aceitar.

  1. Um portal personalizado com scripts ou estilos escritos dentro das páginas não funciona: scripts e estilos vão em ficheiros próprios.
  2. window.MERYDION_AUTH_BASE, window.MERYDION_API_BASE e window.MERYDION_DIAGNOSTICS_BASE só podem mover uma família de pedidos para outro caminho da mesma origem; um endereço noutra origem é ignorado, com um erro na consola do navegador.
  3. As páginas da consola da instalação têm a política sem a exceção das estatísticas e, além disso, não se podem mostrar dentro de uma moldura.
  4. A política está em apps/portal-csp.mjs e nos três Caddyfile, e um teste mantém-nos iguais: altere-a nos quatro sítios ao mesmo tempo.

Sugestão O formulário de início de sessão do serviço de identidade e a página de recusa da consola chegam com uma política própria, ainda mais estrita.

Para administradores da instalação

Consola da instalação

A consola é a ferramenta de quem põe uma instalação Merydion a funcionar. Mostra se cada serviço funciona, como estão os nós e se as bases de dados estão atualizadas, e gere contas, códigos de convite, organizações e a governação da partilha, ao lado do feedback, das solicitações de suporte e das mensagens que as pessoas enviam.

Este guia percorre as secções uma a uma. Governar uma única organização por dentro está descrito no guia de administração da organização.

Primeiros passos

Quem pode abrir a consola, o que diz a sua visão geral e como funcionam as suas secções.

Abrir a consola

A consola só abre para os administradores da instalação: as contas que constam, uma por linha, do seu ficheiro ADMINISTRATORS. O ficheiro volta a ser lido em cada verificação, por isso adicionar ou retirar uma linha tem efeito de imediato.

  1. Entre com uma conta de administrador.
  2. Abra o menu da conta no canto superior direito e escolha Consola de administração: só os administradores da instalação a veem. Também pode abrir diagnostics.html.
  3. Qualquer outra pessoa recebe, em vez da consola, uma página no idioma da página pedida que diz porquê. Sem sessão iniciada, Entrar leva-o de volta à consola depois de entrar; com outra conta, escolha Voltar ao seu espaço de trabalho ou Entrar com outra conta.

Sugestão Como designar o primeiro administrador é explicado no guia de instalação.

Ler a visão geral

A consola abre em Visão geral, que diz o que na instalação pede atenção: os serviços que não respondem, as bases de dados a atualizar, os pedidos de suporte recebidos e os utilizadores à espera de verificação.

  1. Leia os quatro números: um número num cartão colorido pede atenção, um num cartão simples não; um traço significa que ainda está a ser lido.
  2. Sob Bases de dados a atualizar, Serviços não verificados conta os serviços cujas bases de dados não puderam ser verificadas.
  3. Clique num número para abrir a secção onde é tratado; Retroceder leva-o de volta à visão geral.
  4. Atualizar volta a ler todos os números.

Sugestão Os números dos serviços e das bases de dados são os de Estado e de Atualização das bases de dados: leem-se uma vez para ambas as secções e renovam-se enquanto os observa.

Deslocar-se entre as secções

A consola agrupa as suas secções por ofício — Saúde (Visão geral, Estado), Topologia (Visão geral, Nós, Células, Encaminhamento, Armazenamento, Eventos), Pessoas e organizações (Utilizadores, Organizações, Códigos de convite, Partilha), Operações (Atualização das bases de dados) e A voz dos utilizadores (Suporte, Feedback, Mensagens) — e mostra uma de cada vez.

  1. Clique numa secção na coluna da esquerda para a abrir.
  2. Com o foco numa secção, as setas para cima e para baixo abrem a seguinte ou a anterior, de um grupo para o outro; Início e Fim abrem a primeira e a última.
  3. O endereço acompanha a secção que abre — por exemplo diagnostics.html#diag-scope-status —, pelo que o pode guardar nos marcadores ou enviar, e recarregar a página mantém-no.
  4. Num ecrã estreito, a coluna passa a ser uma lista no topo da página: escolha aí a secção.

Sugestão Uma secção lê o que mostra na primeira vez que a abre, e a consola não pede nada antes de verificar que a sua conta pode administrar. Cada secção tem o seu próprio Atualizar; a que não consegue ler diz o quê e porquê, e Tentar novamente volta a lê-la.

Orientar-se na consola

A consola é uma app da suite: a barra de título no topo, a coluna das secções à esquerda, a barra de estado em baixo. A barra de título nomeia a instalação e diz o seu estado; a barra de estado diz se os serviços respondem, quando chegou o último anúncio e por que canal a consola fala com o gateway.

  1. Leia o nome da instalação na barra de título, junto ao quadrante: por baixo, um ponto e o estado dos seus nós — todos em linha, ou quantos estão em cada estado — e o número de alertas atuais.
  2. A pílula junto ao sino indica a versão do Merydion a partir da qual a consola foi criada.
  3. Na barra de estado, leia se todos os serviços respondem ou qual não responde, e há quanto tempo chegou o último anúncio.
  4. À direita da barra de estado, «TLS 1.3» é o canal que o gateway leu para os pedidos da consola; «Sem TLS» indica que a ligação não está cifrada.
  5. O sol ou a lua junto ao idioma alterna entre o tema claro e o escuro; o idioma abre a lista de idiomas do Portal.

Sugestão Na página de um serviço ou de um nó a coluna das secções mantém-se: a secção de onde vem a página está marcada, e um clique noutra secção abre-a na consola.

Ler os alertas atuais

O sino na barra de título conta os alertas da topologia da instalação — um nó ou um serviço que não responde, uma função que nenhum nó em linha desempenha, serviços que executam versões diferentes — e lista-os.

  1. Veja o número no sino: é o número de alertas atuais; sem número, sem alertas.
  2. Clique no sino para abrir a lista: cada alerta é uma frase que nomeia o nó, o serviço ou a função.
  3. Siga «Abrir a visão geral da topologia» no fim da lista para ver os nós e os serviços.
  4. Esc, ou um clique noutro sítio, fecha a lista.

Sugestão Os alertas são os de agora: um alerta desaparece sozinho quando se resolve o que o causou. A consola volta a lê-los a cada 30 segundos enquanto o separador está visível.

Dar nome à instalação

O nome da instalação aparece na barra de título da consola. A topologia da instalação guarda-o, com quem o definiu e quando; sem nome, a consola mostra o nome do anfitrião a que chegou.

  1. Clique na roda à direita da barra de título: abre-se Definições da instalação.
  2. Escreva o nome, até 64 caracteres — por exemplo Produção.
  3. Escolha Guardar: a barra de título mostra o novo nome de imediato.
  4. Para remover o nome, esvazie o campo e guarde.

Sugestão Os espaços no início e no fim são removidos. Cada alteração fica registada entre os eventos da topologia, com a conta que a fez.

Serviços e bases de dados

O estado dos serviços, o seu detalhe e registos, a topologia com os seus nós, células, encaminhamento, armazenamento e eventos, e a atualização das bases de dados.

Verificar o estado dos serviços

Estado lista os onze serviços da instalação, cada um com o ícone, o nome, a descrição e o endereço de saúde.

  1. Leia a luz de cada linha: Operacional quando o serviço responde à verificação de saúde em menos de 6 segundos, Inacessível quando não.
  2. As verificações repetem-se sozinhas a cada 30 segundos enquanto Estado ou Visão geral estão à vista, e descansam enquanto o separador do navegador está oculto; Atualizar repete-as de imediato e atualiza Última verificação.
  3. Clique no estado de um serviço para abrir o seu detalhe de saúde, ou no ícone de registos para os ler.
  4. Runtimes servidos lista o que o navegador executa a partir de ficheiros do front-end, como os efeitos de vídeo, com Servido ou Não servido.

Sugestão Quando um serviço está Inacessível, os seus registos dizem muitas vezes porquê.

Ler o detalhe de saúde de um serviço

Cada serviço tem uma página com o seu detalhe de saúde: um estado global e um cartão para cada um dos seus subsistemas.

  1. Abra-a clicando no estado do serviço em Estado.
  2. A pastilha em cima diz Operacional, Degradado ou Não operacional.
  3. Cada cartão mostra um subsistema com a luz, o nome, um resumo e os seus números.
  4. A página não se atualiza sozinha: clique em Atualizar. O caminho no topo da página leva de volta a Estado e à consola.

Sugestão Degradado significa que o serviço funciona mas uma das suas partes não: o cartão desse subsistema diz qual.

Ler os registos de um serviço

Cada serviço tem uma página com os seus registos, numa consola com o aspeto de um terminal.

  1. Abra-a com o ícone de registos do serviço em Estado.
  2. Escolha o dia em Dia: a lista mostra os dias que têm registos, do mais recente para o mais antigo.
  3. A consola mostra as últimas linhas desse dia, coloridas por nível — ERROR, WARN, INFO, DEBUG, TRACE — e desloca-se até à última.
  4. As linhas mais antigas foram omitidas. significa que o servidor cortou as linhas mais antigas; Sem entradas de registo para este dia. que o dia não tem ficheiro; O registo em ficheiro não está ativado para este serviço. que o serviço não escreve registos em ficheiro.

Sugestão Atualizar volta a ler o dia escolhido.

Ler a topologia da instalação

Em Topologia a consola mostra a instalação tal como a descrevem o registo da topologia e os anúncios dos serviços. A sua Visão geral diz em seis números como está, que funções tem cada nó e que serviços se anunciaram.

  1. Leia os seis números: os nós, os serviços Rust anunciados, as células SQLite, os destinos dos bytes, a última ronda das cópias e os alertas. Os nós e os alertas aparecem na cor da consola quando tudo corre bem, em ocre ou em vermelho quando algo pede atenção; um traço significa que o dado ainda não existe.
  2. Última hora e Hoje, ao lado do título, mostram para cada número que tem uma série o pior valor do período e a hora a que foi atingido; os números sem série continuam a ser os de agora e dizem-no. Agora volta ao estado presente.
  3. Funções × nós tem uma linha por função e uma coluna por nó: um quadrado cheio é uma função ligada nesse nó. O nome de um nó abre a sua página; Mostrar mais acrescenta as colunas dos nós seguintes, e a tabela desloca-se dentro do seu cartão.
  4. Sob a tabela, três verificações — nenhuma função sem nós, nenhuma versão mista, todos respondem — tornam-se o alerta em palavras quando falham.
  5. Serviços anunciados lista cada serviço com o nome do seu binário, quantas instâncias se anunciaram, a versão e um ponto, verde quando todas respondem; a primeira linha é a entrada, caddy.
  6. A secção relê-se sozinha a cada 30 segundos enquanto a consola está aberta, e pára quando o separador do navegador está oculto; Atualizar relê-a de imediato.

Sugestão Perante um alerta, abra a página do nó que ele nomeia: as suas funções e serviços dizem qual serviço não responde. Versões diferentes costumam significar uma atualização ainda em curso em algum nó.

Vigiar os nós

Nós lista os nós que o registo da topologia conhece, ordenados por função com os novos no topo: de cada um o endereço, as funções, o estado, a CPU e a memória que anunciou, as células que tem e a idade do seu último anúncio. Cada linha abre a página do nó, e um nó que entra na instalação aparece sozinho.

  1. Escolha um estado acima da lista — Todos, Em linha, Novos, A esvaziar, Fora de linha e Inacessíveis quando há pelo menos um —: ao lado de cada um, o número de nós. Filtrar os nós, ao lado do título, procura no nome e na identidade.
  2. Um nó novo fica no topo, com o ponto ocre: anunciou-se sozinho e não tem trabalho, e a sua linha oferece Pôr em linha e Rejeitar.
  3. A CPU acima de 70 % fica a ocre, e também as células acima de 80 % da capacidade declarada; um traço entre as células significa que o nó não tem a função Dados. Quando a instalação tem mais nós do que a lista mostra, Mostrar mais acrescenta os seguintes.
  4. Pesos e capacidades, ao lado do título, abre os pesos das funções e as capacidades do nó que escolher: um peso vai de 1 a 1000, e 100 é o nó normal da função; um campo de capacidade vazio deixa-a não declarada. Guardar só vale se ninguém tiver alterado o nó entretanto.
  5. A página de um nó tem à esquerda as sete funções: a que está ligada leva a barrinha, e os serviços da função são fichas acesas quando correm lá e respondem; uma ficha abre, mais abaixo, a configuração e os recursos desse serviço. À direita, a Configuração efetiva, agrupada por origem: a semente do primeiro arranque, o que decide a topologia, o que diz a configuração, o estado do nó e os segredos, ocultados.
  6. Configurar altera o nome, as funções, os pesos e as capacidades do nó; ao lado estão as ações que o seu estado permite, cada uma com confirmação prévia.
  7. Recursos mostra o anfitrião do nó: em Agora CPU, memória, rede, disco, tráfego mensal e processos, atualizados a cada 5 segundos pelo serviço de identidade do nó; em Última hora e Hoje a CPU e a memória minuto a minuto, como os serviços as anunciaram.

Sugestão Um segredo nunca sai do processo que o tem: a página mostra apenas o seu nome, de onde vem e a etiqueta de ocultado. A configuração só muda quando um serviço reinicia.

Pôr nós em linha, esvaziá-los e desativá-los

Cada estado de um nó oferece apenas as ações que o registo da topologia admite a partir dele: na linha de um nó novo em Nós, e no cabeçalho da página de cada nó, ao lado de Configurar. Cada ação pergunta primeiro, nomeando o nó e dizendo o que vai realmente acontecer; o que nada desfaz — Rejeitar, Desativar e Declarar caído — confirma-se escrevendo a identidade do nó.

  1. Novo: Pôr em linha dá trabalho ao nó — células novas, as células que a topologia desloca, salas, trabalhos de renderização, montagens —, e a topologia só o aceita quando tem notícias do nó: pelo menos um dos seus serviços se anuncia ou, para um nó só com a função Entrada, que não tem serviços a anunciar, a sua entrada responde. Até lá o botão fica desativado e diz porquê. Rejeitar é a desativação do nó: sai de todas as vistas, a sua identidade e a sua época nunca mais são reutilizadas, e um processo seu que tente juntar-se de novo fica de fora.
  2. Em linha: Esvaziar faz com que o nó deixe de receber trabalho de imediato e desloca as suas células para os nós menos carregados, no máximo 4 de cada vez; um bucket que monta é montado noutro nó de armazenamento, enquanto uma pasta no seu disco fica e terá de a mover a partir de Armazenamento. Quando não lhe resta nada e os seus pedidos em curso terminaram, no máximo em 30 segundos, fica fora de linha por si só. Um nó inacessível não se esvazia.
  3. A esvaziar: o cartão Esvaziamento em curso acompanha o esvaziamento a cada 5 segundos enquanto está à vista — quem o iniciou e quando, as células ainda no nó em relação às que tinha, com os seus tipos, as deslocações abertas por fase, e o que o retém, por palavras: células cuja deslocação foi recusada ou cancelada, tipos que nenhum nó em linha pode receber, uma pasta no seu disco, serviços que não fecharam o recenseamento das suas células, um nó que ficou em silêncio —, ou Nada o retém. Interromper o esvaziamento volta a pôr o nó em linha: as deslocações do esvaziamento ainda não atribuídas são canceladas e as suas células ficam nele.
  4. Inacessível, ou a esvaziar e em silêncio: Declarar caído, que nunca é oferecido para um nó que tenha a função Controlo. A confirmação diz primeiro a política de recuperação em vigor, lida nesse momento. A topologia só aceita a declaração quando o lease do nó expirou há mais de 10 segundos, e recusa-a antes disso: com a recuperação automática, declara o nó caído por si nesse momento, por isso confirmar nunca o faz mais cedo; com a recuperação manual, a sua confirmação é a única forma de as células do nó recomeçarem noutro sítio. A política é uma chave de Encaminhamento.
  5. Caído: o cartão Recuperação do nó caído acompanha as suas células enquanto recomeçam noutros nós a partir do seu último instante copiado; as montagens que tinha perdem-se, e um destino que desde então ninguém serve é nomeado até que o monte noutro nó de armazenamento. Pôr em linha fica desativado, e diz porquê, até que a topologia volte a ter notícias do nó: então interrompe a recuperação, e o que já recomeçou noutro sítio fica lá.
  6. Fora de linha: Pôr em linha volta a dar trabalho ao nó; Desativar remove-o para sempre, como Rejeitar faz para um nó novo, e a topologia recusa enquanto o nó ainda tiver células, deslocações, montagens ou leases.
  7. Um sucesso aparece num aviso e a página volta a ler o nó: o seu cabeçalho diz em que estado o nó ficou. Uma recusa aparece sob o cabeçalho, com as palavras do seu motivo.

Sugestão A topologia nunca declara caído o seu próprio nó nem um que tenha a função Controlo, e recusa esvaziar o último nó em linha com a função Controlo, Identidade ou Dados, ou o último que escreve num destino ativo: a recusa nomeia a função ou o destino.

Ler as células

Células mostra onde residem os dados da instalação: cada célula é uma base de dados SQLite com um único nó proprietário. A linha sob o título conta as células, os seus tipos e os nós de dados; o gráfico, os tipos e as tabelas dizem como as células se distribuem e qual o seu tamanho.

  1. Escolha, ao lado do título, o que o gráfico mostra: Por nó desenha uma coluna para cada nó de dados e a linha da capacidade em células que cada nó declara — um nó acima de 80 % da sua capacidade fica a ocre, um nó novo, ainda sem trabalho, na cor da consola —; Por tipo desenha uma linha para cada tipo de célula, com os nós que o guardam; Por organização mostra as organizações com mais células, com os seus nós e, para uma organização dividida, os serviços em que as suas entidades têm células próprias.
  2. Células por tipo tem um mosaico para cada tipo, com a sua contagem e o seu tamanho. Um tamanho são os bytes das bases de dados das células, o que uma deslocação transfere: os serviços só os medem enquanto alguém observa a secção, por isso numa primeira visita os tamanhos estão a chegar e aparecem com os próximos anúncios; a linha sob os tipos diz depois de quantos nós vem o recenseamento que os dá e há quanto tempo foi feito. Um tamanho medido numa parte das células diz quantas foram medidas.
  3. Maiores células lista as células com as maiores bases de dados e Escritas mais recentemente as que foram escritas por último, cada uma com o nó que a guarda. Ninguém conta as escritas de uma célula: as células mais ativas mostram-se como as escritas mais recentemente.
  4. Células e tamanhos por nó é o gráfico por nó em palavras: para cada nó o seu estado, as suas células, a sua capacidade com a parte usada, ou não declarada, o tamanho das suas células, a idade do seu recenseamento e as células postas de parte. Um nó que regressa depois de uma recuperação põe de parte uma célula cujas cópias não tinham todas as suas escritas: fica à espera de um operador, e a tabela di-lo.
  5. A secção volta a ler-se sozinha enquanto está à vista — a cada 10 segundos enquanto algo chega ou se desloca, a cada 30 segundos caso contrário —; Atualizar lê-a de imediato.
  6. Num ecrã estreito os cartões ficam uns sob os outros, e o gráfico por nó desloca-se lateralmente dentro do seu cartão; para um leitor de ecrã, os valores do gráfico são os da tabela Células e tamanhos por nó.

Sugestão As contagens vêm do registo da topologia e são exatas; os tamanhos vêm do último recenseamento dos serviços, e ninguém mede os discos enquanto ninguém está a ver.

Reequilibrar as células

Plano de reequilíbrio mostra o que o reequilibrador deslocaria para nivelar os nós de dados: apenas o próximo lote, porque ninguém mede a carga de uma única célula e o reequilíbrio completo não se pode prever. Ao lado, o interruptor do reequilibrador automático e o cartão Porque, seguido do nome de um nó, que diz para onde vão as células novas e porquê.

  1. Leia a etiqueta do plano: simulação é o próximo lote tal como o reequilibrador o calcula agora; autorizado, depois de um operador o ter aplicado; em curso, com quantas deslocações do lote já chegaram; aplicado, quando todas chegaram. O lote é descrito pelas suas células, os seus bytes, os nós que deixa e os que alcança, e depois por uma linha para cada tipo e percurso.
  2. Leia sob o plano o que o reequilibrador está a fazer e porquê — equilibrado, à espera de que a diferença se mantenha, desligado, a assentar depois do lote anterior, sem orçamento —, com a diferença entre os nós de dados e o limiar, e o orçamento da última hora: deslocações, bytes e deslocações em simultâneo.
  3. Aplicar o plano, oferecido enquanto um reequilíbrio é devido, autoriza o reequilibrador: na sua próxima ronda, dentro de segundos, pede o lote tal como o calcular então, que pode ser diferente do mostrado, e sempre dentro do seu orçamento. Vale mesmo com o reequilibrador automático desligado, e não espera a duração mínima. A etiqueta acompanha depois o lote, e a linha sob o plano diz quem o autorizou e o que o reequilibrador fez.
  4. Quando o reequilibrador já não pediria um lote — menos de dois nós de dados com pontuação, um esvaziamento em curso, uma diferença dentro do limiar, o lote anterior a assentar, o orçamento esgotado, tamanhos ainda em falta, nenhuma célula medida que se possa deslocar —, a topologia recusa e o cartão diz porquê, por palavras.
  5. Reequilibrador automático: Desligar mantém o plano calculado e mostrado aqui, mas não desloca nada por si — um plano ainda se pode aplicar, e os esvaziamentos e as recuperações deslocam as suas células como sempre —; Ligar deixa o reequilibrador pedir lotes por si quando a diferença se mantém acima do limiar durante a duração mínima. Ambos perguntam primeiro.
  6. Leia o cartão Porque: a pontuação de carga do nó para onde vão as células novas dos serviços de dados — a parte livre: mais alta, mais livre — com o seu motivo, as medidas que a compõem, cada uma com a sua parte em uso e o seu peso, os candidatos mais livres e a histerese, que mantém o trabalho novo no nó escolhido antes enquanto este se mantiver perto do melhor.

Sugestão Os esvaziamentos e as deslocações dos operadores não contam no orçamento do reequilibrador. Limiar, duração mínima, orçamento e quando uma célula conta como fria são chaves da política, em Encaminhamento.

Deslocar uma célula e acompanhar as deslocações

Deslocações em curso lista as deslocações abertas das células, seja quem for que as pediu — o reequilibrador, um esvaziamento, uma recuperação ou um operador —, e a partir de Células pode deslocar uma célula por si para o nó de dados que escolher.

  1. Leia cada deslocação: a célula pelo seu tipo e a sua chave, o nó que deixa e o que alcança, a sua fase — Em transferência, Copiadas, Atribuídas — com uma barra, quem a pediu e quando; um passo que continua a falhar é indicado sob a fase, com quantas vezes falhou.
  2. Parar interrompe uma deslocação em transferência ou copiada pedida por um operador ou pelo reequilibrador: a célula continua ativa no seu nó, na mesma época, e o que o destino restaurou até então é descartado; uma célula cuja deslocação do reequilibrador pare não volta a ser escolhida por ele durante um dia. Uma deslocação de um esvaziamento ou de uma recuperação não tem Parar e diz de quem é: um esvaziamento interrompe-se a partir da página do nó, uma recuperação voltando a pôr o nó em linha. Uma deslocação atribuída já não se pode parar.
  3. Deslocar… numa linha de Maiores células ou de Escritas mais recentemente abre a caixa de diálogo com a célula e o nó que a guarda: escolha o destino entre os outros nós de dados em linha e prima Deslocar.
  4. Deslocar uma célula…, ao lado do título, pede o tipo, a chave tal como o registo a escreve — uma organização, um utilizador, ou organização/impressão digital para uma entidade — e o nó de destino, e lê qual nó guarda a célula antes de perguntar. A pesquisa da consola também encontra Deslocar uma célula…, e abre a sua caixa de diálogo.
  5. A confirmação nomeia a célula, o nó que deixa e o que alcança: as suas escritas esperam enquanto a origem a entrega e o destino a restaura, a origem remove os seus ficheiros depois do período de carência, e uma deslocação de um operador não conta no orçamento do reequilibrador.
  6. Uma recusa é indicada na caixa de diálogo, por palavras: uma célula que já se está a deslocar ou que já está nesse nó, um destino que não aceita células novas ou não tem a função, demasiadas deslocações abertas desse serviço no nó, uma célula sem um lugar próprio — uma entidade de uma organização não dividida desloca-se com a sua organização.

Sugestão Enquanto uma célula se desloca, as suas escritas esperam e é-lhes pedido que tentem de novo, e a sua época recusa uma escrita atrasada: nada se perde.

Ver para onde vai o trabalho novo

Encaminhamento diz para onde vai o trabalho novo e porquê: a política da topologia, a pontuação de cada nó, o nó escolhido para cada atribuição e as últimas escolhas com a sua motivação. A linha sob o título conta os nós e as atribuições, e lembra que uma pontuação é a parte livre: mais alta, mais livre.

  1. Pontuações lista cada nó em cada função que recebe trabalho — Dados, Computação, Armazenamento — com o seu estado, o peso da função quando não é 100, a sua pontuação e as suas medidas, cada uma com a sua parte em uso e a sua parte dos pesos da função; uma medida acima de 70 % para a CPU, ou de 80 % para as outras, fica a ocre. Um nó que ainda não anunciou uma carga di-lo; Carregar mais nós lê os seguintes.
  2. Nós escolhidos diz para onde vai agora o trabalho novo — as células novas de cada serviço de dados, as salas novas das chamadas, os trabalhos de renderização, as leituras e as escritas de cada destino montado —, cada um com o seu nó, o seu motivo e desde quando está escolhido. Uma atribuição que nenhum nó em linha pode receber é nomeada sob a lista.
  3. Abra Porque sob uma linha para ler a motivação da escolha: a pontuação com o seu motivo — o mais livre, o único candidato, o nó que pede ou o escolhido antes dentro da histerese —, as medidas com a sua parte em uso e o seu peso, os candidatos mais livres e a histerese. Uma motivação deixada aberta continua aberta quando a secção volta a ler.
  4. Escolhas recentes lista as últimas escolhas, da mais recente para a mais antiga: a hora, a atribuição, o nó escolhido com o seu motivo, e a célula e o nó que pediu, quando existem. Atribuição restringe-as a uma atribuição, e Carregar mais lê as mais antigas. A motivação de uma escolha passada mostra as medidas desse momento, não os pesos com que foi feita, que o registo não guarda.
  5. A secção volta a ler-se a cada 30 segundos enquanto está à vista; Atualizar lê-a de imediato.

Sugestão Quantas escolhas o registo guarda é uma chave da política, Escolhas guardadas: Escolhas recentes mostra apenas as que foram guardadas.

Alterar a política da topologia

Política, em Encaminhamento, contém as chaves da topologia em três partes — Carga, Reequilíbrio e Nós —, cada uma com o seu valor, o valor predefinido quando o valor difere dele, e quem a alterou e quando. Alterar… ao lado de uma chave abre o seu formulário.

  1. Carga: Pesos das medidas, quanto conta cada medida na pontuação de um nó de dados, de computação e de armazenamento — 0 exclui uma medida, e cada função mantém pelo menos uma acima de zero; Saturação, onde um nó conta como cheio em ligações, pedidos em curso e células abertas; Histerese, quão perto da melhor pontuação o nó que pede, ou o escolhido antes, mantém o trabalho novo; Escolhas guardadas, quantas escolhas o registo guarda para Escolhas recentes.
  2. Reequilíbrio: Reequilibrador automático, o mesmo interruptor de Células; Limiar da diferença, a diferença entre as pontuações dos nós de dados que inicia um reequilíbrio, que termina quando ela desce para metade; Duração mínima, quanto tempo a diferença tem de durar antes de o reequilibrador pedir um lote por si; Orçamento, as deslocações e os bytes por hora e as deslocações em simultâneo; Fria após, ao fim de quanto tempo sem escritas uma célula está fria — o reequilibrador desloca primeiro as frias, e 0 torna fria cada célula.
  3. Nós: Nós que se juntam, se um nó que se junta fica em linha por si ou fica novo até que um operador o ponha em linha a partir de Nós; Recuperação, se a topologia declara caído por si um nó em silêncio quando o seu lease expirou há mais de 10 segundos, ou espera que um operador o faça a partir da página do nó — até lá, as células do nó não podem ser alcançadas.
  4. No formulário cada campo indica os limites que a topologia aceita, e um valor errado é indicado sob o seu campo e não é enviado. Guardar pergunta primeiro, dizendo o que a alteração faz realmente — para onde vai o trabalho novo, o que o reequilibrador poderá pedir, quem declara um nó caído —, depois escreve a chave e volta a ler a secção.
  5. Cada alteração fica escrita no registo da topologia com o seu nome: a linha sob a chave diz quem a alterou e quando, e Eventos mostra-a.

Sugestão A consola verifica cada valor com os limites da topologia e não escreve um valor que fique fora deles; a topologia só recusa um valor quando é uma topologia de outra versão, com limites diferentes, e a recusa é dita com as palavras da secção.

Rastrear um pedido

Rastreios dos pedidos, em Encaminhamento, lista as janelas de recolha e os rastreios que recolheram. Um pedido só é rastreado dentro de uma janela aberta por um administrador: fora dela, nenhum serviço regista nada sobre ele.

  1. Abrir uma janela… pergunta o que recolher — um utilizador, pela identidade pseudónima que os eventos mostram; uma app, pelo client_id a que o seu token se destina; ou um caminho como o gateway o recebe, a começar por /api/ —, durante quantos minutos, no máximo 30, e porquê. O motivo fica nos eventos da topologia com o seu nome, e há no máximo quatro janelas abertas ao mesmo tempo.
  2. Os serviços começam a recolher no anúncio seguinte, em 5 segundos, e param quando a janela termina ou quando a fecha antes com Fechar.
  3. Cada rastreio recolhido é uma linha: quando, o pedido, o seu resultado, a app e o utilizador, o tempo no sistema. A linha leva à página do rastreio.
  4. A página do rastreio mostra o percurso: uma linha por etapa — a entrada pelo gateway, o encaminhamento para o nó que possui a célula, as verificações do token, a célula em SQLite, os bytes do armazenamento —, cada uma com o seu nó e serviço, o seu tempo e o seu resultado, depois o tempo no sistema. Enquanto ainda puderem chegar mais etapas, a página volta a ler o rastreio sozinha.
  5. Access token mostra o que viu o serviço que verificou o token: o cabeçalho e o conteúdo, os primeiros caracteres da assinatura e cada verificação com a sua regra. Os pedidos recusados com o mesmo token na janela são listados com o motivo por extenso, e as etiquetas sob o percurso só se acendem quando uma sonda do serviço de identidade as confirma.
  6. Copiar o rastreio copia a página como texto, sem a assinatura.

Sugestão O token nunca é guardado: um rastreio contém o seu cabeçalho e conteúdo descodificados, o resultado de cada verificação e os primeiros 12 caracteres da assinatura. Os rastreios vivem apenas na memória da topologia, no máximo uma hora depois de a sua janela terminar.

Consultar o armazenamento

Armazenamento mostra onde residem os bytes da instalação: uma coluna por classe — ficheiros dos utilizadores, anexos, pré-visualizações e cópias das bases de dados — com os seus destinos, quão cheio está cada um face aos seus limiares, e os nós de armazenamento que os montam e quantos bytes servem.

  1. Leia cada coluna: o destino contornado é o ativo da sua classe, o que recebe as novas escritas; sob cada destino vê o seu tipo (disco ou S3), a sua pasta ou bucket, o medidor face ao seu limiar de espaço e os nós que o montam.
  2. A marca no medidor indica onde a rotação prepara o destino seguinte; para lá dela o medidor fica ocre, e ao atingir o limiar o destino seguinte pronto na classe torna-se o ativo por si só.
  3. Leia Montagens: uma linha por nó de armazenamento, com os destinos que monta e o estado de cada montagem, a época da sua última alteração e os bytes que serve por segundo.
  4. Leia os eventos do armazenamento no fundo da página: quem registou, ativou, montou ou esvaziou o quê, do mais recente para o mais antigo; Mostrar mais lê os anteriores.
  5. A página volta a ser lida a cada 30 segundos enquanto está à vista; Atualizar lê-a de imediato.

Sugestão Um destino sem limiar mostra apenas os bytes contados desde o seu registo: os contadores são indicativos, e a rotação decide apenas com base numa contagem que o nó de armazenamento faz listando o destino.

Gerir os destinos

Em Armazenamento adiciona um destino — uma pasta no disco de um nó de armazenamento ou um bucket de um serviço compatível com S3 — e ativa-o, sela-o, esvazia-o, retira-o e altera os seus limiares; Rotação define quando o destino seguinte tem de estar pronto e quando passa a ser o ativo.

  1. Prima Adicionar destino: dê-lhe um nome e a classe que irá servir, escolha disco com uma pasta absoluta ou S3 com endpoint, região, bucket e a referência da credencial — o nome que o nó de armazenamento resolve a partir dos seus próprios segredos, nunca a credencial —, o nó de armazenamento que o monta e, se quiser, os seus limiares. O nó verifica-o antes de o servir; até lá, é novo.
  2. Abra o menu de um destino com o seu botão: oferece apenas o que o seu estado permite. Ativar para uma classe torna-o o ativo dessa classe; Selar passa cada classe que serve para o seu destino seguinte, aquele que a rotação escolheria, e a confirmação nomeia-o.
  3. Limiares… define o espaço, em GB ou TB, e os objetos; um campo vazio significa nenhum limiar. A rotação considera os novos limiares na sua próxima passagem.
  4. Esvaziar move os bytes de um destino selado para o ativo da sua classe, em segundo plano; Suspender o esvaziamento interrompe-o. Retirar remove um destino pronto que nunca recebeu bytes: confirme-o escrevendo o seu nome.
  5. Prima Rotação para definir a preparação e a rotação, em percentagem do limiar, e se o destino que a rotação sela se esvazia por si só para o novo ativo.

Sugestão Cada ação pergunta primeiro, nomeando o destino e dizendo o que vai acontecer; quando a topologia recusa, o motivo aparece junto ao destino, por palavras.

Montar, desmontar e esvaziar

Um destino serve os seus bytes a partir dos nós de armazenamento que o montam: Montagens mostra uma linha por nó de armazenamento e, a partir do menu de um destino, monta-o num nó, desmonta-o de um nó ou move uma montagem para outro nó.

  1. Leia Montagens: cada nó de armazenamento com os destinos que monta, o estado de cada montagem — um ponto verde serve, um ocre está a ser verificado, um anel está a ser desmontado —, a época da sua última alteração e os bytes que serve por segundo.
  2. Escolha Montar em… no menu, ou o botão num destino que ninguém serve: selecione um nó de armazenamento, novo ou em linha, e o modo. O nó verifica a pasta ou o bucket antes de servir.
  3. Escolha Desmontar de um nó: o nó deixa de admitir operações novas, permite que as que estão em curso terminem durante no máximo 60 segundos e cancela as restantes. O último nó que serve em escrita um destino ativo não pode ser desmontado enquanto outro destino não estiver ativo: a confirmação di-lo.
  4. Escolha Mover de um nó… para mover uma montagem para outro nó de armazenamento, novo ou em linha: o primeiro drena, o segundo verifica.
  5. Enquanto um destino se esvazia, o seu cartão mostra a barra rumo ao destino ativo da sua classe com a parte das referências movidas, depois o período de carência, a remoção das cópias antigas e a verificação por contagem.

Sugestão Desmontar nunca perde um byte: as leituras passam para outro nó que monte o destino e, sem nenhum, os seus ficheiros respondem «indisponível» até voltar a ser montado — nunca «não encontrado».

Ler o mapa da instalação

Mapa mostra toda a instalação de relance: os nós em três faixas por função, cada nó de dados um bloco com o mosaico das suas células face à sua capacidade, as cópias contínuas das bases de dados com a fita das suas últimas rondas, e os últimos eventos que alteraram a instalação, cada um com o seu autor.

  1. Leia as faixas: Entrada · controlo · identidade tem um bloco por nó com as suas funções e os serviços que nele respondem; Dados tem um bloco por nó de dados — o seu nome, o seu estado, o mosaico de quarenta posições (as suas células face à capacidade declarada em Pesos e capacidades, ou face ao nó de dados mais cheio quando não há nenhuma declarada), quantas células guarda e a sua CPU —; Computação · armazenamento · TURN tem uma ficha por nó. Cada bloco e cada ficha abre a página do seu nó.
  2. Siga um nó que cai: um contorno ocre diz que o seu lease não é renovado; um contorno vermelho com «isolado · N» diz que o lease expirou e o nó se isolou por si próprio; «fora de linha · N» diz que a topologia o declarou caído e está a recuperar as suas células a partir das cópias — as posições que perdeu têm contorno vermelho —, e os nós que as recebem têm o contorno na cor da consola, com as posições recebidas mais escuras, durante uma hora depois de a recuperação terminar.
  3. Escolha o que diz a cor dos blocos com Funções · Carga · Células: os estados, a CPU (a ocre acima de 70 %) ou as células face à capacidade (a ocre acima de 80 %).
  4. Cópias contínuas diz com que frequência cada processo copia as suas bases de dados, a fita das últimas trinta rondas da instalação — cada barra a ronda mais longa do seu segundo, a mais recente na cor da consola, uma mais longa do que a cadência a ocre —, para onde vão as cópias e até quanto tempo atrás se pode restaurar uma base de dados.
  5. Eventos mostra os últimos eventos que alteraram o mapa, uma série de células recuperadas ou deslocadas numa só linha, com o seu autor: uma pessoa com o seu nome de utilizador, uma tarefa como «topologia», um nó com o seu nome. Todos os eventos abre a secção Eventos.
  6. O mapa volta a ler-se a cada 5 segundos enquanto está à vista; Atualizar lê-o de imediato. Uma instalação com mais de quatro linhas de nós de dados desloca-se dentro do cartão.

Sugestão Quando um nó cai, mantenha o mapa aberto: vê o lease expirar, o nó isolar-se por si próprio, as suas células bloqueadas e recuperadas nos nós menos carregados — e em Eventos quem fez o quê, minuto a minuto.

Ler os eventos da topologia

Eventos é o registo da topologia, do mais recente para o mais antigo: o que aconteceu à instalação — aos seus nós, células, leases, armazenamento e política —, cada evento com o seu autor, uma pessoa ou uma tarefa da topologia. A linha sob o título diz quantos eventos o registo guarda.

  1. Escolha um tipo acima da lista — Todos, Nós, Células, Leases, Armazenamento, Política, Topologia — e um nó em Nó: a lista mostra os eventos dessa família que nomeiam esse nó, como seu objeto ou entre os nós de antes e de depois. Os filtros ficam no endereço da página, pelo que uma ligação os mantém.
  2. Leia cada linha: a hora, com a data quando não é hoje; o ponto e a palavra da família; o que aconteceu, por palavras; o seu objeto — um nó é uma ligação para a sua página, uma célula é o seu tipo e a sua chave —; e por baixo o seu autor: um administrador pela sua conta, uma tarefa da topologia pelo que faz, como a presença, os leases ou o reequilibrador.
  3. Abra Antes e depois numa linha para ler o que o evento alterou, tal como o registo o escreveu; nada significa que não havia valor.
  4. Carregar mais lê os eventos mais antigos. A topologia lê o seu registo um troço de cada vez: quando um troço não tem eventos para os seus filtros, a consola continua sozinha algumas vezes, depois di-lo e oferece Continuar a procurar — só diz que nenhum evento corresponde quando já não resta nada mais antigo.
  5. Os eventos novos chegam ao topo a cada 30 segundos enquanto a secção está à vista; Atualizar lê de imediato.

Sugestão Uma alteração da política, um esvaziamento, um nó declarado caído ou um plano aplicado levam o nome de quem o fez: Eventos é onde encontrar quem alterou o quê, e quando.

Atualizar as bases de dados

Atualização verifica, para cada serviço, se as suas bases de dados estão na versão que o servidor espera. Enquanto não estiverem, as funções de dados desse serviço ficam desligadas para proteger os dados.

  1. Leia cada linha: Total e Desatualizadas, com Atualizado, Atualização disponível, Inacessível — o serviço não respondeu — ou Falha na verificação, com o motivo por baixo da linha.
  2. Executar atualização só aparece quando algo está desatualizado. A confirmação indica o serviço, quantas bases de dados passam para que versão e que não pode ser anulada: escreva o identificador do serviço que ela mostra — por exemplo auth — e confirme; o servidor atualiza em segundo plano enquanto a linha diz A atualizar…
  3. A linha volta a ser verificada a cada 2 segundos até o servidor terminar, e um aviso diz como terminou; Falha na atualização diz que não conseguiu.
  4. O ícone da base de dados abre a página de detalhe, com cada base de dados, o caminho, a versão atual e a de destino e o estado — incluindo Mais recente do que o servidor e Ainda não criada; também dali se pode executar a atualização.

Sugestão Pode fechar a página durante uma atualização: ao reabri-la, volta a vigiá-la.

Contas e organizações

Contas, códigos de convite, organizações e governação da partilha.

Gerir as contas

Conta lista os utilizadores registados: nome, email, estado — Ativo, Suspenso, Verificação pendente ou Desativado — e data de registo.

  1. Registo de acessos abre o histórico de entradas de um utilizador: hora, evento, resultado, endereço IP e cliente.
  2. Repor palavra-passe abre um campo onde escreve uma nova palavra-passe antes de clicar em Aplicar: as sessões do utilizador são fechadas.
  3. Suspender pergunta primeiro, indicando a pessoa: deixa de poder entrar, as suas sessões são terminadas e uma aplicação que já tenha aberta para em poucos minutos; Reativar volta a dar acesso, sem confirmação.
  4. Eliminar pede que escreva o e-mail da pessoa: retira para sempre a conta, o respetivo perfil, as associações a organizações e as sessões; os ficheiros, o e-mail e as conversas que essa pessoa tem nas aplicações não são eliminados.
  5. Criar utilizador acrescenta uma conta com email e palavra-passe, ativa de imediato.

Sugestão Uma palavra-passe definida aqui fecha todas as sessões do utilizador: comunique-lhe a nova por um canal seguro.

Gerar códigos de convite

O Merydion funciona por convite: cada código de convite abre um único registo, e quem o usa consome-o.

  1. Clique em Gerar código de convite: o novo código aparece junto ao botão, pronto a entregar à pessoa que convida.
  2. A lista mostra os códigos, do mais recente para o mais antigo: Disponível ou Consumido, a data de criação e, depois de usado, Utilizado por com a conta que abriu.
  3. Clique num código para o selecionar por inteiro e copie-o.

Sugestão Entregue cada código a uma só pessoa: depois de usado, não abre um segundo registo.

Gerir as organizações

Tenant lista todas as organizações da instalação, com o tipo, o estado, os membros e os administradores; uma organização sem administradores aparece em destaque.

  1. Em Criar organização, escreva o Nome da organização e clique em Criar tenant.
  2. Para mudar o nome de uma organização, altere-o na sua linha e clique em Renomear.
  3. Membros abre o painel de uma organização: mude a função de um membro, use Remover depois de uma confirmação que indica a pessoa e a organização — o último administrador fica, e a linha di-lo — e convide pessoas como na página da organização.
  4. A associação direta acrescenta de imediato um utilizador, sem convite, com a função que escolher: está reservada aos administradores da instalação.

Sugestão Para dar a uma organização o primeiro administrador, associe uma pessoa com a função Administrador, ou convide-a como administrador.

Governar a partilha

Governação define a política de partilha e as etiquetas de confidencialidade de qualquer organização, e mostra o registo de auditoria das suas decisões de partilha.

  1. Escreva o identificador da organização em Tenant: carregam-se a política, as etiquetas e o registo dela.
  2. Em Política de partilha, ajuste Partilha interna, Ligações públicas, Pedidos de ficheiros e Coedição em tempo real, e clique em Guardar política, que só se ativa quando algo mudou.
  3. Em Etiquetas de confidencialidade, acrescente uma etiqueta com o nome, a cor e Bloqueia a partilha, ou elimine uma: a confirmação indica-a e, para uma etiqueta que bloqueia a partilha, lembra que os documentos que a têm voltam a poder ser partilhados publicamente.
  4. Registo de auditoria lista as decisões recentes com hora, sujeito, ação, recurso, decisão e motivo, a ação indicada por extenso, como Ligação pública ou Gravação de uma sessão de coedição; Entradas escolhe quantas, de 1 a 500.

Sugestão Os administradores de uma organização definem as mesmas regras na sua própria página; aqui pode fazê-lo para qualquer organização.

Feedback, solicitações e mensagens

O que as pessoas enviam: avaliações, solicitações de suporte e mensagens do site.

Ler o feedback

Feedback reúne as avaliações e os comentários que as pessoas enviam com Ajuda → Feedback nas aplicações, do mais recente para o mais antigo.

  1. Leia o resumo: a avaliação média, o número de feedbacks recebidos e uma barra por cada avaliação de 5 a 1.
  2. Clique numa barra para ver só essa avaliação, e de novo para retirar o filtro; Só com comentário deixa os que têm comentário, e Todos retira os filtros.
  3. Aplicação escolhe a aplicação cujo feedback lê.
  4. Cada cartão mostra a avaliação, a referência, o comentário, quem o enviou, a aplicação com a versão e a plataforma.

Sugestão Quando há mais feedback do que a lista mostra, uma linha di-lo: o resumo conta sempre tudo.

Tratar as solicitações de suporte

Solicitações de suporte é a fila dos pedidos que as pessoas abrem com Ajuda → Suporte nas aplicações, do mais recente para o mais antigo.

  1. Cada cartão mostra o impacto, a categoria, a referência, o assunto e a descrição, quem o escreveu, a aplicação com a versão, a plataforma, o idioma e a data.
  2. Mostrar descrição completa abre uma descrição longa, e Mostrar menos fecha-a.
  3. A pesquisa e os filtros Aplicação, Impacto e Categoria reduzem a fila; a contagem diz quantos pedidos são mostrados do total.
  4. Responder por email abre o seu programa de correio para o autor, com a referência e o assunto já na linha de assunto.

Sugestão Responda por email mantendo a referência no assunto, para a conversa ficar junta.

Ler as mensagens do site

Mensagens reúne o que os visitantes escrevem com o formulário de contacto do site, da mais recente para a mais antiga. O formulário não envia email a ninguém: a consola é o único lugar onde as mensagens chegam.

  1. A pesquisa reduz as mensagens por nome, email, assunto ou texto.
  2. Mostrar a mensagem completa abre uma mensagem longa.
  3. Responder por email abre o seu programa de correio para o remetente, com Re: e a referência no assunto.
  4. Eliminar, quando o remetente o pede, retira uma mensagem para sempre: confirme com Eliminar definitivamente, ou volte atrás com Cancelar ou Esc.

Sugestão As mensagens são apagadas automaticamente ao fim de 12 meses.

Para administradores da organização

Administração da organização

A administração da organização é a página onde os proprietários e os administradores de uma organização a governam. Abre na organização que administra, e as secções sucedem-se à esquerda: visão geral, pessoas, armazenamento, serviços, partilha e dois registos. As etiquetas da página ainda não estão traduzidas: o guia cita-as tal como a página as mostra.

Este guia percorre cada secção. Pôr toda a instalação a funcionar é outro trabalho, descrito no guia da consola da instalação.

Primeiros passos

Abra a página e leia a visão geral da sua organização.

Abrir a administração da organização

A página é dos proprietários e dos administradores de uma organização. O seu espaço pessoal não é uma organização a administrar, por isso nunca aparece aqui.

  1. Abra o menu da conta no canto superior direito, ou as ações rápidas do seu espaço de trabalho, e escolha Administrar a organização: só aparece se administrar uma organização.
  2. Depois de aceitar um convite como administrador, Administrar a organização na página do convite também leva aqui.
  3. Se administrar mais de uma organização, escolha a que quer governar no seletor Organization, em cima.
  4. Atualizar volta a ler todas as secções e indica a hora da última verificação.

Sugestão Sem sessão iniciada, a página mostra Entrar, que o traz de volta aqui; se não administrar nenhuma organização, di-lo, lembra que os direitos de administração são concedidos por um proprietário ou administrador da organização e leva-o de volta ao seu espaço de trabalho; se não for possível ler a organização, Tentar novamente volta a lê-la.

Ler a visão geral

O topo da página indica a organização, o tipo, o estado e quando foi criada. As secções sucedem-se à esquerda, uma de cada vez.

  1. Overview mostra os números da organização: membros, administradores, serviços ativos no total e armazenamento em uso.
  2. Para mudar o nome da organização, altere Name e clique em Save: o topo e o seletor ficam logo com o novo nome.
  3. Passe de uma secção para outra clicando nelas, ou com as setas, Home e End.
  4. Um ponto em People, e uma faixa na visão geral, avisam que a organização já não tem administradores.
  5. Cada secção diz quando está a carregar; uma que não consegue ler o que mostra diz o quê e porquê, com Tentar novamente, e uma vazia propõe o passo seguinte.

Sugestão Uma organização sem administradores não pode ser governada até alguém receber a função: fale com o administrador da instalação.

Pessoas

Os membros e as suas funções, e os convites para entrar.

Gerir membros e funções

People lista quem faz parte da organização: nome, email e função. Para proprietários e administradores, uma linha indica desde quando e quem os designou.

  1. Escolha uma função na linha de uma pessoa — Proprietário, Administrador ou Membro: a alteração aplica-se de imediato e concede ou retira a administração.
  2. Se o servidor recusar uma alteração, volta a função anterior: a organização tem de manter pelo menos um administrador.
  3. Remover pergunta primeiro, indicando a pessoa e a organização: para voltar, será necessário um novo convite, que terá de ser aceite. Se o servidor recusar, a linha diz porquê.
  4. Com mais de seis membros, Search a person filtra a lista por nome ou email.

Sugestão Para trazer alguém novo, convide essa pessoa: veja Convidar pessoas para a organização.

Convidar pessoas para a organização

Em People convida um endereço como membro ou como administrador. A pessoa só entra se aceitar, por isso ninguém é adicionado sem consentimento, e a resposta é a mesma tenha ou não o endereço uma conta.

  1. Em Convidar uma pessoa, escreva o email, escolha a função proposta — Membro ou Administrador — e clique em Enviar convite.
  2. O convite vale sete dias. Em Convites vê os pendentes, expirados incluídos, e os recusados e revogados recentemente, cada um com quem convidou e quando expira.
  3. Reenviar envia de novo o convite com novo prazo; Revogar anula-o, e a ligação no email deixa de funcionar.
  4. Pendente, Expirado, Recusado e Revogado dizem em que ponto está cada convite: a adesão só nasce quando a pessoa aceita.

Sugestão Adicionar alguém de imediato, sem convite, está reservado ao administrador da instalação, a partir da consola.

Armazenamento e serviços

Quanto cada membro pode armazenar, e que aplicações a organização pode usar.

Definir quotas de armazenamento

Storage mostra, para cada membro, quanto armazena face à sua quota.

  1. Leia cada linha: o espaço usado sobre a quota, com uma barra que fica vermelha a partir dos 90%.
  2. Para alterar uma quota, escreva o novo valor em Quota (GB) — um número inteiro maior do que zero — e clique em Save: a página confirma a alteração.
  3. Um membro que nunca abriu o Aerarys ainda não tem armazenamento: definir uma quota cria-o.

Sugestão Quando o armazenamento de um membro não pode ser lido, a linha di-lo em vez de mostrar zero.

Ativar e desativar aplicações

Services tem um interruptor para cada uma das seis aplicações. Os membros da organização não conseguem entrar numa aplicação desativada, nem na web nem nas aplicações de ambiente de trabalho, e o seu mosaico aparece esbatido no espaço de trabalho deles.

  1. Leia cada linha: Available ou Turned off, com quem definiu e quando — ou que nunca foi restringida.
  2. Clique num interruptor para desativar uma aplicação: a confirmação indica a aplicação e a organização e lembra que os membros deixarão de a poder abrir; enquanto não confirmar, o interruptor fica ligado.
  3. O aviso que se segue oferece Anular, que volta a ativar a aplicação: fica até o fechar.
  4. Clique de novo no interruptor para voltar a ativar a aplicação, sem confirmação.
  5. Se o servidor recusar a alteração, o interruptor volta atrás e a linha diz que a alteração não foi guardada.

Sugestão Desativar uma aplicação não apaga nada: os documentos ficam onde estão, e voltam logo que a aplicação é reativada.

Partilha

O que pode sair da organização, as etiquetas de confidencialidade e os registos do que aconteceu.

Definir as regras de partilha

Sharing tem quatro interruptores que decidem o que pode sair da organização: partilhar com um colega, ligações públicas, pedidos de ficheiros e coedição em tempo real. A página só muda o que toca, e nunca parte de um valor que não leu.

  1. Leia os quatro interruptores. Um interruptor com um traço ainda não foi lido e fica bloqueado até o estado atual ser carregado.
  2. Clique num interruptor para mudar só essa regra: as outras mantêm o seu valor.
  3. Se outro administrador alterou as regras depois de abrir a página, a sua alteração não é guardada: clique em Recarregar para ver o estado atual e decida de novo.
  4. Se o estado atual não puder ser lido, os interruptores ficam bloqueados até que o seja.

Sugestão Cada decisão destas regras fica registada em Sharing log.

Gerir as etiquetas de confidencialidade

As etiquetas de confidencialidade são as classificações que os documentos da organização podem ter, como Confidencial. Uma etiqueta pode bloquear a partilha pública do que a tem.

  1. Em Sensitivity labels, escreva o Label name, assinale Blocks public sharing se necessário e clique em Add label.
  2. Um nome já usado é recusado.
  3. Para retirar uma etiqueta, clique em Eliminar e confirme: a confirmação indica-a e, para uma etiqueta que bloqueia a partilha pública, lembra que os documentos que a têm voltam a poder ser partilhados com uma ligação pública ou um pedido de ficheiros.

Sugestão Uma etiqueta nunca muda de nome: o nome é a sua identidade, e já está escrito nos documentos que a têm.

Ler o registo de partilhas

Sharing log lista as últimas 100 decisões de partilha tomadas para a organização, da mais recente para a mais antiga.

  1. Leia cada linha: quando, a ação e o recurso, o resultado — Allowed ou Denied — e quem pediu. A ação é indicada por extenso: Partilha interna, Ligação pública, Pedido de ficheiro, Entrada na coedição em tempo real, Gravação de uma sessão de coedição ou Administração do armazenamento de uma pessoa.
  2. Uma decisão Denied significa que uma regra de partilha ou uma etiqueta de confidencialidade travou a partilha.

Sugestão Atualizar, no topo da página, volta a ler o registo.

Ler o registo do Simposys

Simposys log regista quem alterou as equipas, os canais e as conversas de grupo da organização: membros adicionados ou retirados, funções, códigos de adesão, endereços e webhooks dos canais, e mensagens eliminadas por um moderador.

  1. Leia cada linha: quem fez o quê, em que equipa, canal ou conversa de grupo, e quando — da mais recente para a mais antiga.
  2. Clique em Load more para ver acontecimentos anteriores.

Sugestão Se o registo do Simposys não puder ser lido neste momento, a secção di-lo: tente de novo com Atualizar.