Échec de l’upgrade dû à la présence de caractères Ctrl+Z

Échec de l’upgrade dû à la présence de caractères Ctrl+Z

Idea
Le problème (SD-118352) est corrigé à partir de la version 14710. À partir de cette release, ces caractères sont automatiquement pris en charge pendant la migration.
Si vous prévoyez de migrer depuis une version inférieure à 14610 vers 14610, vous pouvez directement passer à 14710 afin que les caractères ctrl+Z soient traités automatiquement.

Dans certains scénarios d’upgrade de ServiceDesk Plus (voir le tableau ci-dessous), la base PostgreSQL intégrée au produit est mise à niveau. Durant ce processus, les données de l’instance PostgreSQL actuelle sont migrées vers la nouvelle version 11.17.
Pour cela, les outils PostgreSQL pg_dump et pg_restore sont utilisés afin d’exporter et de restaurer les données entre les deux instances.
Les traces suivantes, trouvées dans les logs, montrent que l’erreur est liée à la présence d’un caractère ^Z (Ctrl+Z) dans la base de données. Ce caractère, lorsqu’il apparaît dans une colonne, perturbe l’exécution de la migration et peut entraîner un décalage des données sur les colonnes suivantes de la même ligne.
Pour corriger le problème, il faut remplacer les caractères ^Z par des mots, des phrases simples, ou même un simple espace. Un outil a été développé pour supprimer automatiquement ces caractères problématiques de la base afin de permettre la migration.
Idea
Pour les versions plus anciennes (avant le build 10500), veuillez consulter l’article correspondant pour résoudre ce problème.

Version Source
Version Cible
Build < 14300
14300
Build < 14610
14610 et plus


Extraits de logs (exemples)

  1. Aug 3, 2023 11:19:19 AM  [com.zoho.postgres.migrate.DumpMigration] [WARNING] : Error :::: ERROR:  missing data for column "columnoldvalue"
  2. Aug 3, 2023 11:19:19 AM  [com.zoho.postgres.migrate.DumpMigration] [INFO] : CONTEXT:  COPY hwaudithistory, line 8557585: "8479381 1443439 HardDiskInfo SERIALNUMBER H­…øÿÿ�?ø"
(OU)
  1. Dec 4, 2023 8:52:33 PM  [com.zoho.postgres.migrate.DumpMigration] [WARNING] : ERROR: extra data after last expected column
  2. Dec 4, 2023 8:52:33 PM  [com.zoho.postgres.migrate.DumpMigration] [INFO] : CONTEXT: COPY aaaaccount, line 6057: "6845 6845 1 2 14921675104876846 6846 1 2 1492167511205"

Étapes pour exécuter l’outil
    1. Téléchargez le fichier ZIP fourni et décompressez-le dans le dossier <servicedeskplus_home>.
      Cela créera un dossier <servicedeskplus_home>\ctrlZScanner.
    2. Démarrez le service ServiceDesk Plus / Database server.
    3. Allez dans le dossier <servicedeskplus_home>\ctrlZScanner et exécutez run.bat une fois que le serveur est démarré.
    4. Un fichier de log nommé ctrlZScanner.log sera généré.
    5. Arrêtez le serveur d’application.
    6. Relancez l’upgrade.
Si l’upgrade échoue à nouveau, récupérez le fichier ctrlZScanner.log ainsi que le dossier logs, et partagez-les avec nous.

Pièce Jointe :