Installation de Sitecore Commerce 10 sur un server (on premise)

L’installation de Sitecore Commerce a souvent été assez difficile et longue. Je vais ici vous montrer comment installer XC10 sur un ordinateur sur site et comment éviter tous les pièges dans lesquels on tombe habituellement. L’objectif de cet article est d’avoir une installation XC propre sur l’ordinateur d’un développeur.

Afin de démontrer que j’ai vraiment un serveur “vide”, je vais commencer par créer une machine virtuelle Azure.

Connectez-vous à votre compte Azure et choisissez Ajouter une machine virtuelle. J’ai pris une image avec Windows 10 Pro, mais vous pouvez également choisir Windows Server 2016 ou Windows Server 2019

Ouvrez uniquement le port entrant RDP, car vous devrez vous connecter à votre serveur avec Remote Desktop.

Installation de SQL Server

Vous pouvez choisir d’installer n’importe quelle version de SQL Server 2017 ou SQL Server 2019. Je choisis d’installer la version gratuite EXPRESS. Installez également SSMS afin de pouvoir contrôler facilement ce que vous avez dans la base de données.

Assurez-vous d’activer l’authentification SQL afin de pouvoir vous connecter avec l’utilisateur “sa”. Dans SSMS, connectez-vous d’abord avec l’authentification Windows par défaut, et faites un clic droit sur le nom de votre serveur, sélectionnez “Propriétés”. Dans l’onglet Général, modifiez l’authentification du serveur en «Mode d’authentification SQL Server et Windows».

Localisez l’utilisateur sa dans Security / Logins et double-cliquez dessus. Dans l’onglet Général, modifiez le mot de passe et assurez-vous que «Enforce password policy» (ou l’equivalent en francais) n’est pas coché.

Puis dans le menu Status, activez cet utilisateur

Sauvegardez vos modifications en cliquant sur “OK”.

Ces modifications nécessitent un redémarrage du service SQL Server. Ouvrez la fenêtre des services et redémarrez “SQL Server (SQLEXPRESS)”

Rouvrez SSMS et assurez-vous que vous pouvez maintenant vous connecter avec l’utilisateur sa

Installer XP0 avec SIA

Surfez sur https://dev.sitecore.net et connectez vous avec votre ID Sitecore

Téléchargez Sitecore Experience Platform et décompressez les fichiers sur par ex c:\XP0

Executez le programme setup

Le programme d’installation est simple. Vous allez d’abord installer quelques prérequis et vous devrez redémarrer votre ordinateur.

Vous allez ensuite installer Solr et entrer vos paramètres Sitecore. Si vous disposez également d’une version EXPRESS de SQL Server, n’oubliez pas d’avoir le suffixe “\SQLExpress” dans le nom du serveur de base de données.

Assurez-vous également d’inclure l’installation du module SXA.

L’installation de XP0 devrait se faire sans le moindre problème.

Quand Sitecore XP est installé, ouvrez la page d’administration avec un browser (https://xc10sc.dev.local/sitecore si vous avez bien gardé les valeurs par défault dans SIA – j’ai indiqué “xc10” comme le préfixe de l’instance Sitecore) puis reconstruisez les liens des bases de données (Rebuild Link Databases).

Vous devez aussi reindexer tous les index.

Preparez votre installation XC10

Les étapes suivantes sont vraiment importantes pour avoir une installation sans erreur de XC10. N’oubliez pas que si le script d’installation se termine par une erreur au milieu de l’installation, vous aurez besoin la plupart du temps de tout désinstaller (XC et XP) et de redémarrer depuis le début, alors assurez-vous d’avoir suivi cette liste de contrôle point par point.

1- Installez Redis (version 3.0.504)

2- Installez .Net Framework 3.1.7

3- Installez Web Deploy 3.6 (si ce n’est deja fait avec SIA)

4- Installez URL Rewrite grace a la Web Platform Installer (si ce n’est deja fait avec SIA)

5- Installez .Net Core SDK 2.1.804 (Runtime 2.1.16)

6- Créez un répertoire d’installation, par ex. c:\XC10

7- Téléchargez MSBuild nuget package et décompressez le dans c:\XC10 (j’utilise 7-zip)

8- Téléchargez Sitecore Commerce 10

9- Décompressez ce ficher dans c:\XC10

10- Téléchargez Sitecore Experience Accelerator 10 et Powershell Extensions 6.1. Copiez ces fichiers zip dans c:\XC10

11- Décompressez SIF.Sitecore.Commerce.5.0.49.zip dans c:\XC10\SIF.Sitecore.Commerce.5.0.49\

12- Après toute cette préparation, votre répertoire d’installation doit ressembler à ceci:

13- Ouvrez le fichier c:\XC10\SIF.SItecore.Commerce.5.0.49\Deploy-Sitecore-Commerce.ps1 à l’aide d’un éditeur (Notepad++, Visual Studio Code,…) et changez les paramètres pour les adapter à votre configuration. Voici ce que j’ai:

14- Créez un Braintree sandbox et copiez les informations Braintree que vous recevez dans votre mail: $BraintreeMerchantId, $BraintreePublicKey et $BraintreePrivateKey.

15- Créez un nouveau script XC10Secret.ps1 avec le code suivant:

$bytes = New-Object Byte[] 32$rand = [System.Security.Cryptography.RandomNumberGenerator]::Create()$rand.GetBytes($bytes)$rand.Dispose()$newClientSecret = [System.Convert]::ToBase64String($bytes)

Executez ce programme avec Powershell et copiez le résultat dans la variable $CommerceEngineConnectClientSecret

A vos marques ! Prêts ? Partez !

1- Redémarrez le serveur d’identité (xc10identityserver.dev.local) depuis IIS

2- Ouvrez une console Powershell en mode Administrateur

3- Changez le répertoire pour c:\XC10\SIF.Sitecore.Commerce.5.0.49 et executez les commandes suivantes:

Set-ExecutionPolicy -Scope CurrentUser Unrestricted.\Deploy-Sitecore-Commerce.ps1

Votre installation devrait maintenant se poursuivre sans erreur.

Verifiez votre installation

Ouvrez votre SXA Storefront dans un navigateur. Quand la page s’est charg+ee, vous devriez voir la page d’accueil de SXA Storefront, avec des catégories dans le menu. Cliquez sur un produit et mettez le dans votre panier virtuel.

Si vous naviguez sur le Content Editor de Sitecore, vous verrez tous les nouveaux items de Sitecore Commerce.