Ir al contenido

Administração e Resolução de Problemas no Proxmox VE

Manual avançado de administração de Proxmox VE, quorum de cluster, Ceph e implementação híbrida de Universal Print em ambientes de laboratório Windows Server.

0lecturas

1. Ceph no Proxmox: Hiperconvergência e Alta Disponibilidade

Sección titulada «1. Ceph en Proxmox: Hiperconvergencia y Alta Disponibilidad»

O Ceph é um motor de armazenamento definido por software (SDS) integrado no Proxmox VE. Permite unificar os discos físicos (SSD/NVMe) de vários servidores para consolidar um único pool lógico de armazenamento distribuído, partilhado e redundante.

  1. Almacenamiento Distribuido: Agrupa discos duros locales dispersos eliminando la necesidad de adquirir cabinas SAN/NAS externas propietarias.
  2. Alta Disponibilidad (HA): Si un nodo físico falla, los datos siguen accesibles de manera transparente en los nodos restantes, facilitando que el gestor de HA reinicie de inmediato las Máquinas Virtuales (VMs) afectadas.
  3. Migração em Tempo Real (Live Migration): Permite transferir máquinas virtuais em execução entre nós físicos sem desligamento ou interrupções do serviço, uma vez que o armazenamento está montado em cluster.
  4. Autocuración (Self-Healing): Al substituir um disco defeituoso, Ceph inicia de forma autónoma a reconstrução e indexação para restabelecer a redundância lógica do pool.

Para garantir um quórum de dados estável em produção:

  • Mínimo de 3 Nodos: Requisito indispensable para evitar escenarios de conflicto tipo cerebro dividido (split-brain).
  • Red de Almacenamiento Dedicada: Enlace físico de 10 Gbps exclusivo para el tráfico de replicación de Ceph. Redes de 1 Gbps inducirán altos tiempos de latencia y cuellos de botella.
  • Discos de Estado Sólido (SSD/NVMe): Requeridos para proporcionar los IOPS necesarios en entornos virtualizados dinámicos.

2. Alteração de Hostname no Proxmox VE

Sección titulada «2. Cambio de Hostname en Proxmox VE»

Proxmox VE emplea el nombre de host de la terminal (hostname) para estructurar las rutas físicas de su sistema de archivos en clúster de solo lectura (/etc/pve/nodes/NOMBRE_NODO). Cambiar este valor directamente en caliente romperá la conectividad y el montaje lógico.

Procedimento de Alteração em Nós Standalone (CLI)

Sección titulada «Procedimiento de Cambio en Nodos Standalone (CLI)»

Passo 1: Configurar os Ficheiros do Sistema Operativo

Sección titulada «Paso 1: Configurar los Archivos del Sistema Operativo»

A partir da consola local de SSH no servidor:

  1. Edite o hostname do sistema:
    Ventana de terminal
    nano /etc/hostname
    # Modifica 'nombre-antiguo' por 'PT-PORTEL-ADMIN-NODE01'
  2. Modifique a resolução local de nomes na base de hosts:
    Ventana de terminal
    nano /etc/hosts
    # Asegura la IP correspondiente:
    # 192.168.10.50 PT-PORTEL-ADMIN-NODE01.local PT-PORTEL-ADMIN-NODE01

