Installation et configuration du stockage BLOB distant (RBS) avec FILESTREAM dans une batterie de serveurs SharePoint Server

Article
03/08/2023

S’APPLIQUE À : oui-img-13 2013 oui-img-16 2016 oui-img-19 2019 oui-img-se Édition d’abonnement no-img-sop SharePoint dans Microsoft 365

SharePoint Server utilise la fonctionnalité de stockage BLOB distant pour stocker les objets BLOB (Binary Large Objects) hors de la base de données de contenu. Pour plus d'informations sur le stockage BLOB distant, voir Vue d'ensemble de la fonctionnalité de stockage BLOB distant (RBS) dans SharePoint Server.

Sauf indication contraire, les informations contenues dans cet article sont spécifiques à l'utilisation de RBS avec le fournisseur FILESTREAM. Pour obtenir de l'aide spécifique à un autre fournisseur, contactez son fabricant.

Conseil

Cette solution utilise le fournisseur FILESTREAM RBS inclus dans SQL Server 2019, SQL Server 2017, SQL Server 2016, SQL Server 2016 SP1, SQL Server 2014, Service Pack 1 SP1, SP2 et SQL Server 2008. Si vous souhaitez installer et configurer RBS à l'aide d'un autre fournisseur, utilisez la procédure décrite dans Installer et configurer RBS avec un fournisseur tiers pour SharePoint Server.

Avant de commencer

Il vous suffit d’installer et de configurer une seule fois le stockage BLOB distant avec le fournisseur FILESTREAM pour la batterie de serveurs. Toutefois, si vous souhaitez activer le stockage BLOB distant à l'aide d'autres fournisseurs pour des bases de données de contenu spécifiques, vous devez configurer le stockage BLOB distant afin d'utiliser ces fournisseurs. Pour plus d'informations sur la procédure à suivre, voir Installer et configurer RBS avec un fournisseur tiers pour SharePoint Server.

Avant de commencer cette opération, lisez les informations suivantes sur les éléments prérequis :

Le compte d'utilisateur utilisé pour effectuer les étapes de la section Mettre en service un magasin BLOB pour chaque base de données de contenu doit être membre du rôle de base de données fixe db_owner sur chaque base de données pour laquelle vous configurez RBS.
Le compte d'utilisateur qui procède à l'installation de la bibliothèque cliente dans les étapes de la section Installer la bibliothèque cliente RBS sur SQL Server et sur chaque serveur frontal ou d'applications doit être membre du groupe Administrateurs sur tous les ordinateurs sur lesquels la bibliothèque est installée.
Le compte d'utilisateur activant RBS dans la section Activer le stockage BLOB distant pour chaque base de données de contenu doit disposer d'autorisations suffisantes pour exécuter Microsoft PowerShell.

Activer FILESTREAM sur le serveur de base de données

Par défaut, la fonctionnalité FILESTREAM est installée lorsque vous installez SQL Server. Pour autant, elle n'est pas activée. Vous devez activer et configurer FILESTREAM sur l'ordinateur qui exécute SQL Server et qui héberge les bases de données SharePoint Server. Suivez les étapes ci-après :

Activez FILESTREAM pour l’accès à Transact-SQL
Activez l’accès en flux continu aux E/S du fichier FILESTREAM.
Autorisez les clients à avoir accès en flux continu aux données FILESTREAM si vous avez besoin d’un accès client à distance.

Pour activer FILESTREAM pour les E/S du fichier et pour permettre l'accès des clients, suivez les instructions décrites dans Activer et configurer FILESTREAM. Il vous suffit de configurer ces paramètres une fois pour chaque serveur de base de données où vous souhaitez utiliser RBS.

Mettre en service un magasin BLOB pour chaque base de données de contenu

Après avoir activé et configuré FILESTREAM, mettez en service un magasin BLOB dans le système de fichiers comme décrit dans la procédure suivante. Vous devez mettre en service un magasin BLOB pour chaque base de données de contenu à utiliser avec le stockage BLOB distant.

Pour mettre en service un magasin BLOB

Vérifiez que le compte d'utilisateur qui effectue ces étapes est membre du rôle de base de données fixe db_owner sur chaque base de données pour laquelle vous configurez le stockage BLOB distant.
Ouvrez SQL Server Management Studio.
Connectez-vous à l'instance de SQL Server qui héberge la base de données de contenu.
Développez Bases de données.
Cliquez sur la base de données de contenu pour laquelle vous souhaitez créer un magasin d'objets BLOB, puis cliquez sur Nouvelle requête.
Collez les requêtes SQL suivantes dans le volet Requête, puis exécutez-les dans l'ordre indiqué. Dans chaque cas, remplacez [WSS_Content] par le nom de la base de données de contenu et remplacez c :\BlobStore par le volume\répertoire dans lequel vous souhaitez créer le magasin d’objets blob. Le processus de mise en service crée un dossier à l'emplacement que vous spécifiez. Sachez que vous ne pouvez mettre en service un magasin BLOB qu'une seule fois. Si vous essayez de mettre en service le même magasin BLOB plusieurs fois, vous recevez un message d'erreur.

Conseil

Pour optimiser les performances et simplifier la résolution des problèmes, nous vous recommandons de créer le magasin BLOB sur un volume qui ne contient pas de système d’exploitation, de fichiers d’échange, de données de base de données, de fichiers journaux ou de fichier tempdb.
```
use [WSS_Content]
if not exists 
(select * from sys.symmetric_keys 
where name = N'##MS_DatabaseMasterKey##')
create master key encryption by password = N'Admin Key Password !2#4'
```
```
use [WSS_Content]
if not exists 
(select groupname from sysfilegroups 
where groupname=N'RBSFilestreamProvider')
alter database [WSS_Content]
add filegroup RBSFilestreamProvider contains filestream
```
```
use [WSS_Content] 
alter database [WSS_Content]
add file (name = RBSFilestreamFile, filename = 'c:\Blobstore') to filegroup RBSFilestreamProvider
```

Installer la bibliothèque cliente RBS sur SQL Server et sur chaque serveur frontal ou d’applications

Vous devez installer la bibliothèque cliente RBS sur le nœud SQL Server et sur tous les serveurs d’applications ou frontaux de la batterie de serveurs SharePoint. La bibliothèque cliente RBS n'est installée qu'une fois par serveur web, mais RBS est configuré séparément pour chaque base de données de contenu associée. La bibliothèque cliente se compose d'une bibliothèque de liens dynamiques (DLL) côté client liée à une application utilisateur et d'un ensemble de procédures stockées installées sur SQL Server.

Attention

N’installez pas la bibliothèque de client RBS en exécutant le fichier RBS_amd64.msi (ou RBS.msi) et en démarrant l’Assistant Installation du stockage BLOB distant SQL. L'Assistant définit certaines valeurs par défaut qui ne sont pas recommandées pour SharePoint Server.

Pour installer la bibliothèque cliente RBS sur SQL Server

Confirmez que le compte d’utilisateur qui exécute ces étapes est membre du groupe Administrateurs sur l’ordinateur sur lequel vous installez la bibliothèque.
Sur le nœud SQL Server, téléchargez le client RBS approprié en fonction de la version de SQL Server et du niveau SharePoint que vous utilisez.

SharePoint Server Édition d’abonnement prend en charge le fournisseur FILESTREAM inclus dans SQL Server 2019 et les versions ultérieures de SQL Server.

SharePoint Server 2019 prend en charge le fournisseur FILESTREAM inclus dans SQL Server 2016 et SQL Server 2017.

SharePoint Server 2016 prend en charge le fournisseur FILESTREAM inclus dans SQL Server 2014 et SQL Server 2016.

SharePoint 2013 prend en charge les fournisseurs FILESTREAM inclus dans toutes les versions de SQL Server 2008 R2, SQL Server 2012 et SQL Server 2014.

Vous devez uniquement télécharger le fichier RSB.msi à partir du Feature Pack, mais assurez-vous que vous téléchargez le type de processeur approprié à votre serveur, soit x86 ou x64.

Pour SharePoint Server Édition d’abonnement, choisissez l’installation appropriée dans la liste suivante :
- Microsoft SQL Server 2019 Integration Services Feature Pack
Pour SharePoint Server 2019, choisissez l’installation appropriée dans la liste suivante :
Pour SharePoint Server 2016, choisissez l'installation correcte dans la liste suivante :
Pour SharePoint 2013, choisissez l'installation correcte dans la liste suivante :
Copiez et collez la commande suivante dans la fenêtre d'invite de commandes. Remplacez WSS_Content par le nom de la base de données et dbInstanceName par le nom de l’instance SQL Server. Vous ne devez exécuter cette commande en utilisant les noms de base de données et d'instance SQL Server spécifiques qu'une seule fois. L'opération doit se terminer au bout d'une minute environ.
```
msiexec /qn /lvx* rbs_install_log.txt /i RBS_amd64.msi TRUSTSERVERCERTIFICATE=true FILEGROUP=PRIMARY DBNAME="WSS_Content" DBINSTANCE="DBInstanceName" FILESTREAMFILEGROUP=RBSFilestreamProvider FILESTREAMSTORENAME=FilestreamProvider_1
```

Pour installer la bibliothèque cliente RBS sur tous les serveurs frontaux et d’applications SharePoint

Confirmez que le compte d’utilisateur qui exécute ces étapes est membre du groupe Administrateurs sur l’ordinateur sur lequel vous installez la bibliothèque.
Sur un serveur web, téléchargez le client RBS approprié en fonction de la version de SQL Server et du niveau SharePoint que vous utilisez. Utilisez l'une des listes suivantes pour choisir l'installation correcte.

SharePoint Server Édition d’abonnement prend en charge le fournisseur FILESTREAM inclus dans SQL Server 2019 et les versions ultérieures de SQL Server.

SharePoint Server 2019 prend en charge le fournisseur FILESTREAM inclus dans SQL Server 2016 et SQL Server 2017.

SharePoint Server 2016 prend en charge le fournisseur FILESTREAM inclus dans SQL Server 2014 et SQL Server 2016.

SharePoint 2013 prend en charge les fournisseurs FILESTREAM inclus dans toutes les versions de SQL Server 2008 R2, SQL Server 2012 et SQL Server 2014.

Vous devez uniquement télécharger le fichier RSB.msi à partir du Feature Pack, mais veillez à télécharger la version x64.

Pour SharePoint Server Édition d’abonnement, choisissez l’installation appropriée dans la liste suivante :
- Microsoft SQL Server 2019 Integration Services Feature Pack
Pour SharePoint Server 2019, choisissez l’installation appropriée dans la liste suivante :
Pour SharePoint Server 2016, choisissez l'installation correcte dans la liste suivante :
Pour SharePoint 2013, choisissez l'installation correcte dans la liste suivante :
Copiez et collez la commande suivante dans la fenêtre d'invite de commandes. Remplacez WSS_Content par le nom de la base de données et dbInstanceName par le nom de l’instance SQL Server. L'opération doit prendre environ une minute.
```
msiexec /qn /lvx* rbs_install_log.txt /i RBS_amd64.msi DBNAME="WSS_Content" DBINSTANCE="DBInstanceName" ADDLOCAL=Client,Docs,Maintainer,ServerScript,FilestreamClient,FilestreamServer
```
Notes

[!REMARQUE] Si vous essayez d'installer SQL Server 2012 Remote Blob Store pour une base de données supplémentaire sur la même instance de SQL Server, vous recevrez une erreur. Pour plus d'informations, reportez-vous à l'article 2767183 de la base de connaissances.

Pour les bases de données de contenu suivantes pour lesquelles vous voulez activer RBS, modifiez la commande msiexec de la même façon que celle décrite ci-dessous.
```
msiexec /qn /lvx* rbs_install_log_ContentDbName.txt /i RBS_amd64.msi REMOTEBLOBENABLE=1 FILESTREAMPROVIDERENABLE=1 DBNAME="WSS_Content_2" ADDLOCAL="EnableRBS,FilestreamRunScript" DBINSTANCE="DBInstanceName"
```
Suivez de nouveau cette procédure pour tous les serveurs frontaux et d’applications de la batterie de serveurs SharePoint.

Notes

[!REMARQUE] Si vous installez des services web Visio sur des serveurs d'applications SharePoint Server sur lesquels aucun fournisseur RBS n'est installé, une erreur Visio se produit lorsque vous essayez d'ouvrir un diagramme Visio à partir de ce serveur. Vous devez installer un client RBS sur les serveurs SharePoint Server exécutant Service Graphiques Visio si vous voulez ouvrir des diagrammes Visio sur ce serveur.

Pour valider l’installation de la bibliothèque cliente RBS

Le fichier journal rbs_install_log.txt est créé au même emplacement que le fichier RBS_amd64.msi. Ouvrez le fichier journal rbs_install_log.txt à l'aide d'un éditeur de texte et faites-le défiler vers le bas. Dans les 20 dernières lignes du fichier, une entrée doit se présenter comme suit : Produit : Stockage étendu des objets blob SQL - L'installation s'est terminée correctement.
Sur l'ordinateur qui exécute le Service Pack 1 (SP1) ou SQL Server 2008, vérifiez que les tables RBS ont été créées dans la base de données de contenu. Plusieurs tables doivent être répertoriées sous la base de données de contenu, sous des noms commençant par les lettres « mssqlrbs ».

Activer le stockage BLOB distant pour chaque base de données de contenu

Vous devez activer RBS sur un serveur web dans la batterie de serveurs SharePoint. Le choix du serveur web pour cette activité n'est pas important, l'essentiel étant que vous ayez installé RBS au moyen de la procédure précédente. Vous devez effectuer cette procédure une fois par base de données de contenu.

Notes

Vous ne pouvez activer RBS qu’à l’aide de Microsoft PowerShell.

Pour activer RBS à l'aide de Microsoft PowerShell

Vérifiez que vous êtes membre :
- du rôle serveur fixe securityadmin sur l'instance SQL Server.
- du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;
- du groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell.
Démarrez SharePoint Management Shell.

À l'invite de commandes Microsoft PowerShell, tapez la commande suivante :

$cdb = Get-SPContentDatabase <ContentDatabaseName>
$rbss = $cdb.RemoteBlobStorageSettings
$rbss.Installed()
$rbss.Enable()
$rbss.SetActiveProviderName($rbss.GetProviderNames()[0])
$rbss

Où <ContentDatabaseName> est le nom de la base de données de contenu.

Pour plus d'informations, voir Get-SPContentDatabase.

Affecter les autorisations db_owner à l’application web

Importante

Assurez-vous que l'application web qui accède à la base de données de contenu compatible avec RBS est membre du rôle de base de données fixe db_owner pour cette base de données.

Tester l’installation de RBS

Vous devez tester l’installation RBS sur un serveur frontal de la batterie de serveurs SharePoint pour vous assurer que le système fonctionne correctement.

Pour tester le magasin de données RBS

Sur l'ordinateur qui contient le magasin de données RBS, cliquez sur Démarrer, puis sur Ordinateur.
Accédez au répertoire du magasin de données RBS.
Vérifiez que le dossier est vide.
Sur la batterie de serveurs SharePoint, téléchargez un fichier d’au moins 100 kilo-octets (Ko) vers une bibliothèque de documents.
Sur l'ordinateur qui contient le magasin de données de stockage BLOB distant, cliquez sur Démarrer, puis sur Ordinateur.
Accédez au répertoire du magasin de données RBS.
Accédez à la liste des fichiers et ouvrez le fichier dont la date de modification est la plus récente. Il doit s’agir du fichier que vous avez téléchargé.