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.
- 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
- 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.
- Consulte la información de la sección «Planificación de una actualización ».
- 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.
- 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
- 2. Recopilación de la información necesaria
- 3. Preparación para realizar actualizaciones en una red restringida
- 4. Preparación para ejecutar actualizaciones desde un registro de contenedores privado
- 5. Preparación del clúster
- 6. Preparación para actualizar una instancia de IBM Software Hub
- 7. Actualización de una instancia de IBM Software Hub
- 8. Actualización del webhook del controlador de admisión
- 9. Actualización del servicio de supervisión con privilegios
- 10. Realización de tareas posteriores a la actualización
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.
Todos los administradores
Repetir tantas veces como sea necesario
| Qué hay que hacer |
|---|
|
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.
Equipo de operaciones
Repetir tantas veces como sea necesario
| Qué hay que hacer |
|---|
|
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.
Todos los administradores
Repetir tantas veces como sea necesario
| Qué hay que hacer |
|---|
|
4. Preparación para ejecutar actualizaciones desde un registro de contenedores privado
Cada usuario debe realizar las tareas que le correspondan.
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.
Administrador del registro
Repetir tantas veces como sea necesario
Qué hay que hacer - 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 ).
- 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-v4imagen del registro de contenedores privado? Si la
olm-utils-v4imagen o laolm-utils-premium-v4imagen está disponible en el registro privado de contenedores, debes actualizar elcpd-clipara descargar la imagen desde el registro privado de contenedores.Todos los administradores
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 - 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 Tu clúster se encuentra en una red restringida
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. Administrador del clúster
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 Estás actualizando servicios que dependen de software previo 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 - Ve a la sección c. Actualización de los componentes compartidos del clúster.
El scheduling service está instalado - 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 ).
- Ve a la sección 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
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.
Administrador del
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 - 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).
- 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 - 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 La instancia incluye watsonx Assistant o watsonx Orchestrate - 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 ).
- Ve a d. ¿Es necesario volver a autorizar al operador de « NamespaceScope »?
- d. ¿Es necesario volver a autorizar al
NamespaceScopeoperador? Si al instalar el sistema le asignó al
NamespaceScopeoperador 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
NamespaceScopeoperador 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 NamespaceScopeoperador tiene todos los permisosEl NamespaceScopeoperador tiene el nivel mínimo de RBAC- 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 »).
- Ve a e. ¿Es necesario volver a autorizar al administrador de la instancia?
- Si el comando devuelve
- 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 Un administrador de la instancia actualizará la instancia, pero el usuario tiene el adminrol en los proyectosUn administrador de la instancia actualizará la instancia, y el usuario dispone de los permisos mínimos necesarios para instalar el software - 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 Estás modificando una o varias soluciones o servicios asociados a la instancia - 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 ).
- 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.
Administrador de la instancia
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 - Actualización completa IBM Software Hub (Actualización de la versión 5.3.x a una versión posterior 5.3 refresh).
- Ve a b. Actualización del servicio cpdbr.
- b. Actualización del
cpdbrservicio Debes actualizar el
cpdbrservicio después de realizar la actualización IBM Software Hub.Opciones Qué hay que hacer No utilices el cpdbrservicio para realizar copias de seguridad y restaurar tu IBM Software Hub implementación- Ve al punto 8. Actualización del webhook del controlador de admisión.
Utiliza el cpdbrservicio para realizar copias de seguridad y restaurar su IBM Software Hub implementació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.
Administrador del
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 |
|
| Has instalado el webhook del controlador de admisión |
|
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.
Administrador del
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
- Todos los operadores son
- Comprobación del estado de la red (
check-network-status) - Comprueba el estado de los
PodNetworkConnectivityCheckobjetos de los recursos del clúster para determinar si dichos objetos estánReachable. - 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-servicecomando 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 | |
| Ha instalado el servicio de supervisión con privilegios |
|
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.
Administrador de la instancia
Repetir tantas veces como sea necesario
| Opciones | Qué hay que hacer |
|---|---|
| Al actualizar la plataforma, también actualizaste los servicios |
|
| No actualizaste los servicios cuando actualizaste la plataforma |
|