Documentación de Oracle Cloud Infrastructure

Actualización de la búsqueda con el software de cluster OpenSearch

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

La búsqueda con OpenSearch soporta varias versiones simultáneas de OpenSearch. Para los clusters existentes que utilizan versiones anteriores, puede actualizar el cluster para utilizar la funcionalidad disponible en la última versión de OpenSearch.

El proceso de actualización depende de si está realizando una actualización de versión principal o una actualización de versión menor. Una actualización de versión principal se indica mediante un cambio en el primer número del número de compilación, por ejemplo, de 2.19.1 a 3.2.0. Una actualización de versión secundaria se indica mediante un cambio en el segundo número del número de compilación, por ejemplo, de 2.11.0 a 2.15.0.

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

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.

Nota

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.
  • 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 ruta de instantánea y 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.

Rutas de actualización recomendadas

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

Las versiones 1.2.4 y 2.3.0 están en desuso, por lo que puede actualizarlas directamente a la versión 2.11.0. Para obtener más información, consulte Búsqueda con versiones soportadas de OpenSearch.

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 Listing Search with OpenSearch Clusters.

Actualización del software

    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 Listing Search with OpenSearch Clusters.
    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.

    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.

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