Mise à jour des données chiffrées à l'aide de MigrateEncryptedInfo (serveur en ligne)

Lorsque le serveur est en cours d'exécution, vous pouvez modifier la clé de commerçant et mettre à jour des données chiffrées à l'aide de l'utilitaire MigrateEncryptedInfo. Utilisez l'option -k (Key Locator Framework) pour spécifier les clés nouvelles et anciennes afin d'affecter un numéro de version à chaque clé.

Remarque : Pour mettre à jour des données chiffrées à l'aide de l'utilitaire MigrateEncryptedInfo lorsque le serveur est hors ligne, voir Mise à jour des données chiffrées à l'aide de MigrateEncryptedInfo (serveur hors ligne).

Avant de commencer

  • Le site doit utiliser une clé de commerçant qui est configurée dans Key Locator Framework. Autrement dit, un fichier de configuration de clés personnalisé est déjà défini dans Transaction server Docker container dans le fichier application_dir/xml/config/wc-server.xml.
  • OraclePour des bases de données Oracle, vous devez affecter une taille suffisamment élevée à l'espace table UNDO. A partir d'une invite SQLPlus, entrez la commande suivante :
    alter database datafile undotablespace datafile autoextend on
    maxsize unlimited;
    

Procédure

  1. Sauvegardez votre base de données, en suivant les instructions figurant dans la documentation du moteur de base de données.
  2. Préparez les nouveaux fichiers de clés et le fichier de configuration de clés.
    Spécifiez pour la nouvelle clé une nouvelle version différente de la version utilisée par la clé en cours existante. En règle générale, cette version est supérieure de 1 à la version de la clé en cours. Placez le fichier de configuration de clés dans le répertoire suivant :
    • HCL Commerce Developerworkspace_dir/WC/xml/config
    • (Dans Utility server Docker container) application_dir/xml/config
  3. Conditionnez les modifications dans les fichiers XML personnalisés. (Par exemple, merchantKey_v2.xml, CustomKeys.xml, KeyEncryptionKey.xml, newMerchantKey_v2-1.xml et newMerchantKey_v2-2.xml).
  4. Lorsque la nouvelle clé est enregistrée sur tous les serveurs:
    1. Exécutez l'utilitaire MigrateEncryptedInfo à l'aide de l'option (-k) de Keys Locator Framework.
      Vous devez tenir compte des considérations suivantes lorsque vous exécutez l'utilitaire :
      L'outil MigrateEncryptedInfo génère les fichiers journaux suivants :
      • migrateFailedRecords_TABLENAME.log
      • MKChangeUserAndCCInfoMigration.log
      • MigrateEncryptedInfoError.log
      dans le répertoire suivant :
      • utilities_root/logs

      Consultez les informations dans ces fichiers journaux. Vérifiez qu'il n'y a pas de messages d'erreur.