Mise à niveau Cognos Analytics 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 Cognos Analytics :

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 Cognos Analytics 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

Cognos Analytics nécessite le IBM Software Hub common core services.

Si les ne common core services sont pas à la bonne version dans le projet d'opérandes pour l'instance, les common core services sont automatiquement mis à niveau lorsque vous mettez à niveau Cognos Analytics. 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 Cognos Analytics.

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 Cognos Analytics 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 Cognos Analytics, procédez comme suit :

1. Amélioration 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 Cognos Analytics :

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 Cognos Analytics.

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

Mise à niveau d'instances de service existantes

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

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. Définissez la variable INSTANCE_VERSION d'environnement sur la version qui correspond à la version de IBM Software Hub sur votre cluster :

   export INSTANCE_VERSION=<version>

   Utilisez le tableau suivant pour déterminer la valeur appropriée :

   IBM Software Hubversion	Version d'instance de service
   5.3.1	29.1.0
   5.3.0	29.0.0

2. Mettez à niveau les instances de service :

   cpd-cli service-instance upgrade \
   --service-type=cognos-analytics-app \
   --profile=${CPD_PROFILE_NAME} \
   --version=${INSTANCE_VERSION} \
   --all

Etape suivante

Cognos Analytics est prêt à l'emploi. Pour commencer, Cognos Analytics consultez Analyser et visualiser les données avec Cognos Analytics.