mirror of
https://github.com/MacRimi/ProxMenux.git
synced 2026-11-02 10:52:22 +00:00
docs: review disk manager documentation in all seven translations
This commit is contained in:
Jonatan
@@ -0,0 +1,128 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Adicionar controlador ou NVMe a uma VM | Documentação ProxMenux",
|
||||
"description": "Atribua um controlador de armazenamento SATA/SAS HBA ou dispositivo NVMe a uma VM Proxmox por passthrough PCI com o ProxMenux. A ferramenta trata da ativação do IOMMU, deteta conflitos e configura a atribuição com qm set --hostpci.",
|
||||
"ogTitle": "Adicionar controlador ou NVMe a uma VM | Documentação ProxMenux",
|
||||
"ogDescription": "Atribua um HBA SATA/SAS completo ou um dispositivo NVMe a uma VM Proxmox. O ProxMenux trata do IOMMU, da deteção de conflitos e da atribuição hostpci."
|
||||
},
|
||||
"header": {
|
||||
"title": "Adicionar controlador ou NVMe a uma VM",
|
||||
"description": "Atribua um adaptador de barramento SATA/SAS completo (HBA) ou dispositivo NVMe a uma VM Proxmox por passthrough PCI. O ProxMenux verifica o IOMMU e ativa-o com o seu consentimento, lista os dispositivos elegíveis, exclui conflitos e configura a atribuição com qm set --hostpci.",
|
||||
"section": "Gerenciador de disco · VM"
|
||||
},
|
||||
"intro": {
|
||||
"title": "O que isto faz (e não faz)",
|
||||
"body": "Trata-se de <strong>passthrough ao nível do dispositivo</strong>: a placa PCIe deixa de estar sob controlo do kernel do host e é associada a <code>vfio-pci</code>. A VM vê o próprio controlador, em vez de discos atribuídos individualmente, e carrega o controlador de software para esse modelo. Todos os discos ligados seguem automaticamente, com dados SMART nativos, todas as funções do firmware e sem uma camada Proxmox intermédia."
|
||||
},
|
||||
"howRuns": {
|
||||
"heading": "Como o script é executado",
|
||||
"body": "O fluxo tem duas fases com separação clara entre \"coletar informações, verificar IOMMU e listar candidatos\" e \"realmente anexar o dispositivo PCI\". Até a confirmação final nada é escrito para a configuração VM."
|
||||
},
|
||||
"iommu": {
|
||||
"heading": "Grupos IOMMU: por que é necessário considerar a placa inteira",
|
||||
"body": "O limite de isolamento do passthrough PCI é o <strong>grupo IOMMU</strong>, a menor unidade que o IOMMU da CPU consegue isolar. Os dispositivos do mesmo grupo não podem ser isolados entre si. Se um controlador SATA partilhar o grupo com um controlador USB, o passthrough SATA pode exigir libertar também o USB do host ou ser impossível. Não atribui automaticamente à VM todos os dispositivos do grupo.",
|
||||
"outro": "O ProxMenux mostra o grupo IOMMU ao lado de cada dispositivo e avisa quando um grupo carrega mais do que o controlador que deseja. Você ainda pode prosseguir se os dispositivos extras do grupo são aceitáveis (todos os controladores de disco, por exemplo), ou voltar se eles não forem."
|
||||
},
|
||||
"prereqs": {
|
||||
"heading": "Pré-requisitos",
|
||||
"items": [
|
||||
"<strong>A CPU e a placa-mãe suportam</strong> VT-d (Intel) ou AMD-Vi, e a função está ativa no firmware (BIOS/UEFI). O ProxMenux pode ativar a parte do kernel, mas não alterar a definição do firmware.",
|
||||
"A VM de destino está <strong>desligada</strong> antes de ligar dispositivos PCI.",
|
||||
"O controlador/NVMe <strong> não é aquele que detém o sistema de arquivos raiz Proxmox</strong>. O script esconde qualquer coisa em uso pela máquina.",
|
||||
"O sistema operativo convidado tem os controladores de software para o modelo do controlador. O Linux suporta praticamente todos os HBA de origem; o Windows precisa do controlador do fabricante instalado <em>antes</em> de arrancar com o dispositivo atribuído."
|
||||
],
|
||||
"warnTitle": "A migração ao vivo não é possível",
|
||||
"warnBody": "Um VM com passagem PCI está ligado ao nó que detém fisicamente o cartão. A migração ao vivo nos nós irá falhar. Planeje backups/replicação em conformidade."
|
||||
},
|
||||
"steps": {
|
||||
"heading": "Passo a passo",
|
||||
"stepLabel": "Etapa",
|
||||
"list": [
|
||||
{
|
||||
"title": "Escolher a VM de destino",
|
||||
"bodyRich": "ProxMenux lê <code>qm list</code> e mostra cada VM. Escolha o que receberá o controlador.",
|
||||
"img": "/disk/nvme-passthrough/vm-selection.png",
|
||||
"alt": "Diálogo de seleção do VM",
|
||||
"caption": "Diálogo de seleção do VM"
|
||||
},
|
||||
{
|
||||
"title": "Verificação IOMMU",
|
||||
"bodyRich": "Se o IOMMU não estiver habilitado na linha cmdline do kernel, o ProxMenux oferece para habilitá-lo. Ele edita <code>/etc/kernel/cmdline</code> (para systemd-boot) ou <code>/etc/default/grub</code> (para GRUB) e adiciona o parâmetro correto para o seu CPU:",
|
||||
"items": [
|
||||
"<code>intel_iommu=on</code> para CPUs Intel.",
|
||||
"<code>amd_iommu=on</code> para CPUs AMD."
|
||||
],
|
||||
"outro": "Uma reinicialização é necessária após esta alteração. O script pede que você reinicie agora ou mais tarde; a passagem não pode continuar até que o novo kernel cmdline esteja ativo.",
|
||||
"img": "/disk/nvme-passthrough/iommu-warning.png",
|
||||
"alt": "Diálogo IOMMU necessário",
|
||||
"caption": "IOMMU Necessário — oferta para ativar e reiniciar"
|
||||
},
|
||||
{
|
||||
"title": "Enumeração do dispositivo",
|
||||
"body": "ProxMenux lista cada controlador de armazenamento (SATA / SAS HBA) e cada dispositivo NVMe no barramento PCI. Para cada dispositivo, mostra:",
|
||||
"items": [
|
||||
"Endereço PCI (<code>00:17.0</code>, <code>01:00.0</code>, ...).",
|
||||
"Descrição do fornecedor / dispositivo.",
|
||||
"Grupo IOMMU, com um aviso ⚠ se for partilhado com outros dispositivos não relacionados.",
|
||||
"Os discos atualmente por trás do controlador (então você sabe o que irá segui-lo para o VM)."
|
||||
],
|
||||
"img": "/disk/nvme-passthrough/device-list.png",
|
||||
"alt": "Controlador / enumeração do dispositivo NVMe",
|
||||
"caption": "Controlador / NVMe enumeração do dispositivo com informações do grupo IOMMU"
|
||||
},
|
||||
{
|
||||
"title": "Detecção de conflitos",
|
||||
"bodyRich": "O script bloqueia dispositivos claramente inseguros: já atribuídos a outra VM através de <code>hostpci</code> na respetiva configuração, utilizados pelo host como o controlador do disco raiz, ou num grupo IOMMU cujos outros membros não consegue identificar com segurança. Os dispositivos elegíveis ficam disponíveis para seleção.",
|
||||
"img": "/disk/nvme-passthrough/conflict-warning.png",
|
||||
"alt": "Aviso de detecção de conflitos",
|
||||
"caption": "Detecção de conflitos — dispositivo bloqueado com razão"
|
||||
},
|
||||
{
|
||||
"title": "Anexar e finalizar",
|
||||
"bodyRich": "Para cada dispositivo selecionado ProxMenux roda <code>qm set <VMID> --hostpciN <pci-addr>,pcie=1</code>, escolhendo o próximo slot livre <code>hostpci</code>. Se IOMMU foi habilitado durante esta sessão você é lembrado para reiniciar antes de iniciar o VM.",
|
||||
"img": "/disk/nvme-passthrough/assignment.png",
|
||||
"alt": "Resumo da atribuição",
|
||||
"caption": "Resumo da atribuição — slots hostpciN e endereços PCI anexados"
|
||||
}
|
||||
]
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Equivalente manual"
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Resolução de Problemas",
|
||||
"noGroupsTitle": "IOMMU activado, mas sem grupos sob /sys/kernel/iommu_groups/",
|
||||
"noGroupsBody": "É necessário reiniciar para que a linha cmdline do kernel faça efeito. Se os grupos ainda estiverem faltando após o reinício, o VT-d / AMD-Vi provavelmente estará desativado no firmware — verifique a configuração BIOS/UEFI.",
|
||||
"busyTitle": "A VM não inicia: \"hostpciN: device busy\"",
|
||||
"busyBody": "Outro processo mantém o dispositivo PCI ocupado. As causas mais comuns são uma VM que falhou sem o libertar ou o kernel do host que o recuperou no último arranque. Execute <code>lspci -nnk -s <addr></code> para ver o controlador de software associado; deve ser <code>vfio-pci</code>. Um reinício completo do host costuma resolver o problema.",
|
||||
"noDisksTitle": "Convidado vê o controlador, mas não os discos",
|
||||
"noDisksBody": "Falta no sistema convidado o controlador de software para esse modelo. No Linux é raro, mas acontece no Windows: instale o controlador do fabricante, por exemplo LSI/Broadcom para HBA SAS antigos, com a placa não atribuída, e reinicie depois de a atribuir.",
|
||||
"sharedTitle": "O grupo IOMMU inclui um dispositivo não relacionado",
|
||||
"sharedBody": "Opções: (a) mover a placa para outra ranhura PCIe para alterar o grupo, (b) ativar <em>ACS override</em> no kernel para dividir grupos (compromisso de segurança: informe-se antes de aplicar), ou (c) escolher outra placa num grupo mais isolado."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/disk-manager/import-disk-vm",
|
||||
"label": "Importar disco para VM",
|
||||
"tail": " — modelo alternativo: anexar um disco físico via Proxmox sem passagem PCIe completa."
|
||||
},
|
||||
{
|
||||
"href": "/docs/hardware/gpu-vm-passthrough",
|
||||
"label": "Adicionar GPU a uma VM (passthrough)",
|
||||
"tail": " — os mesmos conceitos IOMMU / VFIO aplicados a um GPU."
|
||||
},
|
||||
{
|
||||
"href": "/docs/help-info/gpu-commands",
|
||||
"label": "Comandos de passagem GPU",
|
||||
"tail": " — Os comandos de verificação IOMMU também se aplicam à passagem do controlador / NVMe."
|
||||
},
|
||||
{
|
||||
"href": "/docs/disk-manager",
|
||||
"label": "Visão geral do Gerenciador de Discos",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,142 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Formatar ou apagar um disco físico | Documentação ProxMenux",
|
||||
"description": "Apague e formate discos físicos no Proxmox VE com o ProxMenux. Quatro modos, filtros rigorosos que bloqueiam discos de sistema, montados ou em uso e confirmação dupla com introdução do caminho completo.",
|
||||
"ogTitle": "Formatar ou apagar um disco físico | Documentação ProxMenux",
|
||||
"ogDescription": "Limpar ou formatar com segurança um disco físico no Proxmox. Regras de visibilidade seguras, modos de operação 4, dupla confirmação."
|
||||
},
|
||||
"header": {
|
||||
"title": "Formatar ou apagar um disco físico",
|
||||
"description": "Limpar ou formatar com segurança um disco físico no host Proxmox. ProxMenux só mostra discos totalmente livres (sem uso do sistema, sem referência de convidado, sem montagens) e força uma confirmação dupla — sim/não mais digitando o caminho do disco completo — antes de destruir quaisquer dados.",
|
||||
"section": "Gerenciador de disco · Utilitários"
|
||||
},
|
||||
"danger": {
|
||||
"title": "Ferramenta destrutiva",
|
||||
"body": "Cada operação aqui escreve para o disco. Não há nada a desfazer. ProxMenux aplica rigorosos filtros de segurança e confirmações, mas a responsabilidade pela escolha do disco certo é sua. Leia o caminho do disco em voz alta duas vezes antes de digitá-lo."
|
||||
},
|
||||
"howRuns": {
|
||||
"heading": "Como o script é executado",
|
||||
"body": "O fluxo tem duas fases com um filtro de segurança de porta tripla no meio. A lista de discos, o modo de operação e os detalhes do sistema de arquivos são todos coletados na Fase 1; nada é escrito até que a Fase 2 passe uma revalidação final logo antes de executar."
|
||||
},
|
||||
"visibility": {
|
||||
"heading": "Regras de visibilidade",
|
||||
"intro": "Antes mesmo do menu aparecer, o ProxMenux filtra a lista de discos. Apenas os candidatos que são comprovadamente seguros são mostrados:",
|
||||
"items": [
|
||||
"<strong>Mostrados</strong>: discos <em>não</em> utilizados pelo host (pool raiz, swap, montagens, ZFS/LVM/RAID ativos) e <em>não</em> referenciados em configurações de VM/LXC, em execução ou paradas.",
|
||||
"<strong>Ocultos</strong>: discos do host e do sistema.",
|
||||
"<strong>Ocultos</strong>: discos referenciados numa configuração VM/LXC."
|
||||
],
|
||||
"safetyTitle": "Segurança na confirmação e execução",
|
||||
"safetyItems": [
|
||||
"Os discos com metadados antigos ou ativos mostram avisos detalhados <em>antes</em> da confirmação.",
|
||||
"Os discos utilizados por uma VM <strong>em execução</strong> são <strong>bloqueados sem exceção</strong> na confirmação.",
|
||||
"Os discos com partições montadas são <strong>bloqueados sem exceção</strong> na execução. Uma nova verificação é realizada imediatamente antes de qualquer escrita.",
|
||||
"São sempre necessárias duas confirmações: um diálogo <em>sim/não</em> e a introdução exata do caminho completo do disco."
|
||||
]
|
||||
},
|
||||
"modes": {
|
||||
"heading": "Modos de operação",
|
||||
"intro": "Depois de escolher um disco você escolhe um dos quatro modos. Divergem no que destroem e no que deixam para trás.",
|
||||
"headerMode": "Modo",
|
||||
"headerPart": "Tabela de partições",
|
||||
"headerData": "Dados",
|
||||
"headerUseCase": "Caso de uso",
|
||||
"rows": [
|
||||
{
|
||||
"mode": "1. Limpar tudo",
|
||||
"part": "Destruído",
|
||||
"data": "Assinaturas apagadas",
|
||||
"useCase": "Remove o particionamento e os metadados para preparar uma nova organização. Não sobrescreve todos os dados do utilizador."
|
||||
},
|
||||
{
|
||||
"mode": "2. Remover rótulos FS",
|
||||
"part": "Preservado",
|
||||
"data": "Preservado",
|
||||
"useCase": "Remove assinaturas antigas de ZFS / LVM / RAID para evitar a utilização automática do disco. Os dados do utilizador não são sobrescritos em bloco, mas a remoção das assinaturas pode torná-los inacessíveis."
|
||||
},
|
||||
{
|
||||
"mode": "3. Sobrescrever os dados com zeros",
|
||||
"part": "Preservado",
|
||||
"data": "Destruídos (sobrescritos com zeros)",
|
||||
"useCase": "Sobrescreve com zeros as partições existentes, mantendo a tabela de partições. Não abrange espaço não atribuído nem áreas de reserva dos SSD; não garante a sanitização completa do dispositivo."
|
||||
},
|
||||
{
|
||||
"mode": "4. Formato completo",
|
||||
"part": "Novo GPT",
|
||||
"data": "Destruído",
|
||||
"useCase": "Disco pronto a usar com uma nova partição e um novo sistema de ficheiros."
|
||||
}
|
||||
],
|
||||
"fullFormatOutro": "<strong>Formato completo</strong> continua com duas janelas extras:",
|
||||
"fullFormatItems": [
|
||||
"<strong>Filesystem</strong> — <code>ext4</code>, <code>xfs</code>, <code>exfat</code> (portátil), ou <code>btrfs</code>. As ferramentas em falta (por exemplo, <code>mkfs.btrfs</code>) abortam com uma mensagem clara.",
|
||||
"<strong>Etiqueta</strong>: nome opcional do sistema de ficheiros para identificação."
|
||||
]
|
||||
},
|
||||
"steps": {
|
||||
"heading": "Passo a passo",
|
||||
"stepLabel": "Etapa",
|
||||
"list": [
|
||||
{
|
||||
"title": "Escolha um disco livre",
|
||||
"body": "O ProxMenux lista os discos que passam nos filtros acima. Os discos marcados com ⚠ contêm metadados antigos, apresentados em detalhe para saber o que vai sobrescrever."
|
||||
},
|
||||
{
|
||||
"title": "Escolha um modo de operação",
|
||||
"bodyRich": "Escolha <strong>Limpar tudo</strong>, <strong>Remover rótulos FS</strong>, <strong>Sobrescrever os dados com zeros</strong> ou <strong>Formato completo</strong> de acordo com a tabela acima."
|
||||
},
|
||||
{
|
||||
"title": "(Apenas formato completo) Escolha o sistema de arquivos e a etiqueta",
|
||||
"body": "ext4 / xfs / exfat / btrfs, além de uma etiqueta opcional."
|
||||
},
|
||||
{
|
||||
"title": "Confirmar duas vezes",
|
||||
"bodyRich": "O ProxMenux mostra um resumo da operação. Aceite no diálogo sim/não e <strong>introduza o caminho completo do disco</strong> exatamente como indicado, por exemplo <code>/dev/sdc</code>. Qualquer outra entrada cancela a operação."
|
||||
},
|
||||
{
|
||||
"title": "Revalidação e execução",
|
||||
"body": "Pouco antes de escrever, o script verifica novamente o estado do disco. Se uma partição tiver sido montada ou uma VM tiver sido iniciada, a execução será interrompida. Caso contrário, a operação escolhida é executada e um resumo é impresso no final."
|
||||
}
|
||||
]
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Equivalentes manuais",
|
||||
"body": "Se preferir executar os comandos equivalentes à mão:"
|
||||
},
|
||||
"troubleshoot": {
|
||||
"notListedTitle": "Disco não listado no menu",
|
||||
"notListedBody": "Foi filtrado por segurança. Razões comuns: é montado (mesmo em <code>/mnt/tmp</code>), é um ZFS / LVM / RAID membro, é referenciado por um VM ou LXC config, ou é seu disco raiz Proxmox. Execute <code>lsblk -f</code> e <code>cat /proc/mdstat</code> no host para entender o porquê.",
|
||||
"busyTitle": "\"Disk may be busy\" / falha ao desmontar",
|
||||
"busyBody": "Algo ainda está segurando um arquivo aberto em uma partição desse disco — na maioria das vezes um recipiente ou uma shell cujo cwd está dentro de um ponto de montagem. Identifique-o com <code>lsof | grep /dev/sdX</code> ou <code>fuser -vm /dev/sdX1</code>, pare-o e, em seguida, execute novamente a ferramenta."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/disk-manager/smart-disk-test",
|
||||
"label": "Integridade e teste do disco SMART",
|
||||
"tail": " — verificar um disco antes / após limpar para confirmar que é saudável."
|
||||
},
|
||||
{
|
||||
"href": "/docs/disk-manager/import-disk-vm",
|
||||
"label": "Importar disco para VM",
|
||||
"tail": " — passar um disco recém-formatado para um VM."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/host-local-disk",
|
||||
"label": "Adicionar o disco local como armazenamento Proxmox",
|
||||
"tail": " — registar um disco apagado como conjunto de armazenamento Proxmox."
|
||||
},
|
||||
{
|
||||
"href": "/docs/help-info/storage-commands",
|
||||
"label": "Comandos de armazenamento e discos",
|
||||
"tail": " — referência de lsblk, blkid e parted."
|
||||
},
|
||||
{
|
||||
"href": "/docs/disk-manager",
|
||||
"label": "Visão geral do Gerenciador de Discos",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,110 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Importar imagem de disco para uma VM | Documentação ProxMenux",
|
||||
"description": "Importar um arquivo de imagem de disco (.img / .qcow2 / .vmdk / .raw) para um Proxmox VM existente usando ProxMenux. Interface por imagem, emulação SSD e bandeira inicializável, com qm importdisk sob o capô.",
|
||||
"ogTitle": "Importar imagem de disco para uma VM | Documentação ProxMenux",
|
||||
"ogDescription": "Importar imagens de disco .img / .qcow2 / .vmdk / .raw para um VM existente com ProxMenux. Usa o 'qm importdisk' sob o capô."
|
||||
},
|
||||
"header": {
|
||||
"title": "Importar imagem de disco para VM",
|
||||
"description": "Importar um arquivo de imagem de disco (.img, .qcow2, .vmdk ou .raw) para um Proxmox VM existente. ProxMenux coleta cada decisão inicial — destino VM, armazenamento Proxmox, diretório fonte, interface, emulação SSD, ordem de inicialização — e então executa qm importdisk para cada imagem selecionada.",
|
||||
"section": "Gerenciador de disco · VM"
|
||||
},
|
||||
"intro": {
|
||||
"title": "O que isto faz",
|
||||
"body": "Ao contrário de <em>Importar disco para VM</em>, que atribui um disco físico diretamente, este processo utiliza um <strong>ficheiro</strong> no host, exportado de outro hipervisor, transferido como imagem cloud ou extraído de uma cópia de segurança. Converte-o num disco de VM Proxmox no armazenamento escolhido. O original é preservado: o ProxMenux copia-o, não o move."
|
||||
},
|
||||
"howRuns": {
|
||||
"heading": "Como o script é executado",
|
||||
"body": "O fluxo tem duas fases. A fase 1 recolhe todas as decisões (VM, armazenamento, directório de origem, imagens, opções de imagem) à frente através de diálogos. Fase 2 executa <code>qm importdisk</code> para cada imagem selecionada. Até o início da Fase 2, nada é copiado e a configuração VM não é tocada."
|
||||
},
|
||||
"prereqs": {
|
||||
"heading": "Pré-requisitos",
|
||||
"items": [
|
||||
"Pelo menos uma VM definida no host. A VM de destino deve estar <strong>desligada</strong>.",
|
||||
"Pelo menos um arquivo de imagem de um formato suportado no diretório fonte. Suportado: <code>.img</code>, <code>.qcow2</code>, <code>.vmdk</code>, <code>.raw</code>.",
|
||||
"Espaço livre suficiente no armazenamento Proxmox alvo para segurar cada disco importado.",
|
||||
"ProxMenux procura imagens em <code>/var/lib/vz/template/iso</code> por padrão. Você pode apontá-lo para qualquer outro diretório no host quando ele perguntar."
|
||||
]
|
||||
},
|
||||
"steps": {
|
||||
"heading": "Passo a passo",
|
||||
"stepLabel": "Etapa",
|
||||
"list": [
|
||||
{
|
||||
"title": "Escolher a VM de destino",
|
||||
"bodyRich": "ProxMenux lê <code>qm list</code> e mostra cada VM. Escolha o que receberá o(s) disco(s) importado(s)."
|
||||
},
|
||||
{
|
||||
"title": "Escolha o armazenamento do Proxmox",
|
||||
"bodyRich": "A lista contém cada armazenamento que tem o tipo de conteúdo <code>images</code> habilitado. Se houver apenas um candidato, ele é selecionado automaticamente e a janela é ignorada."
|
||||
},
|
||||
{
|
||||
"title": "Escolha o diretório de origem",
|
||||
"bodyRich": "Escolha o diretório padrão (<code>/var/lib/vz/template/iso</code>) ou digite um caminho personalizado — normalmente onde você baixou / enviou a imagem. O script rejeita caminhos que não existem."
|
||||
},
|
||||
{
|
||||
"title": "Escolha uma ou várias imagens",
|
||||
"bodyRich": "O diretório é escaneado para arquivos <code>.img</code> / <code>.qcow2</code> / <code>.vmdk</code> / <code>.raw</code>. Você pode selecionar vários de uma vez; cada um irá passar pelas opções por imagem no próximo passo."
|
||||
},
|
||||
{
|
||||
"title": "Opções por imagem",
|
||||
"intro": "Para cada imagem selecionada, o ProxMenux pergunta:",
|
||||
"items": [
|
||||
"<strong>Interface</strong> — <code>scsi</code> (padrão), <code>virtio</code>, <code>sata</code> ou <code>ide</code>. Corresponde à forma como o hóspede vai ver o disco.",
|
||||
"<strong>Emulação SSD</strong>: apenas para interfaces que não sejam VirtIO. Adiciona <code>ssd=1</code> para o sistema convidado reconhecer um disco de estado sólido. O suporte de discard/TRIM tem de ser configurado separadamente.",
|
||||
"<strong>De arranque</strong>: se responder sim, o ProxMenux adiciona o disco à ordem de arranque como dispositivo principal da VM."
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Importar e anexar",
|
||||
"bodyRich": "O ProxMenux executa o <code>qm importdisk</code> para cada imagem (formato de conversão na hora, onde necessário), liga o disco resultante ao próximo slot livre (<code>scsiN</code>, <code>sataN</code>, ...) com as opções escolhidas e — se você marcou qualquer disco como inicializável — atualiza a ordem de inicialização. O progresso mostra-se no terminal."
|
||||
}
|
||||
]
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Equivalente manual",
|
||||
"body": "A importação de uma única imagem corresponde a três comandos <code>qm</code>:",
|
||||
"warnTitle": "Conversão do formato da imagem",
|
||||
"warnBody": "Quando o armazenamento de destino não pode conter o formato de origem nativamente (por exemplo, o armazenamento LVM não pode conter <code>.qcow2</code>), <code>qm importdisk</code> converte a imagem de forma transparente. Isso pode levar vários minutos para imagens multi-GB; planejar de acordo com isso e não interromper o script."
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Resolução de Problemas",
|
||||
"noImagesTitle": "\"Nenhuma imagem de disco compatível encontrada\"",
|
||||
"noImagesBody": "O script não encontrou ficheiros <code>.img</code>, <code>.qcow2</code>, <code>.vmdk</code> ou <code>.raw</code>. Verifique a extensão, distinguindo maiúsculas e minúsculas, se o ficheiro está diretamente no diretório escolhido (os subdiretórios não são pesquisados) e se root o pode ler.",
|
||||
"slowTitle": "A importação é lenta",
|
||||
"slowBody": "As conversões entre VMDK, QCOW2 e raw podem ser limitadas pela CPU e E/S. A velocidade depende das leituras na origem, das escritas no destino e da eventual descompressão. Prefira fontes raw ou qcow2 quando possível.",
|
||||
"uefiTitle": "O disco importado arranca na shell UEFI",
|
||||
"uefiBody": "A imagem foi construída para legado (SeaBIOS), mas o VM usa OVMF (ou vice-versa). Alternar o VM do BIOS no Proxmox para corresponder à imagem, ou reconstruir a imagem no modo correto antes de importar."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/disk-manager/import-disk-vm",
|
||||
"label": "Importar disco para VM",
|
||||
"tail": " — mesmo fluxo, mas para discos físicos brutos (passagem)."
|
||||
},
|
||||
{
|
||||
"href": "/docs/utils/import-vm",
|
||||
"label": "Importar VM de OVA / OVF",
|
||||
"tail": " — quando você tem um pacote completo VM, não apenas uma imagem de disco."
|
||||
},
|
||||
{
|
||||
"href": "/docs/utils/UUp-Dump-ISO-Creator",
|
||||
"label": "Criador de ISO do UUP Dump",
|
||||
"tail": " — gerar uma ISO do Windows se necessitar de uma nova instalação."
|
||||
},
|
||||
{
|
||||
"href": "/docs/help-info/storage-commands",
|
||||
"label": "Comandos de armazenamento e discos",
|
||||
"tail": " — referência de qm importdisk e qemu-img convert."
|
||||
},
|
||||
{
|
||||
"href": "/docs/disk-manager",
|
||||
"label": "Visão geral do Gerenciador de Discos",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,115 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Importar o Disco para LXC | ProxMenux Documentação",
|
||||
"description": "Anexar um disco físico a um recipiente LXC existente em Proxmox VE usando ProxMenux. Lida com detecção / formatação do sistema de arquivos, ponto de montagem, sem privilégios → conversões privilegiadas e caminhos persistentes do dispositivo.",
|
||||
"ogTitle": "Importar o Disco para LXC | ProxMenux Documentação",
|
||||
"ogDescription": "Anexar um disco físico a um recipiente LXC existente. Lida com sistema de arquivos, ponto de montagem e sem privilégios → conversão privilegiada."
|
||||
},
|
||||
"header": {
|
||||
"title": "Importar disco para LXC",
|
||||
"description": "Ligue um disco físico a um contentor LXC existente no host Proxmox. O ProxMenux deteta discos livres, permite formatá-los com um sistema de ficheiros suportado e liga a partição a um ponto de montagem dentro do contentor através de caminhos persistentes do dispositivo.",
|
||||
"section": "Gerenciador de disco · LXC"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Passthrough em VM e em LXC",
|
||||
"body": "Este passthrough LXC <strong>não fornece um dispositivo de bloco bruto</strong>. O contentor recebe um <em>ponto de montagem</em>, ou seja, um diretório numa partição escolhida no host. Ao contrário de uma VM, utiliza o kernel do host: o sistema de ficheiros (ext4/xfs/btrfs) é lido e gerido pelo host Proxmox e depois disponibilizado ao contentor."
|
||||
},
|
||||
"howRuns": {
|
||||
"heading": "Como o script é executado",
|
||||
"body": "O fluxo tem duas fases com separação clara entre \"coletar informações e decisões\" e \"na verdade mudar a configuração do recipiente\". Até à confirmação final, nada é montado no CT.",
|
||||
"summary": "O ProxMenux exclui o disco raiz, os discos montados e os referenciados em configurações VM/LXC. Os membros ativos de ZFS/LVM/RAID são ocultos; as assinaturas antigas aparecem com ⚠ para poderem ser apagadas antes da formatação."
|
||||
},
|
||||
"prereqs": {
|
||||
"heading": "Pré-requisitos",
|
||||
"items": [
|
||||
"Pelo menos um recipiente LXC definido no hospedeiro.",
|
||||
"O contentor é <strong>privilegiado</strong> ou aceita a conversão proposta pelo script.",
|
||||
"Pelo menos um disco físico que não está em uso pelo host ou por qualquer outro convidado."
|
||||
],
|
||||
"warnTitle": "Recipiente privilegiado necessário",
|
||||
"warnBody": "Este script exige um contentor <strong>privilegiado</strong> para ligar diretamente o disco. Se detetar <code>unprivileged: 1</code>, oferece editar <code>/etc/pve/lxc/<CTID>.conf</code> no local. Isso altera o modelo de segurança sem remapear os proprietários dos ficheiros existentes. Faça uma cópia de segurança e verifique os proprietários antes de aceitar, ou recrie o contentor como privilegiado."
|
||||
},
|
||||
"steps": {
|
||||
"heading": "Passo a passo",
|
||||
"stepLabel": "Etapa",
|
||||
"list": [
|
||||
{
|
||||
"title": "Escolher o contentor de destino",
|
||||
"img": "/disk/select-container.png",
|
||||
"caption": "Menu de seleção do contentor",
|
||||
"bodyRich": "ProxMenux lista cada recipiente LXC no host (<code>pct list</code>). Escolha o que vai receber o disco. Se o recipiente não tiver privilégios, é-lhe oferecido converter agora."
|
||||
},
|
||||
{
|
||||
"title": "Escolha o disco físico",
|
||||
"img": "/disk/disk-selection-ct.png",
|
||||
"caption": "Discos livres detetados no host, com ⚠ para metadados antigos",
|
||||
"bodyRich": "Só são mostrados candidatos seguros. Ao contrário do processo para VM, este script liga <strong>um disco por execução</strong>. Execute-o novamente para cada disco adicional."
|
||||
},
|
||||
{
|
||||
"title": "Formatar ou reutilizar",
|
||||
"intro": "O script inspeciona o disco:",
|
||||
"items": [
|
||||
"Se ele já carrega um sistema de arquivos suportado (ext4 / xfs / btrfs) você pode reutilizá-lo como está (os arquivos existentes são preservados).",
|
||||
"Se não tiver nenhum sistema de arquivos suportado, você é oferecido para formatá-lo. Escolha ext4 / xfs / btrfs."
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Escolha o ponto de montagem",
|
||||
"bodyRich": "Introduza o caminho onde o contentor verá o disco, por exemplo <code>/mnt/data</code> ou <code>/mnt/disk_passthrough</code>. É o caminho <em>dentro</em> do contentor; o host já vê a partição em <code>/dev/disk/by-id/…</code>."
|
||||
},
|
||||
{
|
||||
"title": "Anexar e verificar",
|
||||
"img": "/disk/assignment-ct.png",
|
||||
"caption": "Atribuição a CT",
|
||||
"bodyRich": "O ProxMenux adiciona uma entrada <code>mpN:</code> nova à configuração do recipiente, ignorando índices já em uso e re-leia a configuração para confirmar. Se o recipiente estiver rodando, a montagem será executada ao vivo; caso contrário, fará efeito no próximo início.",
|
||||
"extraImg": "/disk/result-point.png",
|
||||
"extraAlt": "Ponto de montagem criado com sucesso",
|
||||
"extraCaption": "Ponto de montagem criado e verificado"
|
||||
}
|
||||
]
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Equivalente manual",
|
||||
"body": "O script envolve <code>pct set</code>. Uma invocação direta para um único disco parece:"
|
||||
},
|
||||
"important": {
|
||||
"heading": "Considerações importantes",
|
||||
"items": [
|
||||
"<strong>Um disco por execução</strong>. Repita o script para cada disco adicional.",
|
||||
"<strong>Não</strong> ligue a mesma partição a vários contentores que a possam montar simultaneamente: escritas concorrentes corrompem o sistema de ficheiros.",
|
||||
"<strong>Os metadados antigos</strong> (assinaturas RAID/ZFS/LVM) têm de ser apagados manualmente antes de o script permitir a formatação; caso contrário, <code>mkfs</code> recusa sobrescrever. Utilize <wipeLink>Formatar ou apagar um disco físico</wipeLink>."
|
||||
]
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Resolução de Problemas",
|
||||
"unprivTitle": "\"Não posso continuar com um contentor sem privilégios\"",
|
||||
"unprivBody": "Recusou a conversão. Em <code>/etc/pve/lxc/<CTID>.conf</code>, a opção passa de <code>unprivileged: 1</code> para <code>unprivileged: 0</code>, mas isso não converte por si só os UID/GID dos ficheiros existentes. Faça uma cópia de segurança e trate do mapeamento de proprietários antes da conversão no local; em alternativa, restaure ou recrie o contentor como privilegiado.",
|
||||
"permsTitle": "Permissões dentro do recipiente estão erradas",
|
||||
"permsBody": "Montar uma partição num contentor privilegiado mantém os proprietários existentes; um sistema de ficheiros novo pertence frequentemente a <code>root:root</code>. Se o serviço usar outro utilizador, por exemplo <code>www-data</code> para Nextcloud, verifique o UID/GID e ajuste os ficheiros necessários com <code>chown</code>/<code>chmod</code>. As alterações também afetam o disco subjacente."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/disk-manager/import-disk-vm",
|
||||
"label": "Importar disco para VM",
|
||||
"tail": " — fluxo equivalente para VMs."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/lxc-mount-points",
|
||||
"label": "Pontos de montagem LXC (Host ↔ CT)",
|
||||
"tail": " — compartilhar diretórios de host com um CT em vez de anexar um disco inteiro."
|
||||
},
|
||||
{
|
||||
"href": "/docs/help-info/vm-ct-commands",
|
||||
"label": "Comandos de gestão VM e CT",
|
||||
"tail": " — pct config / push / pull referência."
|
||||
},
|
||||
{
|
||||
"href": "/docs/disk-manager",
|
||||
"label": "Visão geral do Gerenciador de Discos",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,113 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Importar o Disco para VM | ProxMenux Documentação",
|
||||
"description": "Anexar um disco físico a um Proxmox VM existente com ProxMenux. Detecção segura de disco (exclui sistema, montado, em uso, ZFS/RAID/LVM), caminhos /dev/disk/by-id persistentes e interfaces SATA / SCSI / VirtIO / IDE.",
|
||||
"ogTitle": "Importar o Disco para VM | ProxMenux Documentação",
|
||||
"ogDescription": "Anexar um disco físico a um Proxmox VM existente. Usa caminhos /dev/disk/by-id persistentes e suporta SATA / SCSI / VirtIO / IDE."
|
||||
},
|
||||
"header": {
|
||||
"title": "Importar disco para VM",
|
||||
"description": "Anexar um disco físico que já existe na máquina Proxmox a uma máquina virtual existente. ProxMenux detecta discos livres, permite que você escolha o alvo VM, o tipo de barramento (SATA / SCSI / VirtIO / IDE) e liga tudo usando caminhos /dev/disk/by-id persistentes para que o mapeamento sobreviva a reinicialização e alterações de ordem do dispositivo.",
|
||||
"section": "Gerenciador de disco · VM"
|
||||
},
|
||||
"intro": {
|
||||
"title": "O que isto faz",
|
||||
"body": "Liga um disco físico bruto como dispositivo subjacente de uma interface de disco virtual. O sistema convidado não recebe automaticamente os dados SMART nativos nem as funções do controlador físico; utilize passthrough PCI do controlador se forem necessários. O disco é ligado por <code>/dev/disk/by-id/…</code>, não por <code>/dev/sdX</code>, para manter a atribuição se a ordem dos dispositivos mudar no arranque."
|
||||
},
|
||||
"howRuns": {
|
||||
"heading": "Como o script é executado",
|
||||
"body": "O fluxo tem duas fases com separação clara entre \"coletar informações e decisões\" e \"realmente anexar discos ao VM\". Até a confirmação final, a configuração VM não é tocada.",
|
||||
"summary": "O ProxMenux exclui candidatos inseguros: disco raiz, discos montados no host, membros ativos ZFS/LVM/RAID e discos referenciados em configurações VM/LXC. Os discos com metadados <em>antigos</em>, ou seja, assinaturas ZFS/RAID/LVM já não utilizadas, aparecem com ⚠ mas não são bloqueados."
|
||||
},
|
||||
"prereqs": {
|
||||
"heading": "Pré-requisitos",
|
||||
"items": [
|
||||
"Pelo menos um VM definido no host (o script envia diretamente para <code>qm list</code>).",
|
||||
"A <strong>VM de destino está desligada</strong>. Se estiver em execução, o script para com uma mensagem; a adição de discos em funcionamento não faz parte deste processo.",
|
||||
"Pelo menos um disco físico no host que não está em uso pelo host ou qualquer outro hóspede."
|
||||
]
|
||||
},
|
||||
"steps": {
|
||||
"heading": "Passo a passo",
|
||||
"stepLabel": "Etapa",
|
||||
"list": [
|
||||
{
|
||||
"title": "Escolher a VM de destino",
|
||||
"bodyRich": "O ProxMenux lista todas as VM do host com <code>qm list</code>. Escolha a que receberá o disco. Se estiver em execução, o script para e pede que a desligue primeiro."
|
||||
},
|
||||
{
|
||||
"title": "Escolha o( s) disco( s) físico( s) a anexar",
|
||||
"img": "/disk/disk-selection.png",
|
||||
"caption": "Discos livres detetados no host, com ⚠ para metadados antigos",
|
||||
"body": "O script examina os discos do host e mostra apenas os que podem ser ligados sem conflitos. Pode selecionar vários. Os discos com assinaturas antigas ZFS/LVM/RAID continuam visíveis com ⚠ para indicar que as assinaturas devem ser apagadas antes de o sistema convidado os formatar."
|
||||
},
|
||||
{
|
||||
"title": "Escolha a interface de barramento",
|
||||
"img": "/disk/disk-assigment.png",
|
||||
"caption": "Seleção da interface de barramento",
|
||||
"intro": "Escolha como o hóspede deve ver o disco:",
|
||||
"items": [
|
||||
"<strong>SCSI</strong> — padrão moderno para Linux e Windows com drivers VirtIO-SCSI instalados.",
|
||||
"<strong>SATA</strong> — ampla compatibilidade, funciona fora da caixa em praticamente todos os hóspedes.",
|
||||
"<strong>VirtIO</strong>: dispositivo de bloco paravirtualizado eficiente; exige controladores de software no sistema convidado.",
|
||||
"<strong>IDE</strong> — para os hóspedes legados que não possuem nenhum dos drivers acima."
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Anexar e verificar",
|
||||
"bodyRich": "ProxMenux liga cada disco selecionado com seu melhor caminho <code>/dev/disk/by-id/</code>, salta os índices de slot que já estão em uso na configuração VM (<code>scsi0</code>, <code>sata0</code>, ...) e re-ler a configuração para confirmar a atribuição. Um resumo é impresso no final."
|
||||
}
|
||||
]
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Equivalente manual",
|
||||
"body": "O script é uma embalagem em torno de <code>qm set</code>. O comando exato para um único disco se parece com este:",
|
||||
"migrationTitle": "A migração ao vivo não é possível",
|
||||
"migrationBody": "Uma VM com um disco físico ligado diretamente fica <strong>dependente do host que disponibiliza esse disco</strong>. Outro nó normalmente não tem o mesmo caminho <code>/dev/disk/by-id/…</code> nem os dados. Faça cópias de segurança e transfira os dados separadamente, ou utilize discos virtuais geridos em armazenamento partilhado ou com replicação suportada. Não pressuponha que a replicação do Proxmox abrange este dispositivo.",
|
||||
"shareTitle": "Não compartilhar um disco físico entre VMs",
|
||||
"shareBody": "Anexar o mesmo disco físico a duas VMs ao mesmo tempo irá corromper os dados na próxima gravação. ProxMenux detecta esta situação e bloqueia-a, mas se você ignorar o script (direto <code>qm set</code>), certifique-se de que apenas um convidado monta o disco."
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Resolução de Problemas",
|
||||
"noDisksTitle": "\"Nenhum disco disponível para este VM\"",
|
||||
"noDisksIntro": "O script encontrou discos, mas todos os candidatos foram filtrados. Razões comuns:",
|
||||
"noDisksItems": [
|
||||
"Cada disco restante já está referenciado na configuração do VM.",
|
||||
"Cada disco restante é montado na máquina ou faz parte de um ZFS / LVM / RAID ativo.",
|
||||
"A máquina só tem o disco raiz instalado."
|
||||
],
|
||||
"noDisksOutro": "Execute <code>lsblk -f</code> no host para rever o estado de cada disco.",
|
||||
"noVisibleTitle": "O VM não vê o disco após o arranque",
|
||||
"noVisibleBody": "Se você escolheu <strong>SCSI</strong> ou <strong>VirtIO</strong>, o hóspede precisa do driver correspondente. No Linux que é nativo do kernel; no Windows você precisa da ISO VirtIO e de uma instalação de driver (veja a página <winLink>Criar VM: Sistema Windows</winLink>). Mudar para SATA na guia de hardware do VM é uma solução rápida para confirmar que o disco está fisicamente ligado."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/disk-manager/import-disk-image-vm",
|
||||
"label": "Importar imagem de disco para VM",
|
||||
"tail": " — mesmo fluxo mas para arquivos de imagem (qcow2 / vmdk / raw / img)."
|
||||
},
|
||||
{
|
||||
"href": "/docs/disk-manager/import-disk-lxc",
|
||||
"label": "Importar disco para LXC",
|
||||
"tail": " — processo equivalente para contentores LXC."
|
||||
},
|
||||
{
|
||||
"href": "/docs/disk-manager/add-controller-nvme-vm",
|
||||
"label": "Adicionar controlador ou NVMe a uma VM",
|
||||
"tail": " — quando necessitar de uma passagem completa PCIe / NVMe em vez de anexar o disco."
|
||||
},
|
||||
{
|
||||
"href": "/docs/help-info/storage-commands",
|
||||
"label": "Comandos de armazenamento e discos",
|
||||
"tail": " — qm importdisk e referência de shell correspondente."
|
||||
},
|
||||
{
|
||||
"href": "/docs/disk-manager",
|
||||
"label": "Visão geral do Gerenciador de Discos",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,135 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Gestor de discos Proxmox: VM/LXC, testes SMART e eliminação | ProxMenux",
|
||||
"description": "Faça a gestão de discos físicos num host Proxmox VE com o ProxMenux: ligue discos a VM ou LXC (qm set scsi/sata/virtio, pct mp), importe imagens img / qcow2 / vmdk / raw, atribua HBA ou controladores NVMe completos, apague discos com verificações de segurança e execute autotestes SMART.",
|
||||
"ogTitle": "Gerenciador de disco Proxmox — Anexar discos a VMs / LXC, testes SMART, limpa",
|
||||
"ogDescription": "Anexar discos a VMs / LXC, importar imagens de disco, passagem PCI para controladores, limpeza segura e testes SMART em Proxmox VE.",
|
||||
"twitterTitle": "Gestor de discos Proxmox | ProxMenux",
|
||||
"twitterDescription": "Anexar discos a VMs / LXC, imagens de importação, passagem PCI, limpeza segura e testes SMART."
|
||||
},
|
||||
"header": {
|
||||
"title": "Gerenciador de disco",
|
||||
"description": "O menu Gerenciador de disco agrupa as ferramentas ProxMenux para lidar com discos físicos em um host Proxmox: anexar discos em recipientes VMs e LXC, importar imagens de disco, passar por um controlador inteiro ou dispositivo NVMe, limpar discos com segurança e executar testes de saúde SMART.",
|
||||
"section": "Gerenciador de disco"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Para que serve este menu",
|
||||
"body": "Estas ferramentas trabalham com <strong>discos físicos visíveis ao host Proxmox e ficheiros de imagem nele guardados</strong>. Há três grupos: <strong>VM</strong> (ligar discos ou importar imagens), <strong>LXC</strong> (ligar discos a um contentor) e <strong>Utilitários</strong> (formatação e estado SMART). As operações de ligação e eliminação ocultam ou bloqueiam discos de sistema e em uso; as verificações SMART podem examiná-los sem os apagar."
|
||||
},
|
||||
"opening": {
|
||||
"heading": "Abrir o menu",
|
||||
"body": "No menu principal do ProxMenux, selecione <strong>Disk Manager</strong>. Você verá isto:",
|
||||
"imageAlt": "Menu Gerenciador de disco com blocos VM, LXC e Utilitários"
|
||||
},
|
||||
"groups": {
|
||||
"heading": "Três grupos de ferramentas",
|
||||
"intro": "O menu está organizado em três grupos: <strong>VM</strong>, <strong>LXC</strong> e <strong>Utilitários</strong>. Clique num cartão para ir diretamente às ferramentas desse grupo.",
|
||||
"vmTitle": "VM",
|
||||
"vmBody": "Ferramentas que operam em máquinas virtuais existentes. O VM deve ser desligado; o ProxMenux valida isto antes de tocar na configuração.",
|
||||
"vmItems": [
|
||||
"Importar disco para VM",
|
||||
"Importar imagem de disco para VM",
|
||||
"Adicionar controlador ou NVMe a uma VM"
|
||||
],
|
||||
"lxcTitle": "LXC",
|
||||
"lxcBody": "Ferramentas para contentores LXC existentes. Este script exige um contentor privilegiado e oferece alterar a opção quando necessário. Leia primeiro os cuidados sobre conversão e propriedade dos ficheiros na página da ferramenta.",
|
||||
"lxcItems": [
|
||||
"Importar disco para LXC"
|
||||
],
|
||||
"utilitiesTitle": "Utilitários",
|
||||
"utilitiesBody": "Ferramentas do lado do hospedeiro que operam nos próprios discos, independentemente de qualquer VM ou recipiente.",
|
||||
"utilitiesItems": [
|
||||
"Formatar ou apagar um disco físico",
|
||||
"Integridade e teste do disco SMART"
|
||||
]
|
||||
},
|
||||
"vm": {
|
||||
"heading": "VM",
|
||||
"intro": "Ferramentas que operam em máquinas virtuais existentes. O VM deve ser desligado; o ProxMenux valida isto antes de tocar na configuração.",
|
||||
"options": [
|
||||
{
|
||||
"icon": "HardDrive",
|
||||
"href": "/docs/disk-manager/import-disk-vm",
|
||||
"title": "Importar disco para VM",
|
||||
"description": "Anexar um disco físico não atribuído a um VM existente. Suporta SATA / SCSI / VirtIO / IDE, usa caminhos /dev/disk/by-id persistentes."
|
||||
},
|
||||
{
|
||||
"icon": "FileDown",
|
||||
"href": "/docs/disk-manager/import-disk-image-vm",
|
||||
"title": "Importar imagem de disco para VM",
|
||||
"description": "Importar arquivos de imagem de disco (.img / .qcow2 / .vmdk / .raw) para um VM existente. Fluxo bifásico, qm importdisk sob o capô."
|
||||
},
|
||||
{
|
||||
"icon": "Cpu",
|
||||
"href": "/docs/disk-manager/add-controller-nvme-vm",
|
||||
"title": "Adicionar controlador ou NVMe a uma VM",
|
||||
"description": "Passagem PCI de um dispositivo inteiro SATA / SAS HBA ou NVMe para um VM. Lida com habilitação IOMMU e detecção de conflitos."
|
||||
}
|
||||
]
|
||||
},
|
||||
"lxc": {
|
||||
"heading": "LXC",
|
||||
"intro": "Ferramentas para contentores LXC existentes. Este script exige um contentor privilegiado e oferece alterar a opção quando necessário. Leia primeiro os cuidados sobre conversão e propriedade dos ficheiros na página da ferramenta.",
|
||||
"options": [
|
||||
{
|
||||
"icon": "Boxes",
|
||||
"href": "/docs/disk-manager/import-disk-lxc",
|
||||
"title": "Importar disco para LXC",
|
||||
"description": "Anexar um disco físico não atribuído a um recipiente LXC existente como ponto de montagem. Lida com detecção / formato do sistema de arquivos e conversão privilegiada."
|
||||
}
|
||||
]
|
||||
},
|
||||
"utilities": {
|
||||
"heading": "Utilitários",
|
||||
"intro": "Ferramentas do lado do hospedeiro que operam nos próprios discos, independentemente de qualquer VM ou recipiente.",
|
||||
"options": [
|
||||
{
|
||||
"icon": "Eraser",
|
||||
"href": "/docs/disk-manager/format-disk",
|
||||
"title": "Formatar/limpar disco físico (seguro)",
|
||||
"description": "Limpar o disco seguro com controles de segurança rigorosos: apenas discos totalmente livres são mostrados e uma confirmação dupla é sempre necessária."
|
||||
},
|
||||
{
|
||||
"icon": "Activity",
|
||||
"href": "/docs/disk-manager/smart-disk-test",
|
||||
"title": "Integridade e teste do disco SMART",
|
||||
"description": "Execute verificações de saúde SMART e auto-testes curtos / longos em unidades SATA, SAS e NVMe. Exporta JSON para o Monitor."
|
||||
}
|
||||
]
|
||||
},
|
||||
"safety": {
|
||||
"title": "Regras de segurança para ligação e eliminação de discos",
|
||||
"intro": "As operações de ligação e eliminação excluem dispositivos que possam prejudicar o host:",
|
||||
"items": [
|
||||
"O <strong>disco de sistema</strong>, o pool raiz, o swap e os membros ativos de ZFS/LVM/RAID ficam sempre ocultos.",
|
||||
"Os discos <strong>montados</strong> em qualquer ponto do host são ocultos ou bloqueados na execução.",
|
||||
"Os discos <strong> referenciados por um VM ou LXC</strong> em execução não podem ser reatribuídos ou apagados.",
|
||||
"Operações que podem alterar o estado host (IOMMU habilitar, limpar) requerem confirmação explícita."
|
||||
]
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/storage-share",
|
||||
"label": "Gerenciador de armazenamento e compartilhamento",
|
||||
"tail": " — registro de armazenamento no próprio Proxmox (NFS / Samba / iSCSI / local) e compartilhar pastas entre host e CTs."
|
||||
},
|
||||
{
|
||||
"href": "/docs/help-info/storage-commands",
|
||||
"label": "Comandos de armazenamento e discos",
|
||||
"tail": " — referência de dispositivos de bloco, LVM, pvesm e SMART."
|
||||
},
|
||||
{
|
||||
"href": "/docs/help-info/zfs-commands",
|
||||
"label": "Comandos de gerenciamento ZFS",
|
||||
"tail": " — para conjuntos e conjuntos de dados ZFS."
|
||||
},
|
||||
{
|
||||
"href": "/docs/hardware/gpu-vm-passthrough",
|
||||
"label": "Adicionar GPU a uma VM (passthrough)",
|
||||
"tail": " — os mesmos conceitos IOMMU / VFIO aplicados às GPU."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,146 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Estado e testes SMART do disco | Documentação ProxMenux",
|
||||
"description": "Executar SMART controlos de saúde e testes de disco em Proxmox VE com ProxMenux. Suporta SATA / SAS (smartmontools) e NVMe (nvme-cli). Auto-testes curtos e longos, JSON exportação para ProxMenux Monitor integração.",
|
||||
"ogTitle": "Estado e testes SMART do disco | Documentação ProxMenux",
|
||||
"ogDescription": "Verificações de saúde e auto-testes de SMART para unidades SATA / SAS e NVMe em Proxmox. Exportação JSON para o Monitor."
|
||||
},
|
||||
"header": {
|
||||
"title": "Integridade e teste do disco SMART",
|
||||
"description": "Leia dados do SMART e ative auto-testes nos discos físicos ligados ao host Proxmox. ProxMenux auto-instala smartmontools para SATA / SAS e nvme-cli para NVMe, executa a ação dentro do firmware da unidade (os testes longos sobrevivem ao encerramento do terminal) e exporta os resultados JSON para o ProxMenux Monitor.",
|
||||
"section": "Gerenciador de disco · Utilitários"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Para que serve isto?",
|
||||
"body": "SMART (Auto-Monitoramento, Análise e Tecnologia de Relatórios) permite que a própria unidade relate sua saúde e execute auto-testes. Esta ferramenta expõe que os dados sem que você precise se lembrar da invocação correta <code>smartctl</code> / <code>nvme</code>, e persiste a saída como JSON, para que o Monitor possa grafar tendências ao longo do tempo."
|
||||
},
|
||||
"howRuns": {
|
||||
"heading": "Como o script é executado",
|
||||
"body": "Todas as ações aqui são não destrutivas — SMART lê os contadores de firmware da unidade, e os auto-testes estão em fila dentro da própria unidade. Nenhuma separação de fases é necessária. O fluxo é: verificação de dependência → seleção de disco → seleção de ação → invocação de ferramenta (smartctl ou nvme-cli dependendo do barramento de disco) → saída impressa mais exportação de JSON para o Monitor."
|
||||
},
|
||||
"deps": {
|
||||
"heading": "Dependências",
|
||||
"body": "A ferramenta auto-instala o que precisa na primeira execução. As unidades SATA / SAS dependem do <code>smartmontools</code>; as unidades NVMe dependem do <code>nvme-cli</code>. Ambos:"
|
||||
},
|
||||
"actions": {
|
||||
"heading": "Acções disponíveis",
|
||||
"headerAction": "Ação",
|
||||
"headerWhat": "O que lê / roda",
|
||||
"headerDur": "Duração",
|
||||
"rows": [
|
||||
{
|
||||
"action": "Estado de saúde rápido",
|
||||
"whatRich": "Total PASSED/FAILED + atributos-chave.<br /><code>smartctl -H</code> + <code>-A</code> (SATA/SAS) ou <code>nvme smart-log</code> (NVMe).",
|
||||
"dur": "Instantânea"
|
||||
},
|
||||
{
|
||||
"action": "Relatório completo",
|
||||
"whatRich": "Dados SMART completos, com deslocamento. <code>smartctl -x</code> para SATA/SAS ou <code>nvme smart-log</code> + <code>id-ctrl</code> para NVMe.",
|
||||
"dur": "Instantânea"
|
||||
},
|
||||
{
|
||||
"action": "Teste curto",
|
||||
"what": "Verificação básica de superfície e elétrica, em fila dentro do firmware da unidade.",
|
||||
"dur": "~2 minutos"
|
||||
},
|
||||
{
|
||||
"action": "Ensaio longo",
|
||||
"what": "Varredura completa de toda a superfície. Funciona no hardware da unidade — persiste mesmo se você fechar o terminal.",
|
||||
"dur": "Horas (dependentes do tamanho do disco)"
|
||||
},
|
||||
{
|
||||
"action": "Verificar o progresso do teste",
|
||||
"what": "Estado do auto-teste ativo ou mais recente.",
|
||||
"dur": "Instantânea"
|
||||
}
|
||||
],
|
||||
"tipTitle": "Longos testes sobrevivem ao encerramento do terminal",
|
||||
"tipBody": "Um teste longo corre <em>dentro do disco</em> e não depende do processo ProxMenux continuar ativo. Pode fechar o terminal e voltar a <strong>Verificar o progresso do teste</strong>. Um reinício do host, uma reposição do controlador ou uma falha de energia pode interromper o teste e a recolha de resultados; não pressuponha que retoma automaticamente."
|
||||
},
|
||||
"json": {
|
||||
"heading": "Exportação de JSON para o Monitor",
|
||||
"intro": "As ações de estado, teste curto e progresso guardam um JSON com data e hora em <code>/usr/local/share/proxmenux/smart/<disk>/</code>; os resultados dos testes longos são recolhidos em segundo plano. O relatório completo é apenas apresentado. A estrutura é:",
|
||||
"outro": "O ProxMenux Monitor utiliza estes ficheiros para mostrar a evolução do estado de cada disco. Os ficheiros antigos são eliminados automaticamente ao atingir o limite de retenção."
|
||||
},
|
||||
"steps": {
|
||||
"heading": "Passo a passo",
|
||||
"stepLabel": "Etapa",
|
||||
"list": [
|
||||
{
|
||||
"title": "Escolha um disco",
|
||||
"body": "ProxMenux lista cada disco físico no host com seu modelo e tamanho. Ao contrário da ferramenta Format, esta lista não é filtrada pela segurança — ler SMART é uma operação não destrutiva.",
|
||||
"img": "/disk/smart/disk-selection.png",
|
||||
"alt": "Menu de seleção de disco SMART",
|
||||
"caption": "Menu de seleção de disco SMART"
|
||||
},
|
||||
{
|
||||
"title": "Escolha uma ação",
|
||||
"body": "Escolha entre estado de saúde rápido, relatório completo, teste curto, teste longo ou check progress. O menu fica aberto após cada ação para que você possa encadear várias consultas contra o mesmo disco.",
|
||||
"img": "/disk/smart/action-menu.png",
|
||||
"alt": "Menu de ação SMART",
|
||||
"caption": "Menu de ação SMART (ações 5 + cancelamento)"
|
||||
},
|
||||
{
|
||||
"title": "(Apenas teste longo) Confirmar execução em segundo plano",
|
||||
"body": "O ProxMenux informa que o teste continuará após fechar o terminal e mostra onde será guardado o resultado JSON. Aceite para iniciar o teste.",
|
||||
"img": "/disk/smart/long-test-warning.png",
|
||||
"alt": "Diálogo de confirmação de teste longo",
|
||||
"caption": "Confirmação de teste longa — roda em segundo plano, resultado salvo em JSON"
|
||||
},
|
||||
{
|
||||
"title": "Rever os resultados",
|
||||
"bodyRich": "O estado e os relatórios são apresentados no terminal; o JSON é exportado para as ações descritas acima, exceto Relatório completo. Para testes longos, volte a <strong>Verificar o progresso do teste</strong> no mesmo disco.",
|
||||
"img": "/disk/smart/quick-status.png",
|
||||
"alt": "Saída rápida do estado de saúde",
|
||||
"caption": "Saída rápida do estado de saúde (SATA — smartctl -H + -A)"
|
||||
}
|
||||
]
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Equivalentes manuais",
|
||||
"nvmeWarnTitle": "Os autotestes NVMe dependem do firmware do disco",
|
||||
"nvmeWarnBody": "Nem toda unidade NVMe suporta o comando de auto-teste curto/longo. Se uma unidade recusar o teste, o log SMART e os dados do controlador de ID (<code>nvme smart-log</code> + <code>id-ctrl</code>) ainda são o sinal de saúde mais confiável."
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Resolução de Problemas",
|
||||
"noSmartTitle": "\"Não foi possível ler dados SMART de /dev/sdX\"",
|
||||
"noSmartBody": "O disco pode estar ligado a um controlador RAID/SAS que não transmite SMART. Com placas megaraid, tente <code>smartctl -d megaraid,N /dev/sdX</code>. Com HBA em modo IT, a chamada direta funciona.",
|
||||
"longTitle": "O teste longo nunca termina",
|
||||
"longBody": "O teste corre no firmware e uma carga elevada de E/S pode atrasá-lo. Tente num período calmo, como durante a noite. Em SATA/SAS, <code>smartctl -c</code> mostra a percentagem restante; o registo de autotestes indica o resultado e eventuais LBA com erros. Uma falha de leitura exige investigação; a lentidão, por si só, não prova um setor danificado."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/disk-manager/format-disk",
|
||||
"label": "Formatar ou apagar um disco físico",
|
||||
"tail": " — reutilizar um disco após confirmar que é saudável."
|
||||
},
|
||||
{
|
||||
"href": "/docs/help-info/storage-commands",
|
||||
"label": "Comandos de armazenamento e discos → Estado SMART",
|
||||
"tail": " — referência smartctl / nvme."
|
||||
},
|
||||
{
|
||||
"href": "/docs/help-info/zfs-commands",
|
||||
"label": "Comandos de gerenciamento ZFS",
|
||||
"tail": " — zpool scrub verifica as somas de controlo dos dados ZFS e complementa os testes SMART do hardware."
|
||||
},
|
||||
{
|
||||
"href": "/docs/monitor/dashboard/storage",
|
||||
"label": "ProxMenux Monitor — Página de armazenamento",
|
||||
"tail": " — vista detalhada do disco que utiliza o JSON aqui exportado: tabela SMART completa, histórico e relatório PDF."
|
||||
},
|
||||
{
|
||||
"href": "/docs/monitor/dashboard/hardware",
|
||||
"label": "ProxMenux Monitor — Página de hardware",
|
||||
"tail": " — Resumo de armazenamento com modelo, capacidade e velocidade de ligação negociada (atual vs máximo em NVMe)."
|
||||
},
|
||||
{
|
||||
"href": "/docs/disk-manager",
|
||||
"label": "Visão geral do Gerenciador de Discos",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user