Quando algo não funciona: por onde começar

14 min · 12 secções

Este guia está ordenado pelo que vês, não pelo que falha. Procura o sintoma, e daí sai o que verificar e por que ordem.

Uma regra antes de mais nada: o painel diz o que sabe e não adivinha. Se um ecrã te dá um motivo, esse motivo foi verificado; se te diz «não foi possível verificar», é porque de facto não foi possível, e é aí que entra este guia.

1. Não consigo abrir o painel

A primeira coisa é separar duas situações muito diferentes: o NAS não responde ou o teu navegador não quer entrar. Distinguem-se em dez segundos.

1.1 Continua nesse endereço?

A causa número um de «não abre» não é uma avaria: é o IP ter mudado. Acontece quando o router reinicia e distribui os endereços outra vez.

Com um monitor e um teclado ligados ao NAS, ou por SSH:

lgm

Mostra a versão, o nome do dispositivo e o endereço do painel. Se for diferente do que tinhas guardado, o problema era esse, e a solução de fundo é dar-lhe um endereço fixo: Painel de controlo → Rede, ou a partir da consola lgm set-ip.

1.2 O serviço está a funcionar?

systemctl status nas-backend nas-helper

São os dois que importam: nas-backend é o painel e nas-helper é o processo com permissões que faz o trabalho do sistema. Se um dos dois estiver parado:

sudo systemctl restart nas-backend
lgm log

lgm log mostra o registo do painel, que é onde vai estar o motivo.

⚠️ Se acabaste de atualizar e o painel não volta, vê a secção 6.

1.3 «O servidor NAS não responde neste momento (a reiniciar?)»

Esta mensagem aparece dentro do painel: a página carregou, por isso o navegador chegou ao NAS alguma vez. Dois casos:

• Acabaste de atualizar ou reiniciar. É normal durante uns segundos; o painel volta a tentar sozinho e regressa.
• Aparece logo ao abrir e não desaparece. Então a página que estás a ver saiu da cópia guardada no navegador, não do NAS. Costuma ser o certificado: o navegador recusa a ligação e nunca chega a mostrar-te o seu próprio aviso, que é o único ecrã a partir do qual se aceita. Na própria mensagem tens o botão «Entrar sem a cópia guardada», que apaga essa cópia e recarrega; aparece então o aviso do certificado de sempre.

2. Entro, mas uma aplicação diz que não tenho acesso

Não é uma avaria: é a distribuição das aplicações. Cada conta tem as suas e com que nível —ver ou ver e alterar—, e quem manda é o NAS, não o ícone.

Quem administra altera isso em Painel de controlo → Utilizadores e grupos → a conta → Aplicações. Está tudo explicado em Utilizadores, permissões e o que cada um vê.

Duas coisas que confundem:

• O ícone já não está lá. Ao retirar uma aplicação, ela desaparece também do ambiente de trabalho e da pesquisa dessa conta. Não foi desinstalada: só não é dela.
• Consigo ver mas não alterar. É o nível «ver». Os botões que escrevem não aparecem. Em Câmaras, Cópias de segurança e Armazenamento é o máximo que se pode dar a uma conta que não administra.

3. Não vejo o NAS a partir do Windows, do Mac ou do telemóvel

Por ordem, do mais comum ao menos comum:

1. Essa conta tem acesso à pasta? Partilhar uma pasta e dar acesso a alguém são duas coisas diferentes: Painel de controlo → Pastas da casa → a pasta → Permissões.
2. O protocolo está ligado? SMB, NFS e WebDAV ligam-se separadamente em Painel de controlo → Serviços de ficheiros, e além disso é preciso marcá-lo **em cada pasta**.
3. A palavra-passe de SMB não é a do painel se nunca a definiste. Ao criar a conta definem-se as duas ao mesmo tempo, mas mudar uma não muda a outra.
4. Escreve o endereço à mão em vez de esperares que apareça sozinho: no Windows \\192.168.1.50, no Mac smb://192.168.1.50. A descoberta automática da rede é a primeira coisa a falhar e não significa nada.
5. Falta só «A minha unidade»? Tem a sua própria linha em `Painel de controlo → Pastas da casa`: se estiver desligada, ou sem o protocolo que usas, não aparece. Por NFS, além disso, só a montam os dispositivos da sua lista.

Todo o pormenor, dispositivo a dispositivo, em Ligar os teus dispositivos ao NAS.

4. Está lento

Antes de mexer em alguma coisa, vê quem está a trabalhar: Monitor mostra CPU, memória, rede e discos em tempo real. Com isso, três casos:

• Os discos a 100 % e tudo o resto calmo. Quase sempre é um scrub, uma cópia ou o indexador de fotos. Termina e passa; em Armazenamento e em Cópias de segurança vê-se o que está a correr.
• A rede no máximo. Alguém está a copiar alguma coisa, ou há um torrent a enviar. Os limites de velocidade das transferências estão na sua própria app.
• Tudo calmo e mesmo assim lento. Se for um torrent, vê o aviso da porta na app Transferências: com a porta fechada só transferes dos pares a que te ligas tu, e isso é uma fração da velocidade. Se for SMB, experimenta copiar um ficheiro grande em vez de muitos pequenos: mil ficheiros de 10 KB são mil conversas, e isso é lento em qualquer NAS.