Ao reiniciar, o Proxmox gerará uma estrutura de diretórios vazia baseada no novo hostname. As configurações de VMs e LXC antigos devem ser copiadas manualmente para a nova localização lógica:

  1. Reinicie o nó físico:
    Ventana de terminal
    reboot
  2. Entre novamente via SSH e execute a migração de arquivos .conf:
    Ventana de terminal
    cp /etc/pve/nodes/NOMBRE_ANTIGUO/qemu-server/* /etc/pve/nodes/PT-PORTEL-ADMIN-NODE01/qemu-server/
    cp /etc/pve/nodes/NOMBRE_ANTIGUO/lxc/* /etc/pve/nodes/PT-PORTEL-ADMIN-NODE01/lxc/

Uma vez verificado a partir da GUI web que os recursos lógicos e VMs estão acessíveis sob o novo nó, proceda à eliminação dos remanescentes obsoletos a quente:

Ventana de terminal
rm -rf /etc/pve/nodes/NOMBRE_ANTIGUO

3. Separação de Nós e Desmantelamento de Cluster

Sección titulada «3. Separación de Nodos y Desmantelamiento de Clúster»

Para desligar um nó de um cluster de comunicação (Corosync) e restabelecer a sua condição standalone sem formatar o host físico:

Ventana de terminal
systemctl stop pve-cluster
systemctl stop corosync

Passo 2: Montar o Sistema de Ficheiros em Modo Local (Read-Write)

Sección titulada «Paso 2: Montar el Sistema de Archivos en Modo Local (Read-Write)»

El sistema de archivos /etc/pve se bloquea en modo de solo lectura si no hay quórum de red. Para alterarlo localmente:

Ventana de terminal
pmxcfs -l
Ventana de terminal
rm -f /etc/pve/corosync.conf
rm -rf /etc/corosync/*

Passo 4: Encerramento do Modo de Manutenção e Ativação Padrão

Sección titulada «Paso 4: Cierre del Modo Mantenimiento y Activación Estándar»
Ventana de terminal
killall pmxcfs
systemctl start pve-cluster

4. Resolução de Erros Críticos (Troubleshooting)

Sección titulada «4. Resolución de Errores Críticos (Troubleshooting)»
  • Síntoma: Todas las máquinas virtuales muestran iconos con interrogantes grises y no es posible editarlas ni iniciarlas.
  • Causa: El nodo ha perdido comunicación con el resto del clúster de Corosync y bloquea la escritura de metadatos para evitar colisiones lógicas.
  • Bypass de Emergencia (1 Voto Máximo):
    Ventana de terminal
    pvecm expected 1

Error 2: Permission Denied al Borrar Carpetas de Nodos con Root

Sección titulada «Error 2: Permission Denied al Borrar Carpetas de Nodos con Root»
  • Síntoma: Intentas borrar un nodo fantasma con rm -rf /etc/pve/nodes/antiguo y el sistema rechaza la operación a nivel de kernel.
  • Causa: Pérdida de quórum bloqueando la base del cluster pmxcfs en modo solo lectura.
  • Solución: Ejecuta la secuencia de montaje local:
    Ventana de terminal
    systemctl stop pve-cluster
    pmxcfs -l
    rm -rf /etc/pve/nodes/antiguo
    killall pmxcfs
    systemctl start pve-cluster

5. Manual de Implementação: Impressão Híbrida com Universal Print

Sección titulada «5. Manual de Despliegue: Impresión Híbrida con Universal Print»

Este caso de estudio detalla la arquitectura de integración de una pasarela intermedia de impresión en Windows Server Core ejecutándose bajo Proxmox VE, para conectar las impresoras físicas locales al servicio SaaS Universal Print de Microsoft 365.

[💻 Cliente Windows 11] ───► [☁️ Universal Print] ───► [🔌 Conector (VM Core)]
(PT-PORTEL-ADMIN) (Microsoft 365) (w-server-2022)
│ │
▼ ▼
(Gestión Remota MMC) ────────────────────────────────► [🖨️ Impresoras Red]
  • Hipervisor Host: Nodo Proxmox VE con almacenamiento SSD.
  • Servidor Pasarela (Invitado VM): Windows Server 2022 Core (Instalación mínima de red).
    • IP Lógica del Servidor: 192.168.10.22
    • Hostname: w-server-2022
  • PC Cliente de Administración: Windows 11 (PT-PORTEL-ADMIN) en la subred de gestión local, autenticado en Microsoft Entra ID (AzureAD\PortelAdmin).
    • IP del Administrador: 192.168.10.164

5.2. Fase 1: Resolução de Problemas na Implementação da VM Windows Server Core

Sección titulada «5.2. Fase 1: Solución de Problemas en el Despliegue de la VM Windows Server Core»

Carregamento de Controladores VirtIO na Instalação

Sección titulada «Carga de Controladores VirtIO en la Instalación»

Durante o início da instalação do Windows Server Core no Proxmox, não será mostrado nenhum disco físico de destino porque o kernel do Windows não possui drivers para controladores SCSI otimizados em ambientes virtualizados.

  • Resolución:
    1. Asegura tener montada la imagen virtio-win.iso en la consola de CD virtual de Proxmox.
    2. Haz clic en Cargar Controlador en el instalador de Windows.
    3. Selecciona la ruta física: D:\viostor\2k22\amd64.
    4. Si el disco aparece inactivo en la terminal de instalación, abre la consola mediante Shift + F10 y actívalo desde Diskpart:
      Ventana de terminal
      diskpart
      select disk 0
      attributes disk clear readonly
      online disk
      exit

Configuração do Adaptador de Rede VirtIO (NetKVM)

Sección titulada «Configuración del Adaptador de Red VirtIO (NetKVM)»

Dado que la interfaz mínima de Windows Core no dispone de consola gráfica clásica (devmgmt.msc), los drivers de la tarjeta de red virtualizada deben provisionarse mediante comandos de PowerShell:

Ventana de terminal
pnputil /add-driver "D:\NetKVM\2k22\amd64\netkvm.inf" /install

Una vez cargado el driver de NetKVM, ejecuta la herramienta administrativa básica sconfig para asignar un direccionamiento IP estático permanente en la subred de servidores del laboratorio.


5.3. Fase 2: Configuração Avançada de Administração Remota (CredSSP e UAC)

Sección titulada «5.3. Fase 2: Configuración Avanzada de Administración Remota (CredSSP y UAC)»

Dado que nuestro laboratorio se ubica en un Grupo de Trabajo aislado (sin directorio activo local local) y el PC cliente está integrado en Entra ID cloud (AzureAD\PortelAdmin), es obligatorio habilitar CredSSP y delegar permisos remotos explícitos para permitir que la herramienta RSAT de Windows 11 administre el subsistema de impresión del servidor Core de forma remota.

Passo 1: Alterar o Perfil de Rede do Servidor Core para Privado

Sección titulada «Paso 1: Cambiar el Perfil de Red del Servidor Core a Privado»

Se a placa de rede do Windows Server Core estiver configurada com a categoria “Pública”, a firewall bloqueará todas as ligações de gestão remota baseadas em DCOM/WMI:

Ventana de terminal
# Identificar el InterfaceIndex del adaptador
Get-NetConnectionProfile
# Reemplazar el número de índice por el correcto obtenido (ejemplo: index 12)
Set-NetConnectionProfile -InterfaceIndex 12 -NetworkCategory Private

Passo 2: Configurar TrustedHosts no PC Cliente Administrador

Sección titulada «Paso 2: Configurar TrustedHosts en el PC Cliente Administrador»

En la terminal elevada de PowerShell de tu máquina Windows 11 de gestión (PT-PORTEL-ADMIN), añade el servidor de destino a la lista de hosts seguros de WinRM:

Ventana de terminal
winrm set winrm/config/client '@{TrustedHosts="w-server-2022,192.168.10.22"}'

Passo 3: Configurar Delegação de Credenciais CredSSP

Sección titulada «Paso 3: Configurar Delegación de Credenciales CredSSP»

Para autorizar a transmissão segura de palavras-passe de rede em duplo salto durante o aprovisionamento de filas de impressão:

  • En el PC Cliente Windows 11:
    Ventana de terminal
    Enable-WSManCredSSP -Role Client -DelegateComputer "w-server-2022"
  • En el Servidor de Impresión Core:
    Ventana de terminal
    Enable-WSManCredSSP -Role Server

Passo 4: Desativar o Bloqueio Local do UAC Remoto (TokenFilterPolicy)

Sección titulada «Paso 4: Deshabilitar el Bloqueo Local de UAC Remoto (TokenFilterPolicy)»

Por predefinição, o Windows aplica uma diretiva rigorosa que reduz os privilégios administrativos de contas locais sobre ligações WMI remotas. Execute este comando no terminal do servidor Windows Server Core para a desativar:

Ventana de terminal
New-ItemProperty -Name LocalAccountTokenFilterPolicy -Path "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System" -Value 1 -PropertyType DWord -Force

Passo 5: Instalar a Função de Serviços de Impressão no Core

Sección titulada «Paso 5: Instalar el Rol de Servicios de Impresión en Core»

O Conector do Universal Print exige que a framework e a infraestrutura básica de filas do sistema operativo estejam instaladas no nó de destino:

Ventana de terminal
Install-WindowsFeature Print-Services -IncludeManagementTools

5.4. Fase 3: Ligação Remota e Duplicação Expresso de Impressoras (Point and Print)

Sección titulada «5.4. Fase 3: Conexión Remota y Duplicación Expresar de Impresoras (Point and Print)»

Desbloqueio de Diretivas de Instalação de Drivers de Terceiros

Sección titulada «Desbloqueo de Directivas de Instalación de Drivers de Terceros»

Para permitir que sejam importados e instalados drivers da Ricoh ou Zebra remotamente na VM sem exigir autorizações presenciais do UAC:

Ventana de terminal
$regPath = "HKLM:\SOFTWARE\Policies\Microsoft\Windows NT\Printers\PointAndPrint"
if (-not (Test-Path $regPath)) { New-Item -Path $regPath -Force }
Set-ItemProperty -Path $regPath -Name "Restricted" -Value 0 -Type DWord -Force
Set-ItemProperty -Path $regPath -Name "NoWarningNoElevationOnInstall" -Value 1 -Type DWord -Force

Execução Segura da Consola de Administração (MMC)

Sección titulada «Ejecución Segura de la Consola de Administración (MMC)»

Debido a un fallo recurrente de Windows al gestionar autenticaciones de red remotas desde clientes unidos en Azure AD a servidores locales standalone, debes inicializar la consola de administración remota de impresión (printmanagement.msc) forzando el ámbito de credenciales del servidor mediante el comando runas /netonly:

Ventana de terminal
# Ejecuta en el CMD de tu PC de administración (PT-PORTEL-ADMIN)
runas /netonly /user:w-server-2022\Administrador "mmc printmanagement.msc"

Este comando levantará a consola de gestão remota de Windows 11 usando sua identidade local, mas a comunicação na sub-rede para a VM w-server-2022 será autorizada de forma implícita com o papel administrativo do servidor, permitindo adicionar impressoras e portas TCP de forma transparente.

Migração e Carregamento de Impressoras por Volume

Sección titulada «Migración y Carga de Impresoras por Volumen»

Em vez de adicionar as 10 impressoras de rede uma a uma no servidor Core:

  1. Exportação: No console gráfico MMC aberto com o comando anterior, clique com o botão direito no nó do PC administrador local (PT-PORTEL-ADMIN) e selecione Exportar impressoras para um arquivo….
  2. Importação: Na mesma árvore de console, clique com o botão direito no servidor remoto (w-server-2022) e selecione Importar impressoras de um arquivo…, carregando o arquivo .printerExport para migrar as 10 portas, configurações e drivers em menos de um minuto.

5.5. Fase 4: Registro Final no Universal Print

Sección titulada «5.5. Fase 4: Registro Final en Universal Print»

Uma vez configuradas as filas locais no servidor virtual, abra uma sessão remota do PowerShell no servidor Core e execute o conector para inscrever os seus recursos de impressão na nuvem sob a sua organização autorizada do Microsoft 365:

Ventana de terminal
# Instalación del paquete del conector en modo desatendido
C:\Deploy\UniversalPrintConnector.exe /quiet ACCEPT_EULA=Y AUTH_CODE="CODIGO_REGISTRO_ENTRA_ID"

⚡ Checklist de Operação em Virtualização

Sección titulada «⚡ Checklist de Operación en Virtualización»
  • ✓ Quórum Garantizado: Servidores de clúster Proxmox resolviendo comunicaciones y enrutando almacenamiento de forma redundante.
  • ✓ Seguridad Híbrida: Enlaces remotos WinRM asegurados bajo CredSSP y UAC filtrado para administración de impresión.
  • ✓ Cuentas Limpias: Identidades y credenciales de red simuladas en consonancia con la arquitectura lógica de laboratorio de Portelcore.