mirror of
https://github.com/MacRimi/ProxMenux.git
synced 2026-11-01 10:22:08 +00:00
336 lines
28 KiB
JSON
336 lines
28 KiB
JSON
{
|
|
"meta": {
|
|
"title": "Atualizar PVE 8 para PVE 9 | Documentação do ProxMenux",
|
|
"description": "Três formas de passar do Proxmox VE 8 para 9 (Debian Bookworm para Trixie e PVE 8 para 9): automática, interativa ou manual, seguindo o procedimento oficial. Verificação pve8to9, migração dos repositórios, dist-upgrade e validação final. A execução no terminal web é bloqueada.",
|
|
"ogTitle": "Atualizar PVE 8 para PVE 9 | Documentação do ProxMenux",
|
|
"ogDescription": "Três métodos (automático, interativo e manual) para passar do Proxmox VE 8 para 9."
|
|
},
|
|
"header": {
|
|
"title": "Atualize PVE 8 para PVE 9",
|
|
"description": "Executa a atualização do Proxmox VE 8 para 9 segundo o procedimento oficial: Debian Bookworm para Trixie e PVE 8 para 9. Oferece métodos automático, interativo e manual, além de uma verificação prévia independente. Bloqueia o terminal web porque uma desconexão durante a atualização pode deixar o anfitrião inutilizável.",
|
|
"section": "Utilitários"
|
|
},
|
|
"dangerCallout": {
|
|
"title": "Uma atualização de versão principal é irreversível",
|
|
"intro": "Esta operação substitui a base Debian (Bookworm → Trixie) e os componentes Proxmox no próprio sistema. <strong>Não existe um procedimento de reversão</strong>. Antes de começar:",
|
|
"items": [
|
|
"<strong>Cópias de segurança verificadas</strong> de cada VM e CT (PBS, vzdump, snapshots ZFS — verifique também o restauro).",
|
|
"<strong>Acesso por consola / IPMI / iKVM</strong> ao anfitrião caso a ligação SSH seja interrompida.",
|
|
"O host já está atualizado em PVE 8.4.x (o script obriga isso).",
|
|
"Ceph (se presente) na versão 19.x Squid.",
|
|
"Pelo menos <strong>5 GB livres</strong> no sistema de ficheiros raiz."
|
|
]
|
|
},
|
|
"modeMenu": {
|
|
"heading": "O menu modo",
|
|
"intro": "A opção abre quatro entradas: Automático, Interativo, Verificação prévia e Guia manual. Três opções <em>executam</em> a atualização ou explicam como fazê-la; a verificação independente <em>confirma</em> os requisitos e pode propor reparações.",
|
|
"imageAlt": "Menu de atualização do PVE 8 para 9 com modos automático, interativo, verificação prévia e guia manual"
|
|
},
|
|
"threeWays": {
|
|
"heading": "Três maneiras de atualizar",
|
|
"intro": "Os modos Automático e Interativo seguem o mesmo processo, com verificações prévias e validação final. Diferem nas respostas às perguntas do dpkg durante <code>dist-upgrade</code>. O guia manual mostra os comandos, incluindo as verificações; cabe-lhe executar todos os passos.",
|
|
"auto": {
|
|
"title": "Automático / Sem assistência",
|
|
"summary": "Define <code>ASSUME_YES=1</code> + <code>DEBIAN_FRONTEND=noninteractive</code>. Para ficheiros de configuração modificados, o dpkg usa a ação predefinida se existir; caso contrário, <strong>mantém o ficheiro atual</strong> (<code>--force-confold</code>).",
|
|
"items": [
|
|
"O mais rápido — sem perguntas do dpkg durante a atualização",
|
|
"Adequado para instalações padrão sem ficheiros de configuração personalizados",
|
|
"Risco: uma configuração personalizada é mantida sem perguntas e pode ocultar os novos valores predefinidos"
|
|
]
|
|
},
|
|
"interactive": {
|
|
"title": "Interactiva",
|
|
"summary": "O mesmo processo, mas o utilizador responde a cada pergunta do dpkg sobre conflitos de configuração. Mais lento, com visibilidade máxima.",
|
|
"items": [
|
|
"Você vê cada conflito de configuração e decide",
|
|
"Melhor quando você tiver personalizado <code>/etc/lvm</code>, <code>/etc/ssh</code>, etc.",
|
|
"Consulte a tabela de respostas recomendadas no procedimento manual abaixo"
|
|
]
|
|
},
|
|
"manual": {
|
|
"title": "Guia de atualização manual",
|
|
"summary": "Apresenta, sem executar, o procedimento oficial Proxmox em 17 passos. Execute os comandos manualmente numa shell separada.",
|
|
"items": [
|
|
"Controle máximo — você digita cada comando",
|
|
"Melhor quando você quer aprender o procedimento ou você não confia em nada",
|
|
"O script exibe as etapas; nada é executado automaticamente"
|
|
]
|
|
}
|
|
},
|
|
"precheckCallout": {
|
|
"title": "Mais uma pré- verificação separada",
|
|
"body": "A opção 3 — <strong>Executar verificação do PVE 8 para 9</strong> — inicia a ferramenta oficial <code>pve8to9 --full</code>, propõe reparações guiadas para problemas comuns e depois <strong>termina</strong>. Utilize-a antes de atualizar ou após reparações manuais. Os modos automático e interativo também a executam; o guia manual indica que deve executá-la pessoalmente."
|
|
},
|
|
"webTerminal": {
|
|
"heading": "Por que o terminal web está bloqueado",
|
|
"body": "Os três modos detetam <code>termproxy</code> / <code>vncshell</code> na cadeia de processos ascendentes e recusam iniciar. O terminal web depende de <code>pveproxy</code>, um serviço atualizado durante o processo. Quando <code>pveproxy</code> reinicia, a sessão termina e o script que nela decorre também. O anfitrião pode ficar parcialmente atualizado.",
|
|
"warningTitle": "Utilize SSH ou uma consola física / IPMI / iKVM",
|
|
"warningBody": "SSH é a opção habitual. Inicie a sessão dentro de <code>tmux</code> ou <code>screen</code> para resistir a breves interrupções de rede. Se detetar uma shell SSH simples, o script apresenta primeiro um lembrete sobre tmux/screen."
|
|
},
|
|
"auto": {
|
|
"heading": "Modo automático / sem vigilância",
|
|
"intro": "As perguntas sobre pacotes e ficheiros de configuração usam os valores predefinidos da tabela seguinte, e um 401 do repositório Enterprise muda para no-subscription sem perguntar. A confirmação da atualização, o resumo da atualização do PVE 8, as reparações das verificações e a pergunta de reinício continuam a ser apresentados.",
|
|
"behaviourHeading": "Comportamento específico do modo automático",
|
|
"behaviourTable": {
|
|
"settingHeader": "Configuração",
|
|
"effectHeader": "Efeito",
|
|
"rows": [
|
|
{
|
|
"settingRich": "<code>ASSUME_YES=1</code>",
|
|
"effectRich": "Opção interna — o script responde sim às suas próprias perguntas, como mudar para no-subscription após um 401"
|
|
},
|
|
{
|
|
"settingRich": "<code>DEBIAN_FRONTEND=noninteractive</code>",
|
|
"effectRich": "apt / dpkg são executados sem abrir perguntas do debconf"
|
|
},
|
|
{
|
|
"settingRich": "<code>--force-confdef</code>",
|
|
"effectRich": "Para arquivos de configuração intocados: instale a nova versão do mantenedor"
|
|
},
|
|
{
|
|
"settingRich": "<code>--force-confold</code>",
|
|
"effectRich": "Para ficheiros modificados: ação predefinida do dpkg, se existir; caso contrário, <strong>manter a sua versão</strong>."
|
|
}
|
|
]
|
|
},
|
|
"flowHeading": "Processo do modo automático",
|
|
"flowIntro": "Seis fases consecutivas. A fase 2 atualiza os pacotes PVE 8 e a fase 3 escreve a configuração dos repositórios do PVE 9. Uma falha interrompe o processo sem reverter essas alterações; se a atualização do PVE 8 falhar ou for cancelada, os repositórios ficam inalterados. A fase 5 executa <code>dist-upgrade</code> para PVE 9.",
|
|
"flowDiagram": "1. VERIFICAÇÕES\nBloqueia termproxy / vncshell; confirma a atualização; rejeita PVE 9.\n\n2. PREPARAR PVE 8\nscripts/global/update-pve8.sh\nAtualiza os pacotes PVE 8; para se a atualização falhar ou for cancelada.\npve8to9 --full (pode propor reparações).\nVerifica espaço e conectividade; Ceph 19.x Squid em nós hiperconvergentes.\n\n3. MIGRAR REPOSITÓRIOS\nBookworm → Trixie; escreve ficheiros deb822 .sources.\nComenta os ficheiros .list antigos; apt-get update.\n\n4. VALIDAR O CANDIDATO PVE 9\napt-cache policy proxmox-ve\napt-get -s dist-upgrade\nPara se o candidato não for 9.x ou se proxmox-ve fosse removido.\n\n5. ATUALIZAR\napt-get -y -o Dpkg::Options::='--force-confdef' -o Dpkg::Options::='--force-confold' dist-upgrade\nSem subscrição: desativa pve-enterprise.sources.\nRegisto: /var/log/pve8-a-pve9-'<'timestamp'>'.log\n\n6. VERIFICAR E REINICIAR\nEFI: apt install grub-efi-amd64\npve8to9 --full; examine os resultados e a pergunta de reinício.",
|
|
"preflightHeading": "Verificações antes da atualização",
|
|
"preflightTable": {
|
|
"checkHeader": "Verificar",
|
|
"whyHeader": "Por que importa",
|
|
"rows": [
|
|
{
|
|
"checkRich": "<strong>Bloco do terminal web</strong>",
|
|
"whyRich": "Impede que a atualização termine a shell que a executa"
|
|
},
|
|
{
|
|
"checkRich": "<strong>Já em 9.x</strong>",
|
|
"whyRich": "Interrompe se a máquina já executar PVE 9 (nada a fazer)"
|
|
},
|
|
{
|
|
"checkRich": "<strong>Versão mais recente do PVE 8.4.x</strong>",
|
|
"whyRich": "Atualiza primeiro o PVE 8 para a última revisão com o respetivo script; versões 8.x antigas têm requisitos diferentes"
|
|
},
|
|
{
|
|
"checkRich": "<strong>pve8to9 --full</strong>",
|
|
"whyRich": "Verificação dos requisitos pelo Proxmox; os erros FAIL bloqueiam a atualização até serem corrigidos"
|
|
},
|
|
{
|
|
"checkRich": "<strong>Espaço em disco</strong>",
|
|
"whyRich": "≥ 1024 MB livres em <code>/var/cache/apt/archives</code> para os ficheiros .deb transferidos"
|
|
},
|
|
{
|
|
"checkRich": "<strong>Conectividade</strong>",
|
|
"whyRich": "Ping a <code>download.proxmox.com</code> — se falhar, a operação não começa"
|
|
},
|
|
{
|
|
"checkRich": "<strong>Ceph 19.x Squid</strong>",
|
|
"whyRich": "Se o Ceph estiver instalado, já deve estar em 19.x. O PVE 9 não funciona com Ceph 17/18. As opções <code>--ignore-ceph-check</code> e <code>--warn-ceph-check</code> permitem ignorar a verificação; utilize-as apenas com conhecimento das consequências."
|
|
}
|
|
]
|
|
},
|
|
"distUpgradeHeading": "O comando dist-upgrade (modo automático)",
|
|
"distUpgradeCode": "apt-get -y \\\n -o Dpkg::Options::='--force-confdef' \\\n -o Dpkg::Options::='--force-confold' \\\n dist-upgrade",
|
|
"distUpgradeOutro": "O resultado aparece em tempo real no stdout e é também guardado em <code>/var/log/pve8-a-pve9-<timestamp>.log</code>. Tudo fica visível; só as perguntas são suprimidas.",
|
|
"postHeading": "Tarefas de pós- atualização (modo automático)",
|
|
"postItems": [
|
|
"<strong>Anfitriões EFI:</strong> instala <code>grub-efi-amd64</code>, de acordo com o problema conhecido na documentação Proxmox. A atualização não o instala automaticamente e pode ser necessário no próximo arranque.",
|
|
"<strong>Repositório Enterprise sem subscrição.</strong> O pve-manager 9 adiciona <code>pve-enterprise.sources</code> durante a atualização; no modo no-subscription, o script define-o como <code>Enabled: false</code>.",
|
|
"<strong>Volta a executar <code>pve8to9 --full</code>.</strong> Mostra problemas restantes. Os erros FAIL apresentam o mesmo menu de reparação da verificação prévia.",
|
|
"<strong>Pergunta de reinício.</strong> Recomenda-se reiniciar para carregar o novo kernel e os serviços. Recuse apenas por um motivo concreto: manter o kernel antigo após uma atualização de versão principal apresenta riscos."
|
|
]
|
|
},
|
|
"interactive": {
|
|
"heading": "Modo interativo",
|
|
"intro": "O mesmo processo do <autolink>modo automático</autolink>: verificações, migração dos repositórios e validação final iguais. A diferença está em <code>dist-upgrade</code>: <strong>responde pessoalmente a cada conflito de configuração do dpkg</strong>. O ProxMenux executa <code>apt-get dist-upgrade</code> sem as opções <code>--force-conf*</code>.",
|
|
"distUpgradeHeading": "O comando dist-upgrade (modo interativo)",
|
|
"distUpgradeCode": "apt-get dist-upgrade\n# (user answers each dpkg config-file conflict prompt as it appears)",
|
|
"whenHeading": "Quando interativo é a escolha certa",
|
|
"whenItems": [
|
|
"Você personalizou <code>/etc/lvm/lvm.conf</code>, <code>/etc/ssh/sshd_config</code>, <code>/etc/default/grub</code> ou qualquer outro arquivo de configuração que seja tocado pela atualização.",
|
|
"Pretende ver que pacotes causam conflitos e decidir para cada ficheiro.",
|
|
"Você está atualizando um host de produção onde qualquer alteração oculta é inaceitável."
|
|
],
|
|
"promptCalloutTitle": "O que responder em cada alerta",
|
|
"promptCalloutBody": "Aplicam-se as mesmas recomendações da operação manual: consulte <dpkglink>Respostas recomendadas às perguntas do dpkg</dpkglink> abaixo. Introduza <strong>D</strong> para ver as diferenças ou <strong>Z</strong> para abrir uma shell."
|
|
},
|
|
"manual": {
|
|
"heading": "Procedimento de actualização manual",
|
|
"intro": "É isto que mostra a opção <strong>Guia de atualização manual</strong>: o <wikilink>wiki oficial Proxmox para passar de 8 para 9</wikilink>, organizado em quatro fases. O script <em>mostra</em> os comandos; executa-os pessoalmente numa shell root separada. Cada passo é visível.",
|
|
"rootCalloutTitle": "Todos os comandos precisam de root",
|
|
"rootCalloutBody": "Utilize uma shell root para estes comandos, incluindo redirecionamentos e documentos here-document. Com <code>sudo</code>, garanta que todo o comando é executado com privilégios root.",
|
|
"phase1Heading": "Fase 1 — Preparação",
|
|
"phase1Intro": "Atualize o anfitrião para a última PVE 8.4.x, confirme a versão e o Ceph se utilizado, execute a verificação Proxmox e inicie um multiplexador de terminal para resistir a desconexões.",
|
|
"phase1Code": "# Step 1 — Update PVE 8 to the latest 8.4+\napt update && apt dist-upgrade -y\n\n# Step 2 — Verify version (must be 8.4.1 or newer)\npveversion\n\n# Step 2.1 — Hyper-converged Ceph: must already be on 19.x Squid\nceph --version\n# If older, follow https://pve.proxmox.com/wiki/Ceph_Reef_to_Squid\n\n# Step 3 — Run the official upgrade-readiness check\npve8to9 --full\n# If it warns about systemd-boot meta-package, remove it:\n# apt remove systemd-boot\n\n# Step 4 — Start tmux or screen (so SSH disconnect doesn't kill the upgrade)\ntmux new-session -s upgrade\n# or\nscreen -S upgrade",
|
|
"phase2Heading": "Fase 2 — Migração do repositório",
|
|
"phase2Intro": "Mude todos os repositórios Debian e Proxmox de Bookworm para Trixie e converta as fontes Proxmox para deb822. <strong>Escolha o passo 7 OU 8</strong> conforme a subscrição Enterprise. Ignore o passo 9 se não utilizar Ceph.",
|
|
"phase2Code": "# Step 5 — Debian: bookworm → trixie\nsed -i 's/bookworm/trixie/g' /etc/apt/sources.list\n\n# Step 6 — Same for the legacy enterprise list (only if you use enterprise)\nsed -i 's/bookworm/trixie/g' /etc/apt/sources.list.d/pve-enterprise.list\n\n# Step 7 — Add the new PVE 9 enterprise repo (deb822) — Enterprise users only\ncat > /etc/apt/sources.list.d/pve-enterprise.sources << EOF\nTypes: deb\nURIs: https://enterprise.proxmox.com/debian/pve\nSuites: trixie\nComponents: pve-enterprise\nSigned-By: /usr/share/keyrings/proxmox-archive-keyring.gpg\nEOF\n\n# Step 8 — OR add the no-subscription repo (most home / lab users)\ncat > /etc/apt/sources.list.d/proxmox.sources << EOF\nTypes: deb\nURIs: http://download.proxmox.com/debian/pve\nSuites: trixie\nComponents: pve-no-subscription\nSigned-By: /usr/share/keyrings/proxmox-archive-keyring.gpg\nEOF\n\n# Step 8.1 — Refresh and verify proxmox-ve candidate is 9.x\napt update && apt policy | sed -n '1,120p'\n\n# Step 9 — Update Ceph repo (only if you run Ceph)\ncat > /etc/apt/sources.list.d/ceph.sources << EOF\nTypes: deb\nURIs: http://download.proxmox.com/debian/ceph-squid\nSuites: trixie\nComponents: no-subscription\nSigned-By: /usr/share/keyrings/proxmox-archive-keyring.gpg\nEOF\n\n# Step 10 — Remove old .list files now superseded by deb822 .sources\nrm -f /etc/apt/sources.list.d/pve-enterprise.list /etc/apt/sources.list.d/ceph.list\n\n# Step 11 — Final apt update\napt update",
|
|
"phase3Heading": "Fase 3 — Dist-upgrade",
|
|
"phase3Intro": "A atualização propriamente dita. O passo 12 é opcional mas recomendado para reduzir mensagens de auditoria. O 13 demora mais: responda às perguntas do dpkg com a tabela. O 13.1 aplica-se apenas a EFI e segue os problemas conhecidos oficiais.",
|
|
"phase3Code": "# Step 12 — Disable kernel audit messages (optional)\nsystemctl disable --now systemd-journald-audit.socket\n\n# Step 13 — The main upgrade (this takes a while)\napt dist-upgrade\n# (answer prompts using the table below)\n\n# Step 13.1 — EFI hosts: install grub for EFI (per known issues)\n[ -d /sys/firmware/efi ] && apt install grub-efi-amd64",
|
|
"dpkgHeading": "Respostas recomendadas para as prompts dpkg",
|
|
"dpkgIntro": "Respostas recomendadas pelo Proxmox: <strong>Y</strong> instala o novo ficheiro do responsável pelo pacote, substituindo o seu; <strong>N</strong> mantém o ficheiro atual. Em caso de dúvida, veja primeiro as diferenças:",
|
|
"dpkgTable": {
|
|
"fileHeader": "Ficheiro / prompt",
|
|
"answerHeader": "Resposta recomendada",
|
|
"whyHeader": "Porquê?",
|
|
"rows": [
|
|
{
|
|
"fileRich": "/etc/issue",
|
|
"answerRich": "<strong>N</strong> (manter o ficheiro atual)",
|
|
"whyRich": "Banner você está acostumado a ver",
|
|
"fileFont": true
|
|
},
|
|
{
|
|
"fileRich": "/etc/lvm/lvm.conf",
|
|
"answerRich": "<strong>Y</strong> (versão do responsável pelo pacote)",
|
|
"whyRich": "O PVE 9 precisa dos novos valores LVM predefinidos",
|
|
"fileFont": true
|
|
},
|
|
{
|
|
"fileRich": "/etc/ssh/sshd_config",
|
|
"answerRich": "<strong>Y</strong> para alterações apenas predefinidas; examine primeiro os ficheiros personalizados",
|
|
"whyRich": "Reveja as definições SSH locais e preserve o acesso antes de substituir o ficheiro. As alterações padrão incluem opções renomeadas e comentários.",
|
|
"fileFont": true
|
|
},
|
|
{
|
|
"fileRich": "/etc/default/grub",
|
|
"answerRich": "<strong>N</strong> se personalizado",
|
|
"whyRich": "Contém parâmetros de arranque, como IOMMU e passthrough PCI",
|
|
"fileFont": true
|
|
},
|
|
{
|
|
"fileRich": "/etc/chrony/chrony.conf",
|
|
"answerRich": "<strong>Y</strong> se não foi modificado; preserve primeiro as definições locais",
|
|
"whyRich": "O Trixie atualiza os valores de sincronização horária. Mova as definições locais para conf.d / sources.d do chrony antes de aceitar o novo ficheiro.",
|
|
"fileFont": true
|
|
},
|
|
{
|
|
"fileRich": "Reinícios de serviços durante a atualização",
|
|
"answerRich": "<strong>Sim</strong> (predefinição)",
|
|
"whyRich": "Reinicia a maioria dos serviços sem reiniciar o anfitrião",
|
|
"fileFont": false
|
|
},
|
|
{
|
|
"fileRich": "<code>apt-listchanges</code>",
|
|
"answerRich": "Pressione <kbd>q</kbd>",
|
|
"whyRich": "Fecha apenas o pager; as informações apresentadas resumem o registo de alterações",
|
|
"fileFont": false
|
|
}
|
|
]
|
|
},
|
|
"inspectCalloutTitle": "Inspecionando um conflito dpkg específico",
|
|
"inspectCalloutBody": "Numa pergunta do dpkg sobre configuração, <strong>D</strong> mostra as diferenças entre o ficheiro atual e o novo; <strong>Z</strong> abre uma shell para investigar. Assim pode decidir sem adivinhar.",
|
|
"phase4Heading": "Fase 4 — Após a atualização",
|
|
"phase4Intro": "Confirme que a atualização terminou corretamente, reinicie com o kernel PVE 9 e verifique a versão. Depois pode converter os antigos ficheiros <code>.list</code> restantes para deb822.",
|
|
"phase4Code": "# Step 14 — Re-run the readiness check (should be much cleaner now)\npve8to9 --full\n\n# Step 15 — Reboot to load the new kernel and PVE 9 daemons\nreboot\n\n# Step 16 — After reboot, confirm PVE 9.x\npveversion\n# Should show pve-manager/9.x.x\n\n# Step 17 — Optional: modernise the remaining legacy .list files to deb822\napt modernize-sources\n# (keeps .list backups as .bak)"
|
|
},
|
|
"clusterCeph": {
|
|
"heading": "Cluster e Ceph",
|
|
"clusterCalloutTitle": "Cluster: atualizar um nó de cada vez",
|
|
"clusterCalloutBody": "Detetado por <code>pvecm status</code>. <strong>Não</strong> atualize vários nós ao mesmo tempo. Mova os convidados, atualize o nó, reinicie e confirme a participação no cluster antes de continuar. Durante a atualização, funciona a migração em direto de versões PVE anteriores para posteriores; o sentido inverso geralmente não é suportado. Os grupos HA são convertidos automaticamente em regras HA quando todos os nós utilizam PVE 9.",
|
|
"cephCalloutTitle": "Ceph: atualizar Ceph PRIMEIRO, depois Proxmox",
|
|
"cephCalloutBody": "O Ceph já deve estar em 19.x Squid antes de atualizar o Proxmox. Siga a sequência oficial Quincy 17 → Reef 18 → Squid 19, atualizando pacotes e reiniciando os daemons Ceph de forma gradual pela ordem documentada. Confirme <code>ceph --version</code> antes de cada nó Proxmox. Procedimento completo: <cephlink>wiki de atualização de Ceph Reef para Squid</cephlink>."
|
|
},
|
|
"troubleshooting": {
|
|
"heading": "Resolução de Problemas",
|
|
"items": [
|
|
{
|
|
"title": "O script interrompe a execução: \"This script cannot be executed from the Proxmox web terminal\"",
|
|
"bodyRich": "Abra uma ligação SSH ou utilize consola / IPMI / iKVM e execute novamente. Inicie primeiro <code>tmux new -s pveupgrade</code> para resistir a breves interrupções de rede."
|
|
},
|
|
{
|
|
"title": "pve8to9 indica FAIL e a opção 1 de reparação produz \"command not found\"",
|
|
"bodyRich": "Se o erro mencionar <code>configure_repositories</code>, a cópia do script está desatualizada: a reparação atual usa cleanup_duplicate_repos e ensure_repositories. Atualize-a ou consulte os comandos manuais na opção 2. <code>apt-get update</code> atualiza as listas de pacotes, mas não corrige todas as verificações bloqueantes."
|
|
},
|
|
{
|
|
"title": "A simulação apt indica \"proxmox-ve will be REMOVED\"",
|
|
"bodyRich": "Os novos repositórios estão inacessíveis ou o nome da distribuição não foi substituído. Verifique <code>cat /etc/apt/sources.list.d/proxmox.sources</code>: a linha <code>Suites:</code> deve indicar <code>trixie</code>, não <code>bookworm</code>. <code>apt-cache policy proxmox-ve</code> deve apresentar um candidato 9.x do novo repositório."
|
|
},
|
|
{
|
|
"title": "dist-upgrade falha a meio",
|
|
"bodyRich": "Execute <code>apt-get -f install</code> para resolver dependências quebradas e, em seguida, execute novamente a atualização. Se isso falhar, verifique o log no <code>/var/log/pve8-a-pve9-<timestamp>.log</code> — as últimas linhas geralmente apontam o pacote ofensivo. Não reiniciar até que o <code>dpkg -l | grep ^iU</code> retorne vazio (sem pacotes semi-instalados)."
|
|
},
|
|
{
|
|
"title": "A máquina EFI não inicializa após reiniciar",
|
|
"bodyRich": "A instalação posterior de <code>grub-efi-amd64</code> resolve este problema. Se foi omitida ou falhou, arranque com o ISO Proxmox em modo de recuperação, monte o sistema raiz, execute chroot e <code>apt-get install grub-efi-amd64 && update-grub</code>."
|
|
},
|
|
{
|
|
"title": "GUI não carrega após a atualização",
|
|
"bodyRich": "Execute <code>systemctl status pveproxy</code> e <code>systemctl restart pveproxy</code>. Se o problema continuar, procure o erro em <code>journalctl -u pveproxy -b</code>."
|
|
},
|
|
{
|
|
"title": "A rede não funciona após reiniciar",
|
|
"bodyRich": "Confirme que <code>/etc/network/interfaces</code> referencia dispositivos existentes e que <code>ifupdown2</code> está instalado: <code>apt install ifupdown2</code>. Se os nomes mudaram, consulte <netlink>Nomes persistentes de interfaces</netlink>."
|
|
},
|
|
{
|
|
"title": "Split-brain no cluster após atualizar um nó",
|
|
"bodyRich": "Os clusters mistos PVE 8 / PVE 9 são suportados durante a atualização. Funciona a migração em direto de versões anteriores para posteriores; o sentido inverso geralmente não é suportado. Se o nó aparecer desligado, verifique <code>corosync</code> e a configuração QDevice / rede. Execute <code>pvecm status</code> em cada nó para confirmar o quórum."
|
|
}
|
|
]
|
|
},
|
|
"files": {
|
|
"heading": "Ficheiros envolvidos",
|
|
"code": "scripts/utilities/upgrade_pve8_to_pve9.sh # main upgrade orchestrator\nscripts/utilities/pve8to9_check.sh # pre-check (separate menu option)\nscripts/utilities/proxmox-upgrade-pve8-to-pve9-manual-guide.sh # 17-step runbook\nscripts/global/update-pve8.sh # PVE 8 worker (final patches)\n/etc/apt/sources.list # bookworm → trixie sed\n/etc/apt/sources.list.d/proxmox.sources # created (deb822 PVE 9)\n/etc/apt/sources.list.d/debian.sources # created (deb822 trixie)\n/etc/apt/sources.list.d/ceph.sources # created if Ceph\n/etc/apt/sources.list.d/*.list # legacy files commented out / removed\n/var/log/pve8-a-pve9-'<'timestamp'>'.log # full upgrade log"
|
|
},
|
|
"references": {
|
|
"heading": "Referências oficiais",
|
|
"intro": "O procedimento manual do script segue estas fontes oficiais. Em caso de dúvida numa atualização, siga o wiki oficial: o ProxMenux ajuda na execução, mas a referência é o Proxmox.",
|
|
"items": [
|
|
{
|
|
"href": "https://pve.proxmox.com/wiki/Upgrade_from_8_to_9",
|
|
"title": "Atualização de 8 para 9",
|
|
"desc": "A página principal do wiki Proxmox para a atualização 8 → 9. Fonte da verdade para cada comando no procedimento manual acima."
|
|
},
|
|
{
|
|
"href": "https://pve.proxmox.com/wiki/Ceph_Reef_to_Squid",
|
|
"title": "Atualização para Ceph Squid (19.x)",
|
|
"desc": "Passo prévio obrigatório para nós Ceph hiperconvergentes. O Ceph deve estar em 19.x Squid antes do PVE 9."
|
|
},
|
|
{
|
|
"href": "https://pve.proxmox.com/wiki/Roadmap",
|
|
"title": "Roteiro Proxmox VE",
|
|
"desc": "Notas de lançamento do PVE 9 e alterações desde 8.x: leia antes de atualizar."
|
|
},
|
|
{
|
|
"href": "https://www.debian.org/releases/trixie/releasenotes",
|
|
"title": "Notas de lançamento do Debian Trixie",
|
|
"desc": "O PVE 9 baseia-se no Debian Trixie. As notas Debian descrevem alterações do sistema operativo que também afetam o anfitrião."
|
|
},
|
|
{
|
|
"href": "https://forum.proxmox.com/forums/proxmox-ve-installation-and-configuration.16/",
|
|
"title": "Fórum de instalação Proxmox VE",
|
|
"desc": "Se algo correr mal durante a atualização, pesquise primeiro neste fórum: alguém pode já ter encontrado o mesmo problema."
|
|
},
|
|
{
|
|
"href": "https://pve.proxmox.com/wiki/Backup_and_Restore",
|
|
"title": "Backup e Restauração",
|
|
"desc": "Uma atualização de versão principal não é reversível. Verifique sua disciplina de backup antes de começar."
|
|
}
|
|
]
|
|
},
|
|
"video": {
|
|
"heading": "Guia em vídeo",
|
|
"intro": "Prefere ver o upgrade correr de ponta a ponta antes de fazê-lo sozinho? Este passeio demonstra o fluxo de atualização ProxMenux em tempo real.",
|
|
"title": "ProxMenux — Guia em vídeo para atualizar Proxmox VE 8 para 9",
|
|
"caption": "Vídeo externo no YouTube. Reprodução no modo de privacidade avançada, sem cookies até iniciar o vídeo."
|
|
},
|
|
"related": {
|
|
"heading": "Relacionado",
|
|
"items": [
|
|
{
|
|
"href": "/docs/utils/system-update",
|
|
"label": "Atualização do sistema Proxmox",
|
|
"tail": " — para atualizações regulares dentro da mesma versão principal (8.4.1 → 8.4.5, etc.)."
|
|
},
|
|
{
|
|
"href": "/docs/utils",
|
|
"label": "Visão geral dos utilitários",
|
|
"tail": " — voltar à visão geral da secção."
|
|
}
|
|
]
|
|
}
|
|
}
|