Documentación de Oracle Cloud Infrastructure

OpenSearch Actualizaciones de software de cluster

Actualizar la versión de software de un cluster con una actualización de software en línea.

Puede actualizar la versión de software del cluster OpenSearch mediante los siguientes métodos:

  • Instantánea y restauración: siga estos pasos:
    1. Cree una instantánea a partir del cluster actual. Para obtener instrucciones, consulte Creación de una copia de seguridad de cluster OpenSearch.
    2. Cree un nuevo cluster de la versión de software necesaria.
    3. Restaure la instantánea en el nuevo cluster. Para obtener instrucciones, consulte Restoring a Backup to a New OpenSearch Cluster.
  • Actualización directa: actualice el cluster a la versión necesaria.
  • Clonar y actualizar: cree una clonación del cluster y actualice a la versión necesaria.

Los métodos de cambio de versión directo y Clonación y cambio de versión se describen más adelante en este tema.

Tenga en cuenta las siguientes limitaciones y consideraciones relacionadas con las actualizaciones en línea:

  • Después de iniciar el proceso de cambio de versión en línea, no puede detener ni cancelar el proceso. Se recomienda crear una copia de seguridad del cluster.
  • Solo puede actualizar un cluster a una versión de software OpenSearch más reciente; no puede volver a una versión de software OpenSearch anterior.
  • Los nodos e índices OpenSearch son compatibles con versiones anteriores de la versión principal anterior.

Rutas de actualización admitidas para la actualización en línea

Versión anterior a la actualización Versión posterior a la actualización
1,2 2,3
2,3 2,11
2,11 2,15
2,15 2,18
2,18 2,19
2,19 3,2

Acceda a la lista Clusters en la consola para comprobar si un cluster es elegible para una actualización de software. Los clusters que se pueden actualizar incluyen el texto Upgrade (Actualizar) en la columna Software version (Versión de software). Para obtener instrucciones sobre cómo acceder a la lista Clusters, consulte Lista de clusters OpenSearch.

    1. En la página de lista Clusters, busque el cluster OpenSearch con el que desea trabajar. Si necesita ayuda para buscar la página de lista o el cluster, consulte Lista de clusters OpenSearch.
    2. En el menú Acciones del cluster OpenSearch, seleccione Actualizar.
    3. En el panel Actualizar, seleccione una de las siguientes opciones:
      • Actualizar cluster actual: actualiza la versión de este cluster. Las actualizaciones de versiones principales pueden tener tiempo de inactividad.
      • Crear una clonación y aplicar la actualización a la clonación: utilice esta función para aplicar la actualización a una clonación para que pueda ejecutar pruebas. Recomendamos seleccionar esta opción para las actualizaciones principales a fin de evitar cualquier tiempo de inactividad del tráfico de producción debido a cualquier problema relacionado con la actualización.
    4. Seleccione la versión de software en la lista Versiones de software disponibles. Inicialmente se muestra la versión actual.
    5. Seleccione Actualizar.

  • Utilice el comando oci opensearch cluster upgrade y los parámetros necesarios para realizar un cambio de versión en línea (versión de compilación menor) para un cluster. Configure el parámetro is-clone como false o true para especificar si está actualizando el cluster actual o está creando un clon del cluster y está aplicando el cambio de versión al clon.

    Ejecute el siguiente comando para actualizar el cluster actual:

    oci opensearch cluster upgrade --opensearch-cluster-id cluster_ocid --desired-software-version desired_OpenSearch_version 
--original_cluster_display_name original_cluster_display_name --upgrade-type [MAJOR | MINOR] --is-clone false [OPTIONS]

    Ejecute el siguiente comando para crear una clonación y aplicar la actualización a la clonación:

    oci opensearch cluster upgrade --opensearch-cluster-id cluster_ocid --desired-software-version desired_OpenSearch_version 
--original_cluster_display_name original_cluster_display_name --upgrade-type [MAJOR | MINOR] --is-clone true [OPTIONS]

    El parámetro original_cluster_display_name es necesario para validar que el ID de cluster tiene el mismo nombre mostrado.

    El valor para upgrade-type debe ser MINOR.

    Para obtener una lista completa de indicadores y opciones de variables para los comandos de la CLI, consulte la Referencia de la línea de comandos.

  • Ejecute la operación UpgradeOpenSearchCluster para realizar una actualización de software en línea para un cluster. Configure upgradeType como secundario.

Realización de una actualización importante

Siga los pasos anteriores de este tema para actualizar la versión de software del cluster. Seleccione la versión 3.2.0 o posterior de la lista Versiones de software disponibles.

Nota

La actualización a la versión 3.2.0 falla si un índice con pipeline RAG está presente en el cluster, la solución alternativa actual es utilizar la instantánea y la ruta de restauración para la actualización. Sin embargo, RAG es totalmente compatible con el cluster actualizado 3.2.0.

Se está trabajando para abordar ambas cuestiones.

Configuración de archivo

Las versiones OpenSearch 3.x cambian el nombre de la configuración en desuso con el prefijo archived. Todos los valores archivados se eliminan durante la actualización. A continuación, se muestra la lista de configuraciones en desuso:

  • thread_pool.test.max_queue_size
  • thread_pool.test.min_queue_size
  • index.store.hybrid.mmap.extensions
  • knn.plugin.enabled
  • index.knn.algo_param.ef_construction
  • index.knn.algo_param.m
  • index.knn.space_type
  • plugins.sql.delete.enabled
  • opendistro*
  • plugins.sql.pagination.api