Étapes de mise à niveau de la base de données Sitecore / Blogs / Perficient

Précédemment nous avons approfondi les conditions préalables requises pour la mise à niveau de la base de données Sitecore et les étapes nécessaires pour s’y préparer.

Dans cette deuxième partie de la série de blogs en trois parties, nous passerons en revue les étapes à suivre pour effectuer la mise à niveau réelle des bases de données.

Étapes de mise à niveau

1. 1. Aller à https://dev.sitecore.net/Downloads/Sitecore_Experience_Platform/103/Sitecore_Experience_Platform_103_Update1.aspx et passez en revue les étapes de la section « Préparer la mise à niveau » du guide « Guide de déploiement de conteneurs de mise à niveau ».
   2. Accédez au répertoire C:\sitecoreupgrade\SitecoreContainerDeployment.10.3.1.009452.1448\compose\ltsc2019\upgrade\xp1
   3. Repérez le fichier update.env et ouvrez-le pour le modifier.
   4. Définissez les valeurs de ces variables d’environnement dans ce fichier. Apportez les modifications nécessaires en fonction de la configuration de votre solution.

      SQL_DATABASE_PREFIX=Sitecore
      SQL_SERVER=IPADDRESSORDOMAINNAMEOFYOURSQLCONTAINER
      SQL_USERNAME=sitecoreupgrade
      SQL_PASSWORD=sitecoreupgrade
      IS_ALWAYS_ENCRYPTED=False
      PROCESSING_ENGINE_TASKS_DATABASE_USERNAME=dbo
      DATABASE_UPGRADE_FROM_VERSION=9.3.0
      DATABASE_UPGRADE_TO_VERSION=10.3.1

   5. Pour convertir et compresser la licence Sitecore en chaîne base 64, exécutez le script présent dans la méthode « ConvertTo-CompressedBase64String » présente dans le guide de mise à niveau. Copiez la sortie du script et utilisez-la pour définir la valeur de la variable « SITECORE_LICENSE » dans le fichier update.env.
   6. Alors que nous effectuons une mise à niveau depuis Sitecore 9.3.0, connectez-vous à votre instance Sitecore locale, sélectionnez le panneau de configuration et dans la section « Base de données », sélectionnez « Nettoyer les bases de données ».
   7. Ouvrez PowerShell en mode Administrateur et modifiez le répertoire en « C:\sitecoreupgrade\SitecoreContainerDeployment.10.3.1.009452.1448\compose\ltsc2019\upgrade\xp1 ».
   8. Exécutez cette commande docker pour créer le conteneur de mise à niveau SQL. « docker-compose -f .\docker-compose.upgrade.yml –env-file .\upgrade.env up »
   9. Lorsque le conteneur de mise à niveau SQL commence à exécuter les scripts qu’il contient, vous pouvez obtenir cette erreur concernant le conteneur de mise à niveau SQL incapable de se connecter au conteneur SQL. Ceci est également mentionné dans la section « Dépannage » du guide de mise à niveau.
      

      Erreur lors de la connexion au serveur SQL

   10. Après quelques dépannages, nous avons découvert que le conteneur SQL et le conteneur de mise à niveau SQL n’étaient pas sur le même réseau.
       • Pour examiner le réseau du conteneur SQL, j’ai exécuté la commande « docker inspect » dans PowerShell et j’ai navigué jusqu’à la section Réseaux où le réseau du conteneur SQL était « nat ».
         

         Détails du réseau de conteneurs SQL

       • Donc, pour forcer le conteneur de mise à niveau SQL à utiliser le même réseau que le conteneur SQL, j’ai ajouté les lignes de code suivantes (surlignées) au fichier « docker-compose.upgrade.yml » présent dans le fichier C:\sitecoreupgrade\SitecoreContainerDeployment.10.3.1.009452. .1448\compose\ltsc2019\upgrade\xp1. Les lignes 24-26 définissent le réseau et les lignes 21-22 indiquent au conteneur d’utiliser ce réseau spécifique.
         

         Détails du réseau ajoutés au fichier docker-compose.upgrade.yml

   11. Après avoir apporté ces modifications au fichier docker-compose.upgrade.yml, j’ai réexécuté cette commande « docker-compose -f .\docker-compose.upgrade.yml –env-file .\upgrade.env up » dans PowerShell et ceci fois, il a fonctionné avec succès. Pour vérifier que le script de mise à niveau s’est exécuté correctement, recherchez une entrée de journal similaire à « INFO : la mise à niveau de la base de données de la version 9.3.0 vers la version 10.3.1 est terminée. » Voici quelques captures d’écran pour référence.
       

       Mise à jour de la base de données Sitecore en cours

       

       Mise à niveau de la base de données Sitecore terminée

À présent, nous avions mis à niveau avec succès les bases de données 9.3.0 vers 10.3.1. Pour valider la mise à niveau de la base de données, nous avons exécuté les étapes suivantes.

1. Démarrez l’instance Vanilla de 10.3.1 via Docker Compose.
2. Vérifiez la connexion à Sitecore.
3. Reconstruire la solution VS (au moment où je suis arrivé à cette étape, mes coéquipiers avaient déjà mis à niveau la solution VS vers 10.3.1).
4. Effectuez une sauvegarde des bases de données Vanilla 10.3.1 en local.
5. Activez l’authentification confinée.
6. Arrêtez le conteneur SQL 10.3.1.
7. Copiez les fichiers mdf et ldf de toutes les bases de données mises à niveau du volume localhost du conteneur SQL 9.3.0 vers un dossier temporaire.
8. Dans le dossier temporaire, renommez les fichiers portant le même nom que les fichiers Vanilla 10.3.1 et copiez-les dans le volume localhost du conteneur SQL 10.3.1.
9. Redémarrez le conteneur SQL 10.3.1.

À ce stade, notre site Web local a été mis à niveau vers les bases de données et la base de code 10.3.1.

L’étape suivante de la mise à niveau consistait à diviser la base de données principale afin que les informations sur les membres se trouvent dans une base de données distincte et voici les étapes que nous avons effectuées pour cela.

1. Effectuez une sauvegarde de la base de données principale.
2. Téléchargez le zip depuis https://dev.sitecore.net/Downloads/Scripts_for_Sitecore_Security_database.aspx et extrayez son contenu dans les tables d’adhésion C:\sitecoreupgrade\move.
3. Consultez le fichier Lisez-moi et le fichier de documentation KCD.
4. Mettez à jour les paramètres dans les fichiers si nécessaire. J’ai changé la valeur par défaut de $server en l’adresse IP du conteneur SQL.
5. Exécutez les scripts comme mentionné dans la documentation.
6. Assurez-vous de mettre à jour le fichier de composition pour la solution afin que ${SQL_DATABASE_PREFIX}.Core soit remplacé par ${SQL_DATABASE_PREFIX}.Security pour la chaîne de connexion ‘Sitecore_ConnectionStrings_Security’ et ‘Sitecore_Sitecore__IdentityServer__SitecoreMemberShipOptions__ConnectionString’.
7. Validez la connexion à Sitecore fonctionne.

Ceci conclut les étapes à effectuer pour mettre à niveau les bases de données Sitecore. Dans la dernière partie de cette série de blogs, nous examinerons les étapes qui doivent être exécutées après la mise à niveau de nos bases de données Sitecore vers 10.3.1.