Mise à niveau OpenPages de la version 5.2 à la version 5.3

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

Veuillez consulter les informations suivantes avant de procéder à la mise à niveau OpenPages :

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

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 de IBM 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 OpenPages logicielles 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 Extraire olm-utils-v4 l'image 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 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

Pour effectuer la mise à niveau OpenPages, procédez comme suit :

1. Mise à niveau du service
2. Validation de la mise à niveau
3. Mise à niveau des instances de service existantes
4. Que faire ensuite?

Mise à niveau du service

Pour mettre à niveau OpenPages :

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. Mettre à jour l'opérateur et la ressource personnalisée pour OpenPages.

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

--tethered_instance_ns=${PROJECT_CPD_INSTANCE_TETHERED}

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=openpages

Mise à niveau d'instances de service existantes

Après la mise à niveau OpenPages, vous devez mettre à niveau toutes les instances de service associées à OpenPages.

Lorsque vous mettez à niveau une OpenPages instance, celle-ci s'arrête puis redémarre. Cela peut prendre environ 2 heures, pendant lesquelles le service sera indisponible pour les utilisateurs. Effectuez la mise à niveau de l'instance lorsque les utilisateurs ne sont pas connectés.

Lorsque vous mettez à niveau une OpenPages instance qui utilise une base de données interne, le Db2 as a service CR est mis à niveau vers la dernière version.

Avant de commencer

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

Le profil doit être associé à un IBM Software Hub utilisateur disposant 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 Création d'un profil pour utiliser les commandes de gestion cpd-cli.

Procédure

Pour mettre à niveau les instances de service :

1. Obtenir la liste des instances OpenPages de service :

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

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

   export INSTANCE_NAME=<instance-name>

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

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

4. Mettre à niveau l'instance de service :

   cpd-cli service-instance upgrade \
   --service-type=openpages \
   --instance-name=${INSTANCE_NAME} \
   --force-version-upgrade=true \
   --profile=${CPD_PROFILE_NAME}
   

5. Répétez les étapes précédentes pour mettre à niveau chaque instance de service associée à cette instance de IBM Software Hub.

Etape suivante