> 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/run-the-platform/es/administracion-del-sistema/cluster-settings.md).

# Configuración del clúster

Referencia de todos los ajustes de configuración del clúster de VergeOS, incluyendo tipo de CPU, asignación de RAM, mitigaciones de seguridad, políticas de recursos de cómputo, swap y monitoreo de temperatura de nodos.

El *Configuración del clúster* el formulario le permite configurar parámetros clave relacionados con el rendimiento, la seguridad, la asignación, la supervisión térmica y el intercambio. Aunque la mayoría de los ajustes predeterminados son apropiados para la mayoría de los entornos, se recomienda revisarlos al crear un nuevo clúster y periódicamente después para garantizar la alineación con las políticas y requisitos operativos de su organización.

{% hint style="success" %}
**La mayoría de los cambios en la configuración del clúster requerirán reiniciar cada nodo del clúster. Aparecerá un mensaje en la parte superior del panel del clúster cuando sea necesario reiniciar. Seleccione la *****Necesita reinicio***** opción (dentro del mensaje de reinicio/reinicio en la parte superior del panel del clúster o en la opción del menú izquierdo) para gestionar los reinicios de los nodos del clúster. Siga siempre los** [**procedimientos del modo de mantenimiento**](/run-the-platform/es/operaciones/maintenance-mode.md) **al reiniciar los nodos para evitar interrupciones en la carga de trabajo.**
{% endhint %}

## Acceso a la configuración del clúster

* Desde el menú superior, vaya a **Infraestructura** > **Clústeres** > **haga doble clic en el clúster deseado**
* Haga clic en **Editar** en el menú izquierdo.

## Clúster

Esta sección define las propiedades fundamentales de su clúster.

1. **Habilitado:** De forma predeterminada, el clúster estará habilitado. Por lo general, no hay motivo para deshabilitarlo; sin embargo, hacerlo puede ser útil en ciertas situaciones, como durante una reconfiguración completa del clúster.
2. **Nombre:** Normalmente se asigna un nombre a un clúster durante la instalación, pero puede cambiarse sin problema.
3. **Descripción:** Área de texto opcional para proporcionar una breve descripción del propósito o las características del clúster.
4. **Tipo de CPU predeterminado:** Define el tipo de CPU predeterminado/recomendado para las máquinas virtuales con este clúster designado. Esta configuración se selecciona automáticamente durante la instalación del clúster, según el hardware de CPU detectado. Durante la configuración inicial, revise el ajuste para verificar que se detectó el tipo de CPU correcto.

{% hint style="success" %}
**Para facilitar la migración/failover de máquinas virtuales a otro clúster que utilice una clase inferior de chip de CPU, *****Tipo de CPU predeterminado***** puede cambiarse al tipo de clase inferior para permitir que las máquinas virtuales se trasladen al hardware con chip más antiguo sin problema.**
{% endhint %}

{% hint style="warning" %}
**Todos los nodos dentro de un clúster deben contener el mismo hardware de CPU; tipos de CPU mezclados dentro del mismo clúster pueden causar problemas de rendimiento y de migración de cargas de trabajo.**
{% endhint %}

5. **Búfer de almacenamiento por nodo (predeterminado 2 GB):** La cantidad de RAM adicional que se asignará por nodo para la caché de rendimiento de vSAN.

{% hint style="info" %}
**Consideraciones**

* Cuando haya RAM disponible, más allá de las necesidades del sistema y de las cargas de trabajo virtuales, considere aumentar este ajuste
* Aumentar el *Búfer de almacenamiento por nodo* puede mejorar significativamente el rendimiento de lectura/escritura
* Como regla general, procure no superar el 80% de utilización de RAM durante la operación normal
  {% endhint %}

### Seguridad/Rendimiento del clúster

Esta subsección le permite habilitar o deshabilitar varias funciones y mitigaciones relacionadas con el rendimiento y la seguridad para todos los nodos del clúster.

