> 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

El *Configuración del clúster* Este formulario le permite configurar parámetros clave relacionados con el rendimiento, la seguridad, la asignación, la supervisión térmica y el swap. Si bien 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 los requisitos operativos de su organización.

{% hint style="success" %}
**La mayoría de los cambios en la configuración del clúster requerirán un reinicio de cada nodo del clúster. Aparecerá un mensaje en la parte superior del panel del clúster cuando sea necesario reiniciar. Seleccione la&#x20;*****Necesita reinicio*****&#x20;opción (dentro del mensaje de reinicio/rearranque en la parte superior del panel del clúster o la opción del menú izquierdo) para administrar 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 nodos para evitar interrupciones en las cargas de trabajo.**
{% endhint %}

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

* En el menú superior, vaya a **Infraestructura** > **Clústeres** > **haga doble clic en el clúster deseado**
* Haga clic en **Editar** en el menú de la izquierda.

## clúster

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

1. **Habilitado:** De forma predeterminada, el clúster estará habilitado. Normalmente no hay razón para deshabilitarlo; sin embargo, hacerlo puede ser útil en ciertas situaciones, como durante una reconfiguración completa del clúster.
2. **Nombre:** Normalmente, un clúster recibe un nombre durante la instalación, pero puede renombrarse 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. Este ajuste 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 acomodar la migración/failover de máquinas virtuales a otro clúster usando una clase inferior de chip de CPU,&#x20;*****El tipo de CPU predeterminado*****&#x20;puede cambiarse al tipo de clase inferior para permitir que las máquinas virtuales se trasladen al hardware de 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; los tipos de CPU mixtos 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/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 por defecto):** Habilitar hugepages se recomienda encarecidamente en la mayoría de los casos, ya que mejora el rendimiento de almacenamiento en memoria para las cargas de trabajo. Deshabilitar este ajuste generalmente se desaconseja, excepto en escenarios poco frecuentes, como cuando se ejecutan solo máquinas virtuales muy pequeñas o sistemas operativos invitados heredados con compatibilidad limitada con hugepages.
2. **Deshabilitar mitigaciones de seguridad de la CPU:** Si se selecciona, las mitigaciones de seguridad de la CPU a nivel del kernel se deshabilitan para el clúster.

{% hint style="warning" %}
**IMPORTANTE: Aunque deshabilitar las mitigaciones de seguridad de la CPU puede mejorar el rendimiento, esto puede ser arriesgado. Seleccione esta opción solo cuando confíe plenamente en todos los invitados que se ejecutan en este clúster y pueda estar seguro de que las cargas de trabajo no tienen vulnerabilidades externas (p. ej., 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 ocasionar una disminución del rendimiento de leve a moderada, dependiendo de las cargas de trabajo del sistema.
4. **Deshabilitar SMT:** Si se selecciona, deshabilita el multihilo simultáneo (SMT) en tiempo de ejecución.

{% hint style="info" %}

* Deshabilitar SMT afectará 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 implicadas con SMT, algunos entornos altamente sensibles pueden optar por deshabilitarlo, incluso si ello conlleva un costo de 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 no está seguro
  {% endhint %}

5. **Deshabilitar los estados de suspensión de las CPU:** Si se selecciona, VergeOS deshabilita automáticamente uno o más estados de suspensión de bajo nivel. Esto puede eliminar transiciones innecesarias de estados de suspensión debido a breves ráfagas de inactividad que, de otro modo, causarían una caída notable del 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 provocar temperaturas y consumo de energía más altos, dependiendo de 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 afectar el rendimiento de las máquinas virtuales que desencadenen un split lock.
7. **Política de energía-rendimiento (predeterminado=*****Rendimiento*****):** Ajuste 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. Existen 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 la CPU a nivel de kernel, basada en 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. Existen 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 de filtros separada por comas en sintaxis rsyslog que determina qué entradas de registro se muestran en la interfaz de usuario. Las entradas que coinciden con estos filtros se muestran; todas las demás se excluyen de la vista de la interfaz. Esta sintaxis admite filtros de facilitad y prioridad, así como inclusiones o exclusiones específicas por programa.

{% hint style="success" %}
**Los registros sin filtrar siguen estando accesibles mediante&#x20;*****Diagnósticos de nodo*****&#x20;(Vaya a&#x20;*****Nodos*****&#x20;> haga doble clic en el nodo deseado > seleccione&#x20;*****Diagnósticos*****&#x20;desde 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 los 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 (p. ej., 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 el inicio y la migración de la carga de trabajo (es decir, el inicio 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 su carga de trabajo más grande esperada. Asignaciones de RAM más bajas a cargas de trabajo individuales maximizarán la flexibilidad para migraciones, failovers y portabilidad de cargas de trabajo, y permitirán tiempos de failover más rápidos.
* **Tenga cuidado al establecer este límite cerca de la capacidad de RAM física de un nodo**. Si establece este límite para que coincida con la RAM total de un nodo (p. ej., 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 el failover, las cargas de trabajo deben migrar a otros nodos disponibles
  * Una VM que consuma 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 de su nodo más pequeño, asegurando que las VM puedan migrar siempre durante escenarios de mantenimiento o failover.
  {% endhint %}

2. **Núcleos máximos por máquina:** Especifica el número máximo de núcleos de CPU que pueden 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 (p. ej., 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 objetivo máximo de RAM (predeterminado 80):** Especifica el porcentaje máximo de RAM física que un nodo del clúster debe 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 un failover o la migración de una carga de trabajo para mantener la continuidad del servicio.

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

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

4. **% de RAM reservada para usar en máquinas:** define una porción (en porcentaje) del swap reservada 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 el sobreaprovisionamiento de RAM.

{% hint style="warning" %}
**Advertencias sobre el sobreaprovisionamiento de RAM**

* El uso de esta función de RAM reservada normalmente solo está pensado como respaldo para el sobreaprovisionamiento de RAM
* Evite el sobreaprovisionamiento en clústeres con alta utilización de memoria de las cargas de trabajo o cargas de trabajo críticas
* Considere ajustar el tamaño de las VM reduciendo las asignaciones de RAM cuando el uso sea constantemente bajo
* Si demasiadas VM demandan simultáneamente su asignación completa 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 por hardware del host.

{% hint style="info" %}
**La virtualización anidada puede implicar implicaciones de seguridad y problemas con la asignación justa de colas/medición.**
{% 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 usan 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**

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

## Almacenamiento (ajustes de swap)

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

1. **Nivel usado para swap:** Nivel de almacenamiento que se utilizará para el espacio de swap. El swap se deshabilita cuando el valor es 0
2. **Swap por unidad:** Cantidad de espacio de swap que se asignará por unidad

## Temperatura del nodo

Esta sección le permite definir ajustes para el comportamiento de alertas de VergeOS relacionados con lecturas térmicas más altas de la CPU en los nodos del clúster. Una notificación oportuna, antes de alcanzar la temperatura máxima 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 hacer que la CPU se apague automáticamente o provoque bloqueos graves, y un posible daño al hardware.

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

   * ***consulta del hardware*****&#x20;(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>Es posible que el hardware que no sea de servidor y algunos servidores heredados no admitan esta consulta; en tales casos, se puede seleccionar el ajuste </strong><em><strong>personalizado</strong></em><strong> para establecer una temperatura máxima en 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 está ejecutando 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 amarillo del nodo 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 disponer de 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á establecida en 80 grados y *Umbral de advertencia de temperatura máxima del núcleo %* está establecida en 10, el estado de advertencia se activará cuando el hardware de la 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 del hardware informadas alcancen esta temperatura, el estado del nodo cambiará a rojo y aparecerá una entrada de error en el registro del sistema.

   * ***consulta del 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>Es posible que el hardware que no sea de servidor y algunos servidores heredados no admitan esta consulta; en tales casos, se puede seleccionar el ajuste </strong><em><strong>personalizado</strong></em><strong> para establecer una temperatura máxima en 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 está ejecutando 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.
