Mise à niveau d' Db2 Warehouse de la version 5.3.x vers une version ultérieure 5.3 refresh

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

Veuillez consulter les informations suivantes avant de mettre à niveau l' Db2 Warehouse :

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 Db2 Warehouse 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

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 Db2 Warehouse.

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 :

1. Les images du logiciel Db2 Warehouse 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é.

Red Hat® OpenShift AI

Si vous prévoyez d'utiliser des fonctionnalités qui nécessitent 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.

Procédure

Effectuez les tâches suivantes pour mettre à niveau Db2 Warehouse :

1. Amélioration du service
2. Validation de la mise à niveau
3. Mise à niveau des instances de service existantes.
4. Vérification de la mise à niveau de l'instance de service.
5. Que faire ensuite?

Mise à niveau du service

Pour mettre à jour l' Db2 Warehouse :

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 Db2 Warehouse.

   cpd-cli manage install-components \
   --license_acceptance=true \
   --components=db2wh \
   --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

[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=db2wh

Mise à niveau d'instances de service existantes

Après avoir mis à niveau Db2 Warehouse, vous devez mettre à niveau toutes les instances de service associées à Db2 Warehouse.

Avant de commencer

Créez un profil sur le poste de travail à partir duquel vous allez mettre à niveau les instances du service.

Le profil doit être associé à un IBM Software Hub utilisateur disposant de l'une des autorisations suivantes :

• Créer des instances de service (can_provision)
• Gérer les instances de service (manage_service_instances)

Pour plus d'informations, consultez la section Création d'un profil pour utiliser les commandes de gestion cpd-cli.

Supprimez les correctifs personnalisés et les scripts de remplacement, le cas échéant :

1. Connectez-vous à Red Hat OpenShift Container Platform en tant qu'utilisateur disposant des droits suffisants pour effectuer la tâche:

   oc login OpenShift_URL:port

2. Exécutez la commande suivante pour supprimer les correctifs personnalisés et remplacer les scripts :
   1. Pour la ressource personnalisée d' Db2uCluster, exécutez la commande suivante :

      oc set volume statefulset/c-${DB2U_ID}-db2u -n ${PROJECT_CPD_INST_OPERANDS} --remove --name=<volume_name>

   2. Pour la ressource personnalisée d' Db2uInstance, exécutez les commandes suivantes :
      1. Trouvez l'index de l' VolumeMount :

         oc get db2uengine c-${DB2U_ID}-db2u -n ${PROJECT_CPD_INST_OPERANDS} -o json | jq '.spec.podTemplate.spec.containers[0].volumeMounts | to_entries[] | select(.value.name=="<volume_name>")'

         Enregistrez la clé sous : MNT_IDX=5.

      2. Trouvez l'indice de volume :

         oc get db2uengine c-${DB2U_ID}-db2u -n ${PROJECT_CPD_INST_OPERANDS} -o json | jq '.spec.podTemplate.spec.volumes | to_entries[] | select(.value.name=="<volume_name>")'

         Enregistrez la clé sous : VOL_IDX=7.

      3. Corrigez les entrées :

         oc patch db2uengine c-${DB2U_ID}-db2u \
           -n ${PROJECT_CPD_INST_OPERANDS} \
           --type='json' \
           -p="[
                 {\"op\":\"remove\",\"path\":\"/spec/podTemplate/spec/containers/0/volumeMounts/${MNT_IDX}\"},
                 {\"op\":\"remove\",\"path\":\"/spec/podTemplate/spec/volumes/${VOL_IDX}\"}
               ]"

Procédure

Pour mettre à niveau les instances du service :

1. Récupérer la liste des instances du service « Db2 Warehouse » :

   cpd-cli service-instance list \
   --service-type=db2wh \
   --profile=${CPD_PROFILE_NAME}

2. Définissez la variable INSTANCE_NAME d'environnement sur le nom de l'instance du service que vous souhaitez mettre à niveau :

   export INSTANCE_NAME="<instance-name>"

3. Exécutez la commande suivante pour vérifier si vos instances du service Db2 Warehouse sont en état de fonctionnement :

   cpd-cli service-instance status ${INSTANCE_NAME} \
   --profile=${CPD_PROFILE_NAME} \
   --service-type=db2wh

4. Mettre à niveau l'instance du service :

   cpd-cli service-instance upgrade \
   --service-type=db2wh \
   --instance-name=${INSTANCE_NAME} \
   --profile=${CPD_PROFILE_NAME}

5. Surveillez l'état de votre Db2uCluster ou Db2uInstance pour vérifier si l'état de la ressource personnalisée passe à Not Ready puis à Ready :
   • Pour la ressource personnalisée d' Db2uCluster, exécutez la commande suivante :

     oc get db2ucluster <instance_id> -o jsonpath='{.status.state} {"\n"}'

   • Pour la ressource personnalisée d' Db2uInstance, exécutez la commande suivante :

     oc get db2uinstance <instance_id> -o jsonpath='{.status.state} {"\n"}'

   Si l'état de la ressource UpgradeCheckFailedpersonnalisée renvoie, consultez la section Dépannage des problèmes d' db2ckupgrade.
6. Vérifiez que l'instance du service a été mise à niveau et qu'elle est prête à être utilisée.
7. Répétez les étapes précédentes pour mettre à niveau chaque instance de service associée à cette instance de IBM Software Hub.

Vérification de la mise à niveau de l'instance de service

Vous pouvez utiliser une commande ou la console Web pour vérifier que l'instance de service a été mise à niveau et est prête à être utilisée.

Commande

1. Obtenez votre statut « Db2uCluster » ou « Db2uInstance ». Attendez que le statut passe à Ready:
   • Pour la ressource personnalisée d' Db2uCluster, exécutez la commande suivante :

     oc get db2ucluster <instance_id> -o jsonpath='{.status.state} {"\n"}'

   • Pour la ressource personnalisée d' Db2uInstance, exécutez la commande suivante :

     oc get db2uinstance <instance_id> -o jsonpath='{.status.state} {"\n"}'

2. Vérifiez l'état de votre instance de service Db2 Warehouse :

   cpd-cli service-instance status ${INSTANCE_NAME} \
   --profile=${CPD_PROFILE_NAME} \
   --service-type=db2wh

3. Vérifiez si l'instance du service est mise à jour :

   cpd-cli service-instance list \
   --profile=${CPD_PROFILE_NAME}\
   --service-type=db2wh

La console web

À partir de la page Détails de la base de données, attendez que la version de la base de données change.

Etape suivante

Vous devez effectuer la configuration post-installation du service « Db2 Warehouse » avant de pouvoir accéder à Db2 Warehouse.