1. **Asignar Hugepages para almacenamiento (habilitado de forma predeterminada):** Se recomienda encarecidamente habilitar hugepages en la mayoría de los casos, ya que mejora el rendimiento del almacenamiento en memoria para las cargas de trabajo. Generalmente se desaconseja deshabilitar este ajuste, excepto en escenarios poco comunes, como cuando solo se ejecutan máquinas virtuales muy pequeñas o sistemas operativos invitados heredados con soporte limitado para hugepages.
2. **Deshabilitar mitigaciones de seguridad de CPU:** Si se selecciona, las mitigaciones de seguridad de CPU a nivel de kernel se deshabilitan para el clúster.

{% hint style="warning" %}
**IMPORTANTE: Aunque deshabilitar las mitigaciones de seguridad de CPU puede mejorar el rendimiento, esto puede ser arriesgado. Seleccione esta opción solo cuando confíe completamente en todos los invitados que se ejecutan en este clúster y pueda asegurarse de que las cargas de trabajo no tienen vulnerabilidades externas (por ejemplo, sistemas aislados de Internet).**
{% endhint %}

3. **Deshabilitar Speculative Store Bypass:** Si se selecciona, deshabilita Speculative Store Bypass (SSB) en tiempo de ejecución. Deshabilitar SSB puede provocar una disminución del rendimiento de leve a moderada, según las cargas de trabajo del sistema.
4. **Deshabilitar SMT:** Si se selecciona, deshabilita la multihilación simultánea (SMT) en tiempo de ejecución.

{% hint style="info" %}

* Deshabilitar SMT perjudicará significativamente el rendimiento, ya que deshabilita el hyper-threading
* Aunque el software moderno y las actualizaciones de microcódigo generalmente mitigan muchas de las vulnerabilidades relacionadas con SMT, algunos entornos muy sensibles pueden optar por deshabilitarlo, incluso si ello implica un costo en rendimiento
* La forma recomendada de deshabilitar SMT es en la BIOS. El nombre exacto del ajuste puede variar según el fabricante; consulte la documentación de su hardware si tiene dudas
  {% endhint %}

5. **Deshabilitar estados de suspensión para CPU:** Si se selecciona, VergeOS deshabilita automáticamente el/los estados de suspensión de bajo nivel. Esto puede eliminar transiciones innecesarias de estado de suspensión debido a breves periodos de inactividad que, de otro modo, provocarían una caída notable en el rendimiento con un beneficio mínimo en eficiencia energética.

{% hint style="info" %}

* Deshabilitar los estados de suspensión de la CPU puede ser especialmente beneficioso en sistemas recién desplegados, donde las cargas de trabajo se agregan gradualmente. En estos casos, los nodos inactivos deben responder rápidamente a medida que aumenta la demanda
* Seleccionar esta opción puede dar lugar a temperaturas y consumo de energía más altos, según las cargas de trabajo del sistema
  {% endhint %}

6. **Habilitar detección de Split Lock:** Detecta eventos de split lock dentro de las cargas de trabajo y los informa en el registro del sistema. Habilitar esta opción puede tener un impacto en el rendimiento de las máquinas virtuales que desencadenan un split lock.
7. **Política de energía-rendimiento (predeterminado=*****Rendimiento*****):** Configuración de política que guía la lógica interna del procesador para equilibrar el rendimiento frente a la eficiencia energética. Normalmente es mejor dejar este ajuste en su valor predeterminado, permitiendo que el sistema optimice dinámicamente el rendimiento en tiempo de ejecución. Hay opciones alternativas de energía frente a rendimiento para admitir entornos no empresariales, como sistemas de consumo, laboratorios domésticos o implementaciones de prueba de concepto (POC).
8. **Gobernador de escalado de CPU (predeterminado=*****Rendimiento*****):** Política para el ajuste dinámico de la frecuencia de CPU a nivel de kernel según la carga del sistema. Normalmente es mejor dejar este ajuste en su valor predeterminado, permitiendo que el sistema optimice dinámicamente el rendimiento en tiempo de ejecución. Hay opciones alternativas de energía frente a rendimiento para admitir entornos no empresariales, como sistemas de consumo, laboratorios domésticos o implementaciones de prueba de concepto (POC).

### Filtro del registro del sistema