5. Um disco dá erros

Não o desligues ainda. Com RAID, tirar o disco errado transforma um problema numa perda.

1. Armazenamento → Proteção → Saúde e encriptação diz qual é o disco e o que tem (SMART). Aponta o seu número de série, que é a única coisa que não muda; a letra (sda, sdb) pode mudar ao reiniciar.
2. Se o volume continuar a funcionar, faz uma cópia agora antes de mexer em alguma coisa. Um disco que começa a falhar costuma aguentar horas.
3. A substituição faz-se a partir do painel e está explicada passo a passo em [Recuperação de desastres](disaster-recovery.md).

6. Atualizei e algo correu mal

lgm log e lgm progress contam o que aconteceu na última atualização.

• O painel não volta. O atualizador guarda uma cópia das unidades antes de lhes mexer precisamente para isto. systemctl status nas-backend diz se é porque não arranca, e lgm log o motivo.
• Uma tarefa crítica a meio. Se houver um restauro ou uma cópia a correr, a atualização recusa-se a começar. É de propósito.

Voltar à versão anterior

Se uma versão nova te estragar alguma coisa e não puderes esperar pela correção, em Painel de controlo → Atualizar o LGM-OS há um botão «Voltar à X» com a versão que existia antes da última atualização. Devolve o painel a essa versão num minuto; os teus dados e as tuas definições ficam como estão e as aplicações continuam a funcionar. A versão retirada não volta a instalar-se sozinha: quando quiseres, «Instalar mesmo assim». O botão não aparece se a atualização mudou a forma das definições (a versão anterior não as entenderia); o painel diz-te isso.

7. O disco encheu

A primeira coisa é saber de que disco estamos a falar: o do sistema e o dos dados são diferentes e resolvem-se de formas diferentes.

• O volume de dados. Painel de controlo → Relatório de espaço mostra em que se gasta o disco e os duplicados. Atenção aos instantâneos: o que eliminas continua a ocupar espaço enquanto houver um instantâneo que se lembre disso.
• O disco do sistema. Enche-se com registos, imagens do Docker e transferências mal colocadas. O botão Limpar do Centro de pacotes —que elimina imagens e volumes que já ninguém usa— e a reciclagem são os dois primeiros sítios.

8. Como pedir ajuda com dados

Em Painel de controlo → Verificação do sistema há um botão, Transferir relatório para o suporte, que transfere um ficheiro com tudo o que é preciso para perceber o que se passa com o dispositivo: a versão, como correu a última atualização, a verificação dos serviços, os discos, a rede, as aplicações do Docker, os avisos e as últimas linhas do registo do painel (no máximo 5.000, do último dia). Prepará-lo pode demorar um minuto. Envia-o tal como está a quem te estiver a ajudar; é o que poupa as dez perguntas de ida e volta. Não leva palavras-passe: nem as das contas do NAS, nem as das câmaras, nem as das nuvens. Os campos que as guardam aparecem como [oculto].

Se preferires vê-lo tu a partir da consola:

lgm info      # versão, dispositivo e endereço
lgm log       # o registo do painel
systemctl status nas-backend nas-helper

E a secção Testes de rede da Verificação traz as verificações de rede —resolver um nome, sair para a internet, ver se uma porta responde— sem sair do navegador.

⚠️ Antes de colares um registo em algum sítio, lê-o. O painel apaga as palavras-passe das mensagens que mostra, mas um registo do sistema é do sistema e pode levar endereços internos ou nomes das tuas pastas.

9. «A definição … estava danificada»

As definições do painel vivem em ficheiros de /var/nas/state, um por tema: users.json as contas, shared_folders.json as pastas da casa, e assim por diante. Se um não puder ser lido, o painel não vai abaixo: põe-no de parte como <nome>.json.corrupt, continua com os valores de fábrica dessa parte e avisa-te com «A definição «…» estava danificada». O que notas depende de qual for:

⚠️ Até a recuperares, não cries nem edites nada dessa parte do painel: guardarias os valores de fábrica por cima. Com shared_folders posto de parte, criar uma pasta voltaria a publicar só essa.

Quase sempre o ficheiro está bem. Até à 2.0.4, uma leitura que corria mal punha de parte ficheiros que no disco estavam perfeitos. Desde a 2.0.4 isso já não acontece, e ao arrancar o painel repõe sozinho os que se leem bem: vais ver «A definição «…» recuperou sozinha».

9.1 Recuperá-la

Por SSH, ou com um monitor e um teclado ligados ao NAS:

1. Com uma versão anterior à 2.0.4, atualiza. Ao arrancar a versão nova é reposta sozinha, e não é preciso mais nada:

sudo lgm update

1. Se já tens a 2.0.4 ou posterior, reinicia o painel; ao arrancar verifica os ficheiros postos de parte:

sudo systemctl restart nas-backend

1. À mão, sem atualizar nem reiniciar. Cola isto inteiro. Repõe cada ficheiro posto de parte que seja uma definição boa, não se sobrepõe a um que já tenha voltado a ser guardado e não mexe nos que estão mesmo estragados:

sudo python3 - <<'EOF'
import glob, json, os
d = "/var/nas/state"
for apartado in sorted(glob.glob(d + "/*.json.corrupt")):
    nombre = os.path.basename(apartado)[:-len(".json.corrupt")]
    destino = f"{d}/{nombre}.json"
    if os.path.exists(destino):
        print(f"- {nombre}: já há um novo, não se mexe"); continue
    try:
        doc = json.loads(open(apartado, "rb").read().decode("utf-8"))
    except Exception as e:
        print(f"- {nombre}: mesmo estragado, fica como está ({e})"); continue
    if not isinstance(doc, dict):
        print(f"- {nombre}: não tem forma de definição, fica como está"); continue
    st = os.stat(apartado)
    tmp = destino + ".reponiendo"
    with open(tmp, "wb") as f:
        f.write(json.dumps(doc, indent=2, ensure_ascii=False).encode("utf-8")); f.flush(); os.fsync(f.fileno())
    os.chown(tmp, st.st_uid, st.st_gid); os.chmod(tmp, 0o600); os.replace(tmp, destino)
    print(f"+ {nombre}: reposto")
EOF

Cada linha com + é uma definição reposta, e nota-se de imediato: com users, já se consegue entrar.

9.2 Se estiver mesmo estragada

Se o passo 3 disser «roto de verdad», o que está no ficheiro não se pode aproveitar e é preciso tirá-lo da cópia da configuração.

• Consegues entrar no painel (a estragada não é users): Painel de controlo → Cópia da configuração → «Restaurar a partir de ficheiro…».
• Não consegues entrar (a estragada é users): tira-se da cópia por SSH. Primeiro, a mais recente:

sudo find /mnt /srv -name 'nas-config-*.tar.gz' -printf '%T+ %p\n' 2>/dev/null | sort | tail -3

E dela, só essa definição (muda o caminho para o que tiver aparecido acima):

COPIA=/mnt/tank/backups/nas-config-XXXX.tar.gz
sudo tar -xzf "$COPIA" -C /tmp state/users.json
sudo install -o "$(stat -c %U /var/nas/state)" -g "$(stat -c %G /var/nas/state)" -m 600 \
  /tmp/state/users.json /var/nas/state/users.json
sudo rm -rf /tmp/state

• Sem cópia das contas: reinicia o painel (sudo systemctl restart nas-backend). Sem contas, volta o assistente do primeiro arranque; pede o código de registo, que só se vê no ecrã do próprio NAS ou com sudo lgm alta. Cria o administrador e volta a registar as restantes contas. Os teus ficheiros e pastas não são tocados.

10. Um aviso de erros no barramento PCIe

O NAS vigia o barramento PCIe, por onde falam com a placa os discos NVMe, as controladoras de discos, as placas de rede e a placa gráfica, e avisa assim que um começa a dar erros, dizendo qual.

• «Erros corrigidos no barramento PCIe»: o sistema corrigiu-os e para já não se perde nada. Se o aviso se repetir e a contagem continuar a crescer, costuma ser um contacto solto ou um dispositivo a começar a falhar: desliga o NAS e volta a encaixá-lo bem na sua ranhura.
• «Erros no barramento PCIe»: erros que o sistema não conseguiu corrigir. Costuma ser um dispositivo mal encaixado, que aquece ou que começa a falhar. Se for um disco, **faz já uma cópia do que é importante**; depois desliga o NAS, volta a encaixar o dispositivo e confirma que lhe chega ar.

11. As chaves do painel e o chip TPM

As chaves que o painel guarda para funcionar — a da VPN, a do DNS dinâmico, a da UPS e outras — são guardadas cifradas com o chip TPM 2.0 da placa se o dispositivo o tiver. Não há nada a ativar, e num dispositivo sem chip guardam-se como sempre.

Se um dia o chip deixar de as abrir, o NAS arranca na mesma e avisa com «O chip de segurança não abre os segredos do painel». Costuma acontecer ao trocar de placa ou ao apagar o TPM na BIOS. Entretanto, a VPN, o DNS dinâmico e o que usar essas chaves não funciona.

• Não se perdeu nada. Entra no painel com uma conta de administrador escrevendo a sua palavra-passe, e as chaves recuperam-se sozinhas. Confirma-o o aviso «Segredos do painel recuperados».
• Se o chip funcionar, voltam a guardar-se com ele; se o dispositivo já não tiver um chip que funcione, guardam-se como antes, sem ele.

Ver também

• Recuperação de desastres — quando já aconteceu algo grave.
• Utilizadores, permissões e o que cada um vê — quase tudo o que é «não consigo ver isto».
• Glossário — o que significa cada palavra estranha das que aparecem aqui.