Mise à niveau d' IBM watsonx.ai de la version 5.1 à la version 5.3

Un administrateur d'instance peut mettre à niveau IBM watsonx.ai de la version 5.1 à la version 5.3.

Qui doit accomplir cette tâche?

Administrateur d'instance Pour mettre à niveau IBM watsonx.ai, vous devez être administrateur d'instance. Un administrateur d'instance est autorisé à gérer les logiciels dans les projets suivants :

Le projet des opérateurs pour l'instance

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

Le projet d'opérandes pour l'instance

Les ressources personnalisées pour control plane et IBM watsonx.ai sont installées dans le projet operands. Dans les commandes de mise à niveau, la variable ${PROJECT_CPD_INST_OPERANDS} d'environnement fait référence au projet des opérandes.

Quand devez-vous terminer cette tâche?

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

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

    Répétez l'opération autant de fois que 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 IBM watsonx.ai sur le cluster.

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

Veuillez consulter les informations suivantes avant de mettre à niveau IBM watsonx.ai :

Version requise

Tous les composants associés à une instance de IBM Software Hub doivent être installés dans la même version. Par exemple, si la IBM Software Hubcontrol plane est à la version 5.3.1, vous devez mettre à niveau IBM watsonx.ai vers la version 5.3.1.

Variables d'environnement
Les commandes de cette tâche utilisent des variables d'environnement afin que vous puissiez les exécuter exactement telles qu'elles sont écrites.
Common core services
IBM watsonx.ai nécessite le IBM Software Hub common core services.

Si les ne common core services sont pas à la bonne version dans le projet operands pour l'instance, les common core services sont automatiquement mis à niveau lorsque vous mettez à niveau IBM watsonx.ai. La common core services mise à niveau augmente le temps nécessaire à son achèvement.

Avant de commencer

Cette tâche suppose que les conditions préalables suivantes sont remplies :

Configuration système requise
Cette tâche suppose que le cluster répond aux exigences minimales pour IBM watsonx.ai.
Où trouver des informations supplémentaires
Si cette tâche n'est pas terminée, consultez la section Configuration système requise.
De plus, assurez-vous que vous disposez du type et du nombre de GPU appropriés pour IBM watsonx.ai.
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 allez exécuter la mise à niveau est configuré comme un 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, consultez la section Mise à jour des postes de travail clients.
Plan de contrôle
Cette tâche suppose que le IBM Software Hubcontrol plane est mis à niveau.
Où trouver des informations supplémentaires
Si cette tâche n'est pas terminée, consultez la section Mise à niveau d'une instance d' IBM r Software Hub.
Registre de conteneurs privé
Si votre environnement utilise un registre de conteneurs privé (par exemple, votre cluster est isolé), cette tâche suppose que les tâches suivantes sont terminées :
  1. Les images logicielles IBM watsonx.ai sont répliquées dans le registre de conteneurs privé.
    Où trouver des informations supplémentaires
    Si cette tâche n'est pas terminée, consultez la section Mise en miroir d'images vers un registre de conteneurs privé.
  2. Le cpd-cli est configuré pour extraire olm-utils-v4 l'image du registre de conteneurs privé.
    Où trouver des informations supplémentaires
    Si cette tâche n'est pas terminée, consultez la section Récupération de l'image olm-utils-v4 à partir 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, consultez la section Installation d'opérateurs pour les services qui nécessitent 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, consultez la section Installation d' 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 d' IBM ez Software Hub.

Procédure

Effectuez les tâches suivantes pour mettre à niveau IBM watsonx.ai :

  1. Suppression des modèles de déploiement avant la mise à niveau vers la version 5.3
  2. Spécification des composants à mettre à niveau
  3. Amélioration du service
  4. Validation de la mise à niveau
  5. Que faire ensuite?

Suppression des modèles de déploiement avant la mise à niveau vers la version 5.3

Si vous utilisez des modèles avec caikit-1.0 (watsonx-cfm-caikit-1.0), ces modèles ne fonctionneront plus après la mise à niveau vers la version 5.3.

Vous devez supprimer tous les déploiements à l'aide de caikit1.0, et créer de nouveaux déploiements à l'aide de caikit1.1 (watsonx-cfm-caikit-1.1) avant de procéder à la mise à niveau. Cela garantit que vos modèles fonctionneront lorsque vous passerez à la version 5.3.

Spécification des composants à mettre à niveau

Définissez la variable d'environnement XAI_COMPONENT_TYPE sur le watsonx_ai composant à mettre à watsonx.ai™ niveau.

Le watsonx_ai composant installe les fonctionnalités de watsonx.ai base qui vous permettent de travailler avec les modèles de base installés dans votre cluster et d'utiliser des outils tels Prompt Lab que et Tuning Studio.

Définissez XAI_COMPONENT_TYPE comme suit pour mettre à niveau le watsonx.ai service :
export XAI_COMPONENT_TYPE=watsonx_ai

Mise à niveau du service

Pour mettre à jour IBM watsonx.ai :

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

Validation de la mise à niveau

IBM watsonx.ai est mis à niveau lorsque la install-components commande renvoie :
[SUCCESS]... The install-components command ran successfully

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

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

Etape suivante

  1. Mettez à niveau tous les services de cette instance vers IBM Software Hub la version 5.3.x.
  2. Terminez la migration catalog-api du service vers PostgreSQL.

Une fois les étapes précédentes terminées, IBM watsonx.ai est prêt à être utilisé.

Pour installer de nouveaux modèles, consultez la section Ajout de modèles de fondations à IBM watsonx.ai.