1. **Filtro del registro del sistema (predeterminado `*:3,ipmievd:5,rasdaemon,!ntpd,!postfix`):** Una lista separada por comas de filtros en sintaxis rsyslog que determina qué entradas de registro se mostrarán en la interfaz de usuario. Se muestran las entradas que coinciden con estos filtros; todas las demás se excluyen de la vista de la interfaz. Esta sintaxis admite filtros de instalación y prioridad, así como inclusiones o exclusiones específicas de programas.

{% hint style="success" %}
**Los registros sin filtrar siguen estando accesibles mediante *****Diagnósticos del nodo***** (Vaya a *****Nodos***** > haga doble clic en el nodo deseado > seleccione *****Diagnósticos***** en el menú izquierdo.)**
{% endhint %}

## Cómputo

Esta sección configura las políticas de recursos de cómputo para su clúster. Estos ajustes no se aplicarán a clústeres solo de almacenamiento.

1. **RAM máxima por máquina:** Especifica la cantidad máxima de RAM que puede asignarse a una sola carga de trabajo (como una máquina virtual, un nodo de inquilino o un servicio NAS).

{% hint style="success" %}
**Consideraciones**

* Si alguna carga de trabajo en ejecución (por ejemplo, VMs) está usando más RAM que este límite, no podrá migrar después de que se reduzca el ajuste.
* El límite afecta al inicio y a la migración de la carga de trabajo (es decir, al iniciarse en un nuevo nodo). No le impide crear una carga de trabajo con más RAM, solo evita que se inicie si se supera el límite.
* Como regla general, elija el valor de RAM más bajo que aún satisfaga las necesidades de la mayor carga de trabajo prevista. Asignaciones de RAM más bajas a cargas de trabajo individuales maximizarán la flexibilidad para migraciones, failovers y portabilidad de la carga de trabajo, y permitirán tiempos de failover más rápidos.
* **Tenga cuidado al establecer este límite cerca de la capacidad física de RAM de un nodo**. Si establece este límite para que coincida con la RAM total de un nodo (por ejemplo, 128 GB) y luego crea una VM usando esa cantidad completa, la VM no podrá iniciarse ni migrar porque:
  * VergeOS reserva RAM para las operaciones del sistema y la funcionalidad de vSAN
  * Durante el mantenimiento o failover, las cargas de trabajo deben migrar a otros nodos disponibles
  * Una VM que consume casi toda la RAM disponible no puede migrar correctamente a otro nodo
* **Enfoque recomendado:** Establezca este límite en no más del 70-80% de la RAM física del nodo más pequeño, asegurando que las VMs puedan migrar siempre durante escenarios de mantenimiento o failover.
  {% endhint %}

2. **Máximo de núcleos por máquina:** Especifica el número máximo de núcleos de CPU que puede asignarse a una sola carga de trabajo (como una máquina virtual, un nodo de inquilino o un servicio NAS)

{% hint style="success" %}
**Consideraciones**

* Si alguna carga de trabajo en ejecución (por ejemplo, VMs) está usando más núcleos que este límite, no podrá migrar después de que se reduzca el ajuste.
* En casi todos los casos, este valor **no debería exceder** el número de núcleos disponibles dentro de un **único socket de CPU**.
* **Este valor nunca debe exceder el número total de núcleos físicos en un solo nodo**
  {% endhint %}

3. **Porcentaje máximo de RAM objetivo (predeterminado 80):** Especifica el porcentaje máximo de RAM física que un nodo del clúster debería usar en condiciones normales. Este umbral ayuda a evitar la sobreasignación de nuevas cargas de trabajo. Sin embargo, puede superarse en circunstancias especiales como failover o migración de cargas de trabajo para mantener la continuidad del servicio.

{% hint style="info" %}
**Ejemplo de *****Porcentaje máximo de RAM objetivo***

* Un nodo del clúster tiene **252 GB de RAM física disponible** (256 GB con 252 GB tras el sobrecosto de BIOS/tarjeta de vídeo)
* ***Porcentaje máximo de RAM objetivo*** está establecido en el valor predeterminado de **80**
* 252 G \* 80% = **aproximadamente 200 G** utilizables en condiciones normales
* **Sobrecoste de RAM del sistema/vSAN 16 G** (nota: el sobrecoste de vSAN variará según la cantidad de almacenamiento del clúster)
* **Disponible para nuevas cargas de trabajo:** 184 GB (utilizables menos el sobrecoste), manteniéndose dentro del objetivo de uso del 80%
* **Durante failover o migración:** Uso de RAM de la carga de trabajo **puede superar temporalmente 184 GB** para admitir cargas de trabajo reubicadas
  {% endhint %}

4. **% de RAM de reserva para usar en máquinas:** define una parte (en porcentaje) del espacio de intercambio reservado específicamente para simular RAM adicional de la carga de trabajo cuando la RAM física se agota. Esta RAM virtual puede configurarse como respaldo para la sobreasignación de RAM.

{% hint style="warning" %}
**Precauciones sobre la sobreasignación de RAM**

* El uso de esta función de RAM de reserva suele estar pensado solo como respaldo para la sobreasignación de RAM
* Evite la sobreasignación en clústeres con alta utilización de memoria de carga de trabajo o cargas de trabajo críticas
* Considere ajustar el tamaño de las VMs reduciendo las asignaciones de RAM cuando el uso sea consistentemente bajo
* Si demasiadas VMs demandan simultáneamente toda su asignación de memoria, el rendimiento de la carga de trabajo puede degradarse, ya que la RAM virtual es órdenes de magnitud más lenta que la RAM física (milisegundos frente a nanosegundos)
  {% endhint %}

5. **Virtualización anidada:** Permite usar una máquina virtual dentro de otra máquina virtual utilizando aceleración de hardware del host.

{% hint style="info" %}
**La virtualización anidada puede implicar implicaciones de seguridad y problemas con la cola/medición justa.**
{% endhint %}

6. *Permitir migración en vivo de virtualización anidada:*\* Permite la migración en vivo de máquinas virtuales con virtualización anidada.
7. *Permitir migración en vivo de vGPU:*\* Permite migrar en vivo máquinas virtuales con dispositivos vGPU (experimental). Aunque no se ha verificado completamente en las pruebas, se ha observado que la migración en vivo de cargas de trabajo vGPU generalmente funciona de forma fiable cuando se utilizan los controladores NVIDIA más recientes tanto en el host como en el invitado.

{% hint style="info" %}
**Si no hay suficientes dispositivos vGPU disponibles, las cargas de trabajo pueden apagarse temporalmente durante el mantenimiento.**
{% endhint %}

{% hint style="success" %}
\***Migraciones en vivo**

La configuración de la máquina virtual: *Método de migración* permite definir el comportamiento de migración por VM (por ejemplo, requerir apagado manual, intentar migración en vivo)
{% endhint %}

### Habilitación de la virtualización anidada

La virtualización anidada requiere dos ajustes; debe habilitarse tanto para el clúster como a nivel de VM:

1. **Nivel de clúster:** Habilite el **Virtualización anidada** ajuste en la lista anterior. Si aparece un mensaje de reinicio en la parte superior del panel del clúster, reinicie los nodos del clúster usando los procedimientos adecuados de [procedimientos del modo de mantenimiento](/run-the-platform/es/operaciones/maintenance-mode.md).
2. **Nivel de VM:** Desde el panel de la VM, haga clic en **Editar** y habilite **Virtualización anidada** en la configuración de la VM.

Reinicie la VM después de habilitar ambos ajustes. La función de CPU se aplica cuando la VM se inicia.

{% hint style="info" %}
El **Permitir migración en vivo de virtualización anidada** el ajuste es independiente. Solo controla si las VMs con virtualización anidada pueden migrar en vivo entre nodos; no es necesario para ejecutar virtualización anidada.
{% endhint %}

{% hint style="success" %}
**Caso de uso de Hyper-V**

Ejecutar Hyper-V dentro de un invitado Windows es una razón común para habilitar la virtualización anidada. Cuando la virtualización anidada no está habilitada en ambos niveles, el rol de Hyper-V puede hacer que el invitado entre en un bucle de arranque poco después de que aparezca el logotipo de Windows. Si el rol de Hyper-V sigue fallando después de reiniciar, apague completamente la VM y vuelva a encenderla. Ejecutar Hyper-V como invitado anidado es adecuado para escenarios de laboratorio y pruebas; no es una configuración certificada para producción.
{% endhint %}

## Almacenamiento (ajustes de intercambio)

{% hint style="warning" %}
**Los ajustes de intercambio se especifican durante la instalación del clúster. Los cambios en la configuración de intercambio solo se aplicarán a discos recién formateados.**
{% endhint %}

1. **Nivel utilizado para intercambio:** Nivel de almacenamiento que se usará para el espacio de intercambio. El intercambio se deshabilita cuando el valor es 0
2. **Intercambio por unidad:** Cantidad de espacio de intercambio que se asignará por unidad

## Temperatura del nodo

Esta sección le permite definir ajustes para el comportamiento de alertas de VergeOS relacionado con lecturas térmicas más altas de la CPU en los nodos del clúster. Una notificación oportuna, antes de alcanzar las temperaturas máximas de la CPU, puede permitir tomar medidas para evitar interrupciones y daños al equipo físico; permitir que el hardware de la CPU alcance sus límites máximos de temperatura puede provocar que la CPU se apague automáticamente o cause bloqueos graves, así como posibles daños en el hardware.

1. **Temperatura máxima del núcleo (Celsius)** Establece una temperatura máxima que se utilizará para la supervisión de temperatura de VergeOS (usada en combinación con el siguiente ajuste: *Umbral de advertencia de temperatura máxima del núcleo %*).

   * ***consulta desde el hardware***** (predeterminado)** - recupera del CPU la temperatura máxima definida por el hardware

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>El hardware que no es de servidor y algunos servidores heredados pueden no admitir esta consulta; en tales casos, se puede seleccionar el ajuste </strong><em><strong>personalizado</strong></em><strong> para establecer una temperatura máxima sobre la que basar las advertencias de VergeOS.</strong></p></div>

   * ***personalizado*** - permite definir manualmente una temperatura máxima específica. Consulte la documentación de su hardware para verificar la temperatura máxima de su CPU.
   * ***deshabilitar*** - esta selección puede usarse cuando no desea supervisar la temperatura dentro de VergeOS (cuando no es responsable de supervisar el hardware, por ejemplo, un proveedor bare metal, o VergeOS se ejecuta dentro de un entorno virtual)
2. **Umbral de advertencia de temperatura máxima del núcleo %** Establece un umbral porcentual relativo a la temperatura máxima del núcleo (arriba) en el que se activará un estado de advertencia. Un estado de advertencia generará un estado de nodo amarillo y se creará una entrada de advertencia en el registro del sistema. Normalmente, se recomienda un umbral de al menos 10% o más para permitir tiempo para tomar las medidas adecuadas en respuesta a un problema térmico.

{% hint style="info" %}
**Ejemplo**

Si *Temperatura máxima del núcleo (Celsius)* está establecido en 80 grados y *Umbral de advertencia de temperatura máxima del núcleo %* está establecido en 10, el estado de advertencia se activará cuando el hardware de CPU informe 72 grados.
{% endhint %}

3. **Temperatura crítica del núcleo (Celsius):** Define la temperatura a la que se activará un estado de error en VergeOS. Cuando las temperaturas de hardware informadas alcanzan esta temperatura, el estado del nodo pasará a rojo y aparecerá una entrada de error en el registro del sistema.

   * ***consulta desde el hardware*****&#x20;(predeterminado)** - recupera del CPU la temperatura crítica definida por el hardware

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>El hardware que no es de servidor y algunos servidores heredados pueden no admitir esta consulta; en tales casos, se puede seleccionar el ajuste </strong><em><strong>personalizado</strong></em><strong> para establecer una temperatura máxima sobre la que basar las advertencias de VergeOS.</strong></p></div>

   * ***personalizado*** - permite definir manualmente una temperatura crítica. Consulte la documentación de su hardware para verificar la temperatura máxima de su CPU.
   * ***deshabilitar*** - esta selección puede usarse cuando no desea supervisar la temperatura dentro de VergeOS (cuando no es responsable de supervisar el hardware, por ejemplo, un proveedor bare metal, o VergeOS se ejecuta dentro de un entorno virtual)


---

# 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/run-the-platform/es/administracion-del-sistema/cluster-settings.md?ask=<question>&goal=<endgoal>
```

`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.