{
"meta": {
"title": "Aplicar atualizações disponíveis — Otimizações pós-instalação | Documentação ProxMenux",
"description": "Como o ProxMenux detecta quando uma otimização pós-instalação (Log2Ram, Configurações de Memória, Limites de Sistema, Logrotate, Ajuste de Rede...) foi atualizada a montante, e como aplicar a nova versão — do menu Post-Install ou do painel Monitor."
},
"header": {
"title": "Aplicar atualizações disponíveis",
"description": "Quando uma otimização pós-instalação (Log2Ram, definições de memória, limites do sistema, Logrotate…) tem uma versão no disco mais recente que a registada no host, o ProxMenux apresenta-a como atualização disponível. Pode aplicá-la pelo menu pós-instalação dos scripts ou pelo painel Monitor. Ambos executam novamente a mesma função e atualizam o registo.",
"section": "Configurações pós-instalação do Proxmox"
},
"intro": {
"title": "O que é isto?",
"body": "As otimizações pós-instalação ProxMenux têm versões, por exemplo Log2ram SSD Protection v1.2. O host regista as otimizações ativas e as suas versões em /usr/local/share/proxmenux/installed_tools.json. Quando uma nova versão ProxMenux atualiza uma otimização, deteta a diferença e propõe reaplicar só essa, sem repetir toda a pós-instalação."
},
"why": {
"heading": "Por que isto existe",
"body": "As otimizações pós-instalação recebem melhorias: ajustes sysctl, limites Logrotate mais rigorosos, novas regras de dimensão Log2RAM ou correções de casos extremos. Sem esta via, era necessário repetir o script, que reaplica todas as otimizações, ou abdicar da melhoria. Aplicar atualizações disponíveis permite escolher individualmente só as que mudaram de versão."
},
"detection": {
"heading": "Como as atualizações são detectadas",
"steps": [
{
"title": "Scripts com versão no disco",
"body": "Cada função pós-instalação declara sua versão dentro do script (scripts/post_install/auto_post_install.sh e scripts/post_install/customizable_post_install.sh). Um scanner extrai estas versões da fonte no disco."
},
{
"title": "Registo versionado na máquina",
"body": "Quando o operador aplicou cada otimização, a chamada register_tool correspondente escreveu a versão ativa em /usr/local/share/proxmenux/installed_tools.json. Esse arquivo é a fonte da verdade para \"o que está ativo neste host agora\"."
},
{
"title": "Monitor compara ambos os lados",
"body": "Na inicialização e a cada 24h, o Monitor compara versões de disco com versões de registro. Qualquer incompatibilidade produz uma entrada em /usr/local/share/proxmenux/updates_available.json. Esse arquivo dirige tanto a entrada de menu Post-Install quanto o cartão de painel Monitor."
},
{
"title": "Uma notificação por nova versão",
"body": "Se houver pelo menos uma atualização pendente, Monitor envia uma única notificação agrupada, por exemplo «4 atualizações de otimizações ProxMenux disponíveis», com uma linha por ferramenta no formato name (vX → vY), como nos pacotes Proxmox. Não a repete diariamente para o mesmo conjunto: só uma nova versão ou nova ferramenta na lista volta a ativá-la."
}
]
},
"pathA": {
"heading": "Caminho A — Do menu pós- instalação",
"intro": "No menu principal ProxMenux, abra Configurações pós-instalação do Proxmox. Havendo atualizações pendentes, surge Aplicar atualizações disponíveis (N) acima de Desinstalar otimizações. O número indica quantas têm versão no disco mais recente que a registada. Se tudo estiver atualizado, a entrada fica oculta.",
"menuAlt": "Post-Install Scripts menu mostrando a entrada condicional 'Aplicar atualizações disponíveis (N)' posicionado logo acima 'Desinstalar otimizações', com o crachá de contagem indicando quantas otimizações têm uma versão mais recente no disco",
"menuCaption": "A entrada Aplicar atualizações disponíveis (N) só renderiza quando pelo menos uma otimização tem uma atualização pendente — ela esconde quando o host está atual.",
"checklistBody": "Abre uma lista com todas as atualizações pendentes no formato name (vX → vY). Estão todas selecionadas por predefinição; desmarque as que não pretende aplicar agora.",
"checklistAlt": "Janela Aplicar atualizações disponíveis com uma linha por otimização pendente, nome e mudança de versão (atual → disponível). Todas as linhas estão selecionadas.",
"checklistCaption": "Escolha individualmente as otimizações a atualizar. O mesmo motor de Automatizado e Personalizável reaplica cada função em segundo plano e atualiza a versão registada."
},
"pathB": {
"heading": "Caminho B — Do painel do monitor",
"intro": "As mesmas atualizações aparecem em Monitor, em Configurações → Otimizações ProxMenux. A ficha mostra um contador de atualizações pendentes que abre o seletor por otimização. Cada ferramenta também tem a sua ação de atualização.",
"imageAlt": "Ficha Otimizações ProxMenux nas configurações Monitor com contador de atualizações pendentes que abre o seletor e ações de atualização por ferramenta",
"imageCaption": "A ficha Otimizações de Monitor permite aceder às atualizações pelo contador quando existe uma versão mais recente no disco, sem acesso à shell."
},
"applying": {
"heading": "O que acontece ao aplicar",
"steps": [
{
"title": "Repetir a função pós-instalação",
"body": "A função escolhida volta a ser executada no host. Como é idempotente, não duplica a configuração: substitui a versão anterior pela nova, incluindo ficheiros sysctl, configurações adicionais e unidades de serviços."
},
{
"title": "Atualiza o registro",
"body": "A chamada register_tool dentro da função escreve a nova versão em installed_tools.json. A próxima varredura não vê mais um descompasso e a entrada de atualização desaparece tanto do menu quanto do cartão Monitor."
},
{
"title": "Sem reiniciar, a menos que a função o diga",
"body": "A maioria das actualizações produz efeitos imediatamente. Atualizações que tocam módulos do kernel, nomes de interface persistentes ou VFIO mostram o mesmo prompt de reinicialização que uma nova instalação seria."
},
{
"title": "Actualizar o registo enviado para o Monitor",
"body": "No fim do lote, o menu envia um pedido POST a http://127.0.0.1:8008/api/updates/post-install/scan para reconstruir /usr/local/share/proxmenux/updates_available.json. Após aplicar todas as atualizações, desaparecem o contador da ficha Otimizações e a entrada condicional da shell, sem esperar pelo próximo scan. A ficha continua disponível."
}
],
"jqTitle": "jq é necessário",
"jqBody": "A lista de verificação Caminho A baseia-se em jq para processar as atualizações pendentes JSON. Se o jq estiver faltando, o fluxo sai silenciosamente — você verá a entrada do menu com uma contagem, mas nada aconteceria depois de escolher linhas. Em qualquer instalação moderna Proxmox jq está presente; se em dúvida executar apt install -y jq."
},
"differs": {
"heading": "Como difere dos outros caminhos",
"headerPath": "Path",
"headerScope": "Escopo",
"headerWhen": "Quando faz sentido",
"rows": [
{
"pathLabel": "Automatizado",
"pathHref": "/docs/post-install/automated",
"scope": "Reaplica todas as otimizações do conjunto.",
"when": "Host novo ou reaplicação completa da base de um nó totalmente gerido."
},
{
"pathLabel": "Personalizável",
"pathHref": "/docs/post-install/customizable",
"scope": "Escolha no catálogo completo.",
"when": "Escolher exatamente as otimizações ativas no host."
},
{
"pathLabel": "Aplicar atualizações disponíveis",
"pathHref": null,
"scope": "Só as otimizações com versão mais recente no disco.",
"when": "Mantenha as otimizações já instaladas atuais sem tocar no resto."
},
{
"pathLabel": "Desinstalar otimizações",
"pathHref": "/docs/post-install/uninstall",
"scope": "Inverta a otimização e remova sua entrada de registro.",
"when": "Retroceda uma mudança específica."
}
]
},
"notifTitle": "Controlo da notificação",
"notifBody": "O evento Atualizações de otimizações ProxMenux disponíveis anuncia as atualizações pendentes. Está ativo por predefinição em cada canal e pode ser silenciado por canal em Configurações → Notificações. Só dispara uma vez por conjunto diferente de atualizações, não em cada scan de 24 horas."
}