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

This image has an empty alt attribute; its file name is capture1.jpg

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».

This image has an empty alt attribute; its file name is capture2.jpg

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é.

This image has an empty alt attribute; its file name is capture3.jpg

Puis dans le menu Status, activez cet utilisateur

This image has an empty alt attribute; its file name is capture4.jpg

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)”

This image has an empty alt attribute; its file name is capture5.jpg

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

This image has an empty alt attribute; its file name is capture6.jpg

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

This image has an empty alt attribute; its file name is capture7.jpg

Executez le programme setup

This image has an empty alt attribute; its file name is capture8.jpg

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

This image has an empty alt attribute; its file name is capture10.jpg

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.

This image has an empty alt attribute; its file name is capture12.jpg

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

This image has an empty alt attribute; its file name is capture11.jpg

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).

This image has an empty alt attribute; its file name is capture13.jpg

Vous devez aussi reindexer tous les index.

This image has an empty alt attribute; its file name is capture14.jpg

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

This image has an empty alt attribute; its file name is capture15.jpg

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

This image has an empty alt attribute; its file name is capture16.jpg

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:

This image has an empty alt attribute; its file name is capture17.jpg

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:

$SiteNamePrefix“XC10”
$SiteName“$($SiteNamePrefix)sc.dev.local”
$IdentityServerSiteName“$($SiteNamePrefix)identityserver.dev.local”
$SitecoreIdentityServerUrlhttps://$IdentityServerSiteName
$CommerceEngineConnectClientSecretvoir plus bas
$InstallDir“$($Env:SYSTEMDRIVE)\inetpub\wwwroot\$SiteName”
$XConnectInstallDir“$($Env:SYSTEMDRIVE)\inetpub\wwwroot\$($SiteNamePrefix)xconnect.dev.local”
$SqlDbPrefix$SiteNamePrefix
$SitecoreDbServer“$($Env:COMPUTERNAME)\SQLEXPRESS”
$SqlUsersa
$SqlPasssa-password
$SitecoreDomain“sitecore”
$SitecoreUsername“admin”
$SitecoreUserPasswordsitecore-admin-password
$SolrUrlhttps://localhost:8983/solr
$SolrRoot“$($Env:SYSTEMDRIVE)\solr\solrsolr-8.4.0”
$SolrService“solrsolr-8.4.0”
$StorefrontIndexPrefix$SiteNamePrefix
$CommerceServicesDbServer$SitecoreDbServer
$BraintreeEnvironment“sandbox”

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.

This image has an empty alt attribute; its file name is capture18.jpg

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.

This image has an empty alt attribute; its file name is capture19.jpg

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

This image has an empty alt attribute; its file name is capture20.jpg

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

%d bloggers like this: