Actualización de IBM Software Hub la versión 5.3.x a una versión posterior: 5.3 refresh

Un administrador Red Hat® OpenShift® Container Platform de clúster y un administrador de instancia pueden colaborar para actualizar IBM Software Hub de la versión 5.3.x a una actualización posterior de la versión 5.3.

Importante: Todos los servicios asociados a una instancia de IBM Software Hub deben actualizarse a la misma versión. Por ejemplo:
  • Si desea actualizar una instancia de IBM Software Hub a la versión 5.3.1, debe actualizar todos los servicios instalados en dicha instancia a la versión 5.3.1.
  • Si desea actualizar un servicio a la versión 5.3.1, debe actualizar la instancia en IBM Software Hub la que está instalado el servicio y actualizar todos los servicios instalados en dicha instancia a la versión 5.3.1.

Antes de empezar

Antes de actualizar IBM Software Hub:
  1. Consulte la información de la sección «Planificación ».

    En concreto, asegúrate de consultar los requisitos del sistema. Tu clúster debe contar con recursos suficientes.

  2. Consulte la información de la sección «Planificación de una actualización ».
  3. Asegúrate de tener una copia del script que define las variables de entorno de instalación para tu implementación.

    El script te permite ejecutar la mayoría de los comandos de instalación y actualización sin necesidad de modificarlos.

  4. Práctica recomendada: haz una copia de seguridad de tu IBM Software Hub instalación antes de actualizarla.

    En caso de que se produzca un fallo irreparable, puedes utilizar la copia de seguridad para recuperar tu instalación actual. Para obtener más información, consulte «Copia de seguridad y restauración IBM Software Hub».

visión general de actualización

La actualización se divide en las siguientes fases:

1. Actualización de las estaciones de trabajo de los clientes

Antes de realizar la actualización IBM Software Hub, debe asegurarse de que la estación de trabajo cuente con una versión compatible de la interfaz IBM Software Hub de línea de comandos, la interfaz OpenShift de línea de comandos y la interfaz Helm de línea de comandos.

Icono Usuario Todos los administradores Cuando el icono Repetir tantas veces como sea necesario

Qué hay que hacer
  1. Actualización completa de las estaciones de trabajo de los clientes (actualización de la versión 5.3.x a una versión posterior 5.3 ).
  2. Ve al punto 2. Recopilación de la información necesaria.

2. Recopilación de la información necesaria

Para actualizar correctamente tu IBM Software Hub instalación, debes disponer de información específica sobre tu entorno.

Icono Usuario Equipo de operaciones Cuando el icono Repetir tantas veces como sea necesario

Qué hay que hacer
  1. Finalizar la determinación de los componentes que se van a actualizar (Actualización de la versión 5.3.x a una versión posterior 5.3 refresh).
  2. Si utilizas un registro de contenedores privado, sigue las instrucciones de la sección «Determinar qué modelos e imágenes duplicar en tu registro de contenedores privado» (Actualización de la versión 5.3.x a una versión posterior 5.3 refresh).
  3. Script completo para actualizar las variables de entorno (actualización de la versión 5.3.x a una versión posterior 5.3 refresh).
  4. Ve a la sección correspondiente según tu entorno:

3. Preparación para realizar actualizaciones en una red restringida

Si vas a ejecutar los IBM Software Hub comandos de actualización en una red restringida, debes preparar las estaciones de trabajo de los clientes antes de trasladarlas detrás del cortafuegos.

Icono Usuario Todos los administradores Cuando el icono Repetir tantas veces como sea necesario

Qué hay que hacer
  1. Consulte la guía «Obtención de la imagen de olm-utils-v4 » antes de ejecutar los comandos de instalación de IBM Software Hub en una red restringida (Actualización de la versión 5.3.x a una versión posterior 5.3 ).
  2. Descarga primero los paquetes de CASE antes de ejecutar los comandos de actualización IBM Software Hub en una red restringida (actualización de la versión 5.3.x a una versión posterior 5.3 refresh).
  3. Ve a la sección correspondiente según tu entorno:

4. Preparación para ejecutar actualizaciones desde un registro de contenedores privado

Icono Usuario Cada usuario debe realizar las tareas que le correspondan.

Cuando el icono Algunas de estas tareas se pueden realizar una sola vez, pero otras deben repetirse para cada usuario que participe en la instalación.

Si utiliza un registro de contenedores privado para alojar las imágenes IBM Software Hub de software, debe replicar las imágenes actualizadas desde el registro de contenedores IBM Entitled Registry público al registro de contenedores privado.

a. Duplicación de imágenes en el registro de contenedor privado

Si ha duplicado las imágenes de IBM Software Hub la versión 5.3.x en un registro de contenedores privado, deberá duplicar las imágenes de la actualización 5.3 que desee instalar en su registro de contenedores privado.

Icono Usuario Administrador del registro Cuando el icono Repetir tantas veces como sea necesario

Qué hay que hacer
  1. Realice la tarea correspondiente a su entorno en «Duplicación de imágenes en un registro de contenedores privado» (Actualización de la versión 5.3.x a una versión posterior: actualización de 5.3 ).
  2. Ve a b. ¿Tienen los usuarios que descargar la imagen « olm-utils-v4 » del registro privado de contenedores?
b. ¿Tienen los usuarios que descargar la olm-utils-v4 imagen del registro de contenedores privado?

Si la olm-utils-v4 imagen o la olm-utils-premium-v4 imagen está disponible en el registro privado de contenedores, debes actualizar el cpd-cli para descargar la imagen desde el registro privado de contenedores.

Icono Usuario Todos los administradores Cuando el icono Repetir tantas veces como sea necesario

Opciones Qué hay que hacer
Tu clúster no se encuentra en una red restringida y los usuarios pueden descargar la imagen desde el IBM Entitled Registry
  1. Ve al punto 5. Preparación del clúster.
Tu clúster no se encuentra en una red restringida, pero quieres que los usuarios descarguen la imagen desde el registro privado de contenedores
  1. Completa la descarga de la imagen « olm-utils-v4 » del registro de contenedores privado (actualización de la versión 5.3.x a una versión posterior 5.3 ).
  2. Ve al punto 5. Preparación del clúster.
Tu clúster se encuentra en una red restringida
  1. Completa la descarga de la imagen « olm-utils-v4 » del registro de contenedores privado (actualización de la versión 5.3.x a una versión posterior 5.3 ).
  2. Ve al punto 5. Preparación del clúster.

5. Preparación del clúster

Antes de realizar la actualización IBM Software Hub, debe actualizar el software necesario y los componentes compartidos del clúster.

Icono Usuario Administrador del clúster Cuando el icono Configuración inicial

a. Actualización del software necesario

Varios servicios requieren un software previo que debe actualizar el administrador del clúster.


Servicios que dependen de software previo
Software de requisito previo Servicios que requieren este requisito previo Actualiza este software si...
Node Feature Discovery Operator

Un asterisco (*) indica que el servicio requiere una GPU en determinadas situaciones.

  • IBM Knowledge Catalog Premium *
  • IBM Knowledge Catalog Standard *
  • Watson Machine Learning *
  • Watson Speech services *
  • Watson Studio Runtimes *
  • watsonx.ai™
  • watsonx Assistant *
  • Watsonx BI
  • watsonx Code Assistant™
  • watsonx Code Assistant for Red Hat Ansible® Lightspeed
  • watsonx Code Assistant for Z
  • watsonx Code Assistant for Z Agentic
  • watsonx Code Assistant for Z Code Explanation
  • watsonx Code Assistant for Z Code Generation
  • watsonx.data™ *
  • watsonx.data Premium
  • watsonx.data intelligence
  • watsonx™ Orchestrate *

Has actualizado Red Hat OpenShift Container Platform y el operador se ha instalado con installPlanApproval: Manual.

NVIDIA GPU Operator

Un asterisco (*) indica que el servicio requiere una GPU en determinadas situaciones.

  • IBM Knowledge Catalog Premium *
  • IBM Knowledge Catalog Standard *
  • Watson Machine Learning *
  • Watson Speech services *
  • Watson Studio Runtimes *
  • watsonx.ai
  • watsonx Assistant *
  • Watsonx BI
  • watsonx Code Assistant
  • watsonx Code Assistant for Red Hat Ansible Lightspeed
  • watsonx Code Assistant for Z
  • watsonx Code Assistant for Z Agentic
  • watsonx Code Assistant for Z Code Explanation
  • watsonx Code Assistant for Z Code Generation
  • watsonx.data *
  • watsonx.data Premium
  • watsonx.data intelligence
  • watsonx Orchestrate *

La versión del operador de su clúster ha llegado al final de su ciclo de soporte. Para más información, consulte «Ciclo NVIDIA GPU Operator de vida» en el

Red Hat OpenShift AI

Un asterisco (*) indica que el servicio requiere Red Hat OpenShift AI en algunas situaciones.

  • IBM Knowledge Catalog Premium *
  • IBM Knowledge Catalog Standard *
  • Watson Speech services *
  • watsonx.ai
  • watsonx Assistant *
  • Watsonx BI
  • watsonx Code Assistant
  • watsonx Code Assistant for Red Hat Ansible Lightspeed
  • watsonx Code Assistant for Z
  • watsonx Code Assistant for Z Agentic
  • watsonx Code Assistant for Z Code Explanation
  • watsonx Code Assistant for Z Code Generation
  • watsonx.data Premium
  • watsonx.data intelligence
  • watsonx Orchestrate *

La versión necesaria de Red Hat OpenShift AI depende de la versión de IBM Software Hub que tengas pensado instalar.

Debe actualizar este software si se cumplen las dos condiciones siguientes:
  • Tienes previsto actualizar una instancia de IBM Software Hub con servicios que dependen de Red Hat OpenShift AI.
  • Tienes pensado actualizar a una versión de IBM Software Hub que requiere una versión más reciente de Red Hat OpenShift AI.
Multicloud Object Gateway
  • Watson Discovery
  • Watson Speech services
  • watsonx Assistant
  • watsonx Orchestrate

Debes actualizar Multicloud Object Gateway si actualizas Red Hat OpenShift Container Platform.

Red Hat OpenShift Serverless Knative Eventing
  • watsonx Assistant
  • watsonx Orchestrate
Debe actualizar Red Hat OpenShift Serverless Knative Eventing si se cumple alguna de las siguientes condiciones:
  • Hay una nueva versión de IBM Events Operator incluida en IBM Software Hub.
  • Si actualizas Red Hat OpenShift Container Platform , la versión de Red Hat OpenShift Serverless Operator en tu clúster no es compatible con la versión de OpenShift Container Platform que estás ejecutando.
  • La versión de Red Hat OpenShift Serverless Operator en su clúster ha dejado de recibir soporte técnico.

Opciones Qué hay que hacer
La instancia que está actualizando no incluye ningún servicio que dependa de software previo
  1. Ve a b. Actualización de los recursos del ámbito del clúster para los componentes compartidos del clúster.
Estás actualizando servicios que dependen de software previo
  1. Instala todo el software necesario para la actualización (actualización de la versión 5.3.x a una versión posterior 5.3 ).
  2. Ve a b. Actualización de los recursos del ámbito del clúster para los componentes compartidos del clúster.
b. Actualización de recursos del ámbito del clúster para componentes compartidos del clúster

Si el scheduling service está instalado en el clúster, debes actualizar los recursos del ámbito del clúster, como las funciones del clúster y las asignaciones de funciones del clúster, para el scheduling service.

Opciones Qué hay que hacer
El no scheduling service está instalado
  1. Ve a la sección c. Actualización de los componentes compartidos del clúster.
El scheduling service está instalado
  1. Actualización completa de los recursos del ámbito del clúster para los componentes compartidos del clúster (actualización de la versión 5.3.x a una versión posterior 5.3 ).
  2. Ve a la sección c. Actualización de los componentes compartidos del clúster.
c. Actualización de los componentes compartidos del clúster

Antes de actualizar IBM Software Hub, debes actualizar el License Service y el scheduling service.

Qué hay que hacer
  1. Finalizar la actualización de los componentes compartidos del clúster (actualización de la versión 5.3.x a una versión posterior 5.3 ).
  2. Ve al punto 6. Preparación para actualizar una instancia de IBM Software Hub.

6. Preparación para actualizar una instancia de IBM Software Hub

Antes de actualizar una instancia de IBM Software Hub, un administrador del clúster debe preparar la instancia para la actualización.

Icono Usuario Administrador del Cuando el icono clúster Repetir tantas veces como sea necesario

a. Comprobar el estado del clúster

La interfaz de línea de IBM Software Hub comandos incluye comandos que puedes utilizar para comprobar el estado de tu clúster antes de actualizarlo IBM Software Hub. Si no comprueba el estado de su clúster antes de actualizarlo IBM Software Hub, es posible que surjan problemas durante la actualización.

Qué hay que hacer
  1. Consulte la sección «Comprobación del estado de su clúster antes de actualizar» en IBM Software Hub (Actualización de la versión 5.3.x a una versión posterior 5.3 refresh).
  2. Ve a b. Actualización de los recursos del ámbito del clúster para los componentes compartidos del clúster.
b. Actualización de los recursos del ámbito del clúster para la instancia

Antes de actualizar la IBM Software Hub plataforma o los servicios, debe crear los recursos del ámbito del clúster, como las funciones de clúster y las asignaciones de funciones de clúster, para los componentes de la instancia que desea actualizar.

Qué hay que hacer
  1. Finalizar la actualización de los recursos del clúster para la plataforma y los servicios (actualización de la versión 5.3.x a una versión posterior 5.3 ).
  2. Ve a la sección c. ¿Necesitas actualizar el operador de eventos de IBM para watsonx Assistant o watsonx Orchestrate?
c. ¿Necesitas actualizar el IBM Events Operator para watsonx Assistant o watsonx Orchestrate?

Si la instancia de IBM Software Hub que desea actualizar incluye watsonx Assistant o, watsonx Orchestrate debe actualizar la instancia de asociada a dicha IBM Events Operator instancia.

Opciones Qué hay que hacer
La instancia no incluye watsonx Assistant ni watsonx Orchestrate
  1. Ve a d. ¿Es necesario volver a autorizar al operador de « NamespaceScope »?
La instancia incluye watsonx Assistant o watsonx Orchestrate
  1. Actualización completa del operador de eventos « IBM » para watsonx Assistant o watsonx Orchestrate (actualización de la versión 5.3.x a una versión posterior 5.3 ).
  2. Ve a d. ¿Es necesario volver a autorizar al operador de « NamespaceScope »?
d. ¿Es necesario volver a autorizar al NamespaceScope operador?

Si al instalar el sistema le asignó al NamespaceScope operador el nivel mínimo IBM Software Hub de control de acceso basado en roles (RBAC), debe actualizar el rol asignado al operador para que este disponga de los privilegios suficientes que le permitan ayudar a los operadores a transferir los roles del proyecto de operador al proyecto de instancia.


Comprobación de los permisos del operador « NamespaceScope »

Para comprobar si el NamespaceScope operador está utilizando el RBAC mínimo, ejecute el siguiente comando:

oc get role nss-managed-role-from-${PROJECT_CPD_INST_OPERATORS} \
-n ${PROJECT_CPD_INST_OPERATORS} \
-o json | jq 'any(.rules[].apiGroups[]; . == "*")'
  • Si el comando devuelve true, no es necesario volver a autorizar al operador.
  • Si el comando devuelve un error false, el operador está utilizando el nivel mínimo de RBAC y debe volver a autorizarse.

Opciones Qué hay que hacer
El NamespaceScope operador tiene todos los permisos
  1. Ve a e. ¿Es necesario volver a autorizar al administrador de la instancia?
El NamespaceScope operador tiene el nivel mínimo de RBAC
  1. Realice la reautorización completa del operador « NamespaceScope » con el RBAC mínimo (actualización de la versión « 5.3.x » a una versión posterior « 5.3 »).
  2. Ve a e. ¿Es necesario volver a autorizar al administrador de la instancia?
decir, ¿Es necesario volver a autorizar al administrador de la instancia?

Si ha concedido a un administrador de la instancia el control de acceso basado en roles (RBAC) mínimo para instalar IBM Software Hub software, debe actualizar los roles asignados al usuario para que este disponga de los privilegios suficientes para actualizar la instancia.

Opciones Qué hay que hacer
El administrador del clúster actualizará la instancia
  1. Ve a la f. ¿Necesitas actualizar tus derechos?
Un administrador de la instancia actualizará la instancia, pero el usuario tiene el admin rol en los proyectos
  1. Ve a la f. ¿Necesitas actualizar tus derechos?
Un administrador de la instancia actualizará la instancia, y el usuario dispone de los permisos mínimos necesarios para instalar el software
  1. Siga los pasos para volver a autorizar a un administrador de instancia con los permisos RBAC mínimos necesarios para actualizar los componentes (actualización de la versión 5.3.x a una versión posterior 5.3 ).
  2. Ve a la f. ¿Necesitas actualizar tus derechos?
f. ¿Necesitas actualizar tus derechos?

Es necesario que mantenga un registro del tamaño de los despliegues para informar a IBM, según se le solicite. La License Service compara tu uso con las condiciones de la licencia.

Opciones Qué hay que hacer
No estás modificando las soluciones ni los servicios asociados a la instancia
  1. Ve al punto 7. Actualización de una instancia de IBM Software Hub.
Estás modificando una o varias soluciones o servicios asociados a la instancia
  1. Realice la tarea correspondiente a su entorno en la sección «Aplicación de sus derechos para supervisar y notificar el uso de acuerdo con los términos de la licencia» (Actualización de la versión 5.3.x a una versión posterior: actualización de 5.3 ).
  2. Ve al punto 7. Actualización de una instancia de IBM Software Hub.

7. Actualización de una instancia de IBM Software Hub

Para actualizar una instancia de IBM Software Hub, debes actualizar los operadores y los operandos (recursos personalizados) asociados a dicha instancia.

Icono Usuario Administrador de la instancia Cuando el icono Repetir tantas veces como sea necesario

a. Actualización de IBM Software Hub

Para actualizar una instancia de IBM Software Hub, debes actualizar los operadores y los recursos personalizados necesarios para dicha instancia.

Qué hay que hacer
  1. Actualización completa IBM Software Hub (Actualización de la versión 5.3.x a una versión posterior 5.3 refresh).
  2. Ve a b. Actualización del servicio cpdbr.
b. Actualización del cpdbr servicio

Debes actualizar el cpdbr servicio después de realizar la actualización IBM Software Hub.

Opciones Qué hay que hacer
No utilices el cpdbr servicio para realizar copias de seguridad y restaurar tu IBM Software Hub implementación
  1. Ve al punto 8. Actualización del webhook del controlador de admisión.
Utiliza el cpdbr servicio para realizar copias de seguridad y restaurar su IBM Software Hub implementación
  1. Finalizar la actualización del servicio cpdbr (actualización de la versión 5.3.x a una versión posterior 5.3 refresh).
  2. Ve al punto 8. Actualización del webhook del controlador de admisión.

8. Actualización del webhook del controlador de admisión

El webhook del controlador de admisión de configuraciones permite a los servicios utilizar un conjunto compartido de certificados personalizados. Si ha instalado el webhook del IBM Software Hub controlador de admisión de configuraciones, un administrador del clúster deberá actualizarlo una vez que haya realizado la actualización IBM Software Hub.

Icono Usuario Administrador del Cuando el icono clúster Repetir tantas veces como sea necesario


Servicios compatibles con certificados personalizados compartidos
  • AI Factsheets
  • Analytics Engine powered by Apache Spark
  • Cognos Analytics
  • Data Privacy
  • DataStage
  • Data Virtualization
  • Db2 Big SQL
  • IBM Master Data Management
  • OpenPages
  • RStudio®
  • Watson Studio
  • Watson Studio Runtimes
  • watsonx Assistant
  • watsonx.data
  • watsonx Orchestrate

Opciones Qué hay que hacer
No has instalado el webhook del controlador de admisión
  1. Ve al punto 9. Actualización del servicio de supervisión con privilegios.
Has instalado el webhook del controlador de admisión
  1. Actualización completa del webhook del controlador de admisión de la configuración de IBM Software Hub (actualización de la versión 5.3.x a una versión posterior 5.3 ).
  2. Ve al punto 9. Actualización del servicio de supervisión con privilegios.

9. Actualización del servicio de supervisión con privilegios

Los monitores privilegiados proporcionan información adicional sobre el estado del clúster y los recursos que no suele incluirse en los monitores de la plataforma. Si ha instalado los monitores con privilegios, un administrador del clúster deberá actualizar los monitores cuando realice la actualización IBM Software Hub.

Icono Usuario Administrador del Cuando el icono clúster Repetir tantas veces como sea necesario


Monitores proporcionados por el servicio de supervisión privilegiada
Comprobación del estado del operador del clúster (check-cluster-operator-status)
Comprueba el estado de los operadores del clúster que conforman la Red Hat OpenShift Container Platform infraestructura para determinar si:
  • Todos los operadores son AVAILABLE
  • Cualquiera de los operadores es DEGRADED
Comprobación del estado de la red (check-network-status)
Comprueba el estado de los PodNetworkConnectivityCheck objetos de los recursos del clúster para determinar si dichos objetos están Reachable.
Comprobación del estado de desequilibrio de los nodos (check-node-imbalance-status)
Comprueba si las solicitudes de vCPU se distribuyen de manera equilibrada entre los nodos o si un nodo está soportando una carga desproporcionadamente elevada.
Comprobación del estado del nodo (check-node-status)
Comprueba si los nodos del clúster están listos y si están consumiendo demasiados recursos.
Comprobación del estado de uso del volumen (check-volume-status)
Comprueba si las reclamaciones de volumen persistente asociadas a la implementación se están quedando sin espacio.
Restricción: Solo se supervisan las reclamaciones de volumen persistente que estén montadas por un pod en ejecución.
Comprobación del estado del espacio de nombres del operador (check-operator-namespace-status)
Comprueba si los recursos del proyecto de Operators para la implementación funcionan correctamente.
Importante: Si también quieres comprobar el estado de los operadores del proyecto en el que scheduling service está instalado, debes ejecutar el apply-privileged-monitoring-service comando con la --cluster_components_ns=${PROJECT_SCHEDULING_SERVICE} opción.
Comprobación del estado del clúster EDB (check-edb-cluster-status)
Comprueba si alguna de EDB Postgres las instancias asociadas a la implementación se encuentra en buen estado. Por ejemplo, si la base de datos que IBM Software Hub se utiliza para almacenar los metadatos de la implementación funciona correctamente.

Opciones Qué hay que hacer
No has instalado el servicio de supervisión con privilegios
  1. Ve al punto 10. Completar tareas posteriores a la actualización
Ha instalado el servicio de supervisión con privilegios
  1. Actualización completa de monitores con privilegios (actualización de la versión 5.3.x a una versión posterior 5.3 ).
  2. Ve al punto 10. Completar tareas posteriores a la actualización

10. Realización de tareas posteriores a la actualización

Una vez realizada la actualización IBM Software Hub, comprueba si hay alguna tarea adicional que debas realizar para configurar tu IBM Software Hub clúster.

Icono Usuario Administrador de la instancia Cuando el icono Repetir tantas veces como sea necesario

Opciones Qué hay que hacer
Al actualizar la plataforma, también actualizaste los servicios
  1. Realice las tareas correspondientes a su entorno en la sección «Configuración de servicios tras la instalación y la actualización ».
No actualizaste los servicios cuando actualizaste la plataforma
  1. Actualiza los servicios de la instancia. Para obtener más información, consulte la sección «Servicios ».
  2. Realice las tareas correspondientes a su entorno en la sección «Configuración de servicios tras la instalación y la actualización ».