Instalar e configurar o RBS com FILESTREAM em um farm do SharePoint Server

APLICA-SE A:yes-img-132013 yes-img-16 2016yes-img-192019 yes-img-seSubscription Edition no-img-sopSharePoint no Microsoft 365

O SharePoint Server usa o recurso RBS para armazenar BLOBs (objetos binários grandes) fora do banco de dados de conteúdo. Confira mais informações sobre o RBS em Overview of RBS in SharePoint Server.

[!OBSERVAçãO] A menos que haja especificação contrária, as informações deste artigo são específicas do RBS com o provedor FILESTREAM. Para obter orientação específica de outro provedor, contate o fabricante do provedor.

Dica

Essa solução usa o provedor RBS FILESTREAM incluído no SQL Server 2019, SQL Server 2017, SQL Server 2016, SQL Server 2016 SP1, SQL Server 2014, Service Pack 1 SP1, SP2 e SQL Server 2008. Se você deseja instalar e configurar o RBS usando um provedor diferente, use o procedimento descrito no tópico Install and configure RBS with a 3rd party provider for SharePoint Server.

Antes de começar

Você só deve instalar e configurar o RBS com o provedor de FILESTREAM uma vez para o farm. No entanto, se deseja ativar o RBS usando diferentes provedores para bancos de dados de conteúdo específicos, configure o RBS para usar esses provedores. Para saber mais sobre como fazer isso, confira Install and configure RBS with a 3rd party provider for SharePoint Server.

Antes de começar essa operação, revise as informações a seguir sobre pré-requisitos:

Ative o FILESTREAM no servidor de banco de dados

Por padrão, o recurso FILESTREAM é instalado quando você instala SQL Server. Mas não está habilitado. Você deve habilitar e configurar FILESTREAM no computador que está executando SQL Server que hospeda os bancos de dados do SharePoint Server. Você deve:

  1. Habilitar FILESTREAM para o acesso do Transact-SQL.

  2. Habilitar FILESTREAM para o acesso do fluxo contínuo de E/S do arquivo.

  3. Permita que clientes remotos tenham acesso a transmissão de dados FILESTREAM se você precisar de acesso remoto ao cliente.

Para habilitar FILESTREAM para E/S de arquivo e permitir o acesso dos clientes, siga as instruções em Habilitar e Configurar FILESTREAM. Você deve definir essas configurações apenas uma vez para cada servidor de banco de dados em que deseja usar o RBS.

Provisione um repositório BLOB para cada banco de dados de conteúdo

Depois de ativar e configurar o FILESTREAM, provisione um repositório BLOB no sistema de arquivo conforme descrito no procedimento a seguir. Você deve provisionar um repositório BLOB para cada banco de dados de conteúdo com o qual deseja usar o RBS.

Para provisionar um repositório BLOB

  1. Confirme se a conta de usuário que executa essas etapas é um membro da função fixa db_owner em cada banco de dados para o qual você está configurando o RBS.

  2. Abra o SQL Server Management Studio.

  3. Conecte-se à instância do SQL Server que hospeda o banco de dados de conteúdo.

  4. Expanda Bancos de dados.

  5. Clique no banco de dados de conteúdo para o qual você deseja criar um repositório BLOB, e clique em Nova Consulta.

  6. Cole as consultas de SQL a seguir no painel Consulta e depois execute-as na sequência listada. Em cada caso, substitua [WSS_Content] pelo nome do banco de dados de conteúdo e c:\BlobStore pelo volume\diretório em que deseja criar o repositório BLOB. O processo de provisionamento cria uma pasta no local especificado. Esteja ciente de que você pode provisionar repositórios BLOB apenas uma vez. Se tentar provisionar o mesmo repositório BLOB várias vezes, receberá um erro.

    Dica

    Para obter o melhor desempenho, simplificar as soluções de problemas e como prática recomendada geral, sugerimos criar o repositório BLOB em um volume que não contenha o sistema operacional, arquivos de paginação, dados do banco de dados, arquivos de log ou o arquivo 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
    

Instalar a biblioteca de cliente RBS no SQL Server e em cada servidor front-end ou de aplicativo

Instale a biblioteca de cliente RBS no nó do SQL Server e em todos os servidores front-end ou de aplicativos no farm do SharePoint. Essa biblioteca é instalada apenas uma vez por servidor Web, mas o RBS é configurado separadamente para cada banco de dados de conteúdo associado. A biblioteca de clientes consiste em uma DLL (biblioteca de links dinâmicos) do lado do cliente que está vinculada a um aplicativo de usuário e um conjunto de procedimentos armazenados instalados no SQL Server.

Cuidado

Não instale a biblioteca de clientes RBS executando o arquivo RBS_amd64.msi (ou RBS.msi) e iniciando o assistente Instalar o ARMAZENAMENTO DE BLOB Remoto do SQL. O assistente define determinados valores padrão que não são recomendados para o SharePoint Server.

Para instalar a biblioteca de cliente RBS no SQL Server:

  1. Confirme se a conta do usuário que está executando essas etapas é membro do grupo Administradores do computador em que você está instalando a biblioteca.

  2. No nó do SQL Server, baixe o cliente RBS correto de acordo com a versão do SQL Server e o nível do SharePoint que você usa.

    Edição de Assinatura do SharePoint Server dá suporte ao provedor FILESTREAM incluído nas versões SQL Server 2019 e posteriores do SQL Server.

    SharePoint Server 2019 dá suporte ao provedor FILESTREAM incluído em SQL Server 2016 e SQL Server 2017.

    O SharePoint Server 2016 dá suporte ao provedor FILESTREAM incluído no SQL Server 2014 e SQL Server 2016.

    O SharePoint 2013 dá suporte aos provedores FILESTREAM incluídos em todas as versões do SQL Server 2008 R2, SQL Server 2012 e SQL Server 2014.

    Você só precisa baixar o arquivo RSB.msi do Feature Pack, mas assegure-se de baixar o tipo de processador correto para o seu servidor, seja x86 ou x64.

    Para Edição de Assinatura do SharePoint Server, escolha a instalação correta na seguinte lista:

    Para SharePoint Server 2019, escolha a instalação correta na seguinte lista:

    Para o SharePoint Server 2016, escolha a instalação correta na lista a seguir:

    Para o SharePoint 2013, escolha a instalação correta na lista a seguir:

  3. Copie e cole o comando a seguir na janela do Prompt de Comando. Substitua WSS_Content pelo nome do banco de dados e substitua DBInstanceName pelo nome da instância SQL Server. Você deve executar esse comando usando o nome do banco de dados específico e SQL Server nome da instância apenas uma vez. A operação deve terminar dentro de aproximadamente um minuto.

    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
    

Para instalar a biblioteca de cliente RBS em todos os servidores front-end do SharePoint e de aplicativos:

  1. Confirme se a conta do usuário que está executando essas etapas é membro do grupo Administradores do computador em que você está instalando a biblioteca.

  2. Em qualquer servidor Web, baixe o cliente RBS correto com base na versão SQL Server e no nível do SharePoint que você usa. Use uma das listas a seguir para escolher a instalação correta.

    Edição de Assinatura do SharePoint Server dá suporte ao provedor FILESTREAM incluído nas versões SQL Server 2019 e posteriores do SQL Server.

    SharePoint Server 2019 dá suporte ao provedor FILESTREAM incluído em SQL Server 2016 e SQL Server 2017.

    O SharePoint Server 2016 dá suporte ao provedor FILESTREAM incluído no SQL Server 2014 e SQL Server 2016.

    O SharePoint 2013 dá suporte aos provedores FILESTREAM incluídos em todas as versões do SQL Server 2008 R2, SQL Server 2012 e SQL Server 2014.

    Você só precisa baixar o arquivo RSB.msi do Pacote de Recursos, mas certifique-se de baixar a versão x64.

    Para Edição de Assinatura do SharePoint Server, escolha a instalação correta na seguinte lista:

    Para SharePoint Server 2019, escolha a instalação correta na seguinte lista:

    Para o SharePoint Server 2016, escolha a instalação correta na lista a seguir:

    Para o SharePoint 2013, escolha a instalação correta na lista a seguir:

  3. Copie e cole o comando a seguir na janela do Prompt de Comando. Substitua WSS_Content pelo nome do banco de dados e substitua DBInstanceName pelo nome da instância SQL Server. A operação deve terminar dentro de aproximadamente um minuto.

    msiexec /qn /lvx* rbs_install_log.txt /i RBS_amd64.msi DBNAME="WSS_Content" DBINSTANCE="DBInstanceName" ADDLOCAL=Client,Docs,Maintainer,ServerScript,FilestreamClient,FilestreamServer
    

    Observação

    Se tentar instalar o Microsoft SQL Server 2012 Remote BLOB Store para um banco de dados adicional na mesma instância do SQL Server, você receberá um erro. Para obter mais informações, consulte KB2767183.

    Para bancos de dados de conteúdo subsequentes para os quais você deseja habilitar o RBS, altere o comando msiexec de forma semelhante ao que é exibido abaixo.

    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"
    
  4. Repita esse procedimento para todos os servidores de front-end e de aplicativos no farm do SharePoint.

    Observação

    Se você instalar os serviços Web do Visio em servidores de aplicativos do SharePoint Server que não têm um provedor RBS instalado, ocorrerá um erro do Visio ao tentar abrir um diagrama do Visio desse servidor. Você deve instalar um cliente EDR nos servidores do SharePoint Server que executam o Serviço de Gráfico do Visio, caso queira abrir diagramas do Visio nesse servidor.

Para confirmar a instalação da biblioteca do cliente RBS

  1. O arquivo de log rbs_install_log.txt é criado no mesmo local que o arquivo RBS_amd64.msi. Abra o rbs_install_log.txt usando um editor de texto e role até o final do arquivo. Nas últimas 20 linhas do final do arquivo, uma entrada deve ser lida da seguinte maneira: Produto: SqL Remote Blob Storage – Instalação concluída com êxito.

  2. No computador que está executando o Service Pack 1 (SP1) ou SQL Server 2008, verifique se as tabelas RBS foram criadas no banco de dados de conteúdo. Várias tabelas devem estar relacionadas no banco de dados de conteúdo, com nomes precedidos pelas letras "mssqlrbs".

Ative o RBS para cada banco de dados de conteúdo

Você deve ativar o RBS em um servidor da Web no farm do SharePoint. O servidor selecionado para essa atividade não tem importância, contanto que o RBS seja instalado nele usando o procedimento anterior. Esse procedimento deve ser executado uma vez para cada banco de dados de conteúdo.

Observação

É possível habilitar o RBS apenas com o Microsoft PowerShell.

Para habilitar o RBS usando o Microsoft PowerShell

  1. Verifique se você possui as seguintes associações:

    • A função de servidor fixa securityadmin na instância do SQL Server.

    • A função de banco de dados fixa db_owner em todos os bancos de dados que devem ser atualizados.

    • O grupo de administradores no servidor no qual você está executando o cmdlets do PowerShell.

  2. Inicie o Shell de Gerenciamento do SharePoint.

  3. No prompt de comando do Microsoft PowerShell, digite o seguinte comando:

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

    Onde <ContentDatabaseName> é o nome do banco de dados de conteúdo.

Para saber mais, confira Get-SPContentDatabase.

Atribuir permissões de db_owner para o aplicativo Web

Importante

Certifique-se de que a aplicação web que acessa o banco de dados de conteúdo RBS-habilitado é um membro da db_owner função de banco fixo para esse banco de dados.

Teste a instalação do RBS

Você deve testar a instalação do RBS em um servidor front-end no farm do SharePoint para verificar se o sistema está funcionando corretamente.

Para testar o repositório de dados RBS

  1. No computador que contém o repositório de dados do RBS, clique em Iniciar e em Computador.

  2. Navegue até o diretório do repositório de dados do RBS

  3. Confirme se a pasta está vazia.

  4. No farm do SharePoint, carregue um arquivo que tenha pelo menos 100 kilobytes (KB) em uma biblioteca de documentos.

  5. No computador que contém o repositório de dados do RBS, clique em Iniciar e em Computador.

  6. Navegue até o diretório do repositório de dados do RBS

  7. Navegue até a lista de arquivos e abra o arquivo que tem data a mais recente alterada. Esse deve ser o arquivo que você carregou.

Confira também

Visão geral do RBS no SharePoint Server

Optar por usar RBS no SharePoint Server

Instalar e configurar o RBS com o SharePoint 2013 e SQL Server 2012

Instalação do SharePoint 2013

Remote Blob Store (RBS) (SQL Server)

Habilitar e configurar FILESTREAM