Mise à niveau d' watsonx.governance de la version 5.2 à la version 5.3

Un administrateur d'instance peut mettre à niveau watsonx.governance de la version 5.2 à la version 5.3.

Qui doit accomplir cette tâche?

Administrateur d'instance Pour mettre à niveau watsonx.governance, 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 d' watsonx.governance 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 watsonx.governance 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 watsonx.governance lors de la mise à niveau de IBM Software Hub control plane, effectuez cette tâche pour mettre à niveau watsonx.governance.
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 davantage d'instances d' watsonx.governance sur le cluster.

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

Veuillez consulter les informations suivantes avant de mettre à niveau l' watsonx.governance :

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 watsonx.governance 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.

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 à partir du script, vous devez les charger avant d'exécuter les commandes de cette tâche. Par exemple, exécutez :
```
source ./cpd_vars.sh
```

Common core services: watsonx.governance 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 watsonx.governance. 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 watsonx.governance.

Où trouver des informations supplémentaires
Si cette tâche n'est pas terminée, consultez la section Configuration système requise.

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 :

Les images du logiciel watsonx.governance 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é.
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é.

Ressources au niveau du cluster

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é.

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é.

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 watsonx.governance :

Spécification des options d'installation
Amélioration du service
Validation de la mise à niveau
Mise à niveau de l'instance de service
Que faire ensuite?

Spécification des options d'installation

Lorsque vous mettez à niveau watsonx.governance, les options que vous avez spécifiées lors de l'installation de watsonx.governance sont utilisées.

Vous pouvez éventuellement spécifier les éléments suivants dans le install-options.yml fichier situé dans le work répertoire.

# ............................................................................
# watsonx.governance parameters
# ............................................................................
  watsonxGovernance:
    installType: <install-type>
    enableFactsheet: "true"
    enableOpenpages: "true"
    enableOpenscale: "true"
#   openpagesInstanceCR: "op-wxgov-instance"
#   openPages:
#     databaseType: internal
#     database: Db2
#     dbSecretName: <secret-name>

Propriété	Descriptif
`installType`	Précisez quel watsonx.governance™ droit vous avez acheté. Valeur par défaut `all` Si vous omettez cette option, la valeur par défaut est utilisée. Les valeur valides `all` Sélectionnez cette option si vous avez acheté à la fois Model Management et Risk and Compliance Foundation . `mm` Sélectionnez cette option si vous avez acheté Model Management un droit. `rcf` Sélectionnez cette option si vous avez acheté Risk and Compliance Foundation un droit.
`enableFactsheet`	Indiquez si vous souhaitez installer AI Factsheets. Ce service vous permet de suivre les actifs et d'enregistrer les faits dans les cas d'utilisation de l'IA. AI Factsheets est disponible avec le Model Management droit. Si vous avez acheté uniquement le Risk and Compliance Foundation droit d'utilisation, vous ne pouvez pas installer AI Factsheets. Valeur par défaut `true` Si vous omettez cette option, la valeur par défaut est utilisée. Les valeur valides `false` Ne pas installer AI Factsheets. `true` Installez AI Factsheets.
`enableOpenpages`	Indiquez si vous souhaitez installer OpenPages. Ce service vous permet de concevoir des flux de travail et de visualiser l'activité du cycle de vie de l'IA à partir d'un tableau de bord afin de vous aider à atteindre vos objectifs en matière de conformité et de réglementation. OpenPages est disponible avec le Risk and Compliance Foundation droit. Si vous avez acheté uniquement le Model Management droit d'utilisation, vous ne pouvez pas installer OpenPages. Valeur par défaut `true` Si vous omettez cette option, la valeur par défaut est utilisée. Les valeur valides `false` Ne pas installer OpenPages. `true` Installez OpenPages.
`enableOpenscale`	Indiquez si vous souhaitez installer Watson OpenScale. Ce service vous permet d'évaluer et de surveiller les invites d'IA générative ou les ressources d'apprentissage automatique en termes d'équité, de qualité et de dérive. Watson OpenScale est disponible avec le Model Management droit. uniquement Model Management et Risk and Compliance Foundation Si vous avez acheté uniquement Risk and Compliance Foundation le droit d'utilisation, vous ne pouvez pas installer Watson OpenScale. Valeur par défaut `true` Si vous omettez cette option, la valeur par défaut est utilisée. Les valeur valides `false` Ne pas installer Watson OpenScale. `true` Installez Watson OpenScale.
`openpagesInstanceCR`	Spécifiez le nom d'une instance de OpenPages service existante. Cette option s'applique uniquement si vous avez défini `enableOpenPages: true` et si vous disposez d'une instance de OpenPages service existante que vous souhaitez utiliser avec watsonx.governance. Valeur par défaut `"openpagesinstance-cr"` Si vous omettez cette option, la valeur par défaut est utilisée. Restriction : si vous ne souhaitez pas utiliser une instance de OpenPages service existante, ne remplacez pas la valeur par défaut. Les valeur valides Nom d'une instance de OpenPages service existante. Assurez-vous que la valeur respecte le format suivant : `"existing-cr-name"`
`databaseType`	Indiquez si vous souhaitez utiliser une base de données externe existante ou une base de données interne créée automatiquement. Cette option ne s'applique que si vous définissez `enableOpenPages: true`. Restriction : n'utilisez pas cette option si vous prévoyez d'utiliser une instance de OpenPages service existante avec watsonx.governance. Valeur par défaut `internal` Si vous omettez cette option, la valeur par défaut est utilisée. Les valeur valides `external` Utilisez une base de données externe existante. Si vous spécifiez cette option, vous devez également spécifier le `dbSecretName` paramètre. Important : si vous souhaitez utiliser une base de données externe, vous devez vous assurer qu'elle est correctement configurée avant de créer l'instance OpenPages de service. Pour plus d'informations, consultez la section Configuration d'une base de données Db2 externe pour OpenPages. `internal` Utilisez une base de données interne créée automatiquement. Y compris ce paramètre Assurez-vous de décommenter les lignes suivantes et de spécifier les valeurs appropriées pour le `databaseType` paramètre : `openPages: databaseType: <database-type>`
`database`	Indiquez si vous souhaitez utiliser Db2 ou Oracle comme base OpenPages de données. Si vous utilisez une base de données externe, indiquez le fournisseur. Valeur par défaut `Db2` Si vous omettez cette option, la valeur par défaut est utilisée. Les valeur valides `Db2` Utilisez Db2 comme base de données. `Oracle` Utilisez Oracle comme base de données. Y compris ce paramètre Assurez-vous de décommenter les lignes suivantes et de spécifier les valeurs appropriées pour le `database` paramètre : `openPages: database: <database>`
`dbSecretName`	Si vous souhaitez utiliser une base de données externe existante, vous devez spécifier le nom du OpenShift secret qui fait référence aux secrets d'identification de la base de données dans le coffre-fort. Cette option ne s'applique que si vous définissez `enableOpenPages: true`. Restriction : n'utilisez pas cette option si vous prévoyez d'utiliser une instance de OpenPages service existante avec watsonx.governance. Les valeur valides Le nom du OpenShift secret que vous avez créé lorsque vous avez terminé la configuration d'une base de données Db2 externe pour OpenPages. Y compris ce paramètre Assurez-vous de décommenter les lignes suivantes et de spécifier les valeurs appropriées pour le `dbSecretName` paramètre : `openPages: databaseType: external dbSecretName: <secret-name>`
`status_max_retries`	Indiquez si vous souhaitez remplacer la valeur de délai d'expiration par défaut lors de l'installation des composants de watsonx.governance. Valeur par défaut `150` (procès-verbal) Si vous omettez cette option, la valeur par défaut est utilisée. Les valeur valides Un nombre entier correspondant au nombre de minutes avant l'expiration du délai. Y compris ce paramètre 5.3.0 Les instructions suivantes s'appliquent uniquement si vous avez installé IBM Software Hub la version 5.3.0. Assurez-vous de décommenter les lignes suivantes et de spécifier les valeurs appropriées pour le `status_max_retries` paramètre : `override_components_meta: watsonx_governance: status_max_retries: <maximum minutes before timeout>`

Mise à niveau du service

Pour mettre à jour l' watsonx.governance :

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.

Mettez à jour l'opérateur et la ressource personnalisée pour watsonx.governance.

cpd-cli manage install-components \
--license_acceptance=true \
--components=watsonx_governance \
--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} \
--param-file=/tmp/work/install-options.yml \
--upgrade=true

Validation de la mise à niveau

watsonx.governance 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=watsonx_governance

Mise à niveau de l'instance de service

Après avoir mis à niveau watsonx.governance, vous devez mettre à niveau l'instance de service associée à watsonx.governance.

Pour AI Factsheets

Aucune instance de service à mettre à niveau.

Pour Watson OpenScale

Les instances de service sont automatiquement mises à niveau lorsque vous mettez à niveau watsonx.governance.

Pour OpenPages

Procédure

Pour mettre à niveau l'instance de service :

cpd-cli service-instance upgrade \
--service-type=openpages \
--profile=${CPD_PROFILE_NAME} \
--all

Etape suivante

watsonx.governance est prêt à l'emploi.

Pour administrer watsonx.governance, consultez la section Administration d' watsonx.governance.