Problemas comunes y soluciones

Patrones de solución de problemas para los inconvenientes de VergeOS que se encuentran con mayor frecuencia: red de VM, informes de memoria del invitado, ruido SEL, comparticiones NAS, problemas de instalación y degradación del almacenamiento.

Referencia rápida para solución de problemas

Esta página recopila los problemas más comunes encontrados por los administradores de VergeOS, organizados por subsistema. Cada sección incluye síntomas, causas raíz y procedimientos de resolución paso a paso.

---

Conectividad de red de la VM

Los problemas de conectividad de red son el tema de soporte más común. Antes de profundizar, verifique si otras VMs en el mismo entorno pueden acceder a Internet. Si ninguna puede, es probable que el problema esté aguas arriba de VergeOS (switch, firewall, ISP). Si otras VMs funcionan bien, casi siempre se trata de una configuración omitida en la VM afectada.

Falta de configuración de NIC

Síntoma: La VM arranca, pero no hay interfaces de red visibles en el sistema operativo invitado.

Resolución:

1. Abra el panel de la VM y revise la NICs sección
2. Si no aparece ninguna NIC, haga clic en Agregar NIC
3. Seleccione la red correcta y establezca el tipo de interfaz en VirtIO (recomendado) o E1000 para compatibilidad heredada
4. La NIC aparece inmediatamente en el invitado cuando la conexión en caliente está habilitada (predeterminada); en algunos sistemas operativos puede ser necesario volver a explorar el sistema operativo invitado. Solo apague y encienda si la conexión en caliente está deshabilitada.

Asignación de red incorrecta

Síntoma: La VM tiene una NIC pero no puede llegar a otras VMs ni a Internet.

Resolución:

1. Navega al panel de la VM → NICs
2. Verifique que el estado de la NIC sea Activo
3. Confirme que la Red columna muestre la red correcta; compárela con una VM que funcione en el mismo entorno
4. Si es incorrecto, edite la NIC y reasígnela a la red adecuada
5. Apague y encienda la VM

Faltan controladores VirtIO

Síntoma: La VM de Windows no muestra ningún adaptador de red en el Administrador de dispositivos, aunque hay una NIC configurada en VergeOS.

Resolución:

1. Verifique que exista una NIC en la NICs sección de la VM dentro de VergeOS
2. Conéctese a la VM mediante la Consola remota
3. Instale los controladores VirtIO desde la ISO del agente invitado; consulte la documentación de VergeOS sobre Agente invitado de VM para los pasos de descarga e instalación
4. Tras instalar los controladores, Windows detectará automáticamente el adaptador de red

Configuración IP del invitado incorrecta

Síntoma: La NIC está presente y los controladores están instalados, pero la VM aún no puede acceder a la red.

Resolución:

1. Dentro del sistema operativo invitado, verifique que el adaptador de red esté detectado y habilitado
2. Para DHCP: asegúrese de que la red tenga un servicio DHCP en ejecución (consulte Redes → [Red] → DHCP)
3. Para IP estática: confirme que la dirección IP, la máscara de subred, la puerta de enlace y la configuración DNS coincidan con el diseño de la red
4. Use la Diagnóstico de red herramienta (ping, exploración ARP) desde el contexto de red de VergeOS para verificar la conectividad de capa 2

---

Informe de memoria del invitado

Los administradores que migran desde VMware o Nutanix a menudo notan que VergeOS informa un uso de memoria mayor del que esperan. Esto es intencional, no un problema.

Memoria asignada frente a activa

Síntoma: VergeOS muestra que una VM usa 8 GB de RAM, pero el administrador de tareas del sistema operativo invitado muestra solo 2 GB en uso.

Explicación: VergeOS muestra asignada memoria — la RAM física reservada en el host para esa VM. Cuando asigna 8 GB a una VM, el hipervisor reserva inmediatamente 8 GB de memoria física, independientemente de lo que el invitado esté consumiendo activamente. Este es el compromiso real de recursos en el host.

Sin ballooning de memoria

A diferencia de las plataformas que dependen del ballooning de memoria para recuperar memoria no utilizada del invitado, VergeOS intencionalmente no usa ballooning. Esta decisión de diseño proporciona:

• Rendimiento predecible — sin sobrecarga del controlador de balloon ni presión de memoria inesperada
• Planificación de capacidad simplificada — asignada = comprometida; sin adivinar ratios de sobrecompromiso
• Mayor fiabilidad — sin riesgo de condiciones OOM provocadas por ballooning dentro de los invitados
• Dimensionamiento de migración preciso — lo que asigna es lo que necesita en el host de destino

Mejores prácticas de planificación de capacidad

Métrica	Dónde comprobar	Qué significa
RAM asignada de la VM	Panel de la VM	RAM física reservada para esta VM
RAM activa del invitado	Dentro del SO invitado (Administrador de tareas / free -h)	Lo que realmente está usando el invitado
RAM disponible del nodo	Panel del nodo → Memoria	Cuánta RAM del host permanece sin asignar
Porcentaje máximo objetivo de RAM del clúster	Sistema → Configuración → Avanzado	Umbral para las decisiones de ubicación de VMs

Ajuste del tamaño de las VMs

Como VergeOS asigna la cantidad completa, ajustar correctamente la memoria de las VMs es más importante que en plataformas con ballooning. Empiece con asignaciones conservadoras y aumente solo cuando la supervisión del invitado muestre un uso alto sostenido.

---

Ruido de SEL (registros IPMI falsos positivos)

Algunos servidores generan entradas de registro IPMI repetitivas e inocuas que llenan el Registro de eventos del sistema (SEL) y activan alertas innecesarias. El culpable más común es el "falló el comando Get SEL Info" mensaje.

Entendiendo el SEL

El registro de eventos del sistema se almacena en el hardware (en el controlador BMC/IPMI) con capacidad limitada. Una vez lleno, no se pueden registrar nuevos eventos hasta que se borre el registro. El panel del nodo muestra la capacidad del SEL como una barra de porcentaje.

Filtrar el ruido del SEL mediante la API

Para suprimir mensajes falsos positivos sin perder alertas reales de hardware:

1. Vaya a Sistema → Documentación de la API
2. Busque la ajustes tabla y expándala
3. Haga clic en la POST opción e introduzca este cuerpo:

{
  "key": "syslog_regex_list",
  "value": "2E2A4765742053454C20496E666F20636F6D6D616E64206661696C65642E",
  "default_value": "",
  "description": "Líneas codificadas en hexadecimal de expresiones regulares para filtrar del syslog"
}

1. Haga clic en Ejecutar

El valor es una expresión regular codificada en hexadecimal: .*falló el comando Get SEL Info. — puede codificar patrones adicionales con una herramienta de codificación hexadecimal y separar varios patrones con |.

Ejemplo — filtrado de dos patrones:

La expresión regular (falló el comando Get SEL Info|No se puede enviar el comando: dispositivo o recurso ocupado) se codifica como:

284765742053454C20496E666F20636F6D6D616E64206661696C65647C556E61626C6520746F2073656E6420636F6D6D616E643A20446576696365206F72207265736F75726365206275737929

Reiniciando el servicio IPMI

Después de aplicar el filtro, reinicie la captura de registros en cada nodo afectado:

Opción A — Mediante la interfaz:

1. Vaya a Infraestructura → Nodos → [Nodo]
2. Edite el nodo, desmarque "Capturar registros del sistema", envíe
3. Espere 15 segundos
4. Edite el nodo nuevamente, vuelva a habilitar "Capturar registros del sistema"

Opción B — Mediante SSH:

sudo systemctl restart openipmi

Borrando un SEL completo

Si el SEL ya está lleno:

1. Vaya a Infraestructura → Nodos → [Nodo]
2. Haga clic en Borrar SEL en el menú izquierdo
3. Confirme con Sí

---

Problemas de uso compartido NAS

Windows: no puede conectarse a recursos compartidos CIFS

Síntoma: Los clientes Windows 10/11 no pueden acceder a recursos compartidos CIFS y reciben errores de "acceso denegado" o "no se puede conectar" incluso con credenciales correctas.

Causa raíz: Windows moderno tiene por defecto deshabilitados los inicios de sesión de invitado inseguros para conexiones SMB.

Resolución — Habilitar inicios de sesión de invitado inseguros:

1. Presione Win + R, escriba gpedit.msc, presione Entrar
2. Vaya a: Configuración del equipo → Plantillas administrativas → Red → Lanman Workstation
3. Localice Habilitar inicios de sesión como invitado inseguros → Clic derecho → Editar
4. Selecciona Habilitado → Haga clic en Aceptar
5. Reiniciar el dispositivo Windows

Windows Home Edition

gpedit.msc no está disponible en Windows Home. Use el Editor del Registro en su lugar: vaya a HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\LanmanWorkstation\Parameters y establezca AllowInsecureGuestAuth (DWORD) en 1.

macOS: Fallos de conexión o rendimiento deficiente

Síntoma: El Finder de macOS no puede conectarse a recursos compartidos CIFS, las conexiones se caen intermitentemente o el rendimiento es inutilizable.

Resolución — Forzar SMB3 mediante nsmb.conf:

1. Abra Terminal y cree o edite la configuración SMB:

sudo nano /etc/nsmb.conf

1. Añada lo siguiente:

[default]
smb_neg=smb3_only
signing_required=no

1. Borre la caché SMB de macOS:

sudo rm -rf /var/db/samba/*
sudo rm -rf /var/db/smb/*

1. Reinicie su Mac para aplicar los cambios

Opciones de configuración avanzada para clientes macOS: Para una mejor compatibilidad con macOS, añada las directivas orientadas a macOS (incluidas vfs objects = fruit streams_xattr y las opciones relacionadas fruit:* opciones) bajo Opciones de configuración avanzadas en la configuración CIFS de NAS (NAS → CIFS). Esto habilita las extensiones SMB nativas de Apple.

Errores de permiso denegado

Síntoma: Los usuarios reciben "Access Denied" al explorar o abrir archivos en un recurso compartido, aunque pueden ver el nombre del recurso.

Lista de verificación de resolución:

1. Lista de usuarios válidos: Vaya a NAS → Recursos compartidos → [Recurso compartido] y confirme que el usuario o grupo esté en la lista de usuarios válidos
2. Configuración browseable: Asegúrese de que el recurso compartido esté configurado como visible si los usuarios necesitan descubrirlo
3. Forzar usuario / forzar grupo: Si está configurado, verifique que el usuario/grupo forzado tenga permisos de lectura/escritura en el volumen subyacente
4. Reinicio del servicio NAS: Tras los cambios de permisos, reinicie el servicio NAS para aplicarlos

Rendimiento lento de CIFS

Síntoma: Las transferencias de archivos por CIFS son significativamente más lentas de lo esperado.

Resolución:

1. Versión del protocolo SMB: En NAS → Volúmenes → [Volumen] → Configuración avanzada, verifique la versión mínima del protocolo SMB. Establecerla demasiado baja (SMB1) obliga a una negociación heredada
2. Ruta de red: Use Diagnóstico de red (ping, traceroute) para comprobar la latencia entre la subred del cliente y la red NAS
3. Carga de conexiones: Use Diagnóstico NAS → Estado de Samba para comprobar las conexiones activas e identificar recursos compartidos sobrecargados
4. Recursos NAS: Compruebe la asignación de CPU y memoria para el servicio NAS; las VMs NAS con recursos insuficientes limitarán el rendimiento

---

Solución de problemas de instalación

Problemas de arranque

Síntoma: El nodo no arranca desde el instalador USB de VergeOS.

Resolución:

• Verifique que la configuración de arranque BIOS/UEFI coincida con el tipo de medio de instalación (UEFI recomendado)
• Pruebe el medio USB en un sistema que se sepa que funciona para descartar una unidad defectuosa
• Confirme la compatibilidad del hardware: verifique que la CPU admita 64 bits con virtualización por hardware (VT-x/AMD-V)
• Deshabilite Secure Boot en la BIOS si el instalador no se carga

Incompatibilidades de configuración de red

Síntoma: La instalación finaliza, pero el nodo no puede comunicarse con otros nodos ni con la red.

Resolución:

• Durante la instalación, deténgase inmediatamente si cualquier IP o interfaz detectada no coincide con el diseño de su red
• Verifique que las configuraciones VLAN coincidan con los ajustes del puerto del switch
• Revise las conexiones físicas de los cables; el instalador detecta interfaces automáticamente, y un cableado incorrecto provoca asignaciones erróneas de interfaz
• Confirme que el direccionamiento IP no entre en conflicto con dispositivos existentes en la red

Modo JBOD del controlador de almacenamiento

Síntoma: El instalador de VergeOS no detecta todas las unidades esperadas.

Resolución:

• VergeOS requiere que las unidades se presenten como discos individuales (modo JBOD/passthrough), no como matrices RAID
• Entre en la BIOS del controlador de almacenamiento (por ejemplo, PERC, MegaRAID) y configure cada unidad como volumen JBOD o RAID-0 individual
• Algunos controladores requieren actualizaciones de firmware para admitir el modo JBOD; consulte la documentación del fabricante del hardware

Fallos al unir nodos secundarios

Síntoma: El controlador secundario o el nodo de cómputo no logra unirse al clúster existente.

Resolución:

1. Verifique que seleccionó "No" cuando se le pregunte si se trata de una instalación nueva (para nodos secundarios)
2. Confirme que introdujo las credenciales de administrador del controlador primario correctamente
3. Asegúrese de que ambos nodos estén en la misma red y puedan alcanzarse entre sí (verifique las asignaciones VLAN de los puertos del switch)
4. Coincida exactamente con la configuración de cifrado del controlador primario
5. Coincida con las asignaciones de nivel de unidad del controlador primario
6. Si el secundario arranca pero no aparece en la interfaz primaria, revise la configuración de red de la malla principal y verifique la conectividad del switch entre nodos

---

Problemas de almacenamiento

Estado degradado de vSAN

Síntoma: El panel muestra un nivel de vSAN en estado "degradado" o "no redundante".

Explicación: Un estado degradado significa que una o más unidades de un nivel han fallado o no están disponibles, pero el vSAN sigue operativo. Los datos siguen siendo accesibles porque VergeOS mantiene la redundancia entre nodos.

Resolución:

1. Vaya a Sistema → vSAN → Unidades para identificar la(s) unidad(es) fallida(s)
2. Compruebe los datos SMART de la unidad mediante Diagnóstico del nodo → Prueba diagnóstica S.M.A.R.T.
3. Si se necesita un reemplazo físico, use Diagnóstico del nodo → Control LED para iluminar la bahía de la unidad e identificarla
4. Póngase en contacto con soporte de Verge para obtener orientación sobre el reemplazo de la unidad; el vSAN reconstruirá automáticamente la redundancia una vez que se añada la unidad de reemplazo

Tiempos de reconstrucción de unidades

Entender las expectativas: Los tiempos de reconstrucción dependen de la cantidad de datos del nivel y de la capacidad de E/S de las unidades restantes. Durante una reconstrucción:

• El sistema sigue funcionando plenamente
• El rendimiento de escritura puede reducirse ligeramente
• Supervise el progreso mediante el indicador de progreso del nivel en el panel de vSAN (100% = completo)

Minimizar el impacto de la reconstrucción

Evite programar migraciones de cargas de trabajo intensivas o grandes importaciones de datos durante una reconstrucción. El vSAN prioriza las operaciones de reconstrucción, pero E/S adicional prolonga la ventana de reconstrucción.

Advertencias de umbral de capacidad

Síntoma: Las alertas del panel advierten que la capacidad de almacenamiento se acerca a los límites.

Resolución:

1. Compruebe la utilización del nivel en Sistema → vSAN — cada nivel muestra la capacidad usada frente a la total
2. Revise los datos SMART de la unidad mediante Infraestructura → Nodos → [Nodo] → Diagnósticos → Prueba diagnóstica S.M.A.R.T. para comprobar los niveles de desgaste e indicadores de salud de la unidad
3. Como alivio inmediato, identifique y elimine instantáneas innecesarias o unidades de VM sin usar
4. Para una solución a largo plazo, añada unidades o nodos para ampliar el nivel; consulte los procedimientos de ampliación de vSAN

Los siguientes puntos de corte son orientación de formación para planificación, no umbrales documentados. Los valores documentados son el predeterminado de alta utilización por suscripción del 80% (usado por las alertas de alta utilización iniciales de vSAN/nivel de almacenamiento) y el 90% sync_max_usage umbral en el que vSAN limita las escrituras y marca el nivel sin espacio.

Nivel de utilización	Acción requerida
< 70%	Funcionamiento normal — no se requiere acción
70–85%	Planifique la ampliación de capacidad; revise las políticas de retención de instantáneas
85–90%	Reduzca activamente el uso o añada capacidad
> 90%	Crítico — priorice la ampliación; riesgo de fallos de escritura

---

Árbol de decisión para solución de problemas

Cuando se enfrente a un problema que no encaje en las categorías anteriores, siga este flujo de trabajo general:

1. Delimite el problema

¿El problema afecta a una VM, una red, un nodo o a todo el sistema? Delimitar el alcance determina con qué herramienta de diagnóstico empezar.

2. Use diagnósticos del componente

Comience con la herramienta de diagnóstico específica del componente (Red, Nodo, NAS o Diagnósticos de vSAN); se ejecutan automáticamente en el contexto correcto.

3. Revise los registros del sistema

Revise los registros del panel y las alertas del sistema en busca de eventos correlacionados. Busque patrones: ¿se activaron varias alertas al mismo tiempo?

4. Escale con datos

Si el problema no se resuelve, genere un Diagnósticos del sistema paquete (Sistema → Diagnósticos del sistema) y envíelo junto con su solicitud de soporte.