Exécution du vérificateur de migration et de l'utilitaire de migration sur votre base de données de développement IBM Websphere Commerce Version 7 Feature Pack 8

A présent, vous avez configuré votre environnement de développement HCL Commerce Version 9 pour utiliser votre base de données de développement IBM Websphere Commerce Version 7. Faites migrer cette base de données IBM Websphere Commerce Version 7 vers HCL Commerce Version 9 en exécutant le vérificateur de migration et l'utilitaire de migration via la ligne de commande. Exécutez ensuite l'utilitaire updatedb pour mettre à niveau votre base de données vers HCL Commerce Version 9.

Procédure

  1. Exécutez la vérification de prémigration de base de données.
    1. Ouvrez une invite de commande.
    2. Accédez au répertoire WCDE_installdir\bin.
    3. Vérifiez la base de données en exécutant la commande suivante : 
      wcim_ant.bat -tier db -action check -from 70 [-defaultTablespace yes | no] [-logLevel Error | Warning | Info | Verbose | Debug]
      Où :
      tier
      (Facultatif) Indique le niveau de votre topologie HCL Commerce que vous migrez. La seule option disponible est db.

      La valeur tier est définie par défaut sur db si elle n'est pas spécifiée.

      action
      Spécifie l'action à effectuer lorsque la commande est exécutée. Les actions supportées sont les suivantes :
      vérification
      Exécute le vérificateur de prémigration de la base de données pour vérifier le statut de votre base de données avant sa migration. Exécutez le vérificateur de prémigration de base de données avant de migrer la base de données.
      migrate
      Migre la base de données vers HCL Commerce Version 9.
      de
      Spécifie la version de la base de données HCL Commerce à partir de laquelle vous procédez à la migration.
      defaultTablespace
      Facultatif : Permet d'indiquer si vous voulez utiliser un espace table par défaut pour la base de données.
      oui
      Définit un espace table par défaut.
      non
      Un espace table autre que celui défini par défaut peut être utilisé. Vous serez invité à saisir un nom d'espace table ultérieurement lors de la migration.
      logLevel
      Facultatif : Spécifie la quantité d'informations consignées relatives à la migration du niveau base de données. Les niveaux de journalisation valides sont les suivants :
      Erreur
      Seuls les messages d'erreur sont consignés.
      Avertissement
      Tous les messages d'erreur et d'avertissement sont consignés.
      Info
      Tous les messages d'erreur, d'avertissement et d'événement sont consignés.
      Verbose
      Toutes les erreurs, tous les événements ainsi que d'autres informations sont consignés, y compris la totalité des informations sur les instructions SQL. Cela nécessite 1 à 2 Mo de stockage pour la plupart des migrations. Verbose est la valeur définie par défaut.
      Déboguer
      Similaire à l'option Verbose, mais elle inclut certaines informations de débogage supplémentaires. Cette valeur peut être utile si vous rencontrez des erreurs et que vous devez les déboguer. Cela nécessite 1 à 2 Mo de stockage pour la plupart des migrations.
      Le fragment suivant est un exemple d'interaction de vérification de base de données : 
      WCDE_installdir\bin>wcim_ant.bat -tier db -action check -from 70 -logLevel Verbose
Database type? 
db2

Database name?
mall

Is the database backup completed? [ Yes ] (Yes,No,)
Yes

Is the database restore completed? [ Yes ] (Yes,No,)
Yes
      Lorsque la vérification aboutit, le message suivant apparaît : 
      INFO:   WCIM has completed the job(s) successfully.
    4. Si la vérification de la base de données échoue, examinez le fichier journal suivant : WCDE_installdir\logs\WCIM\wcim.server.yyyy.mm.dd_hh.mm.ss.log. Corrigez le problème décrit dans le message d'échec, puis relancez la vérification de base de données.
  2. Faites migrer la base de données.
    1. Ouvrez une nouvelle invite de commande ou utilisez celle que vous avez utilisée pour exécuter la vérification de base de données.
    2. Faites migrer la base de données en exécutant la commande suivante : 
      wcim_ant.bat -tier db -action migrate -from 70 [-defaultTablespace yes | no] [-logLevel Error | Warning | Info | Verbose | Debug]
      Où :
      tier
      (Facultatif) Indique le niveau de votre topologie HCL Commerce que vous migrez. La seule option disponible est db.

      La valeur tier est définie par défaut sur db si elle n'est pas spécifiée.

      action
      Spécifie l'action à effectuer lorsque la commande est exécutée. Les actions supportées sont les suivantes :
      vérification
      Exécute le vérificateur de prémigration de la base de données pour vérifier le statut de votre base de données avant sa migration. Exécutez le vérificateur de prémigration de base de données avant de migrer la base de données.
      migrate
      Migre la base de données vers HCL Commerce Version 9.
      de
      Spécifie la version de la base de données HCL Commerce à partir de laquelle vous procédez à la migration.
      defaultTablespace
      Facultatif : Permet d'indiquer si vous voulez utiliser un espace table par défaut pour la base de données.
      oui
      Définit un espace table par défaut.
      non
      Un espace table autre que celui défini par défaut peut être utilisé. Vous serez invité à saisir un nom d'espace table ultérieurement lors de la migration.
      logLevel
      Facultatif : Spécifie la quantité d'informations consignées relatives à la migration du niveau base de données. Les niveaux de journalisation valides sont les suivants :
      Erreur
      Seuls les messages d'erreur sont consignés.
      Avertissement
      Tous les messages d'erreur et d'avertissement sont consignés.
      Info
      Tous les messages d'erreur, d'avertissement et d'événement sont consignés.
      Verbose
      Toutes les erreurs, tous les événements ainsi que d'autres informations sont consignés, y compris la totalité des informations sur les instructions SQL. Cela nécessite 1 à 2 Mo de stockage pour la plupart des migrations. Verbose est la valeur définie par défaut.
      Déboguer
      Similaire à l'option Verbose, mais elle inclut certaines informations de débogage supplémentaires. Cette valeur peut être utile si vous rencontrez des erreurs et que vous devez les déboguer. Cela nécessite 1 à 2 Mo de stockage pour la plupart des migrations.
      Le fragment suivant est un exemple d'exécution de la vérification de migration de base de données : 
      WCDE_installdir\bin>wcim_ant.bat -tier db -action migrate -from 70 -logLevel Verbose
Database type? 
db2 

Database name?
mall

Is the database backup completed? [ Yes ] (Yes,No,)
Yes

Is the database restore completed? [ Yes ] (Yes,No,)
Yes
      Lorsque la migration de la base de données aboutit, le message suivant apparaît : 
      INFO:   WCIM has completed the job(s) successfully.
    3. En cas d'échec de la migration de la base de données, passez en revue et corrigez les erreurs éventuellement consignées dans le fichier journal suivant : WCDE_installdir\logs\WCIM\wcim.server.yyyy.mm.dd_hh.mm.ss.log.
      Remarque : Si la migration de la base de données échoue alors qu'elle active la gestion de versions de contenu, vous devez restaurer la base de données avant de relancer la migration. Pour déterminer si la migration a échoué alors qu'elle activait la gestion de versions de contenu, passez en revue le fichier WCDE_installdir\logs\WCIM\wcim.server.yyyy.mm.dd_hh.mm.ss.log. Vérifiez dans le journal si l'échec s'est produit lors de l'exécution de la tâche createVersion à partir du fichier configureContentVersionComponent.xml.
    4. Une fois la migration terminée, passez en revue les avertissements éventuellement consignés dans WCDE_installdir\logs\WCIM\wcim.server.yyyy.mm.dd_hh.mm.ss.log, puis identifiez les actions requises.
Une fois réussie la migration de votre base de données, effectuez les tâches suivantes de post-migration de la base de données.
  1. Mettez à jour la table SITE devant contenir les valeurs de base requises.
    1. Connectez-vous à votre serveur de base de données.
    2. Exécutez les requêtes SQL suivantes : 
      • delete from site where COMPNAME not IN ('BASE');
      • update SITE set VERSION = 9, MOD=0, FIXPACK=0 where COMPNAME IN ('BASE');
    3. Une fois le code SQL terminé, vous pouvez exécuter le code SQL suivant pour vous assurer que la table SITE a été mise à jour. 
      select * from SITE;
  2. Mettez à jour la table de base de données SRCHCONF avec le répertoire de pré-traitement de la recherche.
    1. Connectez-vous à votre serveur de base de données.
    2. Exécutez l'instruction SQL suivante :
      update SRCHCONF set CONFIG = replace(CONFIG, 'old_PreProcessdir', 'new_PreProcessdir') where indextype='CatalogEntry';
update SRCHCONF set CONFIG = replace(CONFIG, 'old_PreProcessdir', 'new_PreProcessdir') where indextype='CatalogGroup';
      Où :
      old_PreProcessdir
      Répertoire de prétraitement de IBM Websphere Commerce Version 7 Search server.
      new_PreProcessdir
      Répertoire de prétraitement de HCL Commerce Version 9 Search server.
      Par exemple,
      update SRCHCONF set CONFIG = replace(CONFIG, 'C:\IBM\WCDE_E~1\search\pre-processConfig\MC_10051\DB2', 'C:\IBM\WCDE_V9\workspace\WC\xml\search\dataImport\v3\db2\CatalogEntry') where indextype='CatalogEntry';
update SRCHCONF set CONFIG = replace(CONFIG, 'C:\IBM\WCDE_E~1\search\pre-processConfig\MC_10051\DB2\CatalogGroup', 'C:\IBM\WCDE_V9\workspace\WC\xml\search\dataImport\v3\db2\CatalogGroup') where indextype='CatalogGroup';
  3. Effectuez la mise à jour vers la norme de sécurité NIST SP 800-131A.
    1. Si vous avez utilisé KLF (Key Locator Framework) dans IBM Websphere Commerce Version 7, faites migrer les personnalisations de fournisseur de clé. Pour plus d'informations sur KLF, voir Key Locator Framework (KLF).
    2. Copiez tous les fichiers de clés personnalisées de votre environnement IBM Websphere Commerce Version 7 dans votre environnement HCL Commerce Version 9.
      1. Ouvrez votre fichier IBM Websphere Commerce Version 7 workspace_dir/WC/xml/config/wc-server.xml et recherchez le paramètre KeysConfigFile. Ce paramètre KeysConfigFile pointe vers un fichier XML de configuration de clés personnalisée distinct.
      2. Ouvrez le fichier XML de clés personnalisées défini dans workspace_dir/xml/config/wc-server.xml.
      3. Les fichiers personnalisés qui sont référencés dans ce fichier XML de clés personnalisées doivent être copiés dans les mêmes répertoires dans votre environnement HCL Commerce Version 9.
        En général, ces fichiers personnalisés sont les suivants :
        • CustomKeys.xml
        • merchantKey.xml
        • KeyEncryptionKey.xml
    3. Vérifiez que l'utilisateur migré peut se connecter à vos outils HCL Commerce version 9.0.0.3 ou ultérieure.
  4. Lorsque vous avez configuré votre environnement HCL Commerce Version 9, vous avez spécifié un mot de passe spiuser. Après que votre base de données a été migrée à partir d'une version précédente, votre mot de passe utilisateur spiuser peut être incohérent.
    1. Définissez le mot de passe spiuser dans vos images Docker.
    2. Mettez à jour la stratégie de compte pour l'utilisateur spiuser.
      Exécutez l'instruction SQL suivante.
      UPDATE USERREG SET PLCYACCT_ID = NULL WHERE logonid = 'spiuser';
  5. Exécutez l'utilitaire updatedb.
  6. Si vous migrez depuis IBM Websphere Commerce Version 7 et que vous avez configuré des espaces de travail et déjà exécuté le script de mise à jour du schéma des espaces de travail après la migration, exécutez l'instruction SQL suivante dans chaque schéma d'écriture des espaces de travail :
    • DB2 
      ALTER TABLE PAGELAYOUT ALTER COLUMN PAGELAYOUTTYPE_ID DROP NOT NULL;

CALL SYSPROC.ADMIN_CMD ('REORG TABLE PAGELAYOUT');
    • Oracle 
      ALTER TABLE PAGELAYOUT MODIFY PAGELAYOUTTYPE_ID NULL;