Mise à niveau de IBM Software Hub la version 5.2 vers la version 5.3
Un Red Hat® OpenShift® Container Platform administrateur de cluster et un administrateur d'instance peuvent collaborer pour effectuer la mise à niveau IBM Software Hub de la version 5.2 vers la version 5.3.
- Si vous souhaitez mettre à niveau une instance de IBM Software Hub vers la version 5.3.1, vous devez mettre à niveau tous les services installés sur cette instance vers la version 5.3.1.
- Si vous souhaitez mettre à niveau un service vers la version 5.3.1, vous devez mettre à niveau l'instance sur IBM Software Hub laquelle le service est installé et mettre à niveau tous les services installés sur cette instance vers la version 5.3.1.
Avant de commencer
- Consultez les informations de la section « Planification ».
Veillez tout particulièrement à consulter la configuration système requise. Votre cluster doit disposer de ressources suffisantes.
- Consultez les informations fournies dans la section « Planification d'une mise à niveau ».
- Assurez-vous de disposer d'une copie du script qui définit les variables d'environnement d'installation pour votre déploiement.
Ce script vous permet d'exécuter la plupart des commandes d'installation et de mise à jour sans avoir à les modifier.
- Si vous utilisez actuellement le IBM Certificate manager, passez au Red Hat OpenShiftCertificate manager (cert-manager Operator). Pour plus de détails, consultez la section « Migration du IBM Certificate manager vers le Red Hat OpenShift Certificate manager ».
- Recommandation : sauvegardez votre IBM Software
Hub installation avant de procéder à la mise à jour.
En cas de panne irrémédiable, vous pouvez utiliser la sauvegarde pour restaurer votre installation actuelle. Pour plus d'informations, consultez la section « Sauvegarde et restauration IBM Software Hub».
présentation de la mise à niveau
La mise à niveau se déroule selon les étapes suivantes :
- 1. Mise à jour des postes de travail des clients
- 2. Collecte des informations requises
- 3. Préparation à la mise à jour dans un réseau restreint
- 4. Préparation à la mise à jour à partir d'un registre de conteneurs privé
- 5. Préparation de votre cluster
- 6. Préparation de la mise à niveau d'une instance d' IBM Software Hub
- 7. Mise à niveau d'une instance d' IBM Software Hub
- 8. Mise à niveau du webhook du contrôleur d'admission
- 9. Mise à niveau du service de surveillance privilégié
- 10. Effectuer les tâches post-mise à niveau
1. Mise à jour des postes de travail des clients
Avant de pouvoir effectuer la mise à niveau IBM Software Hub, vous devez vous assurer que le poste de travail dispose d'une version prise en charge de l'interface IBM Software Hub de ligne de commande, de l'interface OpenShift de ligne de commande et de l'interface Helm de ligne de commande.
Tous les administrateurs
À répéter si nécessaire
| Procédure à suivre |
|---|
|
2. Collecte des informations requises
Pour réussir la mise à niveau de votre IBM Software Hub installation, vous devez disposer d'informations spécifiques concernant votre environnement.
Équipe des opérations
À répéter si nécessaire
| Procédure à suivre |
|---|
|
3. Préparation à la mise à jour dans un réseau restreint
Si vous exécutez les commandes IBM Software Hub de mise à niveau dans un réseau restreint, vous devez préparer les postes de travail clients avant de les placer derrière votre pare-feu.
Tous les administrateurs
À répéter si nécessaire
| Procédure à suivre |
|---|
|
4. Préparation à la mise à jour à partir d'un registre de conteneurs privé
Chaque utilisateur doit effectuer les tâches qui lui incombent.
Certaines de ces tâches peuvent être effectuées une seule fois, mais d'autres doivent être répétées pour chaque utilisateur concerné par l'installation.
Si vous utilisez un registre de conteneurs privé pour héberger les images IBM Software Hub logicielles, vous devez synchroniser les images mises à jour depuis le registre IBM Entitled Registry vers le registre de conteneurs privé.
- a. Mise en miroir des images dans le registre de conteneur privé
Si vous avez synchronisé les images de IBM Software Hub la version 5.2 vers un registre de conteneurs privé, vous devez synchroniser les images de la version 5.3 vers ce registre avant de mettre à niveau votre installation.
Administrateur du registre
Répéter si nécessaire
Procédure à suivre - Effectuez la tâche correspondant à votre environnement dans la section « Mise en miroir d'images vers un registre de conteneurs privé » (Mise à niveau de la version 5.2 vers la version 5.3 ).
- Aller au point b. Les utilisateurs doivent-ils récupérer l'image « olm-utils-v4 » depuis le registre de conteneurs privé?
- b. Les utilisateurs doivent-ils récupérer
olm-utils-v4l'image depuis le registre de conteneurs privé? Si
olm-utils-v4l'image ouolm-utils-premium-v4l'image est disponible dans le registre de conteneurs privé, vous devez mettre à jour lecpd-clipour récupérer l'image depuis le registre de conteneurs privé.Tous les administrateurs
À répéter si nécessaire
Options Procédure à suivre Votre cluster ne se trouve pas sur un réseau restreint et les utilisateurs peuvent récupérer l'image depuis le IBM Entitled Registry - Passez au point 5. Préparation de votre cluster.
Votre cluster ne se trouve pas sur un réseau restreint, mais vous souhaitez que les utilisateurs récupèrent l'image depuis le registre de conteneurs privé - Téléchargement de l'image « olm-utils-v4 » à partir du registre de conteneurs privé (mise à niveau de la version 5.2 vers la version 5.3 ).
- Passez au point 5. Préparation de votre cluster.
Votre cluster se trouve sur un réseau à accès restreint - Téléchargement de l'image « olm-utils-v4 » à partir du registre de conteneurs privé (mise à niveau de la version 5.2 vers la version 5.3 ).
- Passez au point 5. Préparation de votre cluster.
5. Préparation de votre cluster
Avant de procéder à la mise à niveau IBM Software Hub, vous devez mettre à jour les logiciels requis et les composants partagés du cluster. Administrateur de cluster
Configuration initiale
- a. Mise à jour des logiciels requis
Plusieurs services nécessitent des logiciels préalables qui doivent être mis à jour par un administrateur de cluster.
Services nécessitant des logiciels préalables
Logiciels prérequis Services nécessitant ce prérequis Mettez ce logiciel à jour si... Node Feature Discovery Operator Un astérisque (*) indique que le service nécessite un GPU dans certaines situations.
- 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 *
Vous avez effectué une mise à jour Red Hat OpenShift Container Platform et l'opérateur est installé avec
installPlanApproval: Manual.NVIDIA GPU Operator Un astérisque (*) indique que le service nécessite un GPU dans certaines situations.
- 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 version de l'opérateur installée sur votre cluster n'est plus prise en charge. Pour plus de détails, consultez la NVIDIA GPU Operator section « Cycle de vie » dans le
Red Hat OpenShift AI Un astérisque (*) indique que le service est obligatoire Red Hat OpenShift AI dans certaines situations.
- 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 version requise de Red Hat OpenShift AI dépend de la version de IBM Software Hub que vous comptez installer.
Vous devez mettre à jour ce logiciel si les deux affirmations suivantes sont vraies :- Vous prévoyez de mettre à niveau une instance de IBM Software Hub avec des services qui dépendent de Red Hat OpenShift AI.
- Vous prévoyez de passer à une version de IBM Software Hub qui nécessite une version plus récente de Red Hat OpenShift AI.
Multicloud Object Gateway - Watson Discovery
- Watson Speech services
- watsonx Assistant
- watsonx Orchestrate
Vous devez effectuer la mise à jour Multicloud Object Gateway si vous effectuez la mise à jour Red Hat OpenShift Container Platform.
Red Hat OpenShift Serverless Knative Eventing - watsonx Assistant
- watsonx Orchestrate
Vous devez effectuer la mise à niveau Red Hat OpenShift Serverless Knative Eventing si l'une des affirmations suivantes est vraie :- Une nouvelle version de est IBM Events Operator fournie avec IBM Software Hub.
- Vous effectuez une mise à niveau Red Hat OpenShift Container Platform et la version de Red Hat OpenShift Serverless Operator sur votre cluster n'est pas prise en charge par la version de OpenShift Container Platform que vous utilisez.
- La version de installée Red Hat OpenShift Serverless Operator sur votre cluster n'est plus prise en charge.
Options Procédure à suivre L'instance que vous mettez à niveau ne comprend aucun service dépendant d'un logiciel préalable - Aller au point b. Mise à jour des ressources au niveau du cluster pour les composants partagés du cluster.
Vous mettez à niveau des services qui dépendent d'un logiciel préalable Si le scheduling service est installé sur le cluster, vous devez mettre à jour les ressources au niveau du cluster, telles que les rôles de cluster et les liaisons de rôles de cluster, pour le scheduling service.
Options Procédure à suivre Le scheduling service n'est pas installé - Aller à d. Mise à niveau des composants partagés du cluster.
Le scheduling service est installé - Mise à jour complète des ressources au niveau du cluster pour les composants partagés du cluster (mise à niveau de la version 5.2 vers la version 5.3 ).
- Aller au point c. Création de secrets de récupération pour les composants partagés du cluster.
Si le scheduling service est installé sur le cluster, vous devez créer un secret de récupération d'image dans le projet où vous prévoyez d'installer le service de planification. Le secret de récupération d'images garantit que le scheduling service dispose des informations d'identification nécessaires pour récupérer des images.
Options Procédure à suivre Le scheduling service n'est pas installé - Aller à d. Mise à niveau des composants partagés du cluster.
Le scheduling service est installé Avant de procéder à la mise à niveau IBM Software Hub, vous devez mettre à niveau License Service et scheduling service.
Procédure à suivre
6. Préparation de la mise à niveau d'une instance de IBM Software Hub
Avant de mettre à niveau une instance de IBM Software Hub, un administrateur de cluster doit préparer l'instance en vue de la mise à niveau.
Administrateur de cluster
Répéter si nécessaire
- a. Vérification de l'état de santé de votre cluster
L'interface IBM Software Hub de ligne de commande comprend des commandes qui vous permettent de vérifier l'état de votre cluster avant de procéder à la mise à niveau IBM Software Hub. Si vous ne vérifiez pas l'état de votre cluster avant la mise à niveau IBM Software Hub, vous risquez de rencontrer des problèmes pendant celle-ci.
Procédure à suivre - b. Mise à jour des ressources au niveau du cluster pour l'instance
Avant de mettre à niveau la IBM Software Hub plateforme ou les services, vous devez créer les ressources au niveau du cluster, telles que les rôles de cluster et les liaisons de rôles de cluster, pour les composants de l'instance que vous prévoyez de mettre à niveau.
Procédure à suivre - c. Avez-vous besoin de mettre à niveau le IBM Events Operator pour watsonx Assistant ou watsonx Orchestrate?
Si l'instance de IBM Software Hub que vous souhaitez mettre à niveau comprend watsonx Assistant ou, watsonx Orchestrate vous devez mettre à niveau l'instance de qui IBM Events Operator lui est associée.
Options Procédure à suivre L'instance ne comprend watsonx Assistant pas ou watsonx Orchestrate L'instance comprend watsonx Assistant ou watsonx Orchestrate - d. Faut-il réautoriser l'opérateur
NamespaceScope? Si vous avez attribué à
NamespaceScopel'opérateur le niveau d'accès minimal dans le cadre du contrôle d'accès basé sur les rôles (RBAC) lors de l'installation IBM Software Hub, vous devez mettre à jour le rôle qui lui est attribué afin qu'il dispose des privilèges nécessaires pour aider les opérateurs à transférer les rôles du projet opérateur vers le projet d'instance.
Vérification des autorisations de l'opérateur « NamespaceScope »
Pour vérifier si
NamespaceScopel'opérateur utilise le RBAC minimal, exécutez la commande suivante :oc get role nss-managed-role-from-${PROJECT_CPD_INST_OPERATORS} \ -n ${PROJECT_CPD_INST_OPERATORS} \ -o json | jq 'any(.rules[].apiGroups[]; . == "*")'- Si la commande renvoie un résultat
true, il n'est pas nécessaire de réautoriser l'opérateur. - Si la commande renvoie un résultat
false, cela signifie que l'opérateur utilise le niveau RBAC minimal et doit être réautorisé.
Options Procédure à suivre NamespaceScopeL'opérateur dispose de tous les droitsL'opérateur NamespaceScopedispose du niveau d'accès RBAC le plus bas- Si la commande renvoie un résultat
- e. Faut-il réautoriser l'administrateur de l'instance?
Si vous avez attribué à un administrateur d'instance les autorisations minimales requises dans le cadre du contrôle d'accès basé sur les rôles (RBAC) pour installer IBM Software Hub des logiciels, vous devez mettre à jour les rôles attribués à cet utilisateur afin qu'il dispose des privilèges nécessaires pour mettre à niveau l'instance.
Options Procédure à suivre L'administrateur du cluster mettra à niveau l'instance Un administrateur d'instance procédera à la mise à niveau de l'instance, mais l'utilisateur dispose du adminrôle sur les projetsUn administrateur d'instance se chargera de la mise à niveau de l'instance, et l'utilisateur dispose des autorisations minimales nécessaires pour installer le logiciel - f. Avez-vous besoin de mettre à jour vos droits?
Vous êtes tenu de conserver un enregistrement de la taille des déploiements pour en rendre compte à IBM en cas de demande. Cette fonctionnalité License Service évalue votre utilisation au regard des conditions de votre licence.
Options Procédure à suivre Vous ne modifiez pas les solutions ou les services associés à l'instance - Aller au point 7. Mise à niveau d'une instance d' IBM Software Hub.
Vous modifiez une ou plusieurs solutions ou services associés à l'instance - Effectuez la tâche correspondant à votre environnement dans la section « Application de vos droits pour surveiller et rendre compte de l'utilisation conformément aux conditions de licence » (Mise à niveau de la version 5.2 vers la version 5.3 ).
- Aller au point 7. Mise à niveau d'une instance d' IBM Software Hub.
7. Mise à niveau d'une instance de IBM Software Hub
Pour mettre à niveau une instance de IBM Software Hub, vous devez mettre à jour les opérateurs et les opérandes (ressources personnalisées) associés à cette instance.
Administrateur de
l'instance Répéter si nécessaire
- a. Création de secrets de téléchargement d'images pour l'instance
- Vous devez créer un secret de récupération d'image dans les projets associés à une instance de IBM Software
Hub. Les secrets de récupération d'images garantissent que tous les composants qui utilisent [cet outil Helm ] ont accès aux identifiants nécessaires pour récupérer des images.
Procédure à suivre - Suivez la procédure de création de secrets de téléchargement d'images pour une instance d' IBM Software Hub (Mise à niveau de la version 5.2 vers la version 5.3 ).
- Aller au point b. Mise à jour de IBM Software Hub.
- b. Mise à niveauIBM Software Hub
Pour mettre à niveau une instance de IBM Software Hub, vous devez mettre à niveau les opérateurs et les ressources personnalisées requis pour cette instance.
Procédure à suivre - Mise à niveau complète IBM Software Hub (Mise à niveau de la version 5.2 vers la version 5.3 ).
- Aller au point c. Mise à niveau du service cpdbr.
- c. Mise à niveau du
cpdbrservice Vous devez mettre à niveau le
cpdbrservice après la mise à niveau IBM Software Hub.Options Procédure à suivre Vous n'utilisez pas ce cpdbrservice pour sauvegarder et restaurer votre IBM Software Hub déploiement- Aller au point 8. Mise à jour du webhook du contrôleur d'admission.
Vous utilisez ce cpdbrservice pour sauvegarder et restaurer votre IBM Software Hub déploiement- Terminer la mise à jour du service cpdbr (mise à niveau de la version 5.2 vers la version 5.3 ).
- Aller au point 8. Mise à jour du webhook du contrôleur d'admission.
8. Mise à niveau du webhook du contrôleur d'admission
Le webhook du contrôleur d'admission de configuration permet aux services d'utiliser un ensemble partagé de certificats personnalisés. Si vous avez installé le webhook du IBM Software Hub contrôleur d'admission de configuration, un administrateur de cluster doit mettre à jour ce webhook après la mise à niveau IBM Software Hub.
Administrateur de cluster
Répéter si nécessaire
Services prenant en charge les certificats personnalisés partagés
- 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
| Options | Procédure à suivre |
|---|---|
| Vous n'avez pas installé le webhook du contrôleur d'admission |
|
| Vous avez installé le webhook du contrôleur d'admission |
|
9. Mise à niveau du service de surveillance privilégié
Les moniteurs privilégiés fournissent des informations supplémentaires sur l'état du cluster et des ressources qui ne sont généralement pas incluses dans les moniteurs de la plateforme. Si vous avez installé les moniteurs privilégiés, un administrateur de cluster doit mettre à niveau ces moniteurs lorsque vous effectuez la mise à niveau IBM Software Hub.
Administrateur de cluster
Répéter si nécessaire
Moniteurs fournis par le service de surveillance privilégié
- Vérification de l'état de l'opérateur de cluster (
check-cluster-operator-status) - Vérifie l'état des opérateurs de cluster qui composent Red Hat
OpenShift Container Platform l'infrastructure afin de déterminer si :
- Tous les opérateurs sont
AVAILABLE - N'importe lequel de ces opérateurs est
DEGRADED
- Tous les opérateurs sont
- Vérification de l'état du réseau (
check-network-status) - Vérifie l'état des
PodNetworkConnectivityCheckobjets correspondant aux ressources du cluster afin de déterminer si ces objets sontReachable. - Vérification de l'état de déséquilibre des nœuds (
check-node-imbalance-status) - Vérifie si les requêtes vCPU sont réparties de manière équilibrée entre les nœuds ou si un nœud supporte une charge disproportionnée.
- Vérification de l'état du nœud (
check-node-status) - Vérifie si les nœuds du cluster sont opérationnels et s'ils consomment trop de ressources.
- Vérification de l'état d'utilisation du volume (
check-volume-status) - Vérifie si les revendications de volume persistant associées au déploiement sont sur le point d'être saturées.Restriction : seules les revendications de volume persistant montées par un pod en cours d'exécution sont surveillées.
- Vérification de l'état de l'espace de noms de l'opérateur (
check-operator-namespace-status) - Vérifie si les ressources du projet « operators » destinées au déploiement fonctionnent correctement.Important : si vous souhaitez également vérifier l'état des opérateurs dans le projet où est scheduling service installé, vous devez exécuter la
apply-privileged-monitoring-servicecommande avec--cluster_components_ns=${PROJECT_SCHEDULING_SERVICE}l'option. - Vérification de l'état du cluster EDB (
check-edb-cluster-status) - Vérifie si les instances de EDB Postgres associées au déploiement sont opérationnelles. Par exemple, si la base de données IBM Software Hub utilisée pour stocker les métadonnées du déploiement fonctionne correctement.
| Options | Procédure à suivre |
|---|---|
| Vous n'avez pas installé le service de surveillance privilégié |
|
| Vous avez installé le service de surveillance privilégié |
|
10. Effectuer les tâches post-mise à niveau
Une fois la mise à niveau effectuée IBM Software Hub, vérifiez s'il reste des tâches supplémentaires à effectuer pour configurer votre IBM Software Hub cluster.
Administrateur de
l'instance Répéter si nécessaire
| Options | Procédure à suivre |
|---|---|
| Vous avez mis à niveau les services lors de la mise à niveau de la plateforme |
|
| Vous n'avez pas mis à niveau les services lorsque vous avez mis à niveau la plateforme |
|