> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/learn-the-platform/es/modulo-9-supervision-y-resolucion-de-problemas/06-common-issues.md). # Problemas comunes y soluciones ## 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. ```mermaid graph TD A["Identificar síntoma"] --> B{"¿Qué subsistema?"} B -->|VM| C["Red / Memoria"] B -->|Storage| D["vSAN / NAS"] B -->|Hardware| E["SEL / IPMI"] B -->|Install| F["Arranque / Unión"] C --> G["Pasos de resolución"] D --> G E --> G F --> G G --> H{"¿Resuelto?"} H -->|Sí| I["Documentar y cerrar"] H -->|No| J["Escalar al soporte"] style A fill:#4a90d9,color:#fff style B fill:#2c3e50,color:#fff style G fill:#27ae60,color:#fff style J fill:#e74c3c,color:#fff ``` *** ## 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](https://docs.verge.io/product-guide/virtual-machines/vm-guest-agent/) 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 | {% hint style="success" %} **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. {% endhint %} *** ## 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: ```json { "key": "syslog_regex_list", "value": "2E2A4765742053454C20496E666F20636F6D6D616E64206661696C65642E", "default_value": "", "description": "Líneas codificadas en hexadecimal de expresiones regulares para filtrar del syslog" } ``` 4. 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:** ```bash 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 {% hint style="warning" %} **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`. {% endhint %} ### 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: ```bash sudo nano /etc/nsmb.conf ``` 2. Añada lo siguiente: ```ini [default] smb_neg=smb3_only signing_required=no ``` 3. **Borre la caché SMB de macOS:** ```bash sudo rm -rf /var/db/samba/* sudo rm -rf /var/db/smb/* ``` 4. **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) {% hint style="success" %} **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. {% endhint %} ### 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. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.verge.io/learn-the-platform/es/modulo-9-supervision-y-resolucion-de-problemas/06-common-issues.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.