Mise à niveau d' IBM StreamSets de la version 5.1 à la version 5.3

Un administrateur d'instance peut mettre à niveau IBM StreamSets de la version 5.1 à la version 5.3.

Important : vous ne pouvez pas mettre à niveau IBM StreamSets depuis la version 5.1.0, 5.1.1 ou 5.1.2 vers la version 5.3. Vous devez supprimer les composants IBM StreamSets et réinstaller le service sur la version 5.3.
Qui doit accomplir cette tâche?

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

    Répétez l'opération autant de fois que 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 de IBM StreamSets sur le cluster.

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

Veuillez consulter les informations suivantes avant de mettre à niveau IBM StreamSets :

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 IBM StreamSets 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.

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 IBM StreamSets.
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 logicielles IBM StreamSets 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é.
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 d' IBM ez Software Hub.

Procédure

Effectuez les tâches suivantes pour mettre à niveau IBM StreamSets :

  1. Amélioration du service
  2. Validation de la mise à niveau
  3. Que faire ensuite?

Mise à niveau du service

Pour mettre à jour IBM StreamSets :

  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 IBM StreamSets.
    cpd-cli manage install-components \
    --license_acceptance=true \
    --components=streamsets \
    --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

IBM StreamSets 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=streamsets

Etape suivante

IBM StreamSets est prêt à l'emploi. Pour commencer à utiliser IBM StreamSets, consultez la section « Getting started » (Pour commencer) sur IBM StreamSets.