Mise à niveau watsonx Code Assistant for Z Explication du code de la version 5.2 à la version 5.3

Un administrateur d'instance peut mettre à niveau watsonx Code Assistant for Z Explication du code de la version 5.2 à la version 5.3.

Qui doit accomplir cette tâche?

Administrateur d'instance Pour mettre à niveau watsonx Code Assistant for Z Code Explanation, vous devez être administrateur d'instance. Un administrateur d'instance a le droit de gérer les logiciels dans les projets suivants :

Le projet des opérateurs pour l'instance

Les opérateurs de cette instance de watsonx Code Assistant for Z Code Explanation sont installés dans le projet des opérateurs. Dans les commandes de mise à niveau, la variable d'environnement ${PROJECT_CPD_INST_OPERATORS} fait référence au projet des opérateurs.

Le projet d'opérandes pour l'instance

Les ressources personnalisées pour le control plane et watsonx Code Assistant for Z Code Explanation sont installés dans le projet d'opérandes. Dans les commandes de mise à niveau, la variable d'environnement ${PROJECT_CPD_INST_OPERANDS} fait référence au projet d'exploitation.

Quand devez-vous accomplir cette tâche?

Examinez les options suivantes pour déterminer si vous devez effectuer cette tâche :

  • Si vous souhaitez mettre à niveau IBM Software Hub control plane et un ou plusieurs services en même temps, suivez plutôt la procédure décrite dans Mise à niveau d'une instance de IBM Software Hub.
  • Si vous n'avez pas mis à niveau watsonx Code Assistant for Z Code Explanation lorsque vous avez mis à niveau IBM Software Hub control plane, effectuez cette tâche pour mettre à niveau watsonx Code Assistant for Z Code Explanation.

    Répétez l'opération si nécessaire Si vous êtes responsable de plusieurs instances de IBM Software Hub, vous pouvez répéter cette tâche pour mettre à niveau d'autres instances de watsonx Code Assistant for Z Code Explication sur le cluster.

Informations nécessaires à l'exécution de cette tâche

Examinez les informations suivantes avant de procéder à la mise à niveau : watsonx Code Assistant for Z Code Explanation :

Version requise

Tous les composants associés à une instance de IBM Software Hub doivent être installés à la même version. Par exemple, si la IBM Software Hubcontrol plane est à la version 5.3.1, vous devez mettre à niveau watsonx Code Assistant for Z Explication du code à la version 5.3.1.

Variables d'environnement
Les commandes de cette tâche utilisent des variables d'environnement afin que vous puissiez exécuter les commandes exactement comme elles sont écrites.
  • Si vous ne disposez pas du script qui définit les variables d'environnement, consultez la section Configuration des variables d'environnement d'installation.
  • Pour utiliser les variables d'environnement du script, vous devez créer les variables d'environnement avant d'exécuter les commandes de cette tâche. Par exemple, exécutez :
    source ./cpd_vars.sh
Common core services
watsonx Code Assistant for Z nécessite le IBM Software Hubcommon core services .

Si les common core services ne sont pas à la bonne version dans le projet d'opérandes pour l'instance, les common core services sont automatiquement mis à niveau lorsque vous mettez à niveau watsonx Code Assistant for Z Explication du code. La mise à niveau common core services augmente la durée de la mise à niveau.

Avant de commencer

Cette tâche suppose que les conditions suivantes soient remplies :

Configuration système requise
Cette tâche suppose que le cluster répond aux exigences minimales pour watsonx Code Assistant for Z Code Explanation.
Où trouver des informations supplémentaires
Si cette tâche n'est pas terminée, voir Configuration requise.
De plus, assurez-vous que vous disposez du type et du nombre de GPU appropriés pour l'explication watsonx Code Assistant for Z du code.
Où trouver des informations supplémentaires
Si cette tâche n'est pas terminée, consultez la section Configuration requise pour le GPU.
Poste de travail
Cette tâche suppose que le poste de travail à partir duquel vous exécuterez la mise à niveau est configuré en tant que poste de travail client et dispose des interfaces de ligne de commande suivantes :
  • IBM Software Hub CLI : cpd-cli
  • OpenShift® CLI : oc
  • Helm CLI : oc
Où trouver des informations supplémentaires
Si cette tâche n'est pas terminée, voir Mise à jour des postes clients.
Plan de contrôle
Cette tâche suppose que le site IBM Software Hub control plane a été mis à jour.
Où trouver des informations supplémentaires
Si cette tâche n'est pas terminée, voir Mise à niveau d'une instance de IBM Software Hub.
Registre de conteneurs privé
Si votre environnement utilise un registre de conteneurs privé (par exemple, si votre cluster est en mode air-gapped), cette tâche suppose que les tâches suivantes sont terminées :
  1. Les images du logiciel watsonx Code Assistant for Z Code Explanation sont mises en miroir dans le registre de conteneurs privé.
    Où trouver des informations supplémentaires
    Si cette tâche n'est pas terminée, reportez-vous à la section Mise en miroir d'images vers un registre de conteneurs privé.
  2. Le site cpd-cli est configuré pour extraire l'image olm-utils-v4 du registre de conteneurs privé.
    Où trouver des informations supplémentaires
    Si cette tâche n'est pas terminée, consultez la section Extraire olm-utils-v4 l'image du registre de conteneurs privé.
Opérateurs GPU
Cette tâche suppose que les opérateurs nécessaires à l'utilisation des GPU sont installés.
Où trouver des informations supplémentaires
Si cette tâche n'est pas terminée, voir Installation d'opérateurs pour les services nécessitant des GPU.
Red Hat® OpenShift AI
Cette tâche suppose que Red Hat OpenShift AI est installé.
Où trouver des informations supplémentaires
Si cette tâche n'est pas terminée, voir Installation de Red Hat OpenShift AI.
Ressources au niveau du cluster
Cette tâche suppose que les ressources au niveau du cluster, telles que les définitions de ressources personnalisées, les rôles de cluster et les liaisons de rôles de cluster, ont été mises à jour.
Où trouver des informations supplémentaires
Si cette tâche n'est pas terminée, consultez la section Mise à jour des ressources à l'échelle du cluster pour la plate-forme et les services.
Secrets d'extraction d'image
Cette tâche suppose que les secrets contenant les informations d'identification de récupération d'image pour l'instance existent.
Où trouver des informations supplémentaires
Si cette tâche n'est pas terminée, consultez Création de secrets d'extraction d'image pour une instance de IBM Software Hub.

Procédure

Effectuez les tâches suivantes pour mettre à niveau watsonx Code Assistant for Z Code Explication :

  1. Mise à niveau du service
  2. Valider la mise à niveau
  3. Que faire ensuite?

Mise à niveau du service

Pour mettre à niveau watsonx Code Assistant for Z Code Explication :

  1. Connectez le cpd-cli au cluster Red Hat OpenShift Container Platform :
    ${CPDM_OC_LOGIN}
    Rappel : CPDM_OC_LOGIN est un alias de la commande cpd-cli manage login-to-ocp .
  2. Mettez à jour l'opérateur et la ressource personnalisée pour l'explication watsonx Code Assistant for Z du code.
    cpd-cli manage install-components \
    --license_acceptance=true \
    --components=wca_z_ce \
    --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

Valider la mise à niveau

watsonx Code Assistant for Z est mis à niveau lorsque le install-components la commande renvoie :
[SUCCESS]... The install-components command ran successfully

Si vous souhaitez confirmer que le statut de la ressource personnalisée est Completed, vous pouvez exécuter la commande cpd-cli manage get-cr-status :

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

Etape suivante

watsonx Code Assistant for Z est prêt à l'emploi. Pour commencer à utiliser watsonx Code Assistant for Z Code Explanation, consultez la section Démarrer avec watsonx Code Assistant for Z Code Explanation.