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.

Métodos de actualización

Puede actualizar el cluster de OpenSearch a una versión de software más reciente para acceder a nuevas funciones y funcionalidades. OpenSearch soporta varias versiones simultáneas, por lo que puede mantener el cluster de OpenSearch actualizado con las últimas mejoras. En este tema se describen los métodos de actualización, las consideraciones y las rutas de actualización admitidas.

Seleccione uno de los siguientes métodos para actualizar el cluster de OpenSearch:

Clonar y actualizar: (recomendado) cree un clon del cluster de OpenSearch y actualice el cluster clonado a la versión necesaria. Utilice este enfoque para minimizar el riesgo y el tiempo de inactividad, y para probar la actualización antes de cambiar el tráfico de producción al nuevo cluster.
Actualización directa: actualice el cluster de OpenSearch existente a la versión necesaria. Utilice este método para clusters pequeños o no críticos en los que se puede aceptar un breve tiempo de inactividad. Esta opción también se conoce como "actualización in situ".
Instantánea y restauración: utilice este método para realizar una migración limpia a una nueva versión de cluster de OpenSearch, especialmente cuando necesite cambiar configuraciones como tipo de instancia, región o arquitectura durante el cambio de versión. Siga estos pasos para utilizar este método de actualización:
1. Cree una instantánea del cluster de OpenSearch actual. Para obtener instrucciones, consulte Creación de una copia de seguridad de cluster.
2. Cree un nuevo cluster de OpenSearch con la versión de software necesaria.
3. Restaure la instantánea en el nuevo cluster de OpenSearch. Para obtener instrucciones, consulte Restoring a Backup from a Cluster.

Limitaciones y consideraciones para las actualizaciones

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

Después de iniciar una actualización directa, no puede detener ni cancelar el proceso. Le recomendamos que cree una copia de seguridad antes de iniciar la actualización.
Solo puede actualizar a una versión más reciente del software OpenSearch. No puede cambiar a una versión anterior.
Si algún índice del cluster utiliza el pipeline de RAG, falla la actualización directa a la versión 3.2.0. Use el método de instantánea y restauración como solución alternativa. RAG es totalmente compatible con OpenSearch versión 3.2.0.

Rutas de actualización de software

Puede actualizar un cluster de OpenSearch a una versión más reciente, pero solo a una versión principal a la vez. La ruta de actualización recomendada se describe en la siguiente tabla:


Versión actual	Versión actualizada
1.x	2,19
2.x	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 una versión que se muestra en la tabla anterior. Para obtener más información, consulte Buscar 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.
Actualización del cluster actual
Para actualizar el cluster actual, defina el parámetro is-clone como false:
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]
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.
Clonación del cluster y aplicación de la actualización
Para crear una clonación del cluster y aplicar la actualización a la clonación, defina el parámetro is-clone como true:
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]
Ejecute la operación UpgradeOpenSearchCluster para realizar una actualización en línea (versión de compilación menor) para un cluster.
Actualización del cluster actual
Defina el parámetro .isClone() en false. Por ejemplo:
```
.isClone(false)
```
Clonación del cluster y aplicación de la actualización
Defina el parámetro .isClone() en true. Por ejemplo:
```
.isClone(true)
```

Cambios de ruptura de OpenSearch

Para obtener información sobre los desuso de OpenSearch asociados a la versión 3.x, incluidas las actualizaciones y los desuso, consulte el siguiente sitio de OpenSearch:

https://docs.opensearch.org/latest/breaking-changes/N.º 300

La información sobre otras versiones de OpenSearch también se muestra en el sitio.

Configuración de archivo

Las versiones de OpenSearch 3.x cambian el nombre de la configuración en desuso con el prefijo archived. Todos los valores de archivo 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

Documentación de Oracle Cloud Infrastructure