Migration de la base de données IBM Websphere Commerce Version 8 opérationnelle

Faites migrer votre base de données opérationnelle IBM Websphere Commerce Version 8 en mettant votre magasin opérationnel IBM Websphere Commerce Version 8 en mode maintenance et en faisant pointer votre environnement HCL Commerce Version 9 vers la base de données opérationnelle IBM Websphere Commerce Version 8.

Avant de commencer

  1. Assurez-vous que les données de la table KEYS sont valides. En particulier, vérifiez que les lignes que vous avez ajoutées pour les tables personnalisées contiennent des données valides.
  2. Mettez à jour le centre de configuration HCL Commerce Version 9 dans les paramètres de connexion de la base de données correspondants à la version de votre base de données opérationnelle IBM Websphere Commerce Version 8.
  3. Redéployez vos conteneurs personnalisés dans votre application HCL Commerce.

    Une fois les conteneurs redéployés, les paramètres de connexion à la base de données que vous avez ajoutés à votre centre de configuration sont inclus dans le déploiement. Une fois le déploiement terminé, votre environnement HCL Commerce Version 9 pointe vers votre base de données opérationnelle IBM Websphere Commerce Version 8.

    Vous pouvez valider les détails de connexion de la base de données en examinant le fichier suivant :
    • /opt/WebSphere/AppServer/profiles/default/config/cells/localhost/nodes/localhost/servers/server1/resources.xml
    Recherchez le bloc de code suivant et validez les propriétés de la base de données.
    <factories xmi:type="resources.jdbc:DataSource" xmi:id="DataSource_1511481976537" name="WCDataSource" jndiName="jdbc/WCDataSource" 
    description="Data source template" authMechanismPreference="BASIC_PASSWORD" authDataAlias="WCDataSource_alias" relationalResourceAdapter="builtin_rra" 
    statementCacheSize="50" datasourceHelperClassname="com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper">
      <propertySet xmi:id="J2EEResourcePropertySet_1511481976543">
        <resourceProperties xmi:id="J2EEResourceProperty_1511481976548" name="databaseName" type="java.lang.String" value="mall"/>
        <resourceProperties xmi:id="J2EEResourceProperty_1511481976553" name="driverType" type="java.lang.Integer" value="4"/>
        <resourceProperties xmi:id="J2EEResourceProperty_1511481976558" name="serverName" type="java.lang.String" value="db"/>
        <resourceProperties xmi:id="J2EEResourceProperty_1511481976565" name="portNumber" type="java.lang.Integer" value="50000"/>
      </propertySet>
      <connectionPool xmi:id="ConnectionPool_1511481976569" connectionTimeout="180" maxConnections="55" minConnections="0" reapTime="180" 
        unusedTimeout="1800" agedTimeout="0" purgePolicy="EntirePool"/>
      <mapping xmi:id="MappingModule_1511481976574" mappingConfigAlias="DefaultPrincipalMapping" authDataAlias="WCDataSource_alias"/>
    </factories>

Procédure

  1. Exécutez la vérification de la base de données de prémigration sur votre base de données opérationnelle.
    1. Exécutez docker ps pour vérifier que vos conteneurs sont en cours d'exécution.
    2. Localisez le nom de votre conteneur d'utilitaire dans la colonne NAMES. Par exemple, myproject_utils_1.
    3. Démarrez un shell bash en exécutant la commande suivante avec le nom du conteneur d'utilitaire.
      • docker exec -it <utility_container_name> bash
    4. Accédez au répertoire bin en exécutant la commande suivante.
      • cd WC_installdir/bin
    5. Exporter la variable d'environnement ENVTYPE pour correspondre au type d'environnement.
      • export ENVTYPE=auth pour le transfert.
      • export ENVTYPE=live pour la production.
    6. Vérifiez la base de données en exécutant la commande suivante :
      • wcim_ant.sh -tier db -action check -from 80 -instanceName instance_name -isStaging true|false [-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.
      de
      Spécifie la version de la base de données HCL Commerce à partir de laquelle vous procédez à la migration. La seule option disponible est 80.
      instanceName
      (Facultatif) Indique le nom de votre instance IBM Websphere Commerce Version 8.
      Remarque : instanceName doit être demo. Il s'agit de la valeur par défaut.

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

      isStaging
      Indique si vous vérifiez votre base de données de transfert.
      true
      Vous vérifiez une base de données de transfert.
      false
      Vous ne vérifiez pas de base de données de transfert.
      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é à indiquer 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 : 
      WC_installdir/bin>wcim_ant.sh -tier db -action check -from 80 -instanceName demo -isStaging false -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.
    7. Si la vérification de la base de données échoue, examinez le fichier journal suivant : WC_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 opérationnelle.
    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 à partir de votre conteneur d'utilitaire :
      • wcim_ant.sh -tier db -action migrate -from 80 -instanceName instance_name -isStaging true|false [-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 :
      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. La seule option disponible est 80.
      instanceName
      (Facultatif) Indique le nom de votre instance IBM Websphere Commerce Version 8.
      Remarque : instanceName doit être demo. Il s'agit de la valeur par défaut.

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

      isStaging
      Indique si vous vérifiez votre base de données de transfert.
      true
      Vous vérifiez une base de données de transfert.
      false
      Vous ne vérifiez pas de base de données de transfert.
      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é à indiquer 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 : 
      WC_installdir/bin>wcim_ant.sh -tier db -action migrate -from 80 -instanceName demo -isStaging false -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 : WC_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 les fichiers WC_installdir/logs/WCIM/wcim.server.yyyy.mm.dd_hh.mm.ss.log et WC_installdir/logs/content.version.update.messages_yyyy.mm.dd_hh.mm.ss.log. Vérifiez dans les journaux 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 WC_installdir/logs/WCIM/wcim.server.yyyy.mm.dd_hh.mm.ss.log, puis identifiez les actions requises.