Actualización de la solución de BI de « watsonx » de la versión « 5.3.x » a una versión posterior de « 5.3 »

Información que necesita para completar esta tarea

Revisa la siguiente información antes de actualizar BI de watsonx :

Requisitos de versión

Todos los componentes asociados a una instancia de IBM Software Hub deben estar instalados en la misma versión. Por ejemplo, si la versión IBM Software Hubcontrol plane es 5.3.1, debe actualizar watsonx BI a la versión 5.3.1.

Variables de entorno

Los comandos de esta tarea utilizan variables de entorno, por lo que puedes ejecutarlos tal y como están escritos.

• Si no dispone del script que define las variables de entorno, consulte la sección «Configuración de las variables de entorno de instalación ».
• Para utilizar las variables de entorno desde el script, debes cargar las variables de entorno antes de ejecutar los comandos de esta tarea. Por ejemplo, ejecute:

  source ./cpd_vars.sh

Common core services

watsonx BI requiere el IBM Software Hub common core services.

Si los no common core services tienen la versión correcta en el proyecto de operandos de la instancia, se common core services actualizarán automáticamente al actualizar watsonx BI. La common core services actualización aumenta el tiempo que tarda en completarse.

Antes de empezar

Esta tarea da por supuesto que se cumplen los siguientes requisitos previos:

Requisitos del sistema

Esta tarea da por supuesto que el clúster cumple los requisitos mínimos para BI de watsonx.

Dónde encontrar más información
Si esta tarea no se ha completado, consulta los requisitos del sistema.

Además, asegúrate de disponer del tipo y el número adecuados de GPU para watsonx BI.

Dónde encontrar más información
Si esta tarea no se ha completado, consulta los requisitos de la GPU.

Estación de trabajo

Esta tarea da por supuesto que la estación de trabajo desde la que se va a ejecutar la actualización está configurada como estación de trabajo cliente y dispone de las siguientes interfaces de línea de comandos:

• IBM Software Hub Interfaz de línea de comandos: cpd-cli
• OpenShift® Interfaz de línea de comandos: oc
• Helm Interfaz de línea de comandos: oc

Dónde encontrar más información
Si esta tarea no se ha completado, consulte «Actualización de las estaciones de trabajo de los clientes ».

Panel de control

Esta tarea da por hecho que IBM Software Hubcontrol plane está actualizado.

Dónde encontrar más información
Si esta tarea no se ha completado, consulte «Actualización de una instancia de IBM » en Software Hub.

Registro de contenedor privado

Si su entorno utiliza un registro de contenedores privado (por ejemplo, si su clúster está aislado físicamente), esta tarea da por hecho que las siguientes tareas ya se han completado:

1. Las imágenes del software de BI de watsonx se replican en el registro privado de contenedores.

   Dónde encontrar más información
   Si esta tarea no se ha completado, consulta la sección «Duplicación de imágenes en un registro de contenedores privado ».

2. El cpd-cli está configurado para descargar la olm-utils-v4 imagen del registro privado de contenedores.

   Dónde encontrar más información
   Si aún no has completado esta tarea, consulta la sección «Descarga de la imagen « olm-utils-v4 » del registro de contenedores privado ».

Operadores de GPU

Esta tarea da por hecho que los operadores necesarios para utilizar las GPU están instalados.

Dónde encontrar más información
Si esta tarea no se ha completado, consulta la sección «Instalación de operadores para servicios que requieren GPU ».

Red Hat® OpenShift AI

Esta tarea da por hecho que Red Hat OpenShift AI está instalado.

Dónde encontrar más información
Si esta tarea no se ha completado, consulta la sección «Instalación de una IA de Red Hat OpenShift ».

Recursos con ámbito de clúster

Esta tarea da por hecho que se han actualizado los recursos del ámbito del clúster, como las definiciones de recursos personalizados, las funciones del clúster y las asignaciones de funciones del clúster.

Dónde encontrar más información
Si esta tarea no se ha completado, consulte Actualización de los recursos del ámbito del clúster para la plataforma y los servicios.

Servicios de requisito previo

Antes de actualizar BI de watsonx, asegúrese de que los siguientes servicios estén actualizados y en funcionamiento:

• watsonx.data™
• IBM Software Hub

  oc patch zenservice lite-cr -n cpd-instance --type=merge -p '{"spec": {"version": "6.2.2", "zen_pak_version": "6.2.2"}}'

• watsonx.data intelligence

  • Debes modificar el watsonx.data intelligence CR para habilitar los modelos de GPU.

    Para habilitar los modelos de GPU, ejecuta el siguiente comando:

    oc patch watsonxdataintelligence watsonxdataintelligence-cr -n "${PROJECT_CPD_INST_OPERANDS}" --type='json' -p='[{"op": "replace", "path": "/spec/enableModelsOn", "value": "gpu"},{"op": "replace", "path": "/spec/enableSemanticEmbedding", "value":true}]'

• watsonx.ai™ modelo integrado ibm-slate-30m-english-rtrvr
  • Para instalar el modelo ibm-slate-30m-english-rtrvr integrado, ejecuta el siguiente comando:

    oc patch Watsonxaiifm watsonxaiifm-cr -n "${PROJECT_CPD_INST_OPERANDS}" --type=json -p '[{"op": "add", "path": "/spec/install_model_list/", "value": "ibm-slate-30m-english-rtrvr"}]'

Procedimiento

Realice las siguientes tareas para actualizar BI de watsonx :

1. Mejora del servicio
2. Validación de la actualización
3. Actualización de la instancia del servicio
4. Qué hacer ahora

Actualización del servicio

Para actualizar la solución de BI de watsonx :

1. Inicia sesión cpd-cli en el Red Hat OpenShift Container Platform clúster:

   ${CPDM_OC_LOGIN}

   Recuerda: CPDM_OC_LOGIN es un alias del cpd-cli manage login-to-ocp comando.
2. Actualiza el operador y el recurso personalizado para BI de watsonx.

   cpd-cli manage install-components \
   --license_acceptance=true \
   --components=watsonx_bi_assistant \
   --release=${VERSION} \
   --operator_ns=${PROJECT_CPD_INST_OPERATORS} \
   --instance_ns=${PROJECT_CPD_INST_OPERANDS} \
   --image_pull_prefix=${IMAGE_PULL_PREFIX} \
   --image_pull_secret=${IMAGE_PULL_SECRET} \
   --upgrade=true

Validación de la actualización

[SUCCESS]... The install-components command ran successfully

Si quieres comprobar que el estado del recurso personalizado es Completed, puedes ejecutar el cpd-cli manage get-cr-status comando:

cpd-cli manage get-cr-status \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=watsonx_bi_assistant

Actualización de la instancia de servicio

Después de actualizar BI de watsonx, debe actualizar la instancia del servicio asociada a BI de watsonx.

Antes de empezar

Crea un perfil en la estación de trabajo desde la que vas a actualizar las instancias del servicio.

El perfil debe estar asociado a un IBM Software Hub usuario que tenga alguno de los siguientes permisos:

• Crear instancias de servicio (can_provision)
• Gestionar instancias de servicio (manage_service_instances)

Para obtener más información, consulte «Creación de un perfil para utilizar los comandos de gestión de cpd-cli ».

Procedimiento

Para actualizar la instancia del servicio:

1. Establezca la variable INSTANCE_VERSION de entorno en la versión que corresponda a la versión de IBM Software Hub en su clúster:

   export INSTANCE_VERSION=<version>

   Utilice la siguiente tabla para determinar el valor adecuado:

   Versión de IBM Software Hub	Versión de instancia de servicio
   5.3.1	3.4.0
   5.3.0	3.3.0

2. Actualizar la instancia del servicio:

   cpd-cli service-instance upgrade \
   --service-type=watsonx-bi-assistant \
   --instance-name=${INSTANCE_NAME} \
   --profile=${CPD_PROFILE_NAME} \
   --version=${INSTANCE_VERSION}

Qué hacer a continuación

Si aún no lo ha hecho, complete la configuración posterior a la actualización de BI de watsonx. Si ya ha completado la configuración posterior a la actualización, BI de watsonx está listo para usar. Para empezar a usar watsonx BI, consulta la sección "Primeros pasos con watsonx BI".