Mise à niveau d' watsonx.governance, de la version 5.3.x vers une version ultérieure 5.3 refresh

Un administrateur d'instance peut mettre à niveau watsonx.governance de la version 5.3.x vers une mise à jour ultérieure de la version 5.3.

Qui doit s'acquitter de 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 des projets suivants :

Le projet des opérateurs, par exemple: Les opérateurs pour cette instance d' watsonx.governance s 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 « operands » pour l'instance: Les ressources personnalisées pour les fichiers 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 « operands ».

Quand devez-vous effectuer 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' IBM » à l'adresse Software 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 d'autres instances d' watsonx.governance. sur le cluster.

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

Veuillez prendre connaissance des 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 le IBM Software Hubcontrol plane est à la version 5.3.1, vous devez mettre à jour 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 depuis le 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 version appropriée dans le projet « operands » de l'instance, les common core services sont automatiquement mis à jour lorsque vous mettez à jour watsonx.governance. Cette common core services mise à jour allonge la durée 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 requises pour l' watsonx.governance.

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

Poste de travail

Cette tâche suppose que le poste de travail à partir duquel vous allez effectuer la mise à niveau est configuré en tant que poste client et dispose des interfaces de ligne de commande suivantes :

IBM Software Hub Interface en ligne de commande : cpd-cli
OpenShift® Interface en ligne de commande : oc
Helm Interface en ligne de commande : 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 a été mis à jour.

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 » à l'adresse Software Hub.

Registre de conteneurs privé

Si votre environnement utilise un registre de conteneurs privé (par exemple, si votre cluster est isolé physiquement), cette tâche suppose que les tâches suivantes ont été effectué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 « Synchronisation 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 « Synchronisation d'images vers un registre de conteneurs privé ».

Le cpd-cli est configuré pour récupérer olm-utils-v4 l'image depuis le 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

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 associations 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 au niveau du cluster pour la plateforme et les services.

Procédure

Effectuez les tâches suivantes pour mettre à niveau l' watsonx.governance :

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

Définition des options d'installation

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

Si vous le souhaitez, vous pouvez indiquer 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`	Indiquez quel watsonx.governance™ abonnement vous avez acheté. Valeur par défaut `all` Si vous n'indiquez pas cette option, la valeur par défaut sera utilisée. Les valeur valides `all` Sélectionnez cette option si vous avez acheté à la fois Model Management et Risk and Compliance Foundation le droit d'utilisation. `mm` Sélectionnez cette option si vous avez acheté Model Management une licence. `rcf` Sélectionnez cette option si vous avez acheté Risk and Compliance Foundation une licence.
`enableFactsheet`	Indiquez si vous souhaitez l'installer AI Factsheets. Ce service vous permet de suivre les actifs et d'enregistrer des données dans le cadre d'applications de l'IA. AI Factsheets est disponible avec l'abonnement Model Management . Si vous n'avez acheté que la Risk and Compliance Foundation licence, vous ne pouvez pas l'installer AI Factsheets. Valeur par défaut `true` Si vous n'indiquez pas cette option, la valeur par défaut sera utilisée. Les valeur valides `false` Ne pas installer AI Factsheets. `true` Installez AI Factsheets.
`enableOpenpages`	Indiquez si vous souhaitez l'installer OpenPages. Ce service vous permet de concevoir des flux de travail et de visualiser les activités liées au cycle de vie de l'IA à partir d'un tableau de bord, afin de vous aider à respecter les exigences de conformité et les objectifs réglementaires. OpenPages est disponible avec l'abonnement Risk and Compliance Foundation . Si vous n'avez acheté que la Model Management licence, vous ne pouvez pas l'installer OpenPages. Valeur par défaut `true` Si vous n'indiquez pas cette option, la valeur par défaut sera utilisée. Les valeur valides `false` Ne pas installer OpenPages. `true` Installez OpenPages.
`enableOpenscale`	Indiquez si vous souhaitez l'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 sous l'angle de l'équité, de la qualité et de la dérive. Watson OpenScale est disponible avec l'abonnement Model Management . uniquement Model Management et Risk and Compliance Foundation Si vous n'avez acheté qu'une Risk and Compliance Foundation licence, vous ne pouvez pas l'installer Watson OpenScale. Valeur par défaut `true` Si vous n'indiquez pas cette option, la valeur par défaut sera utilisée. Les valeur valides `false` Ne pas installer Watson OpenScale. `true` Installez Watson OpenScale.
`openpagesInstanceCR`	Indiquez le nom d'une instance de OpenPages service existante. Cette option ne s'applique que si vous avez défini `enableOpenPages: true` et que vous disposez déjà d'une instance OpenPages de service que vous souhaitez utiliser avec watsonx.governance. Valeur par défaut `"openpagesinstance-cr"` Si vous n'indiquez pas cette option, la valeur par défaut sera utilisée. Restriction : si vous ne souhaitez pas utiliser une instance de OpenPages service existante, ne modifiez pas la valeur par défaut. Les valeur valides Le 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 avez défini `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 n'indiquez pas cette option, la valeur par défaut sera utilisée. Les valeur valides `external` Utilisez une base de données externe existante. Si vous sélectionnez cette option, vous devez également indiquer 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. En incluant ce paramètre Veillez à décommenter les lignes suivantes et à indiquer 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 nom du fournisseur. Valeur par défaut `Db2` Si vous n'indiquez pas cette option, la valeur par défaut sera utilisée. Les valeur valides `Db2` Utilisez Db2 comme base de données. `Oracle` Utilisez Oracle comme base de données. En incluant ce paramètre Veillez à décommenter les lignes suivantes et à indiquer 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 indiquer 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 avez défini `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éé lors de la configuration d'une base de données Db2 externe pour OpenPages. En incluant ce paramètre Veillez à décommenter les lignes suivantes et à indiquer 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 par défaut du délai d'expiration lors de l'installation des composants de watsonx.governance. Valeur par défaut `150` (procès-verbal) Si vous n'indiquez pas cette option, la valeur par défaut sera utilisée. Les valeur valides Un nombre entier correspondant au nombre de minutes avant l'expiration du délai. En incluant ce paramètre 5.3.0 Les instructions suivantes s'appliquent uniquement si vous avez installé IBM Software Hub la version 5.3.0 Veillez à décommenter les lignes suivantes et à indiquer 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 à niveau l' watsonx.governance :

Connectez-vous cpd-cli au Red Hat® OpenShift Container Platform cluster :
```
${CPDM_OC_LOGIN}
```
N'oubliez pas : 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 à jour lorsque la install-components commande renvoie :

[SUCCESS]... The install-components command ran successfully

Si vous souhaitez vérifier que l'état 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

Une fois la mise à niveau de watsonx.governance effectuée, 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 l' watsonx.governance.

Pour OpenPages

Procédure

Pour mettre à niveau l'instance du service :

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

Solutions Governance console de mise à niveau

La version d' OpenPages5.3.1 comprend des mises à jour des solutions utilisées dans Governance console. Vous devez mettre à jour les solutions.

Si vous ne mettez pas à jour les solutions, vous risquez de rencontrer les problèmes suivants :

La synchronisation du cas d'utilisation de l'IA échoue dans watsonx.governance.
Lorsqu'un cas d'utilisation est créé dans Governance console, il n'est pas synchronisé avec watsonx.governance.

Actualisez les solutions avec les dernières mises à jour. Pour plus d'informations, consultez l'article « Étapes à suivre après la mise à niveau d' watsonx.governance » | OpenPages sur Cloud Pak for Data.
Important : la rechargement des solutions risque d'écraser vos configurations, Governance console telles que les profils, les paramètres de nom système des objets, ainsi que les personnalisations apportées aux workflows, aux tableaux de bord et aux vues. Vous devez réappliquer vos personnalisations après avoir rechargé les solutions.
Connectez-vous à Governance console en tant qu'administrateur.
Cliquez sur le menu Administration > Configuration du système > Paramètres.
Recherchez le paramètre « Désactiver les déclencheurs ».
Vous pouvez utiliser le champ de recherche ou accéder à Applications > GRCM > Désactiver les déclencheurs.
Dans le champ Valeur, saisissez false.

Une fois les étapes précédentes terminées, Governance console est prêt à être utilisé.

Etape suivante

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

Pour administrer watsonx.governance, consultez la section « Administration de watsonx.governance